stellar-ui-plus 1.25.0 → 1.25.2

package/components/ste-swiper/README.md

@@ -10,9 +10,9 @@
 
 ---$
 
-### 代码演示
+## 代码演示
 
-#### 基础用法
+## 基础用法
 
 - 外层使用`ste-swiper`父标签包裹
     - 默认是水平滚动，宽度必须固定，可以通过`width`属性设置（默认为`100%`，也可以设置父标签宽度）
@@ -44,7 +44,7 @@
 </template>
 ```
 
-#### 纵向轮播
+## 纵向轮播
 
 - `ste-swiper`父标签
     - `direction` 属性是设置滚动方向，默认是水平滚动，可选值`horizontal`、`vertical`
@@ -68,7 +68,7 @@
 </script>
 ```
 
-#### 首尾衔接轮播
+## 首尾衔接轮播
 
 - `ste-swiper`父标签
     - `circular` 属性是设置是否首尾相接，默认是`false`，可选值`true`
@@ -91,7 +91,7 @@
 </script>
 ```
 
-#### 自动轮播
+## 自动轮播
 
 - `ste-swiper`父标签
     - `autoplay` 属性是设置是否自动轮播，默认是`false`，可选值`true`
@@ -115,7 +115,7 @@
 </script>
 ```
 
-#### 显示指示器
+## 显示指示器
 
 - `ste-swiper`父标签
     - `indicatorDots` 属性是设置是否显示指示器，默认是`false`，可选值`true`
@@ -138,7 +138,7 @@
 </script>
 ```
 
-#### 指示器颜色
+## 指示器颜色
 
 - `ste-swiper`父标签
     - `indicatorColor` 属性是设置指示器的颜色，默认是`#00000`
@@ -162,7 +162,7 @@
 </script>
 ```
 
-#### 显示前后页部分
+## 显示前后页部分
 
 - `ste-swiper`父标签
     - `previousMargin` 属性是设置前边距，默认是`0`，单位是`rpx`
@@ -186,7 +186,7 @@
 </script>
 ```
 
-#### 突出显示
+## 突出显示
 
 需要搭配 `perviousMargin` 和 `nextMargin`属性给内容前后留出空间
 `highlightActive` 为 `true` 可突出显示当前内容（横向滑动时有效）
@@ -211,23 +211,21 @@
 
 ---$
 
-### API
-
 <!-- props -->
 
-#### Swiper Slot
+## Swiper Slot
 
 | 插槽名    | 说明                                      | 插槽参数 | 支持版本 |
 | --------- | ----------------------------------------- | -------- | -------- |
 | `default` | 默认插槽，请传入`ste-swiper-item`标签列表 | -        | -        |
 
-#### Swiper Method
+## Swiper Method
 
 | 方法名 | 说明                             | 支持版本 |
 | ------ | -------------------------------- | -------- |
 | `init` | 初始化轮播信息，在渲染完成后调用 | -        |
 
-#### SwiperItem Slot
+## SwiperItem Slot
 
 | 插槽名    | 说明                                         | 插槽参数 | 支持版本 |
 | --------- | -------------------------------------------- | -------- | -------- |

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

