stellar-ui-plus 1.25.0 → 1.25.2

package/components/ste-scroll-to/ATTRIBUTES.md

@@ -1,11 +1,15 @@
-#### Props
+## API
+
+### Props
 | 属性名 | 说明  | 类型 | 默认值  | 可选值 | 支持版本 |
 | ----- | ----- | --- | ------- | ------ | -------- |
 | `active` | 当前激活的节点 | `number` | `0` | - | - |
 | `height` | 滚动区域高度 | `number / string` | `100%` | - | - |
 
 
-#### Events
+### Events
 | 事件名 | 说明  | 事件参数 | 支持版本 |
 | ----- | ----- | ------- | -------- |
-| `change` | 激活节点改变时触发 | - | - |
+| `change` | 激活节点改变时触发 | `data`：(index:number)=>void | - |
+
+

package/components/ste-scroll-to/README.md

@@ -4,7 +4,7 @@
 
 ---$
 
-#### 基础用法
+## 基础用法
 
 ```html
 <script setup lang="ts">
@@ -35,11 +35,9 @@
 
 ---$
 
-### API
-
 <!-- props -->
 
-#### ScrollTo Method
+## ScrollTo Method
 
 | 方法名 | 说明                               | 支持版本 |
 | ------ | ---------------------------------- | -------- |

package/components/ste-scroll-to/ste-scroll-to.easycom.json

@@ -19,7 +19,12 @@
         {
             "name": "[event]change",
             "description": "激活节点改变时触发",
-            "type": "(index:number)=>void"
+            "params": [
+                {
+                    "name": "data",
+                    "description": "(index:number)=>void"
+                }
+            ]
         }
     ]
-}
+}

package/components/ste-search/ATTRIBUTES.md

@@ -1,4 +1,6 @@
-#### Props
+## API
+
+### Props
 | 属性名 | 说明  | 类型 | 默认值  | 可选值 | 支持版本 |
 | ----- | ----- | --- | ------- | ------ | -------- |
 | `type` | 组件类型 | `string` | `default` | `default`：正常搜索<br/>`nav`：导航栏 | - |
@@ -28,13 +30,22 @@
 | `suggestionsList` | 搜索建议对应的数据 | `array` | `[]` | - | - |
 
 
-#### Events
+### Events
 | 事件名 | 说明  | 事件参数 | 支持版本 |
 | ----- | ----- | ------- | -------- |
 | `input` | 输入事件 | `value`：输入框的值 | - |
 | `focus` | 聚焦焦点事件 | `value`：输入框的值 | - |
 | `blur` | 失去焦点事件 | `value`：输入框的值 | - |
 | `search` | 确定搜索时触发 | `value`：输入框的值 | - |
-| `clear` | 点击清除按钮后触发 | - | - |
+| `clear` | 点击清除按钮后触发 | `data`：() => void | - |
 | `click` | 点击事件 | `value`：输入框的值 | - |
 | `selectSuggestion` | 点击搜索建议触发 | `item`：热词列表对象 | - |
+
+
+### Slots
+| 插槽名 | 说明  | 参数 | 支持版本 |
+| ----- | ----- | --- | -------- |
+| `prefix` | 输入框前插槽 | - | - |
+| `suffix` | 输入框后插槽 | - | - |
+
+

package/components/ste-search/README.md

@@ -4,7 +4,7 @@
 
 ---$
 
-### 代码演示
+## 代码演示
 
 **JavaScript**
 
@@ -37,7 +37,7 @@ const onClick = (v: string) => {
 </script>
 ```
 
-#### 基础用法
+## 基础用法
 
 - 通过`input`事件可以捕获用户输入行为，参数为输入的value内容
 - 通过`search`事件可以捕获用户点击`搜索按钮`或`软键盘上的回车`行为，参数为输入的value内容
