@a2simcode/ui 0.0.46 → 0.0.48

package/docs/components/code-mirror.md

@@ -0,0 +1,85 @@
+# CodeMirror 代码编辑器
+
+强大的代码编辑器组件，支持多种编程语言的语法高亮和代码折叠。
+
+## 基础用法
+
+<Demo :source-code="codeMirrorBasicCode">
+  <template #source>
+    <code-mirror-basic />
+  </template>
+  <template #description>
+    使用 value 绑定，通过 mode 属性指定语言模式。
+  </template>
+</Demo>
+
+## 只读模式
+
+通过 `readonly` 属性将编辑器设置为只读状态。
+
+<Demo :source-code="codeMirrorReadonlyCode">
+  <template #source>
+    <code-mirror-readonly />
+  </template>
+  <template #description>
+    设置 `readonly` 属性为 `true` 即可启用只读模式，用户无法编辑内容。
+  </template>
+</Demo>
+
+## 语言模式切换
+
+支持多种编程语言的语法高亮。
+
+<Demo :source-code="codeMirrorModeCode">
+  <template #source>
+    <code-mirror-mode />
+  </template>
+  <template #description>
+    通过 `mode` 属性指定语言模式，如 `application/javascript`、`text/x-sql` 等。
+  </template>
+</Demo>
+
+## 自定义高度
+
+使用 `height` 属性自定义编辑器高度。
+
+<Demo :source-code="codeMirrorHeightCode">
+  <template #source>
+    <code-mirror-height />
+  </template>
+  <template #description>
+    通过 `height` 属性设置编辑器的高度（单位：像素）。
+  </template>
+</Demo>
+
+## 事件监听
+
+监听代码变化事件并执行相应操作。
+
+<Demo :source-code="codeMirrorEventsCode">
+  <template #source>
+    <code-mirror-events />
+  </template>
+  <template #description>
+    通过 `@change` 事件监听代码内容的变化，获取实时更新的代码值。
+  </template>
+</Demo>
+
+## API
+
+<ApiTable :data="codeMirrorApi" componentName="code-mirror" />
+
+<script setup>
+import CodeMirrorBasic from '../examples/code-mirror/basic.vue'
+import CodeMirrorReadonly from '../examples/code-mirror/readonly.vue'
+import CodeMirrorMode from '../examples/code-mirror/mode.vue'
+import CodeMirrorHeight from '../examples/code-mirror/height.vue'
+import CodeMirrorEvents from '../examples/code-mirror/events.vue'
+import codeMirrorApi from './meta/code-mirror'
+
+import codeMirrorBasicCode from '../examples/code-mirror/basic.vue?raw'
+import codeMirrorReadonlyCode from '../examples/code-mirror/readonly.vue?raw'
+import codeMirrorModeCode from '../examples/code-mirror/mode.vue?raw'
+import codeMirrorHeightCode from '../examples/code-mirror/height.vue?raw'
+import codeMirrorEventsCode from '../examples/code-mirror/events.vue?raw'
+</script>

package/docs/components/collapse.md

@@ -0,0 +1,26 @@
+# Collapse 折叠面板
+
+通过折叠面板收纳内容区域。
+
+## 基础用法
+
+可以折叠/展开的内容区域。
+
+<Demo :source-code="collapseBasicCode">
+  <template #source>
+    <collapse-basic />
+  </template>
+  <template #description>
+    通过 `v-model` 绑定当前激活的面板，使用 `el-collapse-item` 定义面板内容。支持 `accordion` 属性开启手风琴模式。
+  </template>
+</Demo>
+
+## API
+
+<ApiTable :data="collapseApi" componentName="collapse" />
+
+<script setup>
+import CollapseBasic from '../examples/collapse/basic.vue'
+import collapseApi from './meta/collapse'
+import collapseBasicCode from '../examples/collapse/basic.vue?raw'
+</script>

package/docs/components/comp.md

