@a2simcode/ui 0.0.70 → 0.0.72

package/docs/components/menu.md

@@ -1,121 +1,121 @@
-# Menu 菜单
-
-为页面和功能提供导航的菜单列表。
-
-## 基础用法
-
-默认为内嵌模式，支持展开和收起子菜单。
-
-<Demo :source-code="menuBasicCode">
-  <template #source>
-    <menu-basic />
-  </template>
-  <template #description>
-    通过 `menus` 属性设置菜单数据，`active-id` 设置当前激活的菜单项，`click` 事件监听菜单点击。
-  </template>
-</Demo>
-
-## 水平菜单
-
-通过 `mode` 属性设置为 `horizontal` 可以使用水平菜单。
-
-<Demo :source-code="menuHorizontalCode">
-  <template #source>
-    <menu-horizontal />
-  </template>
-  <template #description>
-    水平菜单适用于顶部导航栏。
-  </template>
-</Demo>
-
-## 垂直菜单
-
-通过 `mode` 属性设置为 `vertical` 可以使用垂直菜单。
-
-<Demo :source-code="menuVerticalCode">
-  <template #source>
-    <menu-vertical />
-  </template>
-  <template #description>
-    垂直菜单适用于侧边栏，不支持子菜单展开。
-  </template>
-</Demo>
-
-## 折叠菜单
-
-通过 `collapsed` 属性可以折叠菜单。
-
-<Demo :source-code="menuCollapsedCode">
-  <template #source>
-    <menu-collapsed />
-  </template>
-  <template #description>
-    折叠菜单只显示图标，适用于需要节省空间的场景。
-  </template>
-</Demo>
-
-## 主题
-
-通过 `theme` 属性可以设置菜单主题，支持 `light` 和 `dark` 两种主题。
-
-<Demo :source-code="menuThemeCode">
-  <template #source>
-    <menu-theme />
-  </template>
-  <template #description>
-    深色主题适用于深色背景。
-  </template>
-</Demo>
-
-## 选中状态测试
-
-测试切换选中菜单，验证菜单状态是否变化。
-
-<Demo :source-code="menuSelectionTestCode">
-  <template #source>
-    <menu-selection-test />
-  </template>
-  <template #description>
-    通过修改 `active-id` 可以程序化改变选中项。
-  </template>
-</Demo>
-
-## API
-
-### 属性
-
-<ApiTable :data="menuApi" componentName="menu" />
-
-### 事件
-
-| 事件名 | 说明             | 回调参数                      |
-| ------ | ---------------- | ----------------------------- |
-| click  | 点击菜单项时触发 | `(item: Record<string, any>)` |
-
-## 菜单数据结构
-
-```typescript
-interface MenuItem {
-  label: string // 菜单项文本
-  value: string // 菜单项唯一标识
-  icon?: string // 图标
-  children?: MenuItem[] // 子菜单
-}
-```
-
-<script setup>
-import MenuBasic from '../examples/menu/basic.vue'
-import MenuHorizontal from '../examples/menu/horizontal.vue'
-import MenuVertical from '../examples/menu/vertical.vue'
-import MenuCollapsed from '../examples/menu/collapsed.vue'
-import MenuTheme from '../examples/menu/theme.vue'
-import MenuSelectionTest from '../examples/menu/selection-test.vue'
-import menuApi from './meta/menu'
-
-import menuBasicCode from '../examples/menu/basic.vue?raw'
-import menuHorizontalCode from '../examples/menu/horizontal.vue?raw'
-import menuVerticalCode from '../examples/menu/vertical.vue?raw'
-import menuCollapsedCode from '../examples/menu/collapsed.vue?raw'
-import menuThemeCode from '../examples/menu/theme.vue?raw'
-import menuSelectionTestCode from '../examples/menu/selection-test.vue?raw'
-</script>
+# Menu 菜单
+
+为页面和功能提供导航的菜单列表。
+
+## 基础用法
+
+默认为内嵌模式，支持展开和收起子菜单。
+
+<Demo :source-code="menuBasicCode">
+  <template #source>
+    <menu-basic />
+  </template>
+  <template #description>
+    通过 `menus` 属性设置菜单数据，`active-id` 设置当前激活的菜单项，`click` 事件监听菜单点击。
+  </template>
+</Demo>
+
+## 水平菜单
+
+通过 `mode` 属性设置为 `horizontal` 可以使用水平菜单。
+
+<Demo :source-code="menuHorizontalCode">
+  <template #source>
+    <menu-horizontal />
+  </template>
+  <template #description>
+    水平菜单适用于顶部导航栏。
+  </template>
+</Demo>
+
+## 垂直菜单
+
+通过 `mode` 属性设置为 `vertical` 可以使用垂直菜单。
+
+<Demo :source-code="menuVerticalCode">
+  <template #source>
+    <menu-vertical />
+  </template>
+  <template #description>
+    垂直菜单适用于侧边栏，不支持子菜单展开。
+  </template>
+</Demo>
+
+## 折叠菜单
+
+通过 `collapsed` 属性可以折叠菜单。
+
+<Demo :source-code="menuCollapsedCode">
+  <template #source>
+    <menu-collapsed />
+  </template>
+  <template #description>
+    折叠菜单只显示图标，适用于需要节省空间的场景。
+  </template>
+</Demo>
+
+## 主题
+
+通过 `theme` 属性可以设置菜单主题，支持 `light` 和 `dark` 两种主题。
+
+<Demo :source-code="menuThemeCode">
+  <template #source>
+    <menu-theme />
+  </template>
+  <template #description>
+    深色主题适用于深色背景。
+  </template>
+</Demo>
+
+## 选中状态测试
+
+测试切换选中菜单，验证菜单状态是否变化。
+
+<Demo :source-code="menuSelectionTestCode">
+  <template #source>
+    <menu-selection-test />
+  </template>
+  <template #description>
+    通过修改 `active-id` 可以程序化改变选中项。
+  </template>
+</Demo>
+
+## API
+
+### 属性
+
+<ApiTable :data="menuApi" componentName="menu" />
+
+### 事件
+
+| 事件名 | 说明             | 回调参数                      |
+| ------ | ---------------- | ----------------------------- |
+| click  | 点击菜单项时触发 | `(item: Record<string, any>)` |
+
+## 菜单数据结构
+
+```typescript
+interface MenuItem {
+  label: string // 菜单项文本
+  value: string // 菜单项唯一标识
+  icon?: string // 图标
+  children?: MenuItem[] // 子菜单
+}
+```
+
+<script setup>
+import MenuBasic from '../examples/menu/basic.vue'
+import MenuHorizontal from '../examples/menu/horizontal.vue'
+import MenuVertical from '../examples/menu/vertical.vue'
+import MenuCollapsed from '../examples/menu/collapsed.vue'
+import MenuTheme from '../examples/menu/theme.vue'
+import MenuSelectionTest from '../examples/menu/selection-test.vue'
+import menuApi from './meta/menu'
+
+import menuBasicCode from '../examples/menu/basic.vue?raw'
+import menuHorizontalCode from '../examples/menu/horizontal.vue?raw'
+import menuVerticalCode from '../examples/menu/vertical.vue?raw'
+import menuCollapsedCode from '../examples/menu/collapsed.vue?raw'
+import menuThemeCode from '../examples/menu/theme.vue?raw'
+import menuSelectionTestCode from '../examples/menu/selection-test.vue?raw'
+</script>