@@ -114,7 +114,6 @@
         {
             "name": "[event]change",
             "description": "监听item切换",
-            "type": "(index:number,source:'autoplay'| 'touch')=>void",
             "params": [
                 {
                     "name": "index",
@@ -129,7 +128,6 @@
         {
             "name": "[event]error",
             "description": "错误监听",
-            "type": "(error: Error, context: string)=>void",
             "params": [
                 {
                     "name": "error",
@@ -142,4 +140,4 @@
             ]
         }
     ]
-}
+}

package/components/ste-switch/ATTRIBUTES.md

@@ -1,4 +1,6 @@
-#### Props
+## API
+
+### Props
 | 属性名 | 说明  | 类型 | 默认值  | 可选值 | 支持版本 |
 | ----- | ----- | --- | ------- | ------ | -------- |
 | `modelValue` | 开关状态（支持v-model双向绑定） | `Boolean` | `false` | - | - |
@@ -10,8 +12,10 @@
 | `loading` | 加载中 | `Boolean` | `false` | - | - |
 
 
-#### Events
+### Events
 | 事件名 | 说明  | 事件参数 | 支持版本 |
 | ----- | ----- | ------- | -------- |
-| `click` | 点击开关时触发的事件（可拦截change事件）`value`：改变后的绑定值,`allowStop`：允许阻止后续的事件触发,：`resolve`：后续的事件执行 | - | - |
-| `change` | 当绑定值变化时触发的事件 | - | - |
+| `click` | 点击开关时触发的事件（可拦截change事件）`value`：改变后的绑定值,`allowStop`：允许阻止后续的事件触发,：`resolve`：后续的事件执行 | `data`：() => void | - |
+| `change` | 当绑定值变化时触发的事件 | `data`：() => void | - |
+
+

package/components/ste-switch/README.md

@@ -4,9 +4,9 @@
 
 ---$
 
-### 代码演示
+## 代码演示
 
-#### 基础用法
+## 基础用法
 
 通过`value`属性，双向绑定，绑定开关的选中状态，`true` 表示开，`false` 表示关。
 
@@ -20,7 +20,7 @@
 </template>
 ```
 
-#### 只读
+## 只读
 
 通过`readonly `属性，设置只读，不可切换，样式不置灰 默认`false`。
 
@@ -34,7 +34,7 @@
 </template>
 ```
 
-#### 禁用
+## 禁用
 
 通过`disabled`属性，设置禁用，不可切换，样式置灰，默认`false`。
 
@@ -48,7 +48,7 @@
 </template>
 ```
 
-#### 自定义大小
+## 自定义大小
 
 通过 `size` 属性自定义开关的大小，默认`52`。
 
@@ -62,7 +62,7 @@
 </template>
 ```
 
-#### 自定义颜色
+## 自定义颜色
 
 通过 `activeColor` 属性自定义开关的激活颜色，默认`#0090FF`。
 通过 `inactiveColor` 属性自定义开关的激活颜色，默认`#bbbbbb`。
@@ -77,7 +77,7 @@
 </template>
 ```
 
-#### 加载状态
+## 加载状态
 
 通过 `loading` 属性设置开关为加载状态，加载状态下开关不可点击，默认`false`。
 
@@ -95,8 +95,6 @@
 
 ---$
 
-### API
-
 <!-- props -->
 
 ---$

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

@@ -49,12 +49,22 @@
         {
             "name": "[event]click",
             "description": "点击开关时触发的事件（可拦截change事件）`value`：改变后的绑定值,`allowStop`：允许阻止后续的事件触发,：`resolve`：后续的事件执行",
-            "type": "() => void"
+            "params": [
+                {
+                    "name": "data",
+                    "description": "() => void"
+                }
+            ]
         },
         {
             "name": "[event]change",
             "description": "当绑定值变化时触发的事件",
-            "type": "() => void"
+            "params": [
+                {
+                    "name": "data",
+                    "description": "() => void"
+                }
+            ]
         }
     ]
-}
+}

package/components/ste-tab/ATTRIBUTES.md

@@ -1,4 +1,6 @@
-#### Props
+## API
+
+### Props
 | 属性名 | 说明  | 类型 | 默认值  | 可选值 | 支持版本 |
 | ----- | ----- | --- | ------- | ------ | -------- |
 | `title` | 当前标签标题 | `string` | - | - | - |

package/components/ste-table/ATTRIBUTES.md

@@ -1,4 +1,6 @@
-#### Props
+## API
+
+### Props
 | 属性名 | 说明  | 类型 | 默认值  | 可选值 | 支持版本 |
 | ----- | ----- | --- | ------- | ------ | -------- |
 | `data` | 表格数据 | `array` | `[]` | - | - |
@@ -32,12 +34,14 @@
 | `popoverLine` | 单元格开启isPopover时，超过多少行才显示省略提示 | `number / string` | - | - | - |
 
 
-#### Events
+### Events
 | 事件名 | 说明  | 事件参数 | 支持版本 |
 | ----- | ----- | ------- | -------- |
-| `select` | 当用户手动勾选数据行的 Checkbox 时触发的事件 | - | - |
-| `selectAll` | 当用户手动勾选全选 Checkbox 时触发的事件 | - | - |
-| `cellClick` | 当某个单元格被点击时会触发该事件 | - | - |
-| `rowClick` | 当某一行被点击时会触发该事件 | - | - |
-| `headerClick` | 当某一列的表头被点击时会触发该事件 | - | - |
-| `scrollToLower` | 表格体滚动到底事件 | - | `v1.18.9` |
+| `select` | 当用户手动勾选数据行的 Checkbox 时触发的事件 | `data`：() => void | - |
+| `selectAll` | 当用户手动勾选全选 Checkbox 时触发的事件 | `data`：() => void | - |
+| `cellClick` | 当某个单元格被点击时会触发该事件 | `data`：() => void | - |
+| `rowClick` | 当某一行被点击时会触发该事件 | `data`：() => void | - |
+| `headerClick` | 当某一列的表头被点击时会触发该事件 | `data`：() => void | - |
+| `scrollToLower` | 表格体滚动到底事件 | `data`：() => void | `v1.18.9` |
+
+

package/components/ste-table/README.md

@@ -4,9 +4,9 @@
 
 ---$
 
-### 代码演示
+## 代码演示
 
-#### 基础使用
+## 基础使用
 
 ```html
 <script lang="ts" setup>
@@ -30,7 +30,7 @@
 </template>
 ```
 
-#### 带边框
+## 带边框
 
 ```html
 <script lang="ts" setup>
@@ -54,7 +54,7 @@
 </template>
 ```
 
-#### 空数据显示
+## 空数据显示
 
 - 通过`table`中的`emptyText`属性来指定单元格中数据为空时显示的值，否则显示`-`
 - 也可以通过插槽来自定义空数据时显示
@@ -85,7 +85,7 @@
 </template>
 ```
 
-#### 列类型
+## 列类型
 
 通过指定某列上的`type`属性
 
@@ -128,7 +128,7 @@
 </template>
 ```
 
-#### 禁用或只读选择项
+## 禁用或只读选择项
 
 传入一个自定义方法来指定某行是否能选择，方法会传入当前行数据(`row`)和下标(`index`)
 只读同理
@@ -162,7 +162,7 @@
 </template>
 ```
 
-#### 显示合计
+## 显示合计
 
 - 通过`showSummary`控制是否显示合计，`sumText`控制合计行第一列的文本
 - `summaryMethod`来指定合计的方法，需要返回一个数组来确定每一列合计显示的内容
@@ -199,7 +199,7 @@
 </template>
 ```
 
-#### 对齐方式
+## 对齐方式
 
 - 通过`align`指定某列的单元格的对齐方式
 - `headerAlign`指定表头的单元格对齐方式， 没设置时跟随`align`值
@@ -216,7 +216,7 @@
 </template>
 ```
 
-#### 表格方法
+## 表格方法
 
 ```html
 <script lang="ts" setup>
@@ -259,7 +259,7 @@
 </template>
 ```
 
-#### 表格滚动
+## 表格滚动
 
 此时需要给表格设置高度`height`，并保证表体高度是大于此高度，此时表格可以滚动，且滚动到底部时触发`scrollToLower`事件
 
@@ -295,7 +295,7 @@
 </template>
 ```
 
-#### 自定义列
+## 自定义列
 
 当需要格式化某列时，可以不设置列的`prop`，但需要设置`customKey`值，然后给表格传入一个`formatter`方法，
 方法中第一个参数是每一行的数据，第二个参数是列的`customKey`，示例如下
@@ -341,7 +341,7 @@
 </template>
 ```
 
-#### 动态设置表头
+## 动态设置表头
 
 当需要动态设置表头，可以不设置列的`label`，但需要设置`customKey`值，然后给表格传入一个`header`方法，
 方法中第一个参数是列的数据，第二个参数是表格的数据`data`，示例如下
@@ -374,7 +374,7 @@
 </template>
 ```
 
-#### 自定义边框样式
+## 自定义边框样式
 
 表格边框样式不满足时，可通过css更改样式
 
@@ -487,7 +487,7 @@
 </style>
 ```
 
-#### 自定义行或单元格样式
+## 自定义行或单元格样式
 
 ```html
 <script lang="ts" setup>
@@ -558,7 +558,7 @@
 </template>
 ```
 
-#### 高亮行
+## 高亮行
 
 `highlight-current-row`为`true`点击某一行时会高亮显示
 `hightlight-selection-row`为`true`时，列类型为`checkbox`时，勾选后会高亮
@@ -576,7 +576,7 @@
 </template>
 ```
 
-#### 配置选择项图标色
+## 配置选择项图标色
 
 需要指定属性`selectionIconColor`，数据结构如下
 
@@ -589,7 +589,7 @@
 }
 ```
 
-#### 单元格超出长按显示气泡
+## 单元格超出长按显示气泡
 
 ```html
 <script lang="ts" setup>
@@ -618,7 +618,7 @@
 </template>
 ```
 
-#### 合并单元格
+## 合并单元格
 
 当某列的数据为数组类型时，该列会自动触发合并单元格模式，将数组中的每个元素作为一行展示。这在需要展示一对多关系的数据时非常有用。
 
@@ -672,9 +672,9 @@
 
 ---$
 
-### API
+## API
 
-#### Table Props
+## Table Props
 
 | 属性名                  | 说明                                                                                                  | 类型                                       | 默认值     | 可选值 | 支持版本 |
 | ----------------------- | ----------------------------------------------------------------------------------------------------- | ------------------------------------------ | ---------- | ------ | -------- |
@@ -703,7 +703,7 @@
 | `showHeader`            | 是否显示表头                                                                                          | `Boolean`                                  | `true`     | -      | -        |
 | `maxHeight`             | 表格最大高度                                                                                          | `Number/String`                            | -          | -      | -        |
 
-#### Table Events
+## Table Events
 
 | 事件名          | 说明                                         | 事件参数                                                              | 支持版本 |
 | --------------- | -------------------------------------------- | --------------------------------------------------------------------- | -------- |
@@ -716,7 +716,7 @@
 
 <!-- props -->
 
-#### Table Method
+## Table Method
 
 | 方法名               | 说明                               | 方法参数                                                                         | 支持版本 |
 | -------------------- | ---------------------------------- | -------------------------------------------------------------------------------- | -------- |
@@ -725,7 +725,7 @@
 | `toggleAllSelection` | 用于多选表格，切换所有行的选中状态 | -                                                                                | -        |
 | `getSelection`       | 获取当前表格的选中状态的数据       | -                                                                                | -        |
 
-#### TableColumn Props
+## TableColumn Props
 
 | 属性名        | 说明                                             | 类型     | 默认值 | 可选值                                                                                    | 支持版本 |
 | ------------- | ------------------------------------------------ | -------- | ------ | ----------------------------------------------------------------------------------------- | -------- |

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

@@ -79,7 +79,6 @@
             "description": "格式化表头内容的方法，同formatter属性，需要定义customKey属性",
             "type": "function"
         },