@@ -0,0 +1,71 @@
+# Comp 动态组件
+
+`j-comp` 是一个通用的动态组件渲染器，它可以根据配置渲染不同类型的组件，并支持递归渲染子组件。
+
+## 基础用法
+
+通过 `type` 属性指定组件类型，`config` 属性传递组件配置。
+
+<Demo :source-code="basicCode">
+  <template #source>
+    <basic />
+  </template>
+  <template #description>
+    使用 `j-comp` 渲染一个简单的按钮组件。
+  </template>
+</Demo>
+
+## Tabs 示例
+
+当 `type` 为 `j-tabs` 时：
+
+1. 子组件会自动添加 `name` 属性（`_tab` + index）。
+2. 组件会自动开启输入模式（`v-model` 生效）。
+3. 默认值规则：
+   - 优先使用 `config.defaultValue`。
+   - 其次查找子组件中配置了 `active: true` 的项，使用其对应的 `_tab` + index。
+   - 默认值为 `_tab0`。
+
+<Demo :source-code="tabsCode">
+  <template #source>
+    <tabs />
+  </template>
+  <template #description>
+    使用 `j-comp` 渲染 `j-tabs` 组件，子组件会自动获得 `name` 属性。
+  </template>
+</Demo>
+
+## Collapse 示例
+
+当 `type` 为 `j-collapse` 时：
+
+1. 子组件会自动添加 `name` 属性（`_collapse` + index）。
+2. 组件会自动开启输入模式（`v-model` 生效）。
+3. 默认值规则：
+   - 优先使用 `config.defaultValue`。
+   - 其次查找子组件中配置了 `active: true` 的项，使用其对应的 `_collapse` + index。
+   - 默认值为 `[]`（非手风琴模式）或 `''`（手风琴模式）。
+
+<Demo :source-code="collapseCode">
+  <template #source>
+    <collapse />
+  </template>
+  <template #description>
+    使用 `j-comp` 渲染 `j-collapse` 组件，子组件会自动获得 `name` 属性。
+  </template>
+</Demo>
+
+## API
+
+<ApiTable :data="compApi" componentName="comp" />
+
+<script setup>
+import Basic from '../examples/comp/basic.vue'
+import Tabs from '../examples/comp/tabs.vue'
+import Collapse from '../examples/comp/collapse.vue'
+import compApi from './meta/comp'
+
+import basicCode from '../examples/comp/basic.vue?raw'
+import tabsCode from '../examples/comp/tabs.vue?raw'
+import collapseCode from '../examples/comp/collapse.vue?raw'
+</script>

package/docs/components/count-up.md

@@ -0,0 +1,24 @@
+# CountUp 数字滚动动画组件
+
+使用数字滚动效果展示数值的变化，常用于数据统计展示和数值动画效果。
+
+## 基础用法
+
+<Demo :source-code="countUpBasicCode">
+  <template #source>
+    <count-up-basic />
+  </template>
+  <template #description>
+    通过 `end-value` 传入要显示的最终值。支持自定义动画时长、小数位数、起始值等功能。
+  </template>
+</Demo>
+
+## API
+
+<ApiTable :data="countUpApi" componentName="count-up" />
+
+<script setup>
+import CountUpBasic from '../examples/count-up/basic.vue'
+import countUpApi from './meta/count-up'
+import countUpBasicCode from '../examples/count-up/basic.vue?raw'
+</script>

package/docs/components/count.md

@@ -0,0 +1,24 @@
+# Count 计算组件
+
+用于根据公式自动计算数值。
+
+## 基础用法
+
+<Demo :source-code="countBasicCode">
+  <template #source>
+    <count-basic />
+  </template>
+  <template #description>
+    通过 `format-json` 传入计算公式。支持千分位分隔、大写转换、小数精度控制等功能。
+  </template>
+</Demo>
+
+## API
+
+<ApiTable :data="countApi" componentName="count" />
+
+<script setup>
+import CountBasic from '../examples/count/basic.vue'
+import countApi from './meta/count'
+import countBasicCode from '../examples/count/basic.vue?raw'
+</script>

package/docs/components/data-panel.md

@@ -0,0 +1,24 @@
+# DataPanel 数据面板组件
+
+用于展示和组织数据内容的面板容器组件，提供标题、插槽等功能支持。
+
+## 基础用法
+
+<Demo :source-code="dataPanelBasicCode">
+  <template #source>
+    <data-panel-basic />
+  </template>
+  <template #description>
+    通过 `title` 属性设置面板标题。支持 `titleRight` 插槽在标题右侧添加额外内容。
+  </template>
+</Demo>
+
+## API
+
+<ApiTable :data="dataPanelApi" componentName="data-panel" />
+
+<script setup>
+import DataPanelBasic from '../examples/data-panel/basic.vue'
+import dataPanelApi from './meta/data-panel'
+import dataPanelBasicCode from '../examples/data-panel/basic.vue?raw'
+</script>

package/docs/components/dialog-full.md