package/docs/components/meta/buttons.ts

@@ -1,56 +1,56 @@
-export default {
-  "props": [
-    {
-      "name": "list",
-      "description": "按钮数据",
-      "type": "(Array as PropType<ButtonCompType[]>) ||\n(Object as PropType<Record<string, ButtonCompType[]>>)",
-      "default": "() => []"
-    },
-    {
-      "name": "size",
-      "description": "设置按钮大小",
-      "type": "'large' | 'default' | 'small'",
-      "default": "'default'"
-    },
-    {
-      "name": "isLink",
-      "description": "是否是链接按钮",
-      "type": "boolean"
-    }
-  ],
-  "events": [],
-  "slots": [],
-  "methods": [],
-  "types": [
-    {
-      "name": "ButtonCompType",
-      "properties": [
-        {
-          "name": "id",
-          "type": "string",
-          "description": "按钮ID"
-        },
-        {
-          "name": "label",
-          "type": "string",
-          "description": "按钮名称"
-        },
-        {
-          "name": "config",
-          "type": "Record<string, any>",
-          "description": "按钮配置"
-        },
-        {
-          "name": "click",
-          "type": "(scope: {\n    data?: Record<string, any>\n    openLayer: (options: LayerParamType) => void\n  }) => void",
-          "description": "按钮点击方法"
-        },
-        {
-          "name": "children",
-          "type": "ButtonCompType[]",
-          "description": "按钮子集"
-        }
-      ]
-    }
-  ]
-}
+export default {
+  "props": [
+    {
+      "name": "list",
+      "description": "按钮数据",
+      "type": "(Array as PropType<ButtonCompType[]>) ||\n(Object as PropType<Record<string, ButtonCompType[]>>)",
+      "default": "() => []"
+    },
+    {
+      "name": "size",
+      "description": "设置按钮大小",
+      "type": "'large' | 'default' | 'small'",
+      "default": "'default'"
+    },
+    {
+      "name": "isLink",
+      "description": "是否是链接按钮",
+      "type": "boolean"
+    }
+  ],
+  "events": [],
+  "slots": [],
+  "methods": [],
+  "types": [
+    {
+      "name": "ButtonCompType",
+      "properties": [
+        {
+          "name": "id",
+          "type": "string",
+          "description": "按钮ID"
+        },
+        {
+          "name": "label",
+          "type": "string",
+          "description": "按钮名称"
+        },
+        {
+          "name": "config",
+          "type": "Record<string, any>",
+          "description": "按钮配置"
+        },
+        {
+          "name": "click",
+          "type": "(scope: {\n    data?: Record<string, any>\n    openLayer: (options: LayerParamType) => void\n  }) => void",
+          "description": "按钮点击方法"
+        },
+        {
+          "name": "children",
+          "type": "ButtonCompType[]",
+          "description": "按钮子集"
+        }
+      ]
+    }
+  ]
+}

