king-design-analyzer 2.2.0 → 2.2.2

package/components/input.json

@@ -479,24 +479,28 @@
     {
       "name": "prepend",
       "description": "输入框前置内容，展示在输入框外部左侧",
+      "bindingType": "none",
       "vueTemplate": "#prepend",
       "usageExample": "<Input v-model=\"url\">\n  <template #prepend>http://</template>\n</Input>"
     },
     {
       "name": "append",
       "description": "输入框后置内容，展示在输入框外部右侧",
+      "bindingType": "none",
       "vueTemplate": "#append",
       "usageExample": "<Input v-model=\"email\">\n  <template #append>.com</template>\n</Input>"
     },
     {
       "name": "prefix",
       "description": "输入框前缀图标或内容，展示在输入框内部左侧",
+      "bindingType": "none",
       "vueTemplate": "#prefix",
       "usageExample": "<Input v-model=\"user\">\n  <template #prefix><Icon class=\"k-icon-user\" /></template>\n</Input>"
     },
     {
       "name": "suffix",
       "description": "输入框后缀图标或内容，展示在输入框内部右侧",
+      "bindingType": "none",
       "vueTemplate": "#suffix",
       "usageExample": "<Input v-model=\"search\">\n  <template #suffix><Icon class=\"k-icon-search\" /></template>\n</Input>"
     }
@@ -745,8 +749,8 @@
               "description": "当前搜索关键字"
             }
           ],
-          "usageExample": "<Search @submit=\"handleSearch\" />",
-          "handlerExample": "const handleSearch = (keywords: string) => {\n  console.log('搜索关键字:', keywords);\n};"
+          "usageExample": "<Search @submit=\"handleKeywordSearch\" />",
+          "handlerExample": "const searchHistory = ref<string[]>([]);\n\nconst handleKeywordSearch = (keywords: string) => {\n  const normalized = keywords.trim();\n  if (!normalized) return;\n  searchHistory.value = [normalized, ...searchHistory.value.filter((item) => item !== normalized)].slice(0, 5);\n};"
         }
       ],
       "methods": [
@@ -755,14 +759,14 @@
           "description": "使搜索框获得焦点",
           "params": [],
           "returnType": "void",
-          "usageExample": "const searchRef = ref<InstanceType<typeof Search>>();\nsearchRef.value?.focus();"
+          "usageExample": "const searchRef = ref<InstanceType<typeof Search>>();\n\nconst openSearchBar = () => {\n  searchRef.value?.focus();\n};"
         },
         {
           "name": "blur",
           "description": "使搜索框失去焦点",
           "params": [],
           "returnType": "void",
-          "usageExample": "searchRef.value?.blur();"
+          "usageExample": "const closeSearchBar = () => {\n  searchRef.value?.blur();\n};"
         }
       ]
     }

package/components/layoutcontent.json

@@ -141,54 +141,63 @@
         {
             "name": "default",
             "description": "扩展主体内容",
+            "bindingType": "none",
             "vueTemplate": "<LayoutContent>Content</LayoutContent>",
             "usageExample": "<LayoutContent>...</LayoutContent>"
         },
         {
             "name": "headerTitle",
             "description": "扩展顶部栏左侧标题处内容",
+            "bindingType": "none",
             "vueTemplate": "<template #headerTitle>...</template>",
             "usageExample": "<LayoutContent><template #headerTitle>自定义标题</template></LayoutContent>"
         },
         {
             "name": "headerTitleAppend",
             "description": "扩展顶部栏左侧标题后面追加内容",
+            "bindingType": "none",
             "vueTemplate": "<template #headerTitleAppend>...</template>",
             "usageExample": "<LayoutContent><template #headerTitleAppend><Tag>标签</Tag></template></LayoutContent>"
         },
         {
             "name": "headerDocPrepend",
             "description": "扩展顶部栏右侧文档前面追加内容",
+            "bindingType": "none",
             "vueTemplate": "<template #headerDocPrepend>...</template>",
             "usageExample": "<LayoutContent><template #headerDocPrepend><Button>操作</Button></template></LayoutContent>"
         },
         {
             "name": "headerDoc",
             "description": "扩展顶部栏右侧文档处内容",
+            "bindingType": "none",
             "vueTemplate": "<template #headerDoc>...</template>",
             "usageExample": "<LayoutContent><template #headerDoc><Link>文档链接</Link></template></LayoutContent>"
         },
         {
             "name": "tab",
             "description": "扩展选项卡处内容",
+            "bindingType": "none",
             "vueTemplate": "<template #tab>...</template>",
             "usageExample": "<LayoutContent><template #tab><Tabs>...</Tabs></template></LayoutContent>"
         },
         {
             "name": "footerLeft",
             "description": "扩展底部栏左侧处内容",
+            "bindingType": "none",
             "vueTemplate": "<template #footerLeft>...</template>",
             "usageExample": "<LayoutContent><template #footerLeft><span>提示信息</span></template></LayoutContent>"
         },
         {
             "name": "footerRight",
             "description": "扩展底部栏右侧处内容",
+            "bindingType": "none",
             "vueTemplate": "<template #footerRight>...</template>",
             "usageExample": "<LayoutContent><template #footerRight><Button>提交</Button></template></LayoutContent>"
         },
         {
             "name": "footer",
             "description": "扩展底部栏处的整体内容，底部栏没有左右之分的时候可使用此扩展",
+            "bindingType": "none",
             "vueTemplate": "<template #footer>...</template>",
             "usageExample": "<LayoutContent><template #footer><Button>保存</Button><Button>取消</Button></template></LayoutContent>"
         }

