Cascader 级联选择器

基本用法

Cascader 级联选择器 - 图1

  1. <div class="cascader-demo">
  2. <se-cascader
  3. :options="options"
  4. size="mini"
  5. @change="onChange"
  6. :value="selected"
  7. change-on-select
  8. ></se-cascader>
  9. <se-cascader :options="options" @change="onChange"></se-cascader>
  10. <se-cascader :options="options" size="large" @change="onChange"></se-cascader>
  11. </div>
  12. <script>
  13. export default {
  14. data() {
  15. return {
  16. options: [
  17. {
  18. label: '藻类',
  19. value: 'zaolei',
  20. children: [{ label: '绿藻', value: 'lvzao' }, { label: '轮藻', value: 'lunzao' }]
  21. },
  22. {
  23. label: '苔藓',
  24. value: 'taixian',
  25. disabled: true,
  26. children: [
  27. { label: '地钱', value: 'diqian' },
  28. { label: '角苔', value: 'jiaotai' },
  29. { label: '苔藓植物门', value: 'taixianzhiwumeng' }
  30. ]
  31. },
  32. {
  33. label: '蕨类',
  34. value: 'juelei',
  35. children: [
  36. { label: '石松', value: 'shisong' },
  37. { label: '蕨类植物门', value: 'jueleizhiwumeng' }
  38. ]
  39. },
  40. {
  41. label: '种子植物',
  42. value: 'zhongzizhiwu',
  43. children: [
  44. {
  45. label: '被子',
  46. value: 'pizi',
  47. children: [
  48. { label: '睡莲目', value: 'shuilianmu' },
  49. { label: '木兰藤目', value: 'mulantengmu' }
  50. ]
  51. },
  52. { label: '苏铁', value: 'sutie' },
  53. { label: '银杏', value: 'yinxin' },
  54. { label: '松柏', value: 'songbai' }
  55. ]
  56. }
  57. ],
  58. selected: ['zaolei', 'lvzao']
  59. }
  60. },
  61. methods: {
  62. onChange(value) {
  63. console.log(value)
  64. }
  65. }
  66. }
  67. </script>
  68. <style>
  69. .cascader-demo {
  70. display: flex;
  71. align-items: center;
  72. justify-content: space-between;
  73. width: 700px;
  74. }
  75. </style>

内置的省市区选择器

Cascader 级联选择器 - 图2

<se-cascader show-city @change="onChange" :value="selected"></se-cascader>

<script>
  export default {
    data() {
      return {
        selected: ['北京市', '朝阳区']
      }
    },
    methods: {
      onChange(value) {
        console.log(value)
      }
    }
  }
</script>

Props

属性类型默认值必填说明
valuearray<string>[]默认的选中项
show-citybooleanfalse内置的省市区选择器
sizestringdefault设置大小,可选值:default / mini / large
placeholderstring请选择未进行选择时的提示
disabledbooleanfalse是否被禁用
optionsarray[]数据集
separatorstring/分隔符
change-on-selectbooleanfalse是否每级数据的选择都触发 change 事件
label-keystringlabel可以指定数据集中 label 的字段
children-keystringchildren可以指定数据集中 children 的字段
value-keystringvalue可以指定数据集中 value 的字段

Events

事件名称描述回调函数参数
change选择完成后的回调当前选择的数据的数组