stellar-ui-plus 1.25.0 → 1.25.2

package/components/ste-signature/ATTRIBUTES.md

@@ -1,4 +1,6 @@
-#### Props
+## API
+
+### Props
 | 属性名 | 说明  | 类型 | 默认值  | 可选值 | 支持版本 |
 | ----- | ----- | --- | ------- | ------ | -------- |
 | `customClass` | 自定义class | `string` | - | - | - |
@@ -10,9 +12,20 @@
 | `height` | 高度 | `string / number` | `100%` | - | - |
 
 
-#### Events
+### Events
 | 事件名 | 说明  | 事件参数 | 支持版本 |
 | ----- | ----- | ------- | -------- |
-| `start` | 笔画开始时触发 | - | - |
-| `signing` | 画图中触发 | - | - |
-| `end` | 笔画结束时触发 | - | - |
+| `start` | 笔画开始时触发 | `data`：() => void | - |
+| `signing` | 画图中触发 | `data`：() => void | - |
+| `end` | 笔画结束时触发 | `data`：() => void | - |
+
+
+### Methods
+| 方法名 | 说明  | 参数 | 返回值 | 支持版本 |
+| ----- | ----- | --- | ------ | -------- |
+| `clear` | 清空画布 | - | - | - |
+| `back` | 回退 | - | - | - |
+| `save` | 保存为图片 | `成功回调函数`：(base64)=>void<br/>`失败回调函数`：(err)=>void | - | - |
+| `output` | 自定义输出 | `Options`：{orientation:string;success:(base64)=>void;fail:(err)=>void} | - | - |
+
+

package/components/ste-signature/README.md

@@ -4,9 +4,9 @@
 
 ---$
 
-### 代码演示
+## 代码演示
 
-#### 基础使用
+## 基础使用
 
 - `type` 签名保存图片类型，支持 `jpg` 和 `png`(默认) 两种格式。
     - 此处使用 `jpg` 格式。因为媒体预览背景是黑色，画笔颜色是黑色，`png`格式图片时预览看不见
@@ -70,7 +70,7 @@
 </style>
 ```
 
-#### 画笔颜色和线宽
+## 画笔颜色和线宽
 
 - 属性`strokeColor`可以自定义画笔颜色，默认`#000000`(黑色)
 - 属性`lineWidth`可以自定义画笔线宽，默认`3`
@@ -83,18 +83,7 @@
 
 ---$
 
-### API
-
 <!-- props -->
 
-#### 组件方法(Method)
-
-| 方法名   | 说明       | 方法参数                                                     | 支持版本 |
-| -------- | ---------- | ------------------------------------------------------------ | -------- |
-| `clear`  | 清空画布   | -                                                            | -        |
-| `back`   | 回退       | -                                                            | -        |
-| `save`   | 保存为图片 | (base64)=>void,(err)=>void                                   | -        |
-| `output` | 自定义输出 | {orientation:string;success:(base64)=>void;fail:(err)=>void} | `1.24.6` |
-
 ---$
 {{xuyajun}}

package/components/ste-signature/ste-signature.easycom.json

@@ -58,17 +58,64 @@
         {
             "name": "[event]start",
             "description": "笔画开始时触发",
-            "type": "() => void"
+            "params": [
+                {
+                    "name": "data",
+                    "description": "() => void"
+                }
+            ]
         },
         {
             "name": "[event]signing",
             "description": "画图中触发",
-            "type": "() => void"
+            "params": [
+                {
+                    "name": "data",
+                    "description": "() => void"
+                }
+            ]
         },
         {
             "name": "[event]end",
             "description": "笔画结束时触发",
-            "type": "() => void"
+            "params": [
+                {
+                    "name": "data",
+                    "description": "() => void"
+                }
+            ]
+        },
+        {
+            "name": "[method]clear",
+            "description": "清空画布"
+        },
+        {
+            "name": "[method]back",
+            "description": "回退"
+        },
+        {
+            "name": "[method]save",
+            "description": "保存为图片",
+            "params": [
+                {
+                    "name": "成功回调函数",
+                    "description": "(base64)=>void"
+                },
+                {
+                    "name": "失败回调函数",
+                    "description": "(err)=>void"
+                }
+            ]
+        },
+        {
+            "name": "[method]output",
+            "description": "自定义输出",
+            "params": [
+                {
+                    "name": "Options",
+                    "description": "{orientation:string;success:(base64)=>void;fail:(err)=>void}"
+                }
+            ]
         }
     ]
 }

