@antsoo-lib/components 0.1.11 → 0.1.12

package/src/tree/Tree.tsx

@@ -1,277 +0,0 @@
-import type { ExtractPropTypes } from 'vue'
-import { computed, defineComponent, ref, watchEffect } from 'vue'
-
-import classNames from '../_util/classNames'
-import omit from '../_util/omit'
-import { filterEmpty } from '../_util/props-util'
-import initDefaultProps from '../_util/props-util/initDefaultProps'
-import { arrayType, booleanType, functionType, objectType, someType } from '../_util/type'
-import type { CustomSlotsType } from '../_util/type'
-import PropTypes from '../_util/vue-types'
-import useConfigInject from '../config-provider/hooks/useConfigInject'
-import VcTree from '../vc-tree'
-import type { DataNode, EventDataNode, FieldNames, Key, ScrollTo } from '../vc-tree/interface'
-import type { TreeNodeProps } from '../vc-tree/props'
-import { treeProps as vcTreeProps } from '../vc-tree/props'
-import devWarning from '../vc-util/devWarning'
-import { warning } from '../vc-util/warning'
-// CSSINJS
-import useStyle from './style'
-import dropIndicatorRender from './utils/dropIndicator'
-import type { SwitcherIconProps } from './utils/iconUtil'
-import renderSwitcherIcon from './utils/iconUtil'
-
-export interface AntdTreeNodeAttribute {
-  eventKey: string
-  prefixCls: string
-  class: string
-  expanded: boolean
-  selected: boolean
-  checked: boolean
-  halfChecked: boolean
-  children: any
-  title: any
-  pos: string
-  dragOver: boolean
-  dragOverGapTop: boolean
-  dragOverGapBottom: boolean
-  isLeaf: boolean
-  selectable: boolean
-  disabled: boolean
-  disableCheckbox: boolean
-}
-
-export type AntTreeNodeProps = TreeNodeProps
-
-// [Legacy] Compatible for v2
-export type TreeDataItem = DataNode
-
-export interface AntTreeNodeBaseEvent {
-  node: EventDataNode
-  nativeEvent: MouseEvent
-}
-
-export interface AntTreeNodeCheckedEvent extends AntTreeNodeBaseEvent {
-  event: 'check'
-  checked?: boolean
-  checkedNodes?: DataNode[]
-}
-
-export interface AntTreeNodeSelectedEvent extends AntTreeNodeBaseEvent {
-  event: 'select'
-  selected?: boolean
-  selectedNodes?: DataNode[]
-}
-
-export interface AntTreeNodeExpandedEvent extends AntTreeNodeBaseEvent {
-  expanded?: boolean
-}
-
-export interface AntTreeNodeMouseEvent {
-  node: EventDataNode
-  event: DragEvent
-}
-
-export interface AntTreeNodeDragEnterEvent extends AntTreeNodeMouseEvent {
-  expandedKeys: Key[]
-}
-
-export interface AntTreeNodeDropEvent {
-  node: EventDataNode
-  dragNode: EventDataNode
-  dragNodesKeys: Key[]
-  dropPosition: number
-  dropToGap?: boolean
-  event: MouseEvent
-}
-
-export const treeProps = () => {
-  const baseTreeProps = vcTreeProps()
-  return {
-    ...baseTreeProps,
-    showLine: someType<boolean | { showLeafIcon: boolean }>([Boolean, Object]),
-    /** 是否支持多选 */
-    multiple: booleanType(),
-    /** 是否自动展开父节点 */
-    autoExpandParent: booleanType(),
-    /** checkable状态下节点选择完全受控（父子节点选中状态不再关联）*/
-    checkStrictly: booleanType(),
-    /** 是否支持选中 */
-    checkable: booleanType(),
-    /** 是否禁用树 */
-    disabled: booleanType(),
-    /** 默认展开所有树节点 */
-    defaultExpandAll: booleanType(),
-    /** 默认展开对应树节点 */
-    defaultExpandParent: booleanType(),
-    /** 默认展开指定的树节点 */
-    defaultExpandedKeys: arrayType<Key[]>(),
-    /** （受控）展开指定的树节点 */
-    expandedKeys: arrayType<Key[]>(),
-    /** （受控）选中复选框的树节点 */
-    checkedKeys: someType<Key[] | { checked: Key[]; halfChecked: Key[] }>([Array, Object]),
-    /** 默认选中复选框的树节点 */
-    defaultCheckedKeys: arrayType<Key[]>(),
-    /** （受控）设置选中的树节点 */
-    selectedKeys: arrayType<Key[]>(),
-    /** 默认选中的树节点 */
-    defaultSelectedKeys: arrayType<Key[]>(),
-    selectable: booleanType(),
-
-    loadedKeys: arrayType<Key[]>(),
-    draggable: booleanType(),
-    showIcon: booleanType(),
-    icon: functionType<(nodeProps: AntdTreeNodeAttribute) => any>(),
-    switcherIcon: PropTypes.any,
-    prefixCls: String,
-    /**
-     * @default{title,key,children}
-     * deprecated, please use `fieldNames` instead
-     * 替换treeNode中 title,key,children字段为treeData中对应的字段
-     */
-    replaceFields: objectType<FieldNames>(),
-    blockNode: booleanType(),
-    openAnimation: PropTypes.any,
-    onDoubleclick: baseTreeProps.onDblclick,
-    'onUpdate:selectedKeys': functionType<(keys: Key[]) => void>(),
-    'onUpdate:checkedKeys': functionType<(keys: Key[]) => void>(),
-    'onUpdate:expandedKeys': functionType<(keys: Key[]) => void>(),
-  }
-}
-
-export type TreeProps = Partial<ExtractPropTypes<ReturnType<typeof treeProps>>>
-
-export default defineComponent({
-  compatConfig: { MODE: 3 },
-  name: 'ATree',
-  inheritAttrs: false,
-  props: initDefaultProps(treeProps(), {
-    checkable: false,
-    selectable: true,
-    showIcon: false,
-    blockNode: false,
-  }),
-
-  slots: Object as CustomSlotsType<{
-    icon?: any
-    title?: any
-    switcherIcon?: any
-    titleRender?: any
-    default?: any
-    leafIcon?: any
-  }>,
-  setup(props, { attrs, expose, emit, slots }) {
-    warning(
-      !(props.treeData === undefined && slots.default),
-      '`children` of Tree is deprecated. Please use `treeData` instead.',
-    )
-    const { prefixCls, direction, virtual } = useConfigInject('tree', props)
-
-    // style
-    const [wrapSSR, hashId] = useStyle(prefixCls)
-
-    const treeRef = ref()
-    const scrollTo: ScrollTo = (scroll) => {
-      treeRef.value?.scrollTo(scroll)
-    }
-    expose({
-      treeRef,
-      onNodeExpand: (...args) => {
-        treeRef.value?.onNodeExpand(...args)
-      },
-      scrollTo,
-      selectedKeys: computed(() => treeRef.value?.selectedKeys),
-      checkedKeys: computed(() => treeRef.value?.checkedKeys),
-      halfCheckedKeys: computed(() => treeRef.value?.halfCheckedKeys),
-      loadedKeys: computed(() => treeRef.value?.loadedKeys),
-      loadingKeys: computed(() => treeRef.value?.loadingKeys),
-      expandedKeys: computed(() => treeRef.value?.expandedKeys),
-    })
-
-    watchEffect(() => {
-      devWarning(
-        props.replaceFields === undefined,
-        'Tree',
-        '`replaceFields` is deprecated, please use fieldNames instead',
-      )
-    })
-
-    const handleCheck: TreeProps['onCheck'] = (checkedObjOrKeys, eventObj) => {
-      emit('update:checkedKeys', checkedObjOrKeys)
-      emit('check', checkedObjOrKeys, eventObj)
-    }
-    const handleExpand: TreeProps['onExpand'] = (expandedKeys, eventObj) => {
-      emit('update:expandedKeys', expandedKeys)
-      emit('expand', expandedKeys, eventObj)
-    }
-    const handleSelect: TreeProps['onSelect'] = (selectedKeys, eventObj) => {
-      emit('update:selectedKeys', selectedKeys)
-      emit('select', selectedKeys, eventObj)
-    }
-    return () => {
-      const {
-        showIcon,
-        showLine,
-        switcherIcon = slots.switcherIcon,
-        icon = slots.icon,
-        blockNode,
-        checkable,
-        selectable,
-        fieldNames = props.replaceFields,
-        motion = props.openAnimation,
-        itemHeight = 28,
-        onDoubleclick,
-        onDblclick,
-      } = props as TreeProps
-      const newProps = {
-        ...attrs,
-        ...omit(props, [
-          'onUpdate:checkedKeys',
-          'onUpdate:expandedKeys',
-          'onUpdate:selectedKeys',
-          'onDoubleclick',
-        ]),
-        showLine: Boolean(showLine),
-        dropIndicatorRender,
-        fieldNames,
-        icon,
-        itemHeight,
-      }
-      const children = slots.default ? filterEmpty(slots.default()) : undefined
-      return wrapSSR(
-        <VcTree
-          {...newProps}
-          virtual={virtual.value}
-          motion={motion}
-          ref={treeRef}
-          prefixCls={prefixCls.value}
-          class={classNames(
-            {
-              [`${prefixCls.value}-icon-hide`]: !showIcon,
-              [`${prefixCls.value}-block-node`]: blockNode,
-              [`${prefixCls.value}-unselectable`]: !selectable,
-              [`${prefixCls.value}-rtl`]: direction.value === 'rtl',
-            },
-            attrs.class,
-            hashId.value,
-          )}
-          direction={direction.value}
-          checkable={checkable}
-          selectable={selectable}
-          switcherIcon={(nodeProps: SwitcherIconProps) =>
-            renderSwitcherIcon(prefixCls.value, switcherIcon, nodeProps, slots.leafIcon, showLine)
-          }
-          onCheck={handleCheck}
-          onExpand={handleExpand}
-          onSelect={handleSelect}
-          onDblclick={onDblclick || onDoubleclick}
-          v-slots={{
-            ...slots,
-            checkable: () => <span class={`${prefixCls.value}-checkbox-inner`} />,
-          }}
-          children={children}
-        ></VcTree>,
-      )
-    }
-  },
-})

