enhance multiple cascader base on iview
- 以ES Module的方式使用:
# install module
npm i southhill/enhance-multiple-cascader-iview -S
// 引入iview组件库,样式
// 引入iview.css
import iView from 'iview'
import 'iview/dist/styles/iview.css'
// 全局注册组件
import EnhanceMultipleCascader from 'enhance-multiple-cascader'
Vue.use(iView)
Vue.use(EnhanceMultipleCascader)
// 在组件内部使用
import { EnhanceMultipleCascader } from 'enhance-multiple-cascader'
export default {
// ...
components: { EnhanceMultipleCascader }
}
- 以AMD的方式使用:
<!-- 依赖引入:使用script标签引入vue.js,iview.js。使用link标签引入iview.css。-->
<script src="https://cdn.bootcss.com/vue/2.6.10/vue.common.dev.js"></script>
<link rel="stylesheet" type="text/css" href="http://unpkg.com/[email protected]/dist/styles/iview.css">
<script src="https://cdn.bootcss.com/iview/3.5.1/iview.js"></script>
<script src="./dist/enhance-multiple-cascader.js" type="text/javascript"><script>
prop | type | default | explain |
---|---|---|---|
disabled | Boolean | false |
是否被禁用 |
value | Array | [] |
双向绑定使用的值 |
names | Array | [] |
该属性用来校验传入的value的标签是否与data中的数据保持一致,如果不一致,则清空组件的选中内容。 |
data | Array | [] |
待使用的级联数据 |
notFoundText | String | 没有数据可用 |
当没有找到数据时,显示的文本内容 |
propAlias | Object | 传递下来的data数据的属性的别名。有可能从服务端获取到的data树的属性名并不能符合当前使用中的属性名,所以做一次映射操作,以避免对服务端数据的处理,方便操作。 | |
onlyLeaf | Boolean | true |
仅仅只能选择叶子节点 |
uniqueFieldInLeaf | String | `` | 叶子节点独有的字段,用来标识是否为叶子节点 |
allowSelectByParentNode | Boolean | false |
允许通过父节点来选择相应的子节点 |
maxTagCount | Number | -1 |
当选中多个项目时,是否对显示在输入框中的条目精简显示 |
maxTagPlaceholder | Function | (v) => `+ ${v}...` |
当maxTagCount值设置后,选择超过指定数目的项后,级联器的输入值会精简显示为该方法返回的内容 |
filterable | Boolean | false |
是否通过输入过滤级联数据 |
clearable | Boolean | false |
是否可以通过清空输入框的方式删除全部选中的条目 |
allowDeleteByCloseIcon | Boolean | true |
允许通过Tag的关闭按钮来删除相应选中的条目 |
labelInValue | Boolean | false |
触发on-change事件时,返回的参数是否要被包装为传入的对象形式 |
multiple | Boolean | true |
默认为多选级联 |
transfer | Boolean | `!this.$IVIEW |
|
placeholder | String | 请选择 |
未操作时的占位符 |
name | String | cascader |
该值用在级联器的输入框中的name属性上 |
headStyle | Object | {} |
控制级联框的行内样式,多用来控制级联框宽度,默认宽度为240px |