-
         {
             "name": "headerRowClassName",
             "description": "表头行的 className 的回调方法，也可以使用字符串为所有表头行设置一个固定的 className",
@@ -166,33 +165,63 @@
         {
             "name": "[event]select",
             "description": "当用户手动勾选数据行的 Checkbox 时触发的事件",
-            "type": "() => void"
+            "params": [
+                {
+                    "name": "data",
+                    "description": "() => void"
+                }
+            ]
         },
         {
             "name": "[event]selectAll",
             "description": "当用户手动勾选全选 Checkbox 时触发的事件",
-            "type": "() => void"
+            "params": [
+                {
+                    "name": "data",
+                    "description": "() => void"
+                }
+            ]
         },
         {
             "name": "[event]cellClick",
             "description": "当某个单元格被点击时会触发该事件",
-            "type": "() => void"
+            "params": [
+                {
+                    "name": "data",
+                    "description": "() => void"
+                }
+            ]
         },
         {
             "name": "[event]rowClick",
             "description": "当某一行被点击时会触发该事件",
-            "type": "() => void"
+            "params": [
+                {
+                    "name": "data",
+                    "description": "() => void"
+                }
+            ]
         },
         {
             "name": "[event]headerClick",
             "description": "当某一列的表头被点击时会触发该事件",
-            "type": "() => void"
+            "params": [
+                {
+                    "name": "data",
+                    "description": "() => void"
+                }
+            ]
         },
         {
             "name": "[event]scrollToLower",
             "description": "表格体滚动到底事件",
-            "type": "() => void",
-            "version": "v1.18.9"
+            "version": "v1.18.9",
+            "params": [
+                {
+                    "name": "data",
+                    "description": "() => void"
+                }
+            ]
         }
     ]