package/src/tree/breakchange.md

@@ -1 +0,0 @@
-title 的渲染逻辑

package/src/tree/index.en-US.md

@@ -1,93 +0,0 @@
----
-category: Components
-type: Data Display
-title: Tree
-cover: https://mdn.alipayobjects.com/huamei_7uahnr/afts/img/A*Ag9_Q6ArswEAAAAAAAAAAAAADrJ8AQ/original
-coverDark: https://mdn.alipayobjects.com/huamei_7uahnr/afts/img/A*1GeUQJPTGUYAAAAAAAAAAAAADrJ8AQ/original
----
-
-A hierarchical list structure component.
-
-## When To Use
-
-Almost anything can be represented in a tree structure. Examples include directories, organization hierarchies, biological classifications, countries, etc. The `Tree` component is a way of representing the hierarchical relationship between these things. You can also expand, collapse, and select a treeNode within a `Tree`.
-
-## API
-
-### Tree props
-
-| Property              | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | Type                                                                                                                                             | Default                                           | Version |
-| --------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------- | ------- |
-| allowDrop             | Whether to allow dropping on the node                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | ({ dropNode, dropPosition }) => boolean                                                                                                          | -                                                 |         |
-| autoExpandParent      | Whether to automatically expand a parent treeNode                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | boolean                                                                                                                                          | false                                             |         |
-| blockNode             | Whether treeNode fill remaining horizontal space                                                                                                                                                                                                                                                                                                                                                                                                                                                                     | boolean                                                                                                                                          | false                                             |         |
-| checkable             | Adds a `Checkbox` before the treeNodes                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | boolean                                                                                                                                          | false                                             |         |
-| checkedKeys(v-model)  | (Controlled) Specifies the keys of the checked treeNodes (PS: When this specifies the key of a treeNode which is also a parent treeNode, all the children treeNodes of will be checked; and vice versa, when it specifies the key of a treeNode which is a child treeNode, its parent treeNode will also be checked. When `checkable` and `checkStrictly` is true, its object has `checked` and `halfChecked` property. Regardless of whether the child or parent treeNode is checked, they won't impact each other. | string\[] \| number\[] \| {checked: string\[] \| number\[], halfChecked: string\[] \| number\[]}                                                 | \[]                                               |         |
-| checkStrictly         | Check treeNode precisely; parent treeNode and children treeNodes are not associated                                                                                                                                                                                                                                                                                                                                                                                                                                  | boolean                                                                                                                                          | false                                             |         |
-| defaultExpandAll      | Whether to expand all treeNodes by default                                                                                                                                                                                                                                                                                                                                                                                                                                                                           | boolean                                                                                                                                          | false                                             |         |
-| disabled              | whether disabled the tree                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            | bool                                                                                                                                             | false                                             |         |
-| draggable             | Specifies whether this Tree is draggable (IE > 8)                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | boolean                                                                                                                                          | false                                             |         |
-| expandedKeys(v-model) | (Controlled) Specifies the keys of the expanded treeNodes                                                                                                                                                                                                                                                                                                                                                                                                                                                            | string\[] \| number\[]                                                                                                                           | \[]                                               |         |
-| fieldNames            | Replace the title,key and children fields in treeNode with the corresponding fields in treeData                                                                                                                                                                                                                                                                                                                                                                                                                      | object                                                                                                                                           | { children:'children', title:'title', key:'key' } | 3.0.0   |
-| filterTreeNode        | Defines a function to filter (highlight) treeNodes. When the function returns `true`, the corresponding treeNode will be highlighted                                                                                                                                                                                                                                                                                                                                                                                 | function(node)                                                                                                                                   | -                                                 |         |
-| height                | Config virtual scroll height. Will not support horizontal scroll when enable this                                                                                                                                                                                                                                                                                                                                                                                                                                    | number                                                                                                                                           | -                                                 |         |
-| loadData              | Load data asynchronously                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | function(node)                                                                                                                                   | -                                                 |         |
-| loadedKeys            | (Controlled) Set loaded tree nodes. Need work with `loadData`                                                                                                                                                                                                                                                                                                                                                                                                                                                        | string\[] \| number\[]                                                                                                                           | \[]                                               |         |
-| multiple              | Allows selecting multiple treeNodes                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | boolean                                                                                                                                          | false                                             |         |
-| selectable            | whether can be selected                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              | boolean                                                                                                                                          | true                                              |         |
-| selectedKeys(v-model) | (Controlled) Specifies the keys of the selected treeNodes                                                                                                                                                                                                                                                                                                                                                                                                                                                            | string\[] \| number\[]                                                                                                                           | -                                                 |         |
-| showIcon              | Shows the icon before a TreeNode's title. There is no default style; you must set a custom style for it if set to `true`                                                                                                                                                                                                                                                                                                                                                                                             | boolean                                                                                                                                          | false                                             |         |
-| showLine              | Shows a connecting line                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              | boolean \| {showLeafIcon: boolean}(3.0+)                                                                                                         | false                                             |         |
-| switcherIcon          | customize collapse/expand icon of tree node                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | v-slot:switcherIcon="{active, checked, expanded, loading, selected, halfChecked, title, key, children, dataRef, data, defaultIcon, switcherCls}" | -                                                 |         |
-| title                 | custom title                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | slot                                                                                                                                             |                                                   | 2.0.0   |
-| treeData              | treeNode of tree, please use `treeNodes` before v1.1.4                                                                                                                                                                                                                                                                                                                                                                                                                                                               | [TreeNode\[\]](#treenode)                                                                                                                        | -                                                 |         |
-| virtual               | Disable virtual scroll when set to false                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | boolean                                                                                                                                          | true                                              | 3.0     |
-
-### Events
-
-| Events Name | Description                                                    | Arguments                                                              |
-| ----------- | -------------------------------------------------------------- | ---------------------------------------------------------------------- |
-| check       | Callback function for when the onCheck event occurs            | function(checkedKeys, e:{checked: bool, checkedNodes, node, event})    |
-| dragend     | Callback function for when the onDragEnd event occurs          | function({event, node})                                                |
-| dragenter   | Callback function for when the onDragEnter event occurs        | function({event, node, expandedKeys})                                  |
-| dragleave   | Callback function for when the onDragLeave event occurs        | function({event, node})                                                |
-| dragover    | Callback function for when the onDragOver event occurs         | function({event, node})                                                |
-| dragstart   | Callback function for when the onDragStart event occurs        | function({event, node})                                                |
-| drop        | Callback function for when the onDrop event occurs             | function({event, node, dragNode, dragNodesKeys})                       |
-| expand      | Callback function for when a treeNode is expanded or collapsed | function(expandedKeys, {expanded: bool, node})                         |
-| load        | Callback function for when a treeNode is loaded                | function(loadedKeys, {event, node})                                    |
-| rightClick  | Callback function for when the user right clicks a treeNode    | function({event, node})                                                |
-| select      | Callback function for when the user clicks a treeNode          | function(selectedKeys, e:{selected: bool, selectedNodes, node, event}) |
-
-### Tree Methods
-
-| Name                                                                                      | Description                          |
-| ----------------------------------------------------------------------------------------- | ------------------------------------ |
-| scrollTo({ key: string \| number; align?: 'top' \| 'bottom' \| 'auto'; offset?: number }) | Scroll to key item in virtual scroll |
-
-### TreeNode
-
-| Property        | Description                                                                                                                              | Type             | Default                                  | Version |
-| --------------- | ---------------------------------------------------------------------------------------------------------------------------------------- | ---------------- | ---------------------------------------- | ------- |
-| checkable       | When Tree is checkable, set TreeNode display Checkbox or not                                                                             | boolean          | -                                        |         |
-| class           | className                                                                                                                                | string           | -                                        |         |
-| disableCheckbox | Disables the checkbox of the treeNode                                                                                                    | boolean          | false                                    |         |
-| disabled        | Disables the treeNode                                                                                                                    | boolean          | false                                    |         |
-| icon            | customize icon. When you pass component, whose render will receive full TreeNode props as component props                                | slot\|slot-scope | -                                        |         |
-| isLeaf          | Determines if this is a leaf node(effective when `loadData` is specified)                                                                | boolean          | -                                        |         |
-| key             | Used with (default)ExpandedKeys / (default)CheckedKeys / (default)SelectedKeys. P.S.: It must be unique in all of treeNodes of the tree! | string \| number | internal calculated position of treeNode |         |
-| selectable      | Set whether the treeNode can be selected                                                                                                 | boolean          | true                                     |         |
-| style           | style                                                                                                                                    | string\|object   | -                                        |         |
-| title           | Title                                                                                                                                    | string           | '---'                                    |         |
-
-### DirectoryTree props
-
-| Property     | Description                                                   | Type   | Default |
-| ------------ | ------------------------------------------------------------- | ------ | ------- |
-| expandAction | Directory open logic, optional `false` `'click'` `'dblclick'` | string | click   |
-
-## FAQ
-
-### How to hide file icon when use showLine?
-
-File icon realize by using switcherIcon. You can overwrite the style to hide it

package/src/tree/index.tsx

@@ -1,38 +0,0 @@
-import type { App } from 'vue'
-
-import { TreeNode as VcTreeNode } from '../vc-tree'
-import DirectoryTree from './DirectoryTree'
-import Tree from './Tree'
-
-export type { DataNode, EventDataNode } from '../vc-tree/interface'
-
-export type {
-  AntdTreeNodeAttribute,
-  AntTreeNodeCheckedEvent,
-  AntTreeNodeDragEnterEvent,
-  AntTreeNodeDropEvent,
-  AntTreeNodeExpandedEvent,
-  AntTreeNodeMouseEvent,
-  AntTreeNodeSelectedEvent,
-  TreeDataItem,
-  TreeProps,
-} from './Tree'
-
-export type { ExpandAction as DirectoryTreeExpandAction, DirectoryTreeProps } from './DirectoryTree'
-
-/* istanbul ignore next */
-
-const TreeNode = VcTreeNode
-
-export { DirectoryTree, TreeNode }
-
-export default Object.assign(Tree, {
-  DirectoryTree,
-  TreeNode,
-  install: (app: App) => {
-    app.component(Tree.name, Tree)
-    app.component(TreeNode.name, TreeNode)
-    app.component(DirectoryTree.name, DirectoryTree)
-    return app
-  },
-})

package/src/tree/index.zh-CN.md

@@ -1,94 +0,0 @@
----
-category: Components
-type: 数据展示
-title: Tree
-subtitle: 树形控件
-cover: https://mdn.alipayobjects.com/huamei_7uahnr/afts/img/A*Ag9_Q6ArswEAAAAAAAAAAAAADrJ8AQ/original
-coverDark: https://mdn.alipayobjects.com/huamei_7uahnr/afts/img/A*1GeUQJPTGUYAAAAAAAAAAAAADrJ8AQ/original
----
-
-多层次的结构列表。
-
-## 何时使用
-
-文件夹、组织架构、生物分类、国家地区等等，世间万物的大多数结构都是树形结构。使用`树控件`可以完整展现其中的层级关系，并具有展开收起选择等交互功能。
-
-## API
-
-### Tree props
-
-| 参数                  | 说明                                                                                                                                                                                                                                                | 类型                                                                                                                                             | 默认值                                           | 版本  |     |
-| --------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------ | ----- | --- |
-| allowDrop             | 是否允许拖拽时放置在该节点                                                                                                                                                                                                                          | ({ dropNode, dropPosition }) => boolean                                                                                                          | -                                                |       |
-| autoExpandParent      | 是否自动展开父节点                                                                                                                                                                                                                                  | boolean                                                                                                                                          | false                                            |       |     |
-| blockNode             | 是否节点占据一行                                                                                                                                                                                                                                    | boolean                                                                                                                                          | false                                            |       |     |
-| checkable             | 节点前添加 Checkbox 复选框                                                                                                                                                                                                                          | boolean                                                                                                                                          | false                                            |       |     |
-| checkedKeys(v-model)  | （受控）选中复选框的树节点（注意：父子节点有关联，如果传入父节点 key，则子节点自动选中；相应当子节点 key 都传入，父节点也自动选中。当设置`checkable`和`checkStrictly`，它是一个有`checked`和`halfChecked`属性的对象，并且父子节点的选中与否不再关联 | string\[] \| number\[] \| {checked: string\[] \| number\[], halfChecked: string\[] \| number\[]}                                                 | \[]                                              |       |     |
-| checkStrictly         | checkable 状态下节点选择完全受控（父子节点选中状态不再关联）                                                                                                                                                                                        | boolean                                                                                                                                          | false                                            |       |     |
-| defaultExpandAll      | 默认展开所有树节点, 如果是异步数据，需要在数据返回后再实例化，建议用 v-if="data.length"；当有 expandedKeys 时，defaultExpandAll 将失效                                                                                                              | boolean                                                                                                                                          | false                                            |       |     |
-| disabled              | 将树禁用                                                                                                                                                                                                                                            | bool                                                                                                                                             | false                                            |       |     |
-| draggable             | 设置节点可拖拽                                                                                                                                                                                                                                      | boolean                                                                                                                                          | false                                            |       |     |
-| expandedKeys(v-model) | （受控）展开指定的树节点                                                                                                                                                                                                                            | string\[] \| number\[]                                                                                                                           | \[]                                              |       |     |
-| fieldNames            | 替换 treeNode 中 title,key,children 字段为 treeData 中对应的字段                                                                                                                                                                                    | object                                                                                                                                           | {children:'children', title:'title', key:'key' } | 3.0.0 |     |
-| filterTreeNode        | 按需筛选树节点（高亮），返回 true                                                                                                                                                                                                                   | function(node)                                                                                                                                   | -                                                |       |     |
-| height                | 设置虚拟滚动容器高度，设置后内部节点不再支持横向滚动                                                                                                                                                                                                | number                                                                                                                                           | -                                                |       |
-| loadData              | 异步加载数据                                                                                                                                                                                                                                        | function(node)                                                                                                                                   | -                                                |       |     |
-| loadedKeys            | （受控）已经加载的节点，需要配合 `loadData` 使用                                                                                                                                                                                                    | string\[] \| number\[]                                                                                                                           | \[]                                              |       |     |
-| multiple              | 支持点选多个节点（节点本身）                                                                                                                                                                                                                        | boolean                                                                                                                                          | false                                            |       |     |
-| selectable            | 是否可选中                                                                                                                                                                                                                                          | boolean                                                                                                                                          | true                                             |       |     |
-| selectedKeys(v-model) | （受控）设置选中的树节点                                                                                                                                                                                                                            | string\[] \| number\[]                                                                                                                           | -                                                |       |     |
-| showIcon              | 是否展示 TreeNode title 前的图标，没有默认样式，如设置为 true，需要自行定义图标相关样式                                                                                                                                                             | boolean                                                                                                                                          | false                                            |       |     |
-| showLine              | 是否展示连接线                                                                                                                                                                                                                                      | boolean \| {showLeafIcon: boolean}(3.0+)                                                                                                         | false                                            |       |     |
-| switcherIcon          | 自定义树节点的展开/折叠图标                                                                                                                                                                                                                         | v-slot:switcherIcon="{active, checked, expanded, loading, selected, halfChecked, title, key, children, dataRef, data, defaultIcon, switcherCls}" | -                                                |       |     |
-| title                 | 自定义标题                                                                                                                                                                                                                                          | slot                                                                                                                                             |                                                  | 2.0.0 |     |
-| treeData              | treeNodes 数据，如果设置则不需要手动构造 TreeNode 节点（key 在整个树范围内唯一）                                                                                                                                                                    | [TreeNode\[\]](#treenode)                                                                                                                        | --                                               |       |     |
-| virtual               | 设置 false 时关闭虚拟滚动                                                                                                                                                                                                                           | boolean                                                                                                                                          | true                                             | 3.0   |     |
-
-### 事件
-
-| 事件名称   | 说明                 | 回调参数                                                               |
-| ---------- | -------------------- | ---------------------------------------------------------------------- |
-| check      | 点击复选框触发       | function(checkedKeys, e:{checked: bool, checkedNodes, node, event})    |
-| dragend    | dragend 触发时调用   | function({event, node})                                                |
-| dragenter  | dragenter 触发时调用 | function({event, node, expandedKeys})                                  |
-| dragleave  | dragleave 触发时调用 | function({event, node})                                                |
-| dragover   | dragover 触发时调用  | function({event, node})                                                |
-| dragstart  | 开始拖拽时调用       | function({event, node})                                                |
-| drop       | drop 触发时调用      | function({event, node, dragNode, dragNodesKeys})                       |
-| expand     | 展开/收起节点时触发  | function(expandedKeys, {expanded: bool, node})                         |
-| load       | 节点加载完毕时触发   | function(loadedKeys, {event, node})                                    |
-| rightClick | 响应右键点击         | function({event, node})                                                |
-| select     | 点击树节点触发       | function(selectedKeys, e:{selected: bool, selectedNodes, node, event}) |
-
-### Tree 方法
-
-| 名称                                                                                      | 说明                            |
-| ----------------------------------------------------------------------------------------- | ------------------------------- |
-| scrollTo({ key: string \| number; align?: 'top' \| 'bottom' \| 'auto'; offset?: number }) | 虚拟滚动下，滚动到指定 key 条目 |
-
-### TreeNode
-
-| 参数            | 说明                                                                                                                                  | 类型             | 默认值               | 版本 |
-| --------------- | ------------------------------------------------------------------------------------------------------------------------------------- | ---------------- | -------------------- | ---- |
-| checkable       | 当树为 checkable 时，设置独立节点是否展示 Checkbox                                                                                    | boolean          | -                    |      |
-| class           | 节点的 class                                                                                                                          | string           | -                    |      |
-| disableCheckbox | 禁掉 checkbox                                                                                                                         | boolean          | false                |      |
-| disabled        | 禁掉响应                                                                                                                              | boolean          | false                |      |
-| icon            | 自定义图标。可接收组件，props 为当前节点 props                                                                                        | slot\|slot-scope | -                    |      |
-| isLeaf          | 设置为叶子节点(设置了`loadData`时有效)                                                                                                | boolean          | -                    |      |
-| key             | 被树的 (default)ExpandedKeys / (default)CheckedKeys / (default)SelectedKeys 属性所用。注意：整个树范围内的所有节点的 key 值不能重复！ | string \| number | 内部计算出的节点位置 |      |
-| selectable      | 设置节点是否可被选中                                                                                                                  | boolean          | true                 |      |
-| style           | 节点的 style                                                                                                                          | string\|object   | -                    |      |
-| title           | 标题                                                                                                                                  | string           | '---'                |      |
-
-### DirectoryTree props
-
-| 参数         | 说明                                              | 类型   | 默认值 |
-| ------------ | ------------------------------------------------- | ------ | ------ |
-| expandAction | 目录展开逻辑，可选 `false` `'click'` `'dblclick'` | string | click  |
-
-## FAQ
-
-### 在 showLine 时，如何隐藏子节点图标？
-
-文件图标通过 switcherIcon 来实现，如果不需要你可以覆盖对应的样式