package/components/layoutlistcontent.json

@@ -42,46 +42,55 @@
         {
             "name": "default",
             "description": "页面主体内容区域",
+            "bindingType": "none",
             "vueTemplate": "<LayoutListContent>...</LayoutListContent>"
         },
         {
             "name": "headerTitle",
             "description": "扩展顶部栏左侧标题处内容",
+            "bindingType": "none",
             "vueTemplate": "<template #headerTitle>...</template>"
         },
         {
             "name": "headerTitleAppend",
             "description": "扩展顶部栏左侧标题后的追加内容",
+            "bindingType": "none",
             "vueTemplate": "<template #headerTitleAppend>...</template>"
         },
         {
             "name": "headerDocPrepend",
             "description": "扩展顶部栏右侧文档前置内容",
+            "bindingType": "none",
             "vueTemplate": "<template #headerDocPrepend>...</template>"
         },
         {
             "name": "headerDoc",
             "description": "扩展顶部栏右侧文档内容",
+            "bindingType": "none",
             "vueTemplate": "<template #headerDoc>...</template>"
         },
         {
             "name": "opLeft",
             "description": "卡片操作栏左侧内容",
+            "bindingType": "none",
             "vueTemplate": "<template #opLeft>...</template>"
         },
         {
             "name": "opRight",
             "description": "卡片操作栏右侧内容",
+            "bindingType": "none",
             "vueTemplate": "<template #opRight>...</template>"
         },
         {
             "name": "prepend",
             "description": "卡片操作栏上方扩展内容",
+            "bindingType": "none",
             "vueTemplate": "<template #prepend>...</template>"
         },
         {
             "name": "extra",
             "description": "头部附加区域",
+            "bindingType": "none",
             "vueTemplate": "<template #extra>...</template>"
         }
     ],

package/components/layoutpermissioncontent.json

@@ -81,6 +81,7 @@
         {
             "name": "default",
             "description": "主内容区域",
+            "bindingType": "none",
             "vueTemplate": "<LayoutPermissionContent>...</LayoutPermissionContent>"
         }
     ],

package/components/layoutstandardlist.json

@@ -186,6 +186,7 @@
         {
             "name": "default",
             "description": "自定义列表主体内容",
+            "bindingType": "none",
             "vueTemplate": "<LayoutStandardList>...</LayoutStandardList>"
         }
     ],

package/components/lazymount.json

@@ -21,6 +21,7 @@
         {
             "name": "default",
             "description": "延迟挂载的内容",
+            "bindingType": "none",
             "vueTemplate": "<LazyMount>...</LazyMount>"
         }
     ],

package/components/lazyteleport.json

@@ -48,6 +48,7 @@
         {
             "name": "default",
             "description": "待传送内容",
+            "bindingType": "none",
             "vueTemplate": "<LazyTeleport>...</LazyTeleport>"
         }
     ],

package/components/menu.json

@@ -160,7 +160,8 @@
   "slots": [
     {
       "name": "header",
-      "description": "扩展菜单头部"
+      "description": "扩展菜单头部",
+      "bindingType": "none"
     }
   ],
   "methods": [],
@@ -230,8 +231,8 @@
               "description": "原生鼠标事件"
             }
           ],
-          "usageExample": "<MenuItem @select=\"handleSelect\"></MenuItem>",
-          "handlerExample": "const handleSelect = (menuItem, e: MouseEvent) => {\n  console.log('选中了:', menuItem.key);\n};"
+          "usageExample": "<MenuItem @select=\"handleMenuSelect\"></MenuItem>",
+          "handlerExample": "const activeSection = ref('');\n\nconst handleMenuSelect = (menuItem, e: MouseEvent) => {\n  activeSection.value = String(menuItem.key);\n};"
         }
       ]
     }

