@a2simcode/ui 0.0.46 → 0.0.47

package/docs/components/cascader-select.md

@@ -0,0 +1,114 @@
+# CascaderSelect 级联选择
+
+当选项具有层级关系时，使用级联选择器展示并选择内容。
+
+## 基础用法
+
+<Demo :source-code="cascaderSelectBasicCode">
+  <template #source>
+    <cascader-select-basic />
+  </template>
+  <template #description>
+    使用 v-model 实现双向数据绑定。
+  </template>
+</Demo>
+
+## 禁用和只读
+
+通过 `disabled` 和 `readonly` 属性指定级联选择器的状态。
+
+<Demo :source-code="cascaderSelectDisabledCode">
+  <template #source>
+    <cascader-select-disabled />
+  </template>
+  <template #description>
+    通过 disabled 属性指定是否禁用级联选择器，通过 readonly 属性指定是否只读。
+  </template>
+</Demo>
+
+## 可清除
+
+使用 `clearable` 属性即可得到一个可清除的级联选择器。
+
+<Demo :source-code="cascaderSelectClearableCode">
+  <template #source>
+    <cascader-select-clearable />
+  </template>
+  <template #description>
+    设置 `clearable` 属性为 `true` 即可显示清除按钮。
+  </template>
+</Demo>
+
+## 可搜索
+
+使用 `filterable` 属性即可启用搜索功能。
+
+<Demo :source-code="cascaderSelectFilterableCode">
+  <template #source>
+    <cascader-select-filterable />
+  </template>
+  <template #description>
+    设置 `filterable` 属性为 `true` 即可启用搜索功能。
+  </template>
+</Demo>
+
+## 多选
+
+使用 `multiple` 属性即可启用多选功能。
+
+<Demo :source-code="cascaderSelectMultipleCode">
+  <template #source>
+    <cascader-select-multiple />
+  </template>
+  <template #description>
+    设置 `multiple` 属性为 `true` 即可启用多选功能。
+  </template>
+</Demo>
+
+## 自定义插槽
+
+使用各个插槽来自定义级联选择器的内容。
+
+<Demo :source-code="cascaderSelectSlotCode">
+  <template #source>
+    <cascader-select-slot />
+  </template>
+  <template #description>
+    通过 `#default` 插槽自定义节点内容，通过 `#empty` 插槽自定义空状态。
+  </template>
+</Demo>
+
+## 方法调用
+
+通过模板引用访问组件的暴露方法。
+
+<Demo :source-code="cascaderSelectMethodsCode">
+  <template #source>
+    <cascader-select-methods />
+  </template>
+  <template #description>
+    使用 `getCheckedNodes()` 获取选中节点，使用 `clearCheckedNodes()` 清空选中节点。
+  </template>
+</Demo>
+
+## API
+
+<ApiTable :data="cascaderSelectApi" componentName="cascader-select" />
+
+<script setup>
+import CascaderSelectBasic from '../examples/cascader-select/basic.vue'
+import CascaderSelectDisabled from '../examples/cascader-select/disabled.vue'
+import CascaderSelectClearable from '../examples/cascader-select/clearable.vue'
+import CascaderSelectFilterable from '../examples/cascader-select/filterable.vue'
+import CascaderSelectMultiple from '../examples/cascader-select/multiple.vue'
+import CascaderSelectSlot from '../examples/cascader-select/slot.vue'
+import CascaderSelectMethods from '../examples/cascader-select/methods.vue'
+import cascaderSelectApi from './meta/cascader-select'
+import cascaderSelectBasicCode from '../examples/cascader-select/basic.vue?raw'
+import cascaderSelectDisabledCode from '../examples/cascader-select/disabled.vue?raw'
+import cascaderSelectClearableCode from '../examples/cascader-select/clearable.vue?raw'
+import cascaderSelectFilterableCode from '../examples/cascader-select/filterable.vue?raw'
+import cascaderSelectMultipleCode from '../examples/cascader-select/multiple.vue?raw'
+import cascaderSelectSlotCode from '../examples/cascader-select/slot.vue?raw'
+import cascaderSelectMethodsCode from '../examples/cascader-select/methods.vue?raw'
+</script>

