# UTreeSelectNew 树选择
- [示例](#示例)
- [基本用法](#基本用法)
- [禁用状态](#禁用状态)
- [API]()
- [Props/Attrs](#propsattrs)
- [Slots](#slots)
- [Events](#events)
- [Methods](#methods)
**Selector**
树选择
## 示例
### 基本用法
#### Tag 方式
```vue
```
#### Tag 方式
``` html
```
#### Data 方式
``` html { width: 30% }
```
#### 支持清除
多选：
```vue { width: 30% }
```
单选：
```vue { width: 30% }
```
#### 支持多选
```vue { width: 30% }
```
### 禁用状态
```vue
```
#### 一维Data
``` html { width: 30% }
```
#### 动态插槽数据
``` html { width: 70% }
{{ scope.item.text }} - {{ scope.item.value}}
```
#### 动静结合选项回填
``` html { width: 70% }
{{ scope.item.data.deptname }}
```
```html
```
## API
### Props/Attrs
| Prop/Attr | Type | Options | Default | Description |
| --------- | ---- | ------- | ------- | ----------- |
| data-source | Array\ \| Function \| object \| DataSource | | | 展示数据的输入源，可设置为集合类型变量（List）或输出参数为集合类型的逻辑。 |
| data-schema | schema | | | 数据源返回的数据结构的类型，自动识别类型进行展示说明 |
| text-field | string | | `'text'` | 集合的元素类型中，用于显示文本的属性名称 |
| value-field | string | | `'value'` | 集合的元素类型中，用于标识选中值的属性 |
| parent-field | string | | `''` | 集合的元素类型中，用于标识父节点的属性 |
| children-field | string | | `'children'` | 集合的元素类型中，用于标识子节点的属性，默认为children |
| expanded-field | string | | `'expanded'` | 集合的元素类型中，用于标识节点是否展开的属性，默认为expanded |
| value.sync, v-model | any | | | 选择后，所选中的值 |
| checkable | boolean | | `false` | 设置是否开启多选模式，显示多选框 |
| placeholder | string | | `'请选择'` | 为空时显示的占位符文本 |
| check-controlled | boolean | | `false` | 开启后父节点选择不会全选子节点，子节点选择不会联动父节点 |
| disabled-field | string | | `'disabled'` | 集合的元素类型中，用于标识节点的disabled属性 |
| clearable | boolean | | `false` | 设置是否开启可清除模式 |
| render-optimize | boolean | | `false` | 设置只渲染tree激活子节点，用于渲染性能提升。 |
| append-to | string | `[object Object]`
`[object Object]` | `'reference'` | 设置弹出层依据哪个元素定位位置，可选值：`'body'`表示添加到 document.body，`'reference'`表示添加到参考元素中。 |
| disabled | boolean | | `false` | 置灰显示，且禁止任何交互（焦点、点击、选择、输入等） |
| width | string | `[object Object]`
`[object Object]`
`[object Object]`
`[object Object]`
`[object Object]`
`[object Object]`
`[object Object]` | `'normal'` | 设置选择框宽度大小 |
| height | string | `[object Object]`
`[object Object]`
`[object Object]`
`[object Object]`
`[object Object]`
`[object Object]`
`[object Object]` | `'normal'` | 设置选择框高度大小 |
### Slots
#### (default)
插入``子组件
#### item
自定义选项的结构和样式
### Events
#### @change
修改时触发
| Param | Type | Description |
| ----- | ---- | ----------- |
| $event | object | 自定义事件对象 |
| $event.param1 | string | 参数1 |
| $event.param2 | number | 参数2 |
#### @select
选择某一项时触发
| Param | Type | Description |
| ----- | ---- | ----------- |
| $event | object | 自定义事件对象 |
| $event.value | any | 改变后的值 |
| $event.oldValue | any | 旧的值 |
| $event.node | object | 选择项相关对象 |
| $event.oldNode | object | 旧的选择项相关对象 |
| $event.nodeVM | UTreeViewNode | 选择项子组件 |
| $event.oldVM | UTreeViewNode | 旧的选择项子组件 |
| senderVM | UTreeView | 发送事件实例 |
#### @check
选中/取消节点时触发
| Param | Type | Description |
| ----- | ---- | ----------- |
| $event | object | 自定义事件对象 |
| $event.checked | boolean | 选中/取消状态 |
| $event.oldChecked | boolean | 旧的选中/取消状态 |
| $event.values | Array | 所有选中节点的值 |
| $event.node | object | 节点相关对象 |
| $event.nodeVM | UTreeViewNode | 节点组件 |
| senderVM | UTreeView | 发送事件实例 |
#### @before-load
加载前触发
| Param | Type | Description |
| ----- | ---- | ----------- |
| $event | object | 自定义事件对象 |
| $event.preventDefault | Function | 阻止加载流程 |
| senderVM | UTableView | 发送事件实例 |
#### @load
加载后触发
| Param | Type | Description |
| ----- | ---- | ----------- |
| $event | null | 无 |
| senderVM | UTableView | 发送事件实例 |
#### @before-clear
清空前触发
| Param | Type | Description |
| ----- | ---- | ----------- |
| $event | object | 自定义事件对象 |
| $event.value | any | 改变后的值 |
| $event.oldValue | any | 旧的值 |
| $event.preventDefault | Function | 阻止清空流程 |
| senderVM | UTreeView | 发送事件实例 |
#### @clear
清空时触发
| Param | Type | Description |
| ----- | ---- | ----------- |
| $event | object | 自定义事件对象 |
| $event.value | any | 改变后的值 |
| $event.oldValue | any | 旧的值 |
| senderVM | UTreeView | 发送事件实例 |
Methods
#### reload()
重新加载
| Param | Type | Default | Description |
| ----- | ---- | ------- | ----------- |