package/components/notification.json

@@ -0,0 +1,351 @@
+{
+    "id": "notification",
+    "name": "Notification",
+    "displayName": "通知提醒",
+    "category": "feedback",
+    "description": "全局通知组件，用于展示可停留、可关闭的系统级通知信息。支持不同语义类型、展示位置、自定义图标和点击回调，适合成功反馈、系统公告和后台异步任务提醒。",
+    "importStatement": "import { Notification } from '@king-design/vue';",
+    "props": [
+        {
+            "name": "title",
+            "description": "通知标题内容",
+            "type": {
+                "raw": "Children",
+                "kind": "custom"
+            },
+            "required": false,
+            "default": "undefined",
+            "usageExample": "Notification.notice({ title: '部署完成' })"
+        },
+        {
+            "name": "content",
+            "description": "通知正文内容",
+            "type": {
+                "raw": "Children",
+                "kind": "custom"
+            },
+            "required": false,
+            "default": "undefined",
+            "usageExample": "Notification.notice({ content: '实例已经创建成功' })"
+        },
+        {
+            "name": "duration",
+            "description": "通知自动关闭时间，单位 ms；传入 0 表示不自动关闭",
+            "type": {
+                "raw": "number",
+                "kind": "number"
+            },
+            "required": false,
+            "default": "5000",
+            "usageExample": "Notification.info({ title: '处理中', duration: 0 })"
+        },
+        {
+            "name": "type",
+            "description": "通知类型",
+            "type": {
+                "raw": "\"info\" | \"error\" | \"success\" | \"warning\" | \"\"",
+                "kind": "union",
+                "unionTypes": [
+                    "info",
+                    "error",
+                    "success",
+                    "warning",
+                    ""
+                ]
+            },
+            "required": false,
+            "default": "\"info\"",
+            "allowedValues": [
+                {
+                    "value": "info",
+                    "label": "普通提示",
+                    "isDefault": true
+                },
+                {
+                    "value": "success",
+                    "label": "成功通知"
+                },
+                {
+                    "value": "warning",
+                    "label": "警告通知"
+                },
+                {
+                    "value": "error",
+                    "label": "错误通知"
+                },
+                {
+                    "value": "",
+                    "label": "无类型样式"
+                }
+            ],
+            "usageExample": "Notification.success({ title: '发布成功' })"
+        },
+        {
+            "name": "closable",
+            "description": "是否显示关闭按钮",
+            "type": {
+                "raw": "boolean",
+                "kind": "boolean"
+            },
+            "required": false,
+            "default": "true",
+            "usageExample": "Notification.notice({ title: '系统公告', closable: false })"
+        },
+        {
+            "name": "icon",
+            "description": "自定义通知图标",
+            "type": {
+                "raw": "string | VNode",
+                "kind": "union"
+            },
+            "required": false,
+            "default": "undefined",
+            "usageExample": "Notification.notice({ title: '自定义图标', icon: 'k-icon-info' })"
+        },
+        {
+            "name": "position",
+            "description": "通知展示位置",
+            "type": {
+                "raw": "\"topRight\" | \"topLeft\" | \"bottomRight\" | \"bottomLeft\" | \"top\" | \"bottom\"",
+                "kind": "union",
+                "unionTypes": [
+                    "topRight",
+                    "topLeft",
+                    "bottomRight",
+                    "bottomLeft",
+                    "top",
+                    "bottom"
+                ]
+            },
+            "required": false,
+            "default": "\"topRight\"",
+            "allowedValues": [
+                {
+                    "value": "topRight",
+                    "label": "右上角",
+                    "isDefault": true
+                },
+                {
+                    "value": "topLeft",
+                    "label": "左上角"
+                },
+                {
+                    "value": "bottomRight",
+                    "label": "右下角"
+                },
+                {
+                    "value": "bottomLeft",
+                    "label": "左下角"
+                },
+                {
+                    "value": "top",
+                    "label": "顶部居中"
+                },
+                {
+                    "value": "bottom",
+                    "label": "底部居中"
+                }
+            ],
+            "usageExample": "Notification.info({ title: '左下角通知', position: 'bottomLeft' })"
+        },
+        {
+            "name": "className",
+            "description": "自定义通知根节点类名",
+            "type": {
+                "raw": "string",
+                "kind": "string"
+            },
+            "required": false,
+            "default": "undefined",
+            "usageExample": "Notification.notice({ title: '自定义样式', className: 'my-notification' })"
+        },
+        {
+            "name": "onClick",
+            "description": "点击通知主体时触发的回调",
+            "type": {
+                "raw": "(e: MouseEvent) => void",
+                "kind": "function"
+            },
+            "required": false,
+            "default": "undefined",
+            "usageExample": "Notification.notice({ title: '查看详情', onClick: () => console.log('clicked') })"
+        },
+        {
+            "name": "onClose",
+            "description": "通知关闭后触发的回调",
+            "type": {
+                "raw": "() => void",
+                "kind": "function"
+            },
+            "required": false,
+            "default": "undefined",
+            "usageExample": "Notification.notice({ title: '关闭回调', onClose: () => console.log('closed') })"
+        }
+    ],
+    "events": [],
+    "slots": [],
+    "methods": [
+        {
+            "name": "notice",
+            "description": "展示一条通知并返回唯一 ID",
+            "params": [
+                {
+                    "name": "props",
+                    "type": "Partial<NotificationProps>",
+                    "description": "通知配置对象"
+                }
+            ],
+            "returnType": "number",
+            "usageExample": "const id = Notification.notice({ title: '部署完成', content: '实例已创建完成' });"
+        },
+        {
+            "name": "close",
+            "description": "关闭指定 ID 的通知",
+            "params": [
+                {
+                    "name": "id",
+                    "type": "number",
+                    "description": "由 notice 返回的通知 ID"
+                }
+            ],
+            "returnType": "void",
+            "usageExample": "Notification.close(id);"
+        },
+        {
+            "name": "info",
+            "description": "展示普通类型通知",
+            "params": [
+                {
+                    "name": "props",
+                    "type": "Partial<NotificationProps>",
+                    "description": "通知配置对象"
+                }
+            ],
+            "returnType": "number",
+            "usageExample": "Notification.info({ title: '普通提醒', content: '这是一条信息通知' });"
+        },
+        {
+            "name": "success",
+            "description": "展示成功类型通知",
+            "params": [
+                {
+                    "name": "props",
+                    "type": "Partial<NotificationProps>",
+                    "description": "通知配置对象"
+                }
+            ],
+            "returnType": "number",
+            "usageExample": "Notification.success({ title: '保存成功', content: '配置已更新' });"
+        },
+        {
+            "name": "warning",
+            "description": "展示警告类型通知",
+            "params": [
+                {
+                    "name": "props",
+                    "type": "Partial<NotificationProps>",
+                    "description": "通知配置对象"
+                }
+            ],
+            "returnType": "number",
+            "usageExample": "Notification.warning({ title: '余额不足', content: '请尽快续费' });"
+        },
+        {
+            "name": "error",
+            "description": "展示错误类型通知",
+            "params": [
+                {
+                    "name": "props",
+                    "type": "Partial<NotificationProps>",
+                    "description": "通知配置对象"
+                }
+            ],
+            "returnType": "number",
+            "usageExample": "Notification.error({ title: '提交失败', content: '请稍后重试' });"
+        }
+    ],
+    "examples": [
+        {
+            "id": "notification_basic",
+            "title": "基础通知",
+            "description": "点击按钮展示基础通知。",
+            "difficulty": "easy",
+            "code": "<script setup lang=\"ts\">\nimport { Button, Notification } from '@king-design/vue';\n\nconst openNotification = () => {\n  Notification.notice({\n    title: 'Hello, King Design',\n    content: '这是一条基础通知',\n  });\n};\n</script>\n<template>\n  <Button @click=\"openNotification\">打开通知</Button>\n</template>",
+            "tags": [
+                "basic",
+                "notice"
+            ],
+            "usedProps": [],
+            "usedEvents": [],
+            "usedMethods": [
+                "notice"
+            ],
+            "scenario": "在页面操作完成后展示全局反馈。"
+        },
+        {
+            "id": "notification_types",
+            "title": "不同类型",
+            "description": "按语义展示不同类型的通知。",
+            "difficulty": "easy",
+            "code": "<script setup lang=\"ts\">\nimport { Button, Notification } from '@king-design/vue';\n</script>\n<template>\n  <div style=\"display: flex; gap: 8px; flex-wrap: wrap;\">\n    <Button @click=\"Notification.info({ title: '普通提醒', content: '这是一条信息通知' })\">Info</Button>\n    <Button @click=\"Notification.success({ title: '发布成功', content: '版本已上线' })\">Success</Button>\n    <Button @click=\"Notification.warning({ title: '容量不足', content: '请及时清理磁盘' })\">Warning</Button>\n    <Button @click=\"Notification.error({ title: '同步失败', content: '网络连接异常' })\">Error</Button>\n  </div>\n</template>",
+            "tags": [
+                "type",
+                "semantic"
+            ],
+            "usedProps": [
+                "type"
+            ],
+            "usedEvents": [],
+            "usedMethods": [
+                "info",
+                "success",
+                "warning",
+                "error"
+            ],
+            "scenario": "根据业务结果展示不同语义反馈。"
+        },
+        {
+            "id": "notification_position",
+            "title": "位置与常驻",
+            "description": "控制通知位置并让通知常驻直到手动关闭。",
+            "difficulty": "medium",
+            "code": "<script setup lang=\"ts\">\nimport { Button, Notification } from '@king-design/vue';\n\nconst openPinned = () => {\n  Notification.notice({\n    title: '系统公告',\n    content: '该通知位于底部且不会自动关闭',\n    position: 'bottom',\n    duration: 0,\n  });\n};\n</script>\n<template>\n  <Button @click=\"openPinned\">打开常驻通知</Button>\n</template>",
+            "tags": [
+                "position",
+                "duration"
+            ],
+            "usedProps": [
+                "position",
+                "duration"
+            ],
+            "usedEvents": [],
+            "usedMethods": [
+                "notice"
+            ],
+            "scenario": "展示需要用户明确感知和手动关闭的通知。"
+        }
+    ],
+    "searchKeywords": [
+        "notification",
+        "通知",
+        "提醒",
+        "全局通知",
+        "notice"
+    ],
+    "useCases": [
+        "系统公告提醒",
+        "异步任务完成通知",
+        "操作成功或失败反馈"
+    ],
+    "typeDefinitions": [
+        {
+            "name": "NotificationPosition",
+            "definition": "type NotificationPosition = 'topRight' | 'topLeft' | 'bottomRight' | 'bottomLeft' | 'top' | 'bottom'",
+            "description": "通知可展示的位置。"
+        }
+    ],
+    "relatedComponents": [
+        "Message",
+        "Dialog"
+    ]
+}