-}
+}

package/components/ste-tabs/ATTRIBUTES.md

@@ -1,4 +1,6 @@
-#### Props
+## API
+
+### Props
 | 属性名 | 说明  | 类型 | 默认值  | 可选值 | 支持版本 |
 | ----- | ----- | --- | ------- | ------ | -------- |
 | `active` | 当前激活的选项支持v-model:active双向绑定（类型为number时绑定index，类型为string时绑定name） | `number / string` | `0` | - | - |
@@ -17,6 +19,7 @@
 | `ellipsis` | 是否省略过长的标题文字 | `boolean` | `false` | - | - |
 | `tabWidth` | tab内容的宽度 | `number / string` | `auto` | - | - |
 | `tabPadding` | 选项内边距，默认24，单位rpx | `number / string` | `24` | - | - |
+| `tabLineGap` | tab到下划线的距离，默认单位rpx | `number / string` | `4` | - | - |
 | `tabSpace` | tab间距rpx | `number / string` | `0` | - | - |
 | `divideNum` | tab等分数量，设置为 0 ，则不等分 | `number / string` | `4` | - | - |
 | `sticky` | 是否使用粘性布局 | `boolean` | `false` | - | - |
@@ -45,8 +48,10 @@
 | `maskZindex` | 下拉蒙层层级 | `number / string` | `1001` | - | - |
 
 