package/components/ste-simple-calendar/ATTRIBUTES.md

@@ -1,4 +1,6 @@
-#### Props
+## API
+
+### Props
 | 属性名 | 说明  | 类型 | 默认值  | 可选值 | 支持版本 |
 | ----- | ----- | --- | ------- | ------ | -------- |
 | `date` | 展示的日期 | `string / number / Date` | `Date.now()` | - | - |
@@ -10,8 +12,18 @@
 | `customClass` | 自定义根节点 class | `string` | `` | - | - |
 
 
-#### Events
+### Events
 | 事件名 | 说明  | 事件参数 | 支持版本 |
 | ----- | ----- | ------- | -------- |
-| `click` | 点击组件时触发 | - | - |
-| `date-change` | 当 date 属性变化时触发 | - | - |
+| `click` | 点击组件时触发 | `data`：(dateInfo: DateInfo) => void | - |
+| `date-change` | 当 date 属性变化时触发 | `data`：(dateInfo: DateInfo) => void | - |
+
+
+### Methods
+| 方法名 | 说明  | 参数 | 返回值 | 支持版本 |
+| ----- | ----- | --- | ------ | -------- |
+| `setDate` | 设置当前展示日期 | `data`：number / string / Date | - | - |
+| `getDateInfo` | 获取当前日期信息 | - | - | - |
+| `today` | 重置为今天 | - | - | - |
+
+

package/components/ste-simple-calendar/README.md

@@ -4,9 +4,9 @@
 
 ---$
 
-### 代码演示
+## 代码演示
 
-#### 基础使用
+## 基础使用
 
 默认展示当前日期，点击组件后会弹出日历进行选择。
 
@@ -16,7 +16,7 @@
 </template>
 ```
 
-#### 指定日期
+## 指定日期
 
 通过`date`属性设置展示日期，支持时间戳、日期字符串和`Date`对象。
 
@@ -26,7 +26,7 @@
 </template>
 ```
 
-#### 禁用日历弹窗
+## 禁用日历弹窗
 
 - 通过`showCalendar`属性可以关闭内置日历弹窗
 - 关闭后可结合`click`事件自行处理点击逻辑
@@ -43,7 +43,7 @@
 </template>
 ```
 
-#### 自定义年月格式
+## 自定义年月格式
 
 通过`formatter`属性设置年月展示格式，格式规则与`dayjs`一致。
 
@@ -53,7 +53,7 @@
 </template>
 ```
 
-#### 自定义星期文案
+## 自定义星期文案
 
 通过`weekTexts`属性设置星期显示内容。
 
@@ -63,7 +63,7 @@
 </template>
 ```
 
-#### 自定义颜色
+## 自定义颜色
 
 通过`color`属性统一设置日期、星期和年月文字颜色。
 
@@ -73,7 +73,7 @@
 </template>
 ```
 
-#### 调用实例方法
+## 调用实例方法
 
 通过`ref`可以调用组件暴露的方法，例如重置为今天。
 
@@ -96,17 +96,7 @@
 
 ---$
 
-### API
-
 <!-- props -->
 