@@ -71,7 +71,7 @@ const onClick = (v: string) => {
 </template>
 ```
 
-#### 搜索建议
+## 搜索建议
 
 - 给`suggestionsList`属性赋值时，会在输入框下方显示，数据结构见下方示例
 - 点击某条建议后会触发搜索的`selectSuggestion`事件，参数为搜索建议对象
@@ -114,7 +114,7 @@ const onClick = (v: string) => {
 </script>
 ```
 
-#### 热词列表
+## 热词列表
 
 - 可以通过`hotWords`属性传入热词列表
 - 可以通过`interval`属性设置热词切换间隔，单位为毫秒
@@ -144,7 +144,7 @@ const onClick = (v: string) => {
 </template>
 ```
 
-#### 自定义按钮文本内容
+## 自定义按钮文本内容
 
 - 可以通过`btnText`属性自定义按钮文本内容
 
@@ -162,7 +162,7 @@ const onClick = (v: string) => {
 </template>
 ```
 
-#### 隐藏分割线以及按钮
+## 隐藏分割线以及按钮
 
 - 可以通过`hiddenLine`属性隐藏分割线
 - 可以通过`hiddenBtn`属性隐藏按钮，隐藏按钮时也会隐藏分割线
@@ -182,7 +182,7 @@ const onClick = (v: string) => {
 </template>
 ```
 
-#### 隐藏输入框以及按钮
+## 隐藏输入框以及按钮
 
 - 可以通过设置`hiddenInput`属性隐藏输入框 和 `hiddenBtn`属性隐藏按钮只保留放大镜的功能
 
@@ -202,7 +202,7 @@ const onClick = (v: string) => {
 </template>
 ```
 
-#### 不显示清除图标
+## 不显示清除图标
 
 - 可以通过`clearable`属性来切换清除图标是否显示
 
@@ -220,7 +220,7 @@ const onClick = (v: string) => {
 </template>
 ```
 
-#### 颜色和背景
+## 颜色和背景
 
 - 可以通过`borderColor`属性设置边框颜色
 - 可以通过`background`属性设置背景颜色或者背景图片
@@ -284,7 +284,7 @@ const onClick = (v: string) => {
 </template>
 ```
 
-#### 自定义高度以及圆角弧度
+## 自定义高度以及圆角弧度
 
 - 可以通过`height`属性设置搜索框高度，默认值`64`
 - 可以通过`radius`属性设置圆角弧度，默认值`32`
@@ -303,7 +303,7 @@ const onClick = (v: string) => {
 </template>
 ```
 
-#### 导航模式
+## 导航模式
 
 - 可以通过`type`属性设置`nav`开启导航模式；开启后，点击搜索框任意区域都会触发`click`事件，其他功能失效。
 
@@ -324,7 +324,7 @@ const onClick = (v: string) => {
 </template>
 ```
 
-#### 聚焦
+## 聚焦
 
 - 可以通过`fous`属性控制搜索框聚焦，双向绑定
 
@@ -351,16 +351,7 @@ const onClick = (v: string) => {
 
 ---$
 
-### API
-
 <!-- props -->
 
-#### 组件插槽(Slots)
-
-| 插槽名   | 说明         | 插槽参数 | 支持版本 |
-| -------- | ------------ | -------- | -------- |
-| `prefix` | 输入框前插槽 | -        | -        |
-| `suffix` | 输入框后插槽 | -        | -        |
-
 ---$
 {{xuyajun}}

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

@@ -167,7 +167,6 @@
         {
             "name": "[event]input",
             "description": "输入事件",
-            "type": "(value: string) => void",
             "params": [
                 {
                     "name": "value",
@@ -178,7 +177,6 @@
         {
             "name": "[event]focus",
             "description": "聚焦焦点事件",
-            "type": "(value: string) => void",
             "params": [
                 {
                     "name": "value",
@@ -189,7 +187,6 @@
         {
             "name": "[event]blur",
             "description": "失去焦点事件",
-            "type": "(value: string) => void",
             "params": [
                 {
                     "name": "value",
@@ -200,7 +197,6 @@
         {
             "name": "[event]search",
             "description": "确定搜索时触发",
-            "type": "(value: string) => void",
             "params": [
                 {
                     "name": "value",
@@ -211,12 +207,16 @@
         {
             "name": "[event]clear",
             "description": "点击清除按钮后触发",
-            "type": "() => void"
+            "params": [
+                {
+                    "name": "data",
+                    "description": "() => void"
+                }
+            ]
         },
         {
             "name": "[event]click",
             "description": "点击事件",
-            "type": "(value: string) => void",
             "params": [
                 {
                     "name": "value",
@@ -227,13 +227,20 @@
         {
             "name": "[event]selectSuggestion",
             "description": "点击搜索建议触发",
-            "type": "(item: object) => void",
             "params": [
                 {
                     "name": "item",
                     "description": "热词列表对象"
                 }
             ]
+        },
+        {
+            "name": "[slot]prefix",
+            "description": "输入框前插槽"
+        },
+        {
+            "name": "[slot]suffix",
+            "description": "输入框后插槽"
         }
     ]
 }

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

@@ -1,4 +1,6 @@
-#### Props
+## API
+
+### Props
 | 属性名 | 说明  | 类型 | 默认值  | 可选值 | 支持版本 |
 | ----- | ----- | --- | ------- | ------ | -------- |
 | `value` | 当前值（支持v-model双向绑定） | `string / number` | `` | - | - |
@@ -12,7 +14,9 @@
 | `confirmType` | 确认按钮类型 | `string` | `done` | - | - |
 
 
-#### Events
+### Events
 | 事件名 | 说明  | 事件参数 | 支持版本 |
 | ----- | ----- | ------- | -------- |
 | `search` | 确定搜索时触发 | `value`：输入框的值 | - |
+
+

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"
+                }
+            ]
         }
     ]
-}
+}