@@ -0,0 +1,112 @@
+# DialogFull 全屏弹窗
+
+全屏模态对话框，在整个屏幕中显示内容，适用于复杂表单或大量内容展示的场景。
+
+## 基础用法
+
+最简单的用法。
+
+<Demo :source-code="dialogFullBasicCode">
+  <template #source>
+    <dialog-full-basic />
+  </template>
+  <template #description>
+    基础的全屏弹窗，占据整个屏幕。使用 `v-model:visible` 控制显示隐藏。
+  </template>
+</Demo>
+
+## 无按钮
+
+设置 `hasBtns` 为 `false` 可以隐藏所有操作按钮。
+
+<Demo :source-code="dialogFullNoButtonsCode">
+  <template #source>
+    <dialog-full-no-buttons />
+  </template>
+  <template #description>
+    隐藏所有操作按钮，适用于只展示内容不需要操作的场景。
+  </template>
+</Demo>
+
+## 无表头
+
+通过隐藏按钮和关闭按钮可以实现无表头效果。
+
+<Demo :source-code="dialogFullNoHeaderCode">
+  <template #source>
+    <dialog-full-no-header />
+  </template>
+  <template #description>
+    设置 `hasBtns` 和 `showCloseBtn` 为 `false` 可以隐藏表头区域，适用于需要完全自定义布局的场景。
+  </template>
+</Demo>
+
+## 自定义按钮
+
+通过 `buttons` 属性可以自定义顶部操作按钮。
+
+<Demo :source-code="dialogFullCustomButtonsCode">
+  <template #source>
+    <dialog-full-custom-buttons />
+  </template>
+  <template #description>
+    使用 `buttons` 属性配置自定义按钮，支持设置按钮类型、样式、图标、点击事件等。
+  </template>
+</Demo>
+
+## 步骤弹窗
+
+通过 `isStep` 属性可以创建带步骤条的弹窗。
+
+<Demo :source-code="dialogFullStepsCode">
+  <template #source>
+    <dialog-full-steps />
+  </template>
+  <template #description>
+    适用于分步骤的表单或流程，支持步骤校验。使用 `v-model:stepActive` 控制当前步骤，使用 `validateSteps` 进行步骤校验。
+  </template>
+</Demo>
+
+## API
+
+### 属性
+
+<ApiTable :data="dialogFullApi" componentName="dialog-full" />
+
+### 事件
+
+| 事件名            | 说明                   | 回调参数                                         |
+| ----------------- | ---------------------- | ------------------------------------------------ |
+| update:visible    | 弹窗显示状态变化时触发 | `(visible: boolean)`                             |
+| update:stepActive | 步骤变化时触发         | `(stepActive: number)`                           |
+| cancel            | 点击关闭按钮时触发     | -                                                |
+| ok                | 点击确定按钮时触发     | `(showLoading: Function, hideLoading: Function)` |
+| closed            | 弹窗关闭动画结束后触发 | -                                                |
+
+### 插槽
+
+| 插槽名  | 说明         |
+| ------- | ------------ |
+| default | 弹窗内容区域 |
+
+### 方法
+
+| 方法名      | 说明         | 参数              |
+| ----------- | ------------ | ----------------- |
+| showLoading | 显示加载状态 | `(text?: string)` |
+| hideLoading | 隐藏加载状态 | -                 |
+
+<script setup>
+import DialogFullBasic from '../examples/dialog-full/basic.vue'
+import DialogFullNoHeader from '../examples/dialog-full/no-header.vue'
+import DialogFullCustomButtons from '../examples/dialog-full/custom-buttons.vue'
+import DialogFullSteps from '../examples/dialog-full/steps.vue'
+import DialogFullNoButtons from '../examples/dialog-full/no-buttons.vue'
+import dialogFullApi from './meta/dialog-full'
+
+import dialogFullBasicCode from '../examples/dialog-full/basic.vue?raw'
+import dialogFullNoHeaderCode from '../examples/dialog-full/no-header.vue?raw'
+import dialogFullCustomButtonsCode from '../examples/dialog-full/custom-buttons.vue?raw'
+import dialogFullStepsCode from '../examples/dialog-full/steps.vue?raw'
+import dialogFullNoButtonsCode from '../examples/dialog-full/no-buttons.vue?raw'
+</script>

package/docs/components/dialog.md