-#### Methods
-
-| 方法名        | 说明             | 方法参数                   | 支持版本 |
-| ------------- | ---------------- | -------------------------- | -------- |
-| `setDate`     | 设置当前展示日期 | `string \| number \| Date` | -        |
-| `getDateInfo` | 获取当前日期信息 | -                          | -        |
-| `today`       | 重置为今天       | -                          | -        |
-
 ---$
 {{fuyuwei}}

package/components/ste-simple-calendar/ste-simple-calendar.easycom.json

@@ -49,12 +49,40 @@
         {
             "name": "[event]click",
             "description": "点击组件时触发",
-            "type": "(dateInfo: DateInfo) => void"
+            "params": [
+                {
+                    "name": "data",
+                    "description": "(dateInfo: DateInfo) => void"
+                }
+            ]
         },
         {
             "name": "[event]date-change",
             "description": "当 date 属性变化时触发",
-            "type": "(dateInfo: DateInfo) => void"
+            "params": [
+                {
+                    "name": "data",
+                    "description": "(dateInfo: DateInfo) => void"
+                }
+            ]
+        },
+        {
+            "name": "[method]setDate",
+            "description": "设置当前展示日期",
+            "params": [
+                {
+                    "name": "data",
+                    "description": "number / string / Date"
+                }
+            ]
+        },
+        {
+            "name": "[method]getDateInfo",
+            "description": "获取当前日期信息"
+        },
+        {
+            "name": "[method]today",
+            "description": "重置为今天"
         }
     ]
 }

package/components/ste-skeleton/ATTRIBUTES.md

@@ -1,7 +1,15 @@
-#### Props
+## API
+
+### Props
 | 属性名 | 说明  | 类型 | 默认值  | 可选值 | 支持版本 |
 | ----- | ----- | --- | ------- | ------ | -------- |
 | `loading` | 是否显示骨架图 | `boolean` | `true` | - | - |
 | `type` | 骨架图类型 | `string` | `text` | `text`：文本<br/>`image`：图片<br/>`circle`：圆形<br/>`button`：按钮 | - |
 
 
+### Slots
+| 插槽名 | 说明  | 参数 | 支持版本 |
+| ----- | ----- | --- | -------- |
+| `default` | 默认插槽 | - | - |
+
+

package/components/ste-skeleton/README.md

@@ -4,7 +4,7 @@
 
 ---$
 
-### 代码演示
+## 代码演示
 
 JavaScript后面的演示代码中涉及到的变量和方法都使用本`javascript`代码
 
@@ -19,11 +19,11 @@ onMounted(() => {
 });
 ```
 
-#### 骨架类型
+## 骨架类型
 
 通过`type`属性，设置骨架图类型
 
-##### 基础文本骨架
+###### 基础文本骨架
 
 最简单的文本内容骨架图用法
 
@@ -41,7 +41,7 @@ onMounted(() => {
 </template>
 ```
 
-##### 图片骨架
+###### 图片骨架
 
 适用于矩形图片的骨架展示：
 
