@a2simcode/ui 0.0.51 → 0.0.52

package/docs/components/meta/panel.ts

@@ -1,83 +1,83 @@
-export default {
-  "props": [
-    {
-      "name": "title",
-      "description": "标题",
-      "type": "string"
-    },
-    {
-      "name": "toolBtns",
-      "description": "操作按钮",
-      "type": "ButtonCompType[]",
-      "default": "() => []"
-    },
-    {
-      "name": "bootmBtns",
-      "description": "底部按钮",
-      "type": "ButtonCompType[]",
-      "default": "() => []"
-    },
-    {
-      "name": "bootmRightBtns",
-      "description": "底部右侧按钮",
-      "type": "ButtonCompType[]",
-      "default": "() => []"
-    },
-    {
-      "name": "bodyStyle",
-      "description": "样式",
-      "type": "CSSProperties",
-      "default": "() => ({ padding: '8px', })"
-    },
-    {
-      "name": "noPadding",
-      "description": "是否需要边距",
-      "type": "boolean"
-    },
-    {
-      "name": "notTitle",
-      "description": "是否不显示标题",
-      "type": "boolean"
-    },
-    {
-      "name": "flexWidth",
-      "description": "宽度",
-      "type": "number"
-    },
-    {
-      "name": "height",
-      "description": "高度",
-      "type": "number"
-    },
-    {
-      "name": "unit",
-      "description": "单位",
-      "type": "string",
-      "default": "'%'"
-    },
-    {
-      "name": "notSetWidth",
-      "description": "是否不设置宽度",
-      "type": "boolean"
-    }
-  ],
-  "events": [
-    {
-      "name": "click",
-      "description": "点击事件",
-      "type": "ButtonCompType"
-    }
-  ],
-  "slots": [
-    {
-      "name": "title",
-      "description": "标题插槽"
-    },
-    {
-      "name": "default",
-      "description": "内容插槽"
-    }
-  ],
-  "methods": [],
-  "types": []
-}
+export default {
+  "props": [
+    {
+      "name": "title",
+      "description": "标题",
+      "type": "string"
+    },
+    {
+      "name": "toolBtns",
+      "description": "操作按钮",
+      "type": "ButtonCompType[]",
+      "default": "() => []"
+    },
+    {
+      "name": "bootmBtns",
+      "description": "底部按钮",
+      "type": "ButtonCompType[]",
+      "default": "() => []"
+    },
+    {
+      "name": "bootmRightBtns",
+      "description": "底部右侧按钮",
+      "type": "ButtonCompType[]",
+      "default": "() => []"
+    },
+    {
+      "name": "bodyStyle",
+      "description": "样式",
+      "type": "CSSProperties",
+      "default": "() => ({ padding: '8px', })"
+    },
+    {
+      "name": "noPadding",
+      "description": "是否需要边距",
+      "type": "boolean"
+    },
+    {
+      "name": "notTitle",
+      "description": "是否不显示标题",
+      "type": "boolean"
+    },
+    {
+      "name": "flexWidth",
+      "description": "宽度",
+      "type": "number"
+    },
+    {
+      "name": "height",
+      "description": "高度",
+      "type": "number"
+    },
+    {
+      "name": "unit",
+      "description": "单位",
+      "type": "string",
+      "default": "'%'"
+    },
+    {
+      "name": "notSetWidth",
+      "description": "是否不设置宽度",
+      "type": "boolean"
+    }
+  ],
+  "events": [
+    {
+      "name": "click",
+      "description": "点击事件",
+      "type": "ButtonCompType"
+    }
+  ],
+  "slots": [
+    {
+      "name": "title",
+      "description": "标题插槽"
+    },
+    {
+      "name": "default",
+      "description": "内容插槽"
+    }
+  ],
+  "methods": [],
+  "types": []
+}

package/docs/components/meta/tree-select.ts

