ep-craft 0.1.41 → 0.2.0

package/dist-ai/components/select.json

@@ -0,0 +1,697 @@
+{
+  "entry": {
+    "category": "form",
+    "events": [
+      {
+        "description": "绑定值变化时触发",
+        "name": "update:modelValue",
+        "params": "(value: any)"
+      },
+      {
+        "description": "选中值发生变化时触发",
+        "name": "change",
+        "params": "(value: any)"
+      },
+      {
+        "description": "下拉列表滚动时触发",
+        "name": "popupScroll",
+        "params": "({ scrollTop, scrollLeft }: { scrollTop: number; scrollLeft: number })"
+      },
+      {
+        "description": "下拉列表滚动到边界时触发（用于远程加载更多）",
+        "name": "endReached",
+        "params": "(direction: 'top' | 'bottom' | 'left' | 'right')"
+      },
+      {
+        "description": "多选模式下移除 tag 时触发",
+        "name": "removeTag",
+        "params": "(tagValue: any)"
+      },
+      {
+        "description": "下拉框出现/隐藏时触发",
+        "name": "visibleChange",
+        "params": "(visible: boolean)"
+      },
+      {
+        "description": "当 input 获得焦点时触发",
+        "name": "focus",
+        "params": "(event: FocusEvent)"
+      },
+      {
+        "description": "当 input 失去焦点时触发",
+        "name": "blur",
+        "params": "(event: FocusEvent)"
+      },
+      {
+        "description": "可清空的单选模式下用户点击清空按钮时触发",
+        "name": "clear",
+        "params": "()"
+      }
+    ],
+    "exampleOmittedReason": null,
+    "examples": [
+      {
+        "code": "<script setup lang=\"ts\">\nimport { ref } from 'vue'\nimport { EpOption, EpSelect } from 'ep-craft'\n\nconst value = ref('')\n</script>\n\n<template>\n  <ep-select v-model=\"value\" placeholder=\"请选择\">\n    <ep-option label=\"选项一\" value=\"one\" />\n    <ep-option label=\"选项二\" value=\"two\" />\n    <ep-option label=\"选项三\" value=\"three\" disabled />\n  </ep-select>\n</template>",
+        "id": "select-1",
+        "language": "vue",
+        "title": "基础选择"
+      },
+      {
+        "code": "<script setup lang=\"ts\">\nimport { ref } from 'vue'\nimport { EpOption, EpSelect } from 'ep-craft'\n\nconst value = ref(['one'])\n</script>\n\n<template>\n  <ep-select v-model=\"value\" multiple collapse-tags placeholder=\"请选择\">\n    <ep-option label=\"选项一\" value=\"one\" />\n    <ep-option label=\"选项二\" value=\"two\" />\n  </ep-select>\n</template>",
+        "id": "select-2",
+        "language": "vue",
+        "title": "多选"
+      },
+      {
+        "code": "<script setup lang=\"ts\">\nimport { ref } from 'vue'\nimport { EpOption, EpSelect } from 'ep-craft'\n\nconst value = ref('')\n</script>\n\n<template>\n  <ep-select v-model=\"value\" filterable clearable placeholder=\"输入关键字\">\n    <ep-option label=\"Vue\" value=\"vue\" />\n    <ep-option label=\"React\" value=\"react\" />\n    <ep-option label=\"Svelte\" value=\"svelte\" />\n  </ep-select>\n</template>",
+        "id": "select-3",
+        "language": "vue",
+        "title": "可搜索"
+      }
+    ],
+    "exposes": [
+      {
+        "description": "使选择器的输入框获取焦点",
+        "name": "focus",
+        "type": "() => void"
+      },
+      {
+        "description": "使选择器的输入框失去焦点，并隐藏下拉框",
+        "name": "blur",
+        "type": "() => void"
+      }
+    ],
+    "hot": true,
+    "id": "component:select",
+    "keywords": {
+      "en": [
+        "select",
+        "dropdown",
+        "picker",
+        "form"
+      ],
+      "zh": [
+        "选择器",
+        "下拉",
+        "单选",
+        "多选",
+        "表单"
+      ]
+    },
+    "kind": "component",
+    "name": "EpSelect",
+    "nonUseCases": [
+      "选项极多且需层级选择时使用 Cascader 或 TreeSelect"
+    ],
+    "props": [
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "原生 name 属性",
+        "hasDefault": false,
+        "name": "name",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": false,
+        "name": "id",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": "v-model",
+        "defaultText": null,
+        "description": "绑定值",
+        "hasDefault": true,
+        "name": "modelValue",
+        "required": false,
+        "type": "any"
+      },
+      {
+        "alias": null,
+        "defaultText": "off",
+        "description": "原生 autocomplete 属性",
+        "hasDefault": true,
+        "name": "autocomplete",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "对于不可搜索的 Select，获取焦点后是否自动弹出",
+        "hasDefault": false,
+        "name": "automaticDropdown",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "default",
+        "description": "输入框尺寸",
+        "hasDefault": false,
+        "name": "size",
+        "required": false,
+        "type": "'large' | 'default' | 'small'"
+      },
+      {
+        "alias": null,
+        "defaultText": "light",
+        "description": "tooltip 主题",
+        "hasDefault": true,
+        "name": "effect",
+        "required": false,
+        "type": "'dark' | 'light'"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "是否禁用",
+        "hasDefault": true,
+        "name": "disabled",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "是否可以清空选项",
+        "hasDefault": false,
+        "name": "clearable",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "是否可搜索",
+        "hasDefault": false,
+        "name": "filterable",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "是否允许用户创建新条目",
+        "hasDefault": false,
+        "name": "allowCreate",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "是否正在从远程获取数据",
+        "hasDefault": false,
+        "name": "loading",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "Select 下拉框的类名",
+        "hasDefault": true,
+        "name": "popperClass",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": false,
+        "name": "popperStyle",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": true,
+        "name": "popperOptions",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "是否为远程搜索",
+        "hasDefault": false,
+        "name": "remote",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": true,
+        "name": "debounce",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": "加载中",
+        "description": "远程加载时显示的文字",
+        "hasDefault": false,
+        "name": "loadingText",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": "无匹配数据",
+        "description": "搜索条件无匹配时显示的文字",
+        "hasDefault": false,
+        "name": "noMatchText",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": "无数据",
+        "description": "无选项时显示的文字",
+        "hasDefault": false,
+        "name": "noDataText",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "远程搜索方法",
+        "hasDefault": false,
+        "name": "remoteMethod",
+        "required": false,
+        "type": "(query: string) => void"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "自定义搜索方法",
+        "hasDefault": false,
+        "name": "filterMethod",
+        "required": false,
+        "type": "(query: string) => void"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "是否多选",
+        "hasDefault": false,
+        "name": "multiple",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "0",
+        "description": "多选时可被选择的最大数目",
+        "hasDefault": true,
+        "name": "multipleLimit",
+        "required": false,
+        "type": "number"
+      },
+      {
+        "alias": null,
+        "defaultText": "请选择",
+        "description": "占位符",
+        "hasDefault": false,
+        "name": "placeholder",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "按下回车是否选择第一个匹配项",
+        "hasDefault": false,
+        "name": "defaultFirstOption",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "true",
+        "description": "多选且可搜索时选中后是否保留关键字",
+        "hasDefault": true,
+        "name": "reserveKeyword",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "value",
+        "description": "作为 value 唯一标识的键名",
+        "hasDefault": true,
+        "name": "valueKey",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "多选时将选中值按文字形式展示",
+        "hasDefault": false,
+        "name": "collapseTags",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "鼠标悬停折叠标签以显示具体所选值",
+        "hasDefault": false,
+        "name": "collapseTagsTooltip",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": true,
+        "name": "tagTooltip",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": "1",
+        "description": "需要显示的 Tag 的最大数量",
+        "hasDefault": true,
+        "name": "maxCollapseTags",
+        "required": false,
+        "type": "number"
+      },
+      {
+        "alias": null,
+        "defaultText": "true",
+        "description": "是否将下拉列表插入至 body 元素",
+        "hasDefault": true,
+        "name": "teleported",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "true",
+        "description": "下拉菜单关闭后是否销毁",
+        "hasDefault": true,
+        "name": "persistent",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "CircleClose",
+        "description": "自定义清空图标",
+        "hasDefault": true,
+        "name": "clearIcon",
+        "required": false,
+        "type": "string | Component"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "下拉框的宽度是否与输入框相同",
+        "hasDefault": false,
+        "name": "fitInputWidth",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "ArrowDown",
+        "description": "自定义后缀图标",
+        "hasDefault": true,
+        "name": "suffixIcon",
+        "required": false,
+        "type": "string | Component"
+      },
+      {
+        "alias": null,
+        "defaultText": "info",
+        "description": "标签类型",
+        "hasDefault": true,
+        "name": "tagType",
+        "required": false,
+        "type": "'success' | 'info' | 'warning' | 'danger'"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": true,
+        "name": "tagEffect",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": "true",
+        "description": "是否触发表单验证",
+        "hasDefault": true,
+        "name": "validateEvent",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "远程搜索时显示后缀图标",
+        "hasDefault": false,
+        "name": "remoteShowSuffix",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": true,
+        "name": "showArrow",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": true,
+        "name": "offset",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": "bottom-start",
+        "description": "下拉框出现的位置",
+        "hasDefault": true,
+        "name": "placement",
+        "required": false,
+        "type": "Placement"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": true,
+        "name": "fallbackPlacements",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": true,
+        "name": "tabindex",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": false,
+        "name": "appendTo",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": false,
+        "name": "options",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": true,
+        "name": "props",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "是否启用浮动标签（Material 风格），聚焦或有值时占位文本上浮",
+        "hasDefault": true,
+        "name": "floatLabel",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": false,
+        "name": "emptyValues",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": true,
+        "name": "valueOnClear",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "原生 aria-label 属性",
+        "hasDefault": false,
+        "name": "ariaLabel",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "原生 aria-labelledby 属性；显式传入时优先于浮动标签自动关联的文本",
+        "hasDefault": false,
+        "name": "ariaLabelledby",
+        "required": false,
+        "type": "string"
+      }
+    ],
+    "related": [
+      "EpOption",
+      "EpOptionGroup"
+    ],
+    "relations": {
+      "children": [
+        "EpOption",
+        "EpOptionGroup"
+      ],
+      "combos": [
+        "EpSelect + EpOption",
+        "EpSelect + EpOptionGroup"
+      ],
+      "parents": [],
+      "requiredChildren": []
+    },
+    "slots": [
+      {
+        "description": "Option 组件列表",
+        "name": "default"
+      },
+      {
+        "description": "下拉列表顶部的内容",
+        "name": "header"
+      },
+      {
+        "description": "下拉列表底部的内容",
+        "name": "footer"
+      },
+      {
+        "description": "Select 组件头部内容",
+        "name": "prefix"
+      },
+      {
+        "description": "无选项时的列表",
+        "name": "empty"
+      },
+      {
+        "description": "select 组件自定义 tag 内容",
+        "name": "tag"
+      },
+      {
+        "description": "select 组件自定义 loading 内容",
+        "name": "loading"
+      },
+      {
+        "description": "select 组件自定义 label 内容",
+        "name": "label"
+      }
+    ],
+    "slug": "select",
+    "summary": "下拉选择器，支持单选、多选与筛选",
+    "tag": "ep-select",
+    "useCases": [
+      "从有限选项中选择一项或多项",
+      "筛选器与表单字段"
+    ],
+    "variants": [
+      {
+        "dimension": "size",
+        "values": [
+          "large",
+          "default",
+          "small"
+        ],
+        "when": "按容器空间与信息密度选择尺寸"
+      },
+      {
+        "dimension": "state",
+        "values": [
+          "disabled",
+          "loading"
+        ],
+        "when": "通过布尔属性切换禁用、加载或选中状态"
+      },
+      {
+        "dimension": "effect",
+        "values": [
+          "dark",
+          "light"
+        ],
+        "when": "通过视觉修饰属性调整外观效果"
+      }
+    ],
+    "visual": {
+      "cssVars": [
+        "--el-border-color",
+        "--el-border-radius-base",
+        "--el-color-primary",
+        "--el-font-size-base"
+      ],
+      "density": "中等",
+      "shape": "矩形输入框",
+      "slotContent": [
+        "default：Option 组件列表",
+        "header：下拉列表顶部的内容",
+        "footer：下拉列表底部的内容"
+      ]
+    }
+  },
+  "generatedAt": "2026-11-03T03:09:12.050Z",
+  "libraryVersion": "0.2.0",
+  "schemaVersion": 1
+}