@@ -53,7 +53,7 @@ onMounted(() => {
 </template>
 ```
 
-##### 圆形头像骨架
+###### 圆形头像骨架
 
 适用于圆形头像或图标的骨架展示：
 
@@ -67,16 +67,8 @@ onMounted(() => {
 
 ---$
 
-### API
-
 <!-- props -->
 
-#### 组件插槽(Slots)
-
-| 名称    | 说明     | 支持版本 |
-| ------- | -------- | -------- |
-| default | 默认插槽 | -        |
-
 ---$
 
 {{qinpengfei}}

package/components/ste-skeleton/ste-skeleton.easycom.json

@@ -33,6 +33,10 @@
                 }
             ],
             "default": "text"
+        },
+        {
+            "name": "[slot]default",
+            "description": "默认插槽"
         }
     ]
 }

package/components/ste-slide-verify/ATTRIBUTES.md

@@ -1,4 +1,6 @@
-#### Props
+## API
+
+### Props
 | 属性名 | 说明  | 类型 | 默认值  | 可选值 | 支持版本 |
 | ----- | ----- | --- | ------- | ------ | -------- |
 | `modelValue` | 验证状态（支持 v-model 双向绑定） | `Boolean` | `false` | - | - |
@@ -19,9 +21,18 @@
 | `failColor` | 失败态颜色 | `String` | `#ee0a24` | - | - |
 
 
-#### Events
+### Events
 | 事件名 | 说明  | 事件参数 | 支持版本 |
 | ----- | ----- | ------- | -------- |
-| `change` | 拖动过程中实时触发 | - | - |
-| `success` | 验证成功时触发 | - | - |
-| `fail` | 验证失败时触发 | - | - |
+| `change` | 拖动过程中实时触发 | `data`：(detail) => void | - |
+| `success` | 验证成功时触发 | `data`：(detail) => void | - |
+| `fail` | 验证失败时触发 | `data`：(detail) => void | - |
+
+
+### Methods
+| 方法名 | 说明  | 参数 | 返回值 | 支持版本 |
+| ----- | ----- | --- | ------ | -------- |
+| `init` | 重新计算轨道宽度并同步状态 | - | - | - |
+| `reset` | 重置验证状态 | - | - | - |
+
+

package/components/ste-slide-verify/README.md

@@ -4,9 +4,9 @@
 
 ---$
 
-### 代码演示
+## 代码演示
 
-#### 基础用法
+## 基础用法
 
 ```html
 <script setup lang="ts">
@@ -19,7 +19,7 @@
 </template>
 ```
 
-#### 没有错误提示
+## 没有错误提示
 
 ```html
 <script setup lang="ts">
@@ -32,7 +32,7 @@
 </template>
 ```
 
-#### 转动图片
+## 转动图片
 
 ```html
 <script setup lang="ts">
@@ -45,7 +45,7 @@
 </template>
 ```
 
-#### 禁用状态
+## 禁用状态
 
 ```html
 <template>
@@ -53,7 +53,7 @@
 </template>
 ```
 
-#### 失败态停留更久
+## 失败态停留更久
 
 ```html
 <script setup lang="ts">
@@ -66,7 +66,7 @@
 </template>
 ```
 
-#### 尺寸、颜色与文案
+## 尺寸、颜色与文案
 
 ```html
 <script setup lang="ts">
@@ -91,17 +91,8 @@
 
 ---$
 
-### API
-
 <!-- props -->
 
-#### Methods
-
-| 方法名  | 说明                       | 参数 |
-| ------- | -------------------------- | ---- |
-| `init`  | 重新计算轨道宽度并同步状态 | -    |
-| `reset` | 重置验证状态               | -    |
-
 `detail` 数据结构：
 
 ```ts

package/components/ste-slide-verify/ste-slide-verify.easycom.json

@@ -103,17 +103,40 @@
         {
             "name": "[event]change",
             "description": "拖动过程中实时触发",
-            "type": "(detail) => void"
+            "params": [
+                {
+                    "name": "data",
+                    "description": "(detail) => void"
+                }
+            ]
         },
         {
             "name": "[event]success",
             "description": "验证成功时触发",
-            "type": "(detail) => void"
+            "params": [
+                {
+                    "name": "data",
+                    "description": "(detail) => void"
+                }
+            ]
         },
         {
             "name": "[event]fail",
             "description": "验证失败时触发",
-            "type": "(detail) => void"
+            "params": [
+                {
+                    "name": "data",
+                    "description": "(detail) => void"
+                }
+            ]
+        },
+        {
+            "name": "[method]init",
+            "description": "重新计算轨道宽度并同步状态"
+        },
+        {
+            "name": "[method]reset",
+            "description": "重置验证状态"
         }
     ]
 }

package/components/ste-slider/ATTRIBUTES.md