@@ -0,0 +1,112 @@
+export default {
+  "props": [
+    {
+      "name": "modelValue",
+      "description": "绑定值",
+      "type": "string | number | Array"
+    },
+    {
+      "name": "options",
+      "description": "树形数据选项列表",
+      "type": "Array"
+    },
+    {
+      "name": "checkStrictly",
+      "description": "在点击节点时，是否只关注本级节点而不关注父子节点的关系",
+      "type": "boolean",
+      "default": "true"
+    },
+    {
+      "name": "renderAfterExpand",
+      "description": "是否在第一次展开时才进行渲染",
+      "type": "boolean",
+      "default": "true"
+    },
+    {
+      "name": "props",
+      "description": "配置选项，定义树形节点的相关字段，如 children、label、value 等",
+      "type": "Record",
+      "default": "() => ({\r\n  children: 'children',\r\n  label: 'label',\r\n  value: 'value',\r\n})"
+    },
+    {
+      "name": "size",
+      "description": "尺寸",
+      "type": "\"large\" | \"default\" | \"small\"",
+      "default": "'default'"
+    },
+    {
+      "name": "disabled",
+      "description": "是否禁用",
+      "type": "boolean",
+      "default": "false"
+    },
+    {
+      "name": "readonly",
+      "description": "是否只读",
+      "type": "boolean",
+      "default": "false"
+    },
+    {
+      "name": "clearable",
+      "description": "是否显示清空按钮",
+      "type": "boolean",
+      "default": "true"
+    },
+    {
+      "name": "placeholder",
+      "description": "输入框占位文本",
+      "type": "string",
+      "default": "'请选择'"
+    },
+    {
+      "name": "dataType",
+      "description": "数据类型，用于从全局数据加载树形数据",
+      "type": "string",
+      "default": "''"
+    },
+    {
+      "name": "dataCode",
+      "description": "数据编码，用于从全局数据加载树形数据",
+      "type": "string",
+      "default": "''"
+    },
+    {
+      "name": "labelKey",
+      "description": "树形标签字段的键名",
+      "type": "string",
+      "default": "'label'"
+    },
+    {
+      "name": "valueKey",
+      "description": "树形值字段的键名",
+      "type": "string",
+      "default": "'value'"
+    },
+    {
+      "name": "pidKey",
+      "description": "树形父级ID字段的键名",
+      "type": "string",
+      "default": "'pid'"
+    },
+    {
+      "name": "idKey",
+      "description": "树形ID字段的键名",
+      "type": "string",
+      "default": "'id'"
+    },
+  ],
+  "events": [
+    {
+      "name": "update:modelValue",
+      "description": "v-model 双向绑定更新事件",
+      "type": "unknown"
+    },
+    {
+      "name": "change",
+      "description": "选择项变化事件，在用户改变选中值时触发",
+      "type": "unknown"
+    }
+  ],
+  "slots": [],
+  "methods": []
+}

package/docs/components/tree-select.md

@@ -0,0 +1,24 @@
+# TreeSelect 树形选择器
+
+基于 Element Plus 的 `el-tree-select` 组件封装。
+
+## 基础用法
+
+<Demo :source-code="treeSelectBasicCode">
+  <template #source>
+    <tree-select-basic />
+  </template>
+  <template #description>
+    最简单的 TreeSelect 用法。
+  </template>
+</Demo>
+
+## API
+
+<ApiTable :data="treeSelectApi" componentName="tree-select" />
+
+<script setup>
+import TreeSelectBasic from '../examples/tree-select/basic.vue'
+import treeSelectBasicCode from '../examples/tree-select/basic.vue?raw'
+import treeSelectApi from './meta/tree-select'
+</script>

package/docs/examples/tree-select/basic.vue

@@ -0,0 +1,47 @@
+<template>
+  <j-tree-select v-model="selectedValue" :options="treeData" placeholder="请选择" />
+</template>
+
+<script setup lang="ts">
+import { ref } from 'vue'
+import JTreeSelect from '../../../packages/components/tree-select'
+
+const selectedValue = ref<string>('1')
+
+const treeData = ref([
+  {
+    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',
+      },
+      {
+        value: '2-2',
+        label: 'Level two 2-2',
+      },
+    ],
+  },
+  {
+    value: '3',
+    label: 'Level one 3',
+  },
+])
+</script>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@a2simcode/ui",
-  "version": "0.0.51",
+  "version": "0.0.52",
   "description": "A Vue 3 UI Component Library",
   "type": "module",
   "main": "./dist/simcode-ui.umd.js",