stellar-ui-plus 1.25.1 → 1.25.3

package/components/ste-search-box/README.md

@@ -4,7 +4,7 @@
 
 ---$
 
-### 基础用法
+## 基础用法
 
 ```html
 <script setup lang="ts">
@@ -21,7 +21,7 @@
 </template>
 ```
 
-#### 日期选择时间段
+## 日期选择时间段
 
 ```html
 <script setup lang="ts">
@@ -39,7 +39,7 @@
 </template>
 ```
 
-#### 输入框字体
+## 输入框字体
 
 ```html
 <script setup lang="ts">
@@ -58,8 +58,6 @@
 
 ---$
 
-### API
-
 <!-- props -->
 
 ---$

package/components/ste-search-box/ste-search-box.easycom.json

@@ -3,7 +3,6 @@
     "description": "搜索组件",
     "example": "<ste-search-box></ste-search-box>",
     "tutorial": "https://stellar-ui.intecloud.com.cn/?projectName=stellar-ui-plus&menu=%E7%BB%84%E4%BB%B6&active=ste-search-box",
-
     "attributes": [
         {
             "name": "value",
@@ -71,7 +70,6 @@
         {
             "name": "[event]search",
             "description": "确定搜索时触发",
-            "type": "(value: string) => void",
             "params": [
                 {
                     "name": "value",
@@ -80,4 +78,4 @@
             ]
         }
     ]
-}
+}

package/components/ste-select/ATTRIBUTES.md

@@ -1,4 +1,6 @@
-#### Props
+## API
+
+### Props
 | 属性名 | 说明  | 类型 | 默认值  | 可选值 | 支持版本 |
 | ----- | ----- | --- | ------- | ------ | -------- |
 | `modelValue` | 绑定的值，支持v-model双向绑定 | `number / string / Array<number / string>` | - | - | - |
@@ -30,11 +32,13 @@
 | `clearable` | 显示清楚按钮 | `boolean` | `false` | - | `1.16.17` |
 
 
-#### Events
+### Events
 | 事件名 | 说明  | 事件参数 | 支持版本 |
 | ----- | ----- | ------- | -------- |
 | `change` | 选择时触发 | `value`：选中的值或选中值列表<br/>`option`：选中的选项或选中项列表 | - |
-| `cancel` | 取消选择时触发 | - | - |
+| `cancel` | 取消选择时触发 | `data`：()=>void | - |
 | `confirm` | 确定选择时触发 | `value`：选中的值或选中值列表 | - |
-| `inputFilterable` | 搜索框输入数据时触发 | - | `1.16.16` |
-| `loadMore` | 上拉触底时触发 | - | `1.16.16` |
+| `inputFilterable` | 搜索框输入数据时触发 | `data`：(str:string)=>void | `1.16.16` |
+| `loadMore` | 上拉触底时触发 | `data`：()=>void | `1.16.16` |
+
+

package/components/ste-select/README.md

@@ -6,7 +6,7 @@
 
 ## 使用示例
 
-### 基础用法
+## 基础用法
 
 - 属性`list`接收一个数组，数组中的每一项为一个对象，对象中包含`label`和`value`两个属性，分别表示节点的显示文本和节点的值
     - 若`lable`和`value`属性字段名不同，可通过`labelKey`和`valueKey`属性进行设置
@@ -39,7 +39,7 @@
 </script>
 ```
 
-### 多选
+## 多选
 
 - 属性`multiple`设置为`true`时，可进行多选
 - 属性`value`接收一个数组，数组中的每一项表示一个选中的节点值
@@ -65,7 +65,7 @@
 </script>
 ```
 
-### 多列选择
+## 多列选择
 
 - 属性`list`可接收一个二维数组，数组中的每一项为一个对象，对象结构同上
 - 属性`value`接收一个数组，数组中的每一项表示一个选中的节点值
@@ -90,7 +90,7 @@
 </script>
 ```
 
-### 树形选择
+## 树形选择
 
 - 属性`list`可接收一个树形结构数组，数组中的每一项为一个对象，对象结构同上，`children`属性表示子节点
     - 若`children`属性字段名不同，可通过`childrenKey`属性进行设置
@@ -125,7 +125,7 @@
 </script>
 ```
 
-### 日期时间选择器
+## 日期时间选择器
 
 - 属性`mode`设置为`date`时，可进行日期选择
     - 设置为`time`时，可进行时间选择
@@ -148,7 +148,7 @@
 </template>
 ```
 
-### 搜索
+## 搜索
 
 - 属性`mode`设置为`filterable`时，可进行搜索（仅`list`为一维数组时有效）
 
@@ -171,7 +171,7 @@
 </script>
 ```
 
-### 创建条目
+## 创建条目
 
 - 属性`allowCreate`设置为`true`时，可进行创建条目（仅在`mode`属性为`filterable`时并且`list`为一维数组时生效）
 
@@ -195,7 +195,7 @@
 </script>
 ```
 
-### 远程搜索
+## 远程搜索
 
 - 当在`mode`属性为`filterable`时，属性`autoFilterable`设置为`false`时，则不会执行自动筛选，可通过`inputFilterable`监听输入执行远程搜索
 