@@ -1,4 +1,6 @@
-#### Props
+## API
+
+### Props
 | 属性名 | 说明  | 类型 | 默认值  | 可选值 | 支持版本 |
 | ----- | ----- | --- | ------- | ------ | -------- |
 | `value` | 滑块选择值，在双滑块模式下为数组格式（数组的值都是从小到大） | `number / string / array` | - | - | - |
@@ -16,10 +18,20 @@
 | `marks` | 标记，key 的类型必须为 number 且取值在闭区间 [min, max] 内，每个标记可以单独设置样式 | `object` | - | - | - |
 
 
-#### Events
+### Events
 | 事件名 | 说明  | 事件参数 | 支持版本 |
 | ----- | ----- | ------- | -------- |
 | `change` | 进度变化且结束拖动后触发 | `percentage`：当前滑块值 | - |
 | `dragStart` | 开始拖动时触发 | `e`：拖动事件 | - |
 | `dragEnd` | 结束拖动时触发 | `e`：拖动事件 | - |
 | `input` | 进度变化时实时触发 | `percentage`：进度百分比 | - |
+
+
+### Slots
+| 插槽名 | 说明  | 参数 | 支持版本 |
+| ----- | ----- | --- | -------- |
+| `button` | 自定义滑块按钮 | - | - |
+| `leftButton` | 自定义左侧滑块按钮（范围选择下） | - | - |
+| `rightButton` | 自定义右侧滑块按钮（范围选择下） | - | - |
+
+

package/components/ste-slider/README.md

@@ -1,12 +1,13 @@
 # Slider 滑块
 
 该组件一般用于表单中，手动选择一个区间范围的场景
+注意：在弹窗等初始隐藏的场景中使用时，组件显示后需通过 v-if 重新加载以计算宽度。
 
 ---$
 
-### 代码演示
+## 代码演示
 
-#### 基础使用
+## 基础使用
 
 ```html
 <template>
@@ -14,7 +15,7 @@
 </template>
 ```
 
-#### 滑块条高度 & 滑块大小
+## 滑块条高度 & 滑块大小
 
 ```html
 <template>
@@ -23,7 +24,7 @@
 </template>
 ```
 
-#### 进度条颜色
+## 进度条颜色
 
 ```html
 <template>
@@ -31,7 +32,7 @@
 </template>
 ```
 
-#### 范围选择
+## 范围选择
 
 ```html
 <template>
@@ -39,7 +40,7 @@
 </template>
 ```
 
-#### 竖向
+## 竖向
 
 ```html
 <template>
@@ -47,7 +48,7 @@
 </template>
 ```
 
-#### 禁用
+## 禁用
 
 ```html
 <template>
@@ -55,7 +56,7 @@
 </template>
 ```
 
-#### 只读
+## 只读
 
 ```html
 <template>
@@ -63,7 +64,7 @@
 </template>
 ```
 
-#### 间断点
+## 间断点
 
 当`showStops`为`true`时，会根据最大值(`max`)、最小值(`min`)、步长(`step`)来显示间断点
 
@@ -73,7 +74,7 @@
 </template>
 ```
 
-#### 标记
+## 标记
 
 当同时配置了`showStops`属性和`marks`属性时，会显示自定义节点
 
@@ -97,7 +98,7 @@
 </template>
 ```
 
-#### 自定义滑块
+## 自定义滑块
 
 ```html
 <template>
@@ -152,17 +153,7 @@
 
 ---$
 
-### API
-
 <!-- props -->
 
-#### 组件插槽(Slots)
-
-| 插槽名        | 说明                             | 插槽参数 | 支持版本 |
-| ------------- | -------------------------------- | -------- | -------- |
-| `button`      | 自定义滑块按钮                   | -        | -        |
-| `leftButton`  | 自定义左侧滑块按钮（范围选择下） | -        | -        |
-| `rightButton` | 自定义右侧滑块按钮（范围选择下） | -        | -        |
-
 ---$  
 {{fuyuwei}}