基于vue-bootstrap-typeahead二次开发组件,支持输入多个tag和tag的远程搜索组件。
特别注意
- 需要vue-property-decorator, vue-class-component, bootstrap的b-form-tags全局注册
usage
组件方式
import { MultipleSearchInput } from 'multiple-search-input'
Vue.component('MultipleSearchInput', MultipleSearchInput)
插件方式
import { multipleSearchInputPlugin } from 'multiple-search-input'
Vue.use(multipleSearchInputPlugin);
Prop
prop |
type |
description |
limit |
Number |
限制tag的个数 |
list |
{text: string; value: T} |
下拉选择 |
options |
{text: string; value: T} |
初始下拉(当是远程搜索没有初始下拉选择时需要提供,不然value找不到对应显示的text值,当options和list同时有优先选options里面的值) |
label |
string |
label |
fieldClass |
string |
设置整体div的class |
disabled |
boolean |
disabled |
canFreeText |
boolean |
不检查是否在下拉内,可以直接新建tag |
busy |
boolean |
使用无限滚动时翻页设置成true,load数据后改成false |
infinite |
boolean |
是否采用无限滚动 |
handleValidate |
(val: T) => boolean |
控制能否加入tag内 |
value [v-model] |
T[] |
tag的value |
Event
event |
type |
description |
fetch-data |
(val: string) => void; |
输入之后得到的值(可以在此调用远程搜索api) |
fetch-more-data |
(val: string) => void; |
触发滚动到底部的时候触发 |
get-option |
(val: {text: string; value: T}[]) => void; |
获取当前已被选中的tag option(对于得不到初始option,在页面返回的时候可以在option中传入) |
blur |
() => void; |
当输入后没有匹配或者选择list里面的value,触发失去焦点时(对于远程搜的时候,可以利用这个钩子来清空list) |
change[v-model] |
(val: string[]) => void; |
|
如何链接到别的包本地调试
- 运行
npm run dev
,将package.json
中的main改为dist/multipleSearchInput.js
, 并运行npm link
将包链接到本地全局,再在需要调试的项目运行npm link multiple-search-input
。需要调试的项目还需要npm install source-map-loader
配置webpack.config
启动命令详解:
npm run start
: 本地demo启本地服务器
nom run dev
: 打一个dev环境的js包
nom run start:demo
: 打一个prod环境的包但不抽离vue,vue-class-component,vue-property-decorator,方便直接引入js,而不是通过npm本地引入
nom run build
: 打prod包发布新版本
pre-publish
: 打包并改版本号
组件数据同步流程图