package/docs/components/checkbox.md

@@ -0,0 +1,114 @@
+# Checkbox 复选框
+
+复选框组件，用于多项选择。
+
+## 基础用法
+
+<Demo :source-code="checkboxBasicCode">
+  <template #source>
+    <checkbox-basic />
+  </template>
+  <template #description>
+    使用 v-model 实现双向数据绑定。
+  </template>
+</Demo>
+
+## 不同尺寸
+
+Checkbox 组件提供三种尺寸。
+
+<Demo :source-code="checkboxSizeCode">
+  <template #source>
+    <checkbox-size />
+  </template>
+  <template #description>
+    使用 size 属性改变复选框大小。除了默认大小外，还有另外两个选项: large, small。
+  </template>
+</Demo>
+
+## 禁用
+
+通过 `disabled` 和 `readonly` 属性指定复选框的状态。
+
+<Demo :source-code="checkboxDisabledCode">
+  <template #source>
+    <checkbox-disabled />
+  </template>
+  <template #description>
+    通过 disabled 属性指定是否禁用 checkbox 组件，通过 readonly 属性指定是否只读。
+  </template>
+</Demo>
+
+## 最小/最大选择数量
+
+使用 `min` 和 `max` 属性限制可选择的最小和最大数量。
+
+<Demo :source-code="checkboxMinMaxCode">
+  <template #source>
+    <checkbox-min-max />
+  </template>
+  <template #description>
+    设置 `min` 属性为 1 和 `max` 属性为 2，限制选择数量。
+  </template>
+</Demo>
+
+## 按钮样式
+
+使用 `type="button"` 将复选框显示为按钮样式。
+
+<Demo :source-code="checkboxButtonCode">
+  <template #source>
+    <checkbox-button />
+  </template>
+  <template #description>
+    设置 `type` 属性为 `button` 即可显示为按钮样式。
+  </template>
+</Demo>
+
+## 自定义颜色
+
+使用 `text-color` 和 `fill` 属性自定义按钮样式的颜色。
+
+<Demo :source-code="checkboxColorCode">
+  <template #source>
+    <checkbox-color />
+  </template>
+  <template #description>
+    在按钮样式中，通过 `text-color` 指定文字颜色，通过 `fill` 指定背景和边框颜色。
+  </template>
+</Demo>
+
+## 组合示例
+
+展示复选框组件的多种属性组合使用。
+
+<Demo :source-code="checkboxMixedCode">
+  <template #source>
+    <checkbox-mixed />
+  </template>
+  <template #description>
+    展示按钮样式+颜色、最小/最大选择、部分禁用等多种功能的组合使用。
+  </template>
+</Demo>
+
+## API
+
+<ApiTable :data="checkboxApi" componentName="checkbox" />
+
+<script setup>
+import CheckboxBasic from '../examples/checkbox/basic.vue'
+import CheckboxSize from '../examples/checkbox/size.vue'
+import CheckboxDisabled from '../examples/checkbox/disabled.vue'
+import CheckboxMinMax from '../examples/checkbox/min-max.vue'
+import CheckboxButton from '../examples/checkbox/button.vue'
+import CheckboxColor from '../examples/checkbox/color.vue'
+import CheckboxMixed from '../examples/checkbox/mixed.vue'
+import checkboxApi from './meta/checkbox'
+import checkboxBasicCode from '../examples/checkbox/basic.vue?raw'
+import checkboxSizeCode from '../examples/checkbox/size.vue?raw'
+import checkboxDisabledCode from '../examples/checkbox/disabled.vue?raw'
+import checkboxMinMaxCode from '../examples/checkbox/min-max.vue?raw'
+import checkboxButtonCode from '../examples/checkbox/button.vue?raw'
+import checkboxColorCode from '../examples/checkbox/color.vue?raw'
+import checkboxMixedCode from '../examples/checkbox/mixed.vue?raw'
+</script>

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>