@@ -0,0 +1,127 @@
+# Dialog 弹窗
+
+模态对话框，在浮层中显示内容，支持拖拽、缩放等功能。
+
+## 基础用法
+
+最简单的用法。
+
+<Demo :source-code="dialogBasicCode">
+  <template #source>
+    <dialog-basic />
+  </template>
+  <template #description>
+    基础的弹窗，支持拖拽、缩放等功能。使用 `v-model:visible` 控制显示隐藏。
+  </template>
+</Demo>
+
+## 不同尺寸
+
+通过 `width` 和 `height` 属性可以设置弹窗的尺寸。
+
+<Demo :source-code="dialogSizeCode">
+  <template #source>
+    <dialog-size />
+  </template>
+  <template #description>
+    支持自定义弹窗的宽度和高度，单位为像素。设置 `minWidth` 和 `minHeight` 可限制最小尺寸。
+  </template>
+</Demo>
+
+## 全屏显示
+
+使用全屏显示弹窗。
+
+<Demo :source-code="dialogFullscreenCode">
+  <template #source>
+    <dialog-fullscreen />
+  </template>
+  <template #description>
+    可以通过缩放控制实现全屏显示效果。
+  </template>
+</Demo>
+
+## 自定义按钮
+
+通过 `buttons` 属性可以自定义底部按钮。
+
+<Demo :source-code="dialogCustomButtonsCode">
+  <template #source>
+    <dialog-custom-buttons />
+  </template>
+  <template #description>
+    使用 `buttons` 属性配置自定义按钮，支持设置按钮类型、样式、图标、点击事件等。设置 `hasBtns` 为 `false` 可隐藏整个按钮区域。
+  </template>
+</Demo>
+
+## 步骤弹窗
+
+通过 `isStep` 属性可以创建带步骤条的弹窗。
+
+<Demo :source-code="dialogStepsCode">
+  <template #source>
+    <dialog-steps />
+  </template>
+  <template #description>
+    适用于分步骤的表单或流程，支持步骤校验。使用 `v-model:stepActive` 控制当前步骤，使用 `validateSteps` 进行步骤校验。
+  </template>
+</Demo>
+
+## 无遮罩层
+
+设置 `mask` 为 `false` 可以取消遮罩层。
+
+<Demo :source-code="dialogNoMaskCode">
+  <template #source>
+    <dialog-no-mask />
+  </template>
+  <template #description>
+    无遮罩层的弹窗允许用户与页面其他内容进行交互。
+  </template>
+</Demo>
+
+## API
+
+### 属性
+
+<ApiTable :data="dialogApi" componentName="dialog" />
+
+### 事件
+
+| 事件名            | 说明                         | 回调参数                                         |
+| ----------------- | ---------------------------- | ------------------------------------------------ |
+| update:visible    | 弹窗显示状态变化时触发       | `(visible: boolean)`                             |
+| update:stepActive | 步骤变化时触发               | `(stepActive: number)`                           |
+| cancel            | 点击取消按钮或关闭按钮时触发 | -                                                |
+| ok                | 点击确定按钮时触发           | `(showLoading: Function, hideLoading: Function)` |
+| closed            | 弹窗关闭动画结束后触发       | -                                                |
+
+### 插槽
+
+| 插槽名  | 说明         |
+| ------- | ------------ |
+| default | 弹窗内容区域 |
+
+### 方法
+
+| 方法名      | 说明         | 参数              |
+| ----------- | ------------ | ----------------- |
+| showLoading | 显示加载状态 | `(text?: string)` |
+| hideLoading | 隐藏加载状态 | -                 |
+
+<script setup>
+import DialogBasic from '../examples/dialog/basic.vue'
+import DialogSize from '../examples/dialog/size.vue'
+import DialogFullscreen from '../examples/dialog/fullscreen.vue'
+import DialogCustomButtons from '../examples/dialog/custom-buttons.vue'
+import DialogSteps from '../examples/dialog/steps.vue'
+import DialogNoMask from '../examples/dialog/no-mask.vue'
+import dialogApi from './meta/dialog'
+
+import dialogBasicCode from '../examples/dialog/basic.vue?raw'
+import dialogSizeCode from '../examples/dialog/size.vue?raw'
+import dialogFullscreenCode from '../examples/dialog/fullscreen.vue?raw'
+import dialogCustomButtonsCode from '../examples/dialog/custom-buttons.vue?raw'
+import dialogStepsCode from '../examples/dialog/steps.vue?raw'
+import dialogNoMaskCode from '../examples/dialog/no-mask.vue?raw'
+</script>

package/docs/components/divider.md

@@ -0,0 +1,24 @@
+# Divider 分隔符
+
+用于分隔不同的内容区域。支持自定义文本、颜色、大小和样式等功能。
+
+## 基础用法
+
+<Demo :source-code="dividerBasicCode">
+  <template #source>
+    <divider-basic />
+  </template>
+  <template #description>
+    通过 `content` 属性添加文本，`contentPosition` 属性控制文本对齐方式。
+  </template>
+</Demo>
+
+## API
+
+<ApiTable :data="dividerApi" componentName="divider" />
+
+<script setup>
+import DividerBasic from '../examples/divider/basic.vue'
+import dividerApi from './meta/divider'
+import dividerBasicCode from '../examples/divider/basic.vue?raw'
+</script>

