ep-craft 0.1.41 → 0.2.0

package/dist-ai/components/tooltip.json

@@ -0,0 +1,599 @@
+{
+  "entry": {
+    "category": "layout",
+    "events": [
+      {
+        "description": "Tooltip 可见性变化时触发",
+        "name": "update:visible",
+        "params": "(visible: boolean)"
+      },
+      {
+        "description": "显示动画播放前触发",
+        "name": "beforeShow",
+        "params": "(event?: Event)"
+      },
+      {
+        "description": "隐藏动画播放前触发",
+        "name": "beforeHide",
+        "params": "(event?: Event)"
+      },
+      {
+        "description": "显示时触发",
+        "name": "show",
+        "params": "(event?: Event)"
+      },
+      {
+        "description": "隐藏时触发",
+        "name": "hide",
+        "params": "(event?: Event)"
+      },
+      {
+        "description": "显示时触发（兼容事件名，建议监听 show）",
+        "name": "open",
+        "params": "(event?: Event)"
+      },
+      {
+        "description": "隐藏时触发（兼容事件名，建议监听 hide）",
+        "name": "close",
+        "params": "(event?: Event)"
+      }
+    ],
+    "exampleOmittedReason": null,
+    "examples": [
+      {
+        "code": "<script setup lang=\"ts\">\nimport { EpButton, EpTooltip } from 'ep-craft'\n</script>\n\n<template>\n  <ep-tooltip content=\"这里展示提示内容\">\n    <ep-button>悬停查看</ep-button>\n  </ep-tooltip>\n</template>",
+        "id": "tooltip-1",
+        "language": "vue",
+        "title": "基础提示"
+      },
+      {
+        "code": "<script setup lang=\"ts\">\nimport { EpButton, EpTooltip } from 'ep-craft'\n</script>\n\n<template>\n  <ep-tooltip content=\"右侧提示\" placement=\"right\" effect=\"dark\">\n    <ep-button>右侧</ep-button>\n  </ep-tooltip>\n</template>",
+        "id": "tooltip-2",
+        "language": "vue",
+        "title": "深色提示"
+      }
+    ],
+    "exposes": [],
+    "hot": true,
+    "id": "component:tooltip",
+    "keywords": {
+      "en": [
+        "tooltip",
+        "hint",
+        "hover",
+        "layout"
+      ],
+      "zh": [
+        "文字提示",
+        "悬停",
+        "气泡",
+        "布局"
+      ]
+    },
+    "kind": "component",
+    "name": "EpTooltip",
+    "nonUseCases": [
+      "需要承载可交互内容时使用 Popover"
+    ],
+    "props": [
+      {
+        "alias": null,
+        "defaultText": "true",
+        "description": "是否显示箭头",
+        "hasDefault": true,
+        "name": "showArrow",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": false,
+        "name": "onUpdate:visible",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": true,
+        "name": "role",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": false,
+        "name": "appendTo",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": "''",
+        "description": "显示的内容",
+        "hasDefault": true,
+        "name": "content",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "content 中的内容是否作为 HTML 字符串处理",
+        "hasDefault": false,
+        "name": "rawContent",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "当 tooltip 组件长时间不触发且 persistent 为 false 时销毁",
+        "hasDefault": false,
+        "name": "persistent",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": "v-model:visible",
+        "defaultText": null,
+        "description": "Tooltip 组件可见性",
+        "hasDefault": true,
+        "name": "visible",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "''",
+        "description": "动画名称",
+        "hasDefault": false,
+        "name": "transition",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": "true",
+        "description": "是否使用 teleport",
+        "hasDefault": true,
+        "name": "teleported",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "Tooltip 组件是否禁用",
+        "hasDefault": false,
+        "name": "disabled",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "与 aria-label 属性保持一致",
+        "hasDefault": false,
+        "name": "ariaLabel",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": "0",
+        "description": "在触发后多久显示内容",
+        "hasDefault": true,
+        "name": "showAfter",
+        "required": false,
+        "type": "number"
+      },
+      {
+        "alias": null,
+        "defaultText": "200",
+        "description": "延迟关闭",
+        "hasDefault": true,
+        "name": "hideAfter",
+        "required": false,
+        "type": "number"
+      },
+      {
+        "alias": null,
+        "defaultText": "0",
+        "description": "自动隐藏时长",
+        "hasDefault": true,
+        "name": "autoClose",
+        "required": false,
+        "type": "number"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": false,
+        "name": "id",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": true,
+        "name": "style",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": false,
+        "name": "className",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": "dark",
+        "description": "Tooltip 主题",
+        "hasDefault": true,
+        "name": "effect",
+        "required": false,
+        "type": "'dark' | 'light'"
+      },
+      {
+        "alias": null,
+        "defaultText": "true",
+        "description": "鼠标是否可进入到 tooltip 中",
+        "hasDefault": true,
+        "name": "enterable",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": true,
+        "name": "pure",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": true,
+        "name": "focusOnShow",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": true,
+        "name": "trapping",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "为 Tooltip 的 popper 添加类名",
+        "hasDefault": false,
+        "name": "popperClass",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": true,
+        "name": "popperStyle",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": false,
+        "name": "referenceEl",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": false,
+        "name": "triggerTargetEl",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": true,
+        "name": "stopPopperMouseEvent",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "是否使用虚拟触发",
+        "hasDefault": true,
+        "name": "virtualTriggering",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": false,
+        "name": "zIndex",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": true,
+        "name": "loop",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": true,
+        "name": "boundariesPadding",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": false,
+        "name": "fallbackPlacements",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": true,
+        "name": "gpuAcceleration",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": "12",
+        "description": "出现位置的偏移量",
+        "hasDefault": true,
+        "name": "offset",
+        "required": false,
+        "type": "number"
+      },
+      {
+        "alias": null,
+        "defaultText": "bottom",
+        "description": "Tooltip 组件出现的位置",
+        "hasDefault": true,
+        "name": "placement",
+        "required": false,
+        "type": "'top' | 'top-start' | 'top-end' | 'bottom' | 'bottom-start' | 'bottom-end' | 'left' | 'left-start' | 'left-end' | 'right' | 'right-start' | 'right-end'"
+      },
+      {
+        "alias": null,
+        "defaultText": "{}",
+        "description": "popper.js 的参数",
+        "hasDefault": true,
+        "name": "popperOptions",
+        "required": false,
+        "type": "object"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": true,
+        "name": "strategy",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": true,
+        "name": "arrowOffset",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": "hover",
+        "description": "如何触发 Tooltip",
+        "hasDefault": true,
+        "name": "trigger",
+        "required": false,
+        "type": "'hover' | 'click' | 'focus' | 'contextmenu'"
+      },
+      {
+        "alias": null,
+        "defaultText": "['Enter', 'Space']",
+        "description": "触发 tooltip 显示的按键",
+        "hasDefault": true,
+        "name": "triggerKeys",
+        "required": false,
+        "type": "string[]"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": false,
+        "name": "focusOnTarget",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "虚拟触发的引用",
+        "hasDefault": false,
+        "name": "virtualRef",
+        "required": false,
+        "type": "HTMLElement"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": false,
+        "name": "onMouseenter",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": false,
+        "name": "onMouseleave",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": false,
+        "name": "onClick",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": false,
+        "name": "onKeydown",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": false,
+        "name": "onFocus",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": false,
+        "name": "onBlur",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": false,
+        "name": "onContextmenu",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": false,
+        "name": "open",
+        "required": false,
+        "type": "unknown"
+      }
+    ],
+    "related": [
+      "EpPopover"
+    ],
+    "relations": {
+      "children": [],
+      "combos": [],
+      "parents": [],
+      "requiredChildren": []
+    },
+    "slots": [
+      {
+        "description": "Tooltip 触发 & 引用的元素",
+        "name": "default"
+      },
+      {
+        "description": "自定义内容",
+        "name": "content"
+      }
+    ],
+    "slug": "tooltip",
+    "summary": "文字提示，悬停展示简短说明",
+    "tag": "ep-tooltip",
+    "useCases": [
+      "图标或截断文本的解释",
+      "补充字段含义与操作说明"
+    ],
+    "variants": [
+      {
+        "dimension": "state",
+        "values": [
+          "disabled"
+        ],
+        "when": "通过布尔属性切换禁用、加载或选中状态"
+      },
+      {
+        "dimension": "effect",
+        "values": [
+          "dark",
+          "light"
+        ],
+        "when": "通过视觉修饰属性调整外观效果"
+      }
+    ],
+    "visual": {
+      "cssVars": [
+        "--el-bg-color",
+        "--el-border-color",
+        "--el-border-radius-base"
+      ],
+      "density": "宽松",
+      "shape": "区块容器",
+      "slotContent": [
+        "default：Tooltip 触发 & 引用的元素",
+        "content：自定义内容"
+      ]
+    }
+  },
+  "generatedAt": "2026-11-03T03:09:12.050Z",
+  "libraryVersion": "0.2.0",
+  "schemaVersion": 1
+}