@@ -273,7 +273,7 @@
 </script>
 ```
 
-### 分页
+## 分页
 
 - 事件`loadMore`可监听上拉触底（多列渲染无效）
 - 属性`total`控制每页显示条数
@@ -312,9 +312,9 @@
 
 ---$
 
-### API
+## API
 
-#### Props
+## Props
 
 背景之外的颜色属性只支持`16进制`、`RGB`、`RGBA`格式
 

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

@@ -249,7 +249,6 @@
         {
             "name": "[event]change",
             "description": "选择时触发",
-            "type": "(value: string | number,option: SelectOption | SelectOption[])=>void",
             "params": [
                 {
                     "name": "value",
@@ -264,12 +263,16 @@
         {
             "name": "[event]cancel",
             "description": "取消选择时触发",
-            "type": "()=>void"
+            "params": [
+                {
+                    "name": "data",
+                    "description": "()=>void"
+                }
+            ]
         },
         {
             "name": "[event]confirm",
             "description": "确定选择时触发",
-            "type": "(value: string | number | (string | number)[])=>void",
             "params": [
                 {
                     "name": "value",
@@ -281,13 +284,23 @@
             "name": "[event]inputFilterable",
             "description": "搜索框输入数据时触发",
             "version": "1.16.16",
-            "type": "(str:string)=>void"
+            "params": [
+                {
+                    "name": "data",
+                    "description": "(str:string)=>void"
+                }
+            ]
         },
         {
             "name": "[event]loadMore",
             "description": "上拉触底时触发",
             "version": "1.16.16",
-            "type": "()=>void"
+            "params": [
+                {
+                    "name": "data",
+                    "description": "()=>void"
+                }
+            ]
         }
     ]
-}
+}

package/components/ste-select-seat/ATTRIBUTES.md

@@ -1,4 +1,6 @@
-#### Props
+## API
+
+### Props
 | 属性名 | 说明  | 类型 | 默认值  | 可选值 | 支持版本 |
 | ----- | ----- | --- | ------- | ------ | -------- |
 | `modelValue` | 已选座位坐标列表（仅包含 row/col） | `SteSelectSeatValue[]` | - | - | - |
@@ -11,8 +13,10 @@
 | `seatGap` | 座位间距(rpx) | `number` | `8` | - | - |
 
 
-#### Events
+### Events
 | 事件名 | 说明  | 事件参数 | 支持版本 |
 | ----- | ----- | ------- | -------- |
-| `seat-click` | 点击有效座位事件（empty/disabled 不触发） | - | - |
-| `move` | 拖动/缩放事件 | - | - |
+| `seat-click` | 点击有效座位事件（empty/disabled 不触发） | `data`：(seat: SteSelectSeatItem) => void | - |
+| `move` | 拖动/缩放事件 | `data`：(data: { translateX, translateY, scale, screenTranslateX }) => void | - |
+
+

package/components/ste-select-seat/README.md

@@ -6,7 +6,7 @@
 
 ## 代码演示
 
-### 基础用法
+## 基础用法
 
 最简单的用法只需要传入行列数和画布尺寸。
 
@@ -23,7 +23,7 @@
 </script>
 ```
 
-### 自定义座位
+## 自定义座位
 
 通过 `seats` 可以覆盖指定坐标的座位属性，常见场景包括：
 
@@ -55,7 +55,7 @@
 </script>
 ```
 
-### 预选座位
+## 预选座位
 
 预选本质上就是给 `v-model` 初始值。这里的坐标只表示“已选状态”，不负责定义座位是否禁用、是否留空。
 
@@ -77,7 +77,7 @@
 </script>
 ```
 
-### 重置位置
+## 重置位置
 
 组件实例暴露了 `reset()`，用于把当前缩放和拖拽视口恢复到初始状态，不会清空已选座位。
 
@@ -100,7 +100,7 @@
 </script>
 ```
 
-### 电影院座位图
+## 电影院座位图
 
 复杂场景通常会同时用到以下能力：
 
@@ -221,31 +221,17 @@
 
 ---$
 
-## API
-
 <!-- props -->
 
-### 组件方法(Methods)
-
-通过组件实例 `ref` 可调用以下方法：
-
-| 方法名     | 说明                                             | 参数                                                           |
-| ---------- | ------------------------------------------------ | -------------------------------------------------------------- |
-| `setSeat`  | 设置指定座位属性，不直接控制选中状态             | `(row: number, col: number, data: Partial<SteSelectSeatItem>)` |
-| `getSeats` | 获取内部当前全量座位数据，包含自动补齐的普通座位 | -                                                              |
-| `reset`    | 重置当前缩放和拖拽位置，不清空 `modelValue`      | -                                                              |
-
-`setSeat()` 常用于接口返回后，动态更新某个座位的可售状态或颜色。
-
 ## 数据说明
 
-### 坐标约定
+## 坐标约定
 
 - 所有 `row`、`col` 均从 `0` 开始计数
 - `row: 0, col: 0` 表示第一行第一列
 - 页面展示给用户时，通常会自行转成 `row + 1`、`col + 1`
 
-### `modelValue` 与 `seats` 的区别
+## `modelValue` 与 `seats` 的区别
 
 - `modelValue` 只表示当前选中了哪些座位
 - `seats` 只表示这些座位是什么属性

package/components/ste-select-seat/ste-select-seat.easycom.json

@@ -51,12 +51,22 @@
         {
             "name": "[event]seat-click",
             "description": "点击有效座位事件（empty/disabled 不触发）",
-            "type": "(seat: SteSelectSeatItem) => void"
+            "params": [
+                {
+                    "name": "data",
+                    "description": "(seat: SteSelectSeatItem) => void"
+                }
+            ]
         },
         {
             "name": "[event]move",
             "description": "拖动/缩放事件",
-            "type": "(data: { translateX, translateY, scale, screenTranslateX }) => void"
+            "params": [
+                {
+                    "name": "data",
+                    "description": "(data: { translateX, translateY, scale, screenTranslateX }) => void"
+                }
+            ]
         }
     ]
-}
+}

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` | 默认插槽 | - | - |
+
+