package/docs/components/drawer.md

@@ -0,0 +1,127 @@
+# Drawer 抽屉
+
+抽屉组件，从屏幕边缘滑出的浮层面板。
+
+## 基础用法
+
+最简单的用法。
+
+<Demo :source-code="drawerBasicCode">
+  <template #source>
+    <drawer-basic />
+  </template>
+  <template #description>
+    基础的抽屉，默认从右侧滑出。使用 `v-model:visible` 控制显示隐藏。
+  </template>
+</Demo>
+
+## 打开方向
+
+抽屉可以从四个方向打开。
+
+<Demo :source-code="drawerDirectionCode">
+  <template #source>
+    <drawer-direction />
+  </template>
+  <template #description>
+    通过 `direction` 属性可以设置抽屉的打开方向，支持 `rtl`（右到左）、`ltr`（左到右）、`ttb`（上到下）、`btt`（下到上）。
+  </template>
+</Demo>
+
+## 不同尺寸
+
+通过 `width` 和 `height` 属性可以设置抽屉的尺寸。
+
+<Demo :source-code="drawerSizeCode">
+  <template #source>
+    <drawer-size />
+  </template>
+  <template #description>
+    支持自定义抽屉的尺寸。左右打开时使用 `width` 属性（单位：像素），上下打开时使用 `height` 属性（单位：像素）。
+  </template>
+</Demo>
+
+## 自定义按钮
+
+通过 `buttons` 属性可以自定义底部按钮。
+
+<Demo :source-code="drawerCustomButtonsCode">
+  <template #source>
+    <drawer-custom-buttons />
+  </template>
+  <template #description>
+    使用 `buttons` 属性配置自定义按钮，支持设置按钮类型、样式、图标、点击事件等。
+  </template>
+</Demo>
+
+## 无底部按钮
+
+设置 `hasBtns` 为 `false` 可以隐藏底部按钮。
+
+<Demo :source-code="drawerNoButtonsCode">
+  <template #source>
+    <drawer-no-buttons />
+  </template>
+  <template #description>
+    适用于只展示信息，不需要操作按钮的场景。
+  </template>
+</Demo>
+
+## 遮罩层配置
+
+可以配置遮罩层的显示。
+
+<Demo :source-code="drawerMaskCode">
+  <template #source>
+    <drawer-mask />
+  </template>
+  <template #description>
+    设置 `mask` 为 `false` 可以取消遮罩层。
+  </template>
+</Demo>
+
+## API
+
+### 属性
+
+<ApiTable :data="drawerApi" componentName="drawer" />
+
+### 事件
+
+| 事件名            | 说明                         | 回调参数                                         |
+| ----------------- | ---------------------------- | ------------------------------------------------ |
+| update:visible    | 抽屉显示状态变化时触发       | `(visible: boolean)`                             |
+| update:stepActive | 步骤变化时触发               | `(stepActive: number)`                           |
+| cancel            | 点击取消按钮或关闭按钮时触发 | -                                                |
+| ok                | 点击确定按钮时触发           | `(showLoading: Function, hideLoading: Function)` |
+| closed            | 抽屉关闭动画结束后触发       | -                                                |
+
+### 插槽
+
+| 插槽名  | 说明         |
+| ------- | ------------ |
+| default | 抽屉内容区域 |
+
+### 方法
+
+| 方法名      | 说明         | 参数              |
+| ----------- | ------------ | ----------------- |
+| showLoading | 显示加载状态 | `(text?: string)` |
+| hideLoading | 隐藏加载状态 | -                 |
+
+<script setup>
+import DrawerBasic from '../examples/drawer/basic.vue'
+import DrawerDirection from '../examples/drawer/direction.vue'
+import DrawerSize from '../examples/drawer/size.vue'
+import DrawerCustomButtons from '../examples/drawer/custom-buttons.vue'
+import DrawerNoButtons from '../examples/drawer/no-buttons.vue'
+import DrawerMask from '../examples/drawer/mask.vue'
+import drawerApi from './meta/drawer'
+
+import drawerBasicCode from '../examples/drawer/basic.vue?raw'
+import drawerDirectionCode from '../examples/drawer/direction.vue?raw'
+import drawerSizeCode from '../examples/drawer/size.vue?raw'
+import drawerCustomButtonsCode from '../examples/drawer/custom-buttons.vue?raw'
+import drawerNoButtonsCode from '../examples/drawer/no-buttons.vue?raw'
+import drawerMaskCode from '../examples/drawer/mask.vue?raw'
+</script>