package/docs/components/meta/date.ts

@@ -0,0 +1,275 @@
+export default {
+  "props": [
+    {
+      "name": "modelValue",
+      "description": "绑定值",
+      "type": "string | number | Date | Array<string | number | Date>"
+    },
+    {
+      "name": "selectType",
+      "description": "显示类型",
+      "type": "'year' | 'month' | 'date' | 'dates' | 'week' | 'datetime' | 'datetimerange' | 'daterange' | 'monthrange'",
+      "default": "'date'"
+    },
+    {
+      "name": "readonly",
+      "description": "是否只读",
+      "type": "boolean",
+      "default": "false"
+    },
+    {
+      "name": "disabled",
+      "description": "是否禁用",
+      "type": "boolean",
+      "default": "false"
+    },
+    {
+      "name": "editable",
+      "description": "文本框可输入",
+      "type": "boolean",
+      "default": "true"
+    },
+    {
+      "name": "clearable",
+      "description": "是否显示清除按钮",
+      "type": "boolean",
+      "default": "true"
+    },
+    {
+      "name": "size",
+      "description": "输入框尺寸",
+      "type": "'large' | 'default' | 'small'",
+      "default": "'default'"
+    },
+    {
+      "name": "placeholder",
+      "description": "非范围选择时的占位内容",
+      "type": "string",
+      "default": "''"
+    },
+    {
+      "name": "startPlaceholder",
+      "description": "范围选择时开始日期的占位内容",
+      "type": "string",
+      "default": "''"
+    },
+    {
+      "name": "endPlaceholder",
+      "description": "范围选择时结束日期的占位内容",
+      "type": "string",
+      "default": "''"
+    },
+    {
+      "name": "format",
+      "description": "显示在输入框中的格式",
+      "type": "string"
+    },
+    {
+      "name": "valueFormat",
+      "description": "绑定值的格式。 不指定则绑定值为 Date 对象",
+      "type": "string"
+    },
+    {
+      "name": "rangeSeparator",
+      "description": "选择范围时的分隔符",
+      "type": "string"
+    },
+    {
+      "name": "defaultValue",
+      "description": "可选，选择器打开时默认显示的时间",
+      "type": "Date | Array<Date>"
+    },
+    {
+      "name": "defaultTime",
+      "description": "范围选择时选中日期所使用的当日内具体时刻",
+      "type": "Date | Array<Date>"
+    },
+    {
+      "name": "shortcuts",
+      "description": "设置快捷选项，需要传入数组对象",
+      "type": "Array<{ text: string; value: Date | Function }>"
+    },
+    {
+      "name": "disabledDate",
+      "description": "一个用来判断该日期是否被禁用的函数，接受一个 Date 对象作为参数。 应该返回一个 Boolean 值",
+      "type": "(date: Date) => boolean"
+    },
+    {
+      "name": "teleported",
+      "description": "是否将 date-picker 的下拉列表插入至 body 元素",
+      "type": "boolean",
+      "default": "true"
+    },
+    {
+      "name": "prefixIcon",
+      "description": "自定义头部图标",
+      "type": "string | Component"
+    },
+    {
+      "name": "clearIcon",
+      "description": "自定义清空图标",
+      "type": "string | Component"
+    }
+  ],
+  "events": [
+    {
+      "name": "update:modelValue",
+      "description": "绑定值更新时触发",
+      "type": "(val: string | number | Date | Array<string | number | Date>) => void"
+    },
+    {
+      "name": "change",
+      "description": "用户确认选定的值时触发",
+      "type": "(val: string | number | Date | Array<string | number | Date>) => void"
+    },
+    {
+      "name": "blur",
+      "description": "在组件 Input 失去焦点时触发",
+      "type": "(e: FocusEvent) => void"
+    },
+    {
+      "name": "focus",
+      "description": "在组件 Input 获得焦点时触发",
+      "type": "(e: FocusEvent) => void"
+    },
+    {
+      "name": "calendar-change",
+      "description": "在日历所选日期更改时触发",
+      "type": "(val: [Date, Date | null]) => void"
+    },
+    {
+      "name": "panel-change",
+      "description": "当日期面板改变时触发",
+      "type": "(date: Date, mode: string, view: string) => void"
+    },
+    {
+      "name": "visible-change",
+      "description": "当 DatePicker 的下拉列表出现/消失时触发",
+      "type": "(visibility: boolean) => void"
+    }
+  ],
+  "slots": [
+    {
+      "name": "default",
+      "description": "自定义内容"
+    },
+    {
+      "name": "range-separator",
+      "description": "自定义范围分隔符内容"
+    }
+  ],
+  "methods": [
+    {
+      "name": "ref",
+      "description": "获取 el-date-picker 实例",
+      "type": "() => any"
+    }
+  ],
+  "types": [
+    {
+      "name": "DateProps",
+      "properties": [
+        {
+          "name": "modelValue",
+          "type": "string | number | Date | Array<string | number | Date>",
+          "description": "绑定值"
+        },
+        {
+          "name": "selectType",
+          "type": "'year' | 'month' | 'date' | 'dates' | 'week' | 'datetime' | 'datetimerange' | 'daterange' | 'monthrange'",
+          "description": "显示类型"
+        },
+        {
+          "name": "readonly",
+          "type": "boolean",
+          "description": "是否只读"
+        },
+        {
+          "name": "disabled",
+          "type": "boolean",
+          "description": "是否禁用"
+        },
+        {
+          "name": "editable",
+          "type": "boolean",
+          "description": "文本框可输入"
+        },
+        {
+          "name": "clearable",
+          "type": "boolean",
+          "description": "是否显示清除按钮"
+        },
+        {
+          "name": "size",
+          "type": "'large' | 'default' | 'small'",
+          "description": "输入框尺寸"
+        },
+        {
+          "name": "placeholder",
+          "type": "string",
+          "description": "非范围选择时的占位内容"
+        },
+        {
+          "name": "startPlaceholder",
+          "type": "string",
+          "description": "范围选择时开始日期的占位内容"
+        },
+        {
+          "name": "endPlaceholder",
+          "type": "string",
+          "description": "范围选择时结束日期的占位内容"
+        },
+        {
+          "name": "format",
+          "type": "string",
+          "description": "显示在输入框中的格式"
+        },
+        {
+          "name": "valueFormat",
+          "type": "string",
+          "description": "绑定值的格式。 不指定则绑定值为 Date 对象"
+        },
+        {
+          "name": "rangeSeparator",
+          "type": "string",
+          "description": "选择范围时的分隔符"
+        },
+        {
+          "name": "defaultValue",
+          "type": "Date | Array<Date>",
+          "description": "可选，选择器打开时默认显示的时间"
+        },
+        {
+          "name": "defaultTime",
+          "type": "Date | Array<Date>",
+          "description": "范围选择时选中日期所使用的当日内具体时刻"
+        },
+        {
+          "name": "shortcuts",
+          "type": "Array<{ text: string; value: Date | Function }>",
+          "description": "设置快捷选项，需要传入数组对象"
+        },
+        {
+          "name": "disabledDate",
+          "type": "(date: Date) => boolean",
+          "description": "一个用来判断该日期是否被禁用的函数，接受一个 Date 对象作为参数。 应该返回一个 Boolean 值"
+        },
+        {
+          "name": "teleported",
+          "type": "boolean",
+          "description": "是否将 date-picker 的下拉列表插入至 body 元素"
+        },
+        {
+          "name": "prefixIcon",
+          "type": "string | Component",
+          "description": "自定义头部图标"
+        },
+        {
+          "name": "clearIcon",
+          "type": "string | Component",
+          "description": "自定义清空图标"
+        }
+      ]
+    }
+  ]
+}