Skip to content

TreeSelect

基础用法

归属地区
请选择归属地区

<template>
  <ai-form ref="formEl" :model="formInfo" :formConfig="formConfig"></ai-form>
</template>

<script setup>
import { reactive, computed } from 'vue'

const regionOptions = [
  {
    value: 'cn',
    label: '中国',
    children: [
      { value: 'bg', label: '北京' },
      { value: 'cq', label: '重庆' }
    ]
  },
  {
    value: 'en',
    label: '英国',
    children: [{ value: 'lo', label: '伦敦' }]
  },
]

const formInfo = reactive({
  region: '',
})

const formConfig = computed(() => {
  return [
    {
      key: "region",
      label: "归属地区",
      type: "tree-select",
      model: "region",
      prop: "region",
      required: true,
      dictList: regionOptions,
      dictKey: "value",
      dictLabel: "label",
    },
  ]
})
</script>

Props

属性说明类型默认值
typetree-selectstring-
key配置列表唯一标识string-
label标签文本string-
model属性名,它可以是属性的路径(如a.b.0)也可以是一个方法,返回属性路径,该属性是必填的string/Function-
prop一般和属性名保持一致,在使用了validateresetFields的方法时,该属性是必填的string/Function-
width宽度(1-24)number12
noneLabel是否隐藏标签booleanfalse
placeholder输入框占位文本string-
disabled是否禁用boolean/Functionfalse
size输入框尺寸string-
required是否必填booleanfalse
validator自定义校验方法Function-
data数据源array[]
nodeKey每个树节点用来作为唯一标识的属性,整棵树应该是唯一的string-
defaultProps树结构的propsobject-
multiple是否多选booleanfalse
teleported弹层是否使用teleportbooleantrue
filterable是否可筛选booleanfalse
clearable是否显示清除按钮booleanfalse
lazy是否懒加载子节点,需与load方法结合使用booleanfalse
load加载子树数据的方法,仅当lazy属性为true时生效Function-
accordion是否每次只打开一个同级树节点展开booleanfalse
filterNodeMethod对树节点进行筛选时执行的方法, 返回false则表示这个节点会被隐藏Function-
currentNodeKey当前选中的节点string/number-
showCheckbox节点是否可被选择booleanfalse
defaultCheckedKeys默认勾选的节点的key的数组array-
defaultExpandedKeys默认展开的节点的key的数组array-
renderContent树节点的内容区的渲染 FunctionFunction-
collapseTags多选时是否将选中值按文字的形式展示booleanfalse
collapseTagsTooltip当鼠标悬停于折叠标签的文本时,是否显示所有选中的标签booleanfalse
showErrorTooltip是否展示错误提示booleantrue
changeFun当绑定值变化时触发的回调函数Function-
showFun是否展示的判断函数,返回一个booleanFunction-