-#### Events
+### Events
 | 事件名 | 说明  | 事件参数 | 支持版本 |
 | ----- | ----- | ------- | -------- |
-| `click-tab` | 点击tab触发 | - | - |
-| `change` | 切换tab触发 | - | - |
+| `click-tab` | 点击tab触发 | `data`：(tab:TabProps)=>void | - |
+| `change` | 切换tab触发 | `data`：(tab:TabProps)=>void | - |
+
+

package/components/ste-tabs/README.md

@@ -4,7 +4,7 @@
 
 ---$
 
-### 代码演示
+## 代码演示
 
 ```html
 <script setup lang="ts">
@@ -133,17 +133,15 @@
 
 ---$
 
-### API
-
 <!-- props -->
 
-#### Tabs Slot
+## Tabs Slot
 
 | 插槽名    | 说明                              | 插槽参数 | 支持版本 |
 | --------- | --------------------------------- | -------- | -------- |
 | `default` | 默认插槽，请传入`ste-tab`标签列表 | -        | -        |
 
-#### Tab Props
+## Tab Props
 
 | 属性名          | 说明                                                                 | 类型              | 默认值  | 可选值 | 支持版本 |
 | --------------- | -------------------------------------------------------------------- | ----------------- | ------- | ------ | -------- |
@@ -157,7 +155,7 @@
 | `badge`         | 右上角徽标的内容                                                     | `String`/`Number` | `0`     | -      | -        |
 | `showZeroBadge` | 当 badge 为数字 0 时，是否展示徽标                                   | `Boolean`         | `false` | -      | -        |
 
-#### Tab Slot
+## Tab Slot
 
 | 插槽名          | 说明                                         | 插槽参数 | 支持版本   |
 | --------------- | -------------------------------------------- | -------- | ---------- |

package/components/ste-tabs/props.ts

@@ -17,6 +17,7 @@ export interface SteTabsProps {
   ellipsis: boolean
   tabWidth: number | string
   tabPadding: number | string
+  tabLineGap: number | string
   tabSpace: number | string
   divideNum: number
   sticky: boolean
@@ -78,6 +79,8 @@ export default {
   tabWidth: { type: [String, Number], default: () => 'auto' },
   // 选项内边距，默认24，单位rpx
   tabPadding: { type: [Number, String], default: () => 24 },
+  // tab到下划线的距离，默认单位rpx
+  tabLineGap: { type: [Number, String], default: () => 4 },
   // tab间距rpx
   tabSpace: { type: [Number, String], default: () => 0 },
   // tab等分数量，设置为 0 ，则不等分

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

@@ -108,6 +108,12 @@
             "type": "number | string",
             "default": 24
         },
+        {
+            "name": "tabLineGap",
+            "description": "tab到下划线的距离，默认单位rpx",
+            "type": "number | string",
+            "default": 4
+        },
         {
             "name": "tabSpace",
             "description": "tab间距rpx",
@@ -267,12 +273,22 @@
         {
             "name": "[event]click-tab",
             "description": "点击tab触发",
-            "type": "(tab:TabProps)=>void"
+            "params": [
+                {
+                    "name": "data",
+                    "description": "(tab:TabProps)=>void"
+                }
+            ]
         },
         {
             "name": "[event]change",
             "description": "切换tab触发",
-            "type": "(tab:TabProps)=>void"
+            "params": [
+                {
+                    "name": "data",
+                    "description": "(tab:TabProps)=>void"
+                }
+            ]
         }
     ]
 }

package/components/ste-tabs/useData.ts

@@ -136,7 +136,7 @@ export default function useData({
       '--tabs-line-height': utils.formatPx(props.lineHeight),
       '--tabs-tab-width': tabWidth,
       '--tabs-tab-padding': utils.formatPx(props.tabPadding),
-      '--tabs-tab-padding-bottom': cmpShowLine.value ? utils.formatPx(4) : utils.formatPx(props.tabPadding),
+      '--tabs-tab-padding-bottom': cmpShowLine.value ? utils.formatPx(props.tabLineGap) : utils.formatPx(props.tabPadding),
       '--tabs-transition-duration': props.duration ? `${props.duration}s` : 'inherit',
       '--tabs-tab-space': tabSpace,
       '--tabs-tab-space-line': tabSpaceLine,