Appearance
TreeSelectDispatcher
Element Plus 的 el-tree-select 组件分发器,添加了只读功能。
基础用法
树状选择器
树状选择器
Select
show checkbox:
Select
vue
<template>
<div class="m-4">
<p>树状选择器</p>
<el-tree-select-dispatcher
v-model="value"
:data="data"
:render-after-expand="false"
style="width: 240px"
/>
</div>
<div class="m-4">
<p>show checkbox:</p>
<el-tree-select-dispatcher
v-model="value"
:data="data"
:render-after-expand="false"
show-checkbox
style="width: 240px"
/>
</div>
</template>
<script lang="ts" setup>
import { ref } from "vue";
const value = ref();
const data = [
{
value: "1",
label: "Level one 1",
children: [
{
value: "1-1",
label: "Level two 1-1",
children: [
{
value: "1-1-1",
label: "Level three 1-1-1",
},
],
},
],
},
{
value: "2",
label: "Level one 2",
children: [
{
value: "2-1",
label: "Level two 2-1",
children: [
{
value: "2-1-1",
label: "Level three 2-1-1",
},
],
},
{
value: "2-2",
label: "Level two 2-2",
children: [
{
value: "2-2-1",
label: "Level three 2-2-1",
},
],
},
],
},
{
value: "3",
label: "Level one 3",
children: [
{
value: "3-1",
label: "Level two 3-1",
children: [
{
value: "3-1-1",
label: "Level three 3-1-1",
},
],
},
{
value: "3-2",
label: "Level two 3-2",
children: [
{
value: "3-2-1",
label: "Level three 3-2-1",
},
],
},
],
},
];
</script>
隐藏源码
选择任意级别
当属性 check-strictly=true 时,任何节点都可以被选择,否则只有子节点可被选择。
Select
Select
show checkbox:
Select
show checkbox with `check-on-click-node`:
Select
vue
<template>
<div class="m-4">
<p>Select</p>
<el-tree-select-dispatcher
v-model="value"
:data="data"
check-strictly
:render-after-expand="false"
style="width: 240px"
/>
</div>
<div class="m-4">
<p>show checkbox:</p>
<el-tree-select-dispatcher
v-model="value"
:data="data"
check-strictly
:render-after-expand="false"
show-checkbox
style="width: 240px"
/>
</div>
<div class="m-4">
<p>show checkbox with `check-on-click-node`:</p>
<el-tree-select-dispatcher
v-model="value"
:data="data"
check-strictly
:render-after-expand="false"
show-checkbox
check-on-click-node
style="width: 240px"
/>
</div>
</template>
<script lang="ts" setup>
import { ref } from "vue";
const value = ref();
const data = [
{
value: "1",
label: "Level one 1",
children: [
{
value: "1-1",
label: "Level two 1-1",
children: [
{
value: "1-1-1",
label: "Level three 1-1-1",
},
],
},
],
},
{
value: "2",
label: "Level one 2",
children: [
{
value: "2-1",
label: "Level two 2-1",
children: [
{
value: "2-1-1",
label: "Level three 2-1-1",
},
],
},
{
value: "2-2",
label: "Level two 2-2",
children: [
{
value: "2-2-1",
label: "Level three 2-2-1",
},
],
},
],
},
{
value: "3",
label: "Level one 3",
children: [
{
value: "3-1",
label: "Level two 3-1",
children: [
{
value: "3-1-1",
label: "Level three 3-1-1",
},
],
},
{
value: "3-2",
label: "Level two 3-2",
children: [
{
value: "3-2-1",
label: "Level three 3-2-1",
},
],
},
],
},
];
</script>
隐藏源码
多选
通过点击或复选框选择多个选项。
多选
Select
show checkbox:
Select
show checkbox with `check-strictly`:
Select
vue
<template>
<div class="m-4">
<p>多选</p>
<el-tree-select-dispatcher
v-model="value"
:data="data"
multiple
:render-after-expand="false"
style="width: 240px"
/>
</div>
<div class="m-4">
<p>show checkbox:</p>
<el-tree-select-dispatcher
v-model="value"
:data="data"
multiple
:render-after-expand="false"
show-checkbox
style="width: 240px"
/>
</div>
<div class="m-4">
<p>show checkbox with `check-strictly`:</p>
<el-tree-select-dispatcher
v-model="valueStrictly"
:data="data"
multiple
:render-after-expand="false"
show-checkbox
check-strictly
check-on-click-node
style="width: 240px"
/>
</div>
</template>
<script lang="ts" setup>
import { ref } from "vue";
const value = ref();
const valueStrictly = ref();
const data = [
{
value: "1",
label: "Level one 1",
children: [
{
value: "1-1",
label: "Level two 1-1",
children: [
{
value: "1-1-1",
label: "Level three 1-1-1",
},
],
},
],
},
{
value: "2",
label: "Level one 2",
children: [
{
value: "2-1",
label: "Level two 2-1",
children: [
{
value: "2-1-1",
label: "Level three 2-1-1",
},
],
},
{
value: "2-2",
label: "Level two 2-2",
children: [
{
value: "2-2-1",
label: "Level three 2-2-1",
},
],
},
],
},
{
value: "3",
label: "Level one 3",
children: [
{
value: "3-1",
label: "Level two 3-1",
children: [
{
value: "3-1-1",
label: "Level three 3-1-1",
},
],
},
{
value: "3-2",
label: "Level two 3-2",
children: [
{
value: "3-2-1",
label: "Level three 3-2-1",
},
],
},
],
},
];
</script>
隐藏源码
禁用选项
使用 disabled 字段禁用选项。
禁用选项
Select
vue
<template>
<div class="m-4">
<p>禁用选项</p>
<el-tree-select-dispatcher v-model="value" :data="data" style="width: 240px" />
</div>
</template>
<script lang="ts" setup>
import { ref } from "vue";
const value = ref();
const data = [
{
value: "1",
label: "Level one 1",
disabled: true,
children: [
{
value: "1-1",
label: "Level two 1-1",
disabled: true,
children: [
{
disabled: true,
value: "1-1-1",
label: "Level three 1-1-1",
},
],
},
],
},
{
value: "2",
label: "Level one 2",
children: [
{
value: "2-1",
label: "Level two 2-1",
children: [
{
value: "2-1-1",
label: "Level three 2-1-1",
},
],
},
{
value: "2-2",
label: "Level two 2-2",
children: [
{
value: "2-2-1",
label: "Level three 2-2-1",
},
],
},
],
},
{
value: "3",
label: "Level one 3",
children: [
{
value: "3-1",
label: "Level two 3-1",
children: [
{
value: "3-1-1",
label: "Level three 3-1-1",
},
],
},
{
value: "3-2",
label: "Level two 3-2",
children: [
{
value: "3-2-1",
label: "Level three 3-2-1",
},
],
},
],
},
];
</script>
隐藏源码
可筛选
使用关键字筛选或自定义筛选方法。 filterMethod可以自定义数据筛选的方法, filterNodeMethod可以自定义节点数据筛选的方法。
可筛选
Select
filter method:
Select
filter node method:
Select
vue
<template>
<div class="m-4">
<p>可筛选</p>
<el-tree-select-dispatcher
v-model="value"
:data="data"
filterable
style="width: 240px"
/>
</div>
<div class="m-4">
<p>filter method:</p>
<el-tree-select-dispatcher
v-model="value"
:data="filteredData"
:filter-method="filterMethod"
filterable
style="width: 240px"
/>
</div>
<div class="m-4">
<p>filter node method:</p>
<el-tree-select-dispatcher
v-model="value"
:data="data"
:filter-node-method="filterNodeMethod"
filterable
style="width: 240px"
/>
</div>
</template>
<script lang="ts" setup>
import { ref } from "vue";
const value = ref();
const sourceData = [
{
value: "1",
label: "Level one 1",
children: [
{
value: "1-1",
label: "Level two 1-1",
children: [
{
value: "1-1-1",
label: "Level three 1-1-1",
},
],
},
],
},
{
value: "2",
label: "Level one 2",
children: [
{
value: "2-1",
label: "Level two 2-1",
children: [
{
value: "2-1-1",
label: "Level three 2-1-1",
},
],
},
{
value: "2-2",
label: "Level two 2-2",
children: [
{
value: "2-2-1",
label: "Level three 2-2-1",
},
],
},
],
},
{
value: "3",
label: "Level one 3",
children: [
{
value: "3-1",
label: "Level two 3-1",
children: [
{
value: "3-1-1",
label: "Level three 3-1-1",
},
],
},
{
value: "3-2",
label: "Level two 3-2",
children: [
{
value: "3-2-1",
label: "Level three 3-2-1",
},
],
},
],
},
];
const data = ref(sourceData);
const filteredData = ref(sourceData);
const filterMethod = (value: string) => {
filteredData.value = [...sourceData].filter((item) =>
item.label.includes(value)
);
};
const filterNodeMethod = (value: string, data: any) => {
return data.label.includes(value);
};
</script>
隐藏源码
自定义内容
自定义树节点的内容。
自定义内容
Select
use render content:
Select
vue
<template>
<div class="m-4">
<p>自定义内容</p>
<el-tree-select-dispatcher v-model="value" :data="data" style="width: 240px">
<template #default="{ data: { label } }">
{{ label }}<span style="color: gray">(suffix)</span>
</template>
</el-tree-select-dispatcher>
</div>
<div class="m-4">
<p>use render content:</p>
<el-tree-select-dispatcher
v-model="value"
:data="data"
:render-content="renderContent"
style="width: 240px"
/>
</div>
</template>
<script lang="ts" setup>
import { ref, h } from "vue";
const value = ref();
const renderContent = (h: any, { data }: any) => {
return h(
"span",
{
style: {
color: "#626AEF",
},
},
data.label
);
};
const data = [
{
value: "1",
label: "Level one 1",
children: [
{
value: "1-1",
label: "Level two 1-1",
children: [
{
value: "1-1-1",
label: "Level three 1-1-1",
},
],
},
],
},
{
value: "2",
label: "Level one 2",
children: [
{
value: "2-1",
label: "Level two 2-1",
children: [
{
value: "2-1-1",
label: "Level three 2-1-1",
},
],
},
{
value: "2-2",
label: "Level two 2-2",
children: [
{
value: "2-2-1",
label: "Level three 2-2-1",
},
],
},
],
},
{
value: "3",
label: "Level one 3",
children: [
{
value: "3-1",
label: "Level two 3-1",
children: [
{
value: "3-1-1",
label: "Level three 3-1-1",
},
],
},
{
value: "3-2",
label: "Level two 3-2",
children: [
{
value: "3-2-1",
label: "Level three 3-2-1",
},
],
},
],
},
];
</script>
隐藏源码
使用 node-key 属性
默认情况下,modelValue 会查找 value 键。 对于其他数据结构,必须提供 node-key 才能正常工作。
vue
<template>
<el-tree-select-dispatcher
v-model="value"
style="width: 240px"
:data="data"
node-key="id"
show-checkbox
multiple
default-expand-all
/>
</template>
<script lang="ts" setup>
import { ref } from "vue";
const value = ref([2]);
const data = [
{
id: 1,
label: "Level one 1",
children: [
{
id: 2,
label: "Level two 1-1",
},
{
id: 3,
label: "Level two 1-2",
},
],
},
];
</script>
隐藏源码
Slots
使用 slots 中的 ${Config.namespace}Reader, ${Config.namespace}Writer 覆盖读写状态渲染函数。
writer:
vue
<template>
<el-tree-select-dispatcher
v-model="value"
:data="data"
:render-after-expand="false"
style="width: 240px"
>
<template #[`${Config.namespace}Reader`]>
<span style="color: green" key="reader">reader: {{ value }}</span>
</template>
<template #[`${Config.namespace}Writer`]>
<span style="color: red" key="writer">writer: {{ value }}</span>
</template>
</el-tree-select-dispatcher>
</template>
<script lang="ts" setup>
import { ref } from "vue";
import { Config } from "element-plus-form-dispatcher";
const value = ref();
const data = [
{
value: "1",
label: "Level one 1",
children: [
{
value: "1-1",
label: "Level two 1-1",
children: [
{
value: "1-1-1",
label: "Level three 1-1-1",
},
],
},
],
},
{
value: "2",
label: "Level one 2",
children: [
{
value: "2-1",
label: "Level two 2-1",
children: [
{
value: "2-1-1",
label: "Level three 2-1-1",
},
],
},
{
value: "2-2",
label: "Level two 2-2",
children: [
{
value: "2-2-1",
label: "Level three 2-2-1",
},
],
},
],
},
{
value: "3",
label: "Level one 3",
children: [
{
value: "3-1",
label: "Level two 3-1",
children: [
{
value: "3-1-1",
label: "Level three 3-1-1",
},
],
},
{
value: "3-2",
label: "Level two 3-2",
children: [
{
value: "3-2-1",
label: "Level three 3-2-1",
},
],
},
],
},
];
</script>
隐藏源码
API
与 el-tree-select 的 props attrs slots 完全一致