package/components/popover.json

@@ -274,6 +274,29 @@
             "handlerExample": "const handleCancel = () => {\n  console.log('已取消');\n};"
         }
     ],
+    "slots": [
+        {
+            "name": "title",
+            "description": "自定义确认提示标题区域内容。",
+            "bindingType": "none",
+            "vueTemplate": "<template #title>...</template>",
+            "usageExample": "<Popover>\n  <template #title>删除实例</template>\n  <Button>删除</Button>\n</Popover>"
+        },
+        {
+            "name": "content",
+            "description": "自定义确认提示主体内容。",
+            "bindingType": "none",
+            "vueTemplate": "<template #content>...</template>",
+            "usageExample": "<Popover>\n  <template #content>\n    删除后将无法恢复，请确认操作。\n  </template>\n  <Button>删除</Button>\n</Popover>"
+        },
+        {
+            "name": "footer",
+            "description": "自定义底部操作区内容，可覆盖默认的确认/取消按钮。",
+            "bindingType": "none",
+            "vueTemplate": "<template #footer>...</template>",
+            "usageExample": "<Popover>\n  <template #footer>\n    <Button size=\"small\">稍后处理</Button>\n    <Button type=\"danger\" size=\"small\">立即删除</Button>\n  </template>\n  <Button>删除</Button>\n</Popover>"
+        }
+    ],
     "methods": [],
     "typeDefinitions": [
         {

package/components/protable.json

@@ -172,12 +172,14 @@
         {
             "name": "actions",
             "description": "表格的左上角操作区",
+            "bindingType": "none",
             "vueTemplate": "<template #actions>...</template>",
             "usageExample": "<ProTable><template #actions><Button type=\"primary\">新建</Button></template></ProTable>"
         },
         {
             "name": "toolbar",
             "description": "表格的右上角功能区",
+            "bindingType": "none",
             "vueTemplate": "<template #toolbar>...</template>",
             "usageExample": "<ProTable><template #toolbar><Button>自定义操作</Button></template></ProTable>"
         }

package/components/rate.json

@@ -82,6 +82,7 @@
         {
             "name": "icon",
             "description": "自定义每一项评分图标，默认使用星形图标。",
+            "bindingType": "none",
             "vueTemplate": "<template #icon>...</template>",
             "usageExample": "<Rate v-model=\"score\"><template #icon><Icon class=\"k-icon-favorite\" /></template></Rate>"
         }