stellar-ui-plus 1.25.1 → 1.25.3

package/components/ste-sticky/ATTRIBUTES.md

@@ -1,4 +1,6 @@
-#### Props
+## API
+
+### Props
 | 属性名 | 说明  | 类型 | 默认值  | 可选值 | 支持版本 |
 | ----- | ----- | --- | ------- | ------ | -------- |
 | `offsetTop` | 吸顶时与顶部的距离，单位rpx | `string / number` | `0` | - | - |
@@ -8,8 +10,10 @@
 | `zIndex` | 吸顶时的z-index值 | `string / number` | `98` | - | - |
 
 
-#### Events
+### Events
 | 事件名 | 说明  | 事件参数 | 支持版本 |
 | ----- | ----- | ------- | -------- |
-| `fixed` | 组件吸顶时触发 | - | - |
-| `unfixed` | 组件取消吸顶时触发 | - | - |
+| `fixed` | 组件吸顶时触发 | `data`：() => void | - |
+| `unfixed` | 组件取消吸顶时触发 | `data`：() => void | - |
+
+

package/components/ste-sticky/README.md

@@ -4,9 +4,9 @@
 
 ---$
 
-### 代码演示
+## 代码演示
 
-#### 基础用法
+## 基础用法
 
 - 事件`fixed`监听组件进入粘性布局时触发
 - 事件`unfixed`监听组件取消粘性布局时触发
@@ -50,8 +50,6 @@
 
 ---$
 
-### API
-
 <!-- props -->
 
 ---$

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

@@ -37,12 +37,22 @@
         {
             "name": "[event]fixed",
             "description": "组件吸顶时触发",
-            "type": "() => void"
+            "params": [
+                {
+                    "name": "data",
+                    "description": "() => void"
+                }
+            ]
         },
         {
             "name": "[event]unfixed",
             "description": "组件取消吸顶时触发",
-            "type": "() => void"
+            "params": [
+                {
+                    "name": "data",
+                    "description": "() => void"
+                }
+            ]
         }
     ]
-}
+}

package/components/ste-swipe-action/ATTRIBUTES.md

@@ -1,4 +1,6 @@
-#### Props
+## API
+
+### Props
 | 属性名 | 说明  | 类型 | 默认值  | 可选值 | 支持版本 |
 | ----- | ----- | --- | ------- | ------ | -------- |
 | `mode` | 模式 | `string` | `right` | `right`：右滑(默认)<br/>`left`：左滑<br/>`all`：左右滑 | - |
@@ -9,8 +11,17 @@
 | `rightIcon` | 是否显示右侧图标 | `boolean` | `false` | - | - |
 
 
-#### Events
+### Events
 | 事件名 | 说明  | 事件参数 | 支持版本 |
 | ----- | ----- | ------- | -------- |
 | `open` | 打开滑块时触发，参数为方向 | `direction`：方向（值为left或right） | - |
-| `close` | 关闭滑块时触发 | - | - |
+| `close` | 关闭滑块时触发 | `data`：()=>void | - |
+
+
+### Methods
+| 方法名 | 说明  | 参数 | 返回值 | 支持版本 |
+| ----- | ----- | --- | ------ | -------- |
+| `open` | 打开滑块，参数为方向 | `direction`：left / right：需要打开的方向，默认同 mode | - | - |
+| `close` | 关闭滑块 | - | - | - |
+
+

package/components/ste-swipe-action/README.md

@@ -5,9 +5,9 @@
 
 ---$
 
-### 代码演示
+## 代码演示
 
-#### 基础用法
+## 基础用法
 
 - 插槽`default`为单元格内容区域
 - 插槽`right`为单元格右侧内容区域
@@ -38,7 +38,7 @@
 </style>
 ```
 
-#### 调用方法打开或关闭
+## 调用方法打开或关闭
 
 - 方法`open`可打开单元格
     - 参数为需要打开的方向（默认同mode）
@@ -82,7 +82,7 @@
 </style>
 ```
 
-#### 滑动方向、开关按钮
+## 滑动方向、开关按钮
 
 - 属性`mode`可以设置滑动方向，默认为`right`，可选值为`left`、`all`
 - 属性`leftIcon`和`rightIcon`可以设置是否显示开关按钮
@@ -135,7 +135,7 @@
 </style>
 ```
 
-#### 单元格组
+## 单元格组
 
 - 标签`ste-swipe-action-group`用于包裹多个单元格
 - 事件`open`监听组内单元格的开启
@@ -202,20 +202,11 @@
 
 ---$
 
-### SwipeAction API
-
 <!-- props -->
 
-#### Method
-
-| 方法名  | 说明                 | 方法参数                                     | 支持版本 |
-| ------- | -------------------- | -------------------------------------------- | -------- |
-| `open`  | 打开滑块，参数为方向 | `left`/`right`：需要打开的方向，默认同`mode` | -        |
-| `close` | 关闭滑块             | -                                            | -        |
-
-### SwipeActionGroup API
+## SwipeActionGroup API
 
-#### Props
+### Props
 
 | 属性名           | 说明                                        | 类型              | 默认值  | 可选值                                                     | 支持版本 |
 | ---------------- | ------------------------------------------- | ----------------- | ------- | ---------------------------------------------------------- | -------- |
@@ -227,14 +218,14 @@
 | `leftIcon`       | 是否显示左侧图标                            | `Boolean`         | `false` | -                                                          | -        |
 | `rightIcon`      | 是否显示右侧图标                            | `Boolean`         | `false` | -                                                          | -        |
 
-#### Events
+### Events
 
 | 事件名  | 说明           | 事件参数                                       | 支持版本 |
 | ------- | -------------- | ---------------------------------------------- | -------- |
 | `open`  | 打开滑块时触发 | `left`/`right`：打开的方向,`index`：打开的下标 | -        |
 | `close` | 关闭滑块时触发 | -                                              | -        |
 
-#### Method
+### Method
 
 | 方法名  | 说明     | 方法参数                                                                | 支持版本 |
 | ------- | -------- | ----------------------------------------------------------------------- | -------- |

package/components/ste-swipe-action/ste-swipe-action.easycom.json

@@ -57,7 +57,6 @@
         {
             "name": "[event]open",
             "description": "打开滑块时触发，参数为方向",
-            "type": "(d:string)=>void",
             "params": [
                 {
                     "name": "direction",
@@ -68,7 +67,26 @@
         {
             "name": "[event]close",
             "description": "关闭滑块时触发",
-            "type": "()=>void"
+            "params": [
+                {
+                    "name": "data",
+                    "description": "()=>void"
+                }
+            ]
+        },
+        {
+            "name": "[method]open",
+            "description": "打开滑块，参数为方向",
+            "params": [
+                {
+                    "name": "direction",
+                    "description": "left / right：需要打开的方向，默认同 mode"
+                }
+            ]
+        },
+        {
+            "name": "[method]close",
+            "description": "关闭滑块"
         }
     ]
 }

package/components/ste-swipe-action/useData.ts

@@ -44,21 +44,28 @@ export default function useData({ props, parent, thas, emits }: {
     changeCallback.value = val
   }
 
-  const cmpMode = computed<ModeType>(() => props.mode || parent?.mode || 'right')
+  // 获取配置值：优先使用自己的值，其次使用父组件的值，最后使用默认值
+  const getDefaultData = <T,>(selfValue: T | null | undefined, parentValue: T | undefined, defaultValue: T): T => {
+    if (selfValue !== null && selfValue !== undefined) return selfValue;
+    if (parentValue !== undefined) return parentValue;
+    return defaultValue;
+  };
 
-  const cmpLeft = computed(() => ['all', 'left'].includes(cmpMode.value))
+  const cmpMode = computed<ModeType>(() => getDefaultData(props.mode, parent?.props?.mode, 'right'));
 
-  const cmpRight = computed(() => ['all', 'right'].includes(cmpMode.value))
+  const cmpLeft = computed(() => ['all', 'left'].includes(cmpMode.value));
 
-  const cmpDisabled = computed<boolean>(() => props.disabled !== null ? props.disabled : parent?.disabled)
+  const cmpRight = computed(() => ['all', 'right'].includes(cmpMode.value));
 
-  const cmpSwipeThreshold = computed<number>(() => props.swipeThreshold || parent?.swipeThreshold || 0.35)
+  const cmpDisabled = computed<boolean>(() => getDefaultData(props.disabled, parent?.props?.disabled, false));
 
-  const cmpDuration = computed<number>(() => props.duration || parent?.duration || 300)
+  const cmpSwipeThreshold = computed<number>(() => getDefaultData(props.swipeThreshold, parent?.props?.swipeThreshold, 0.35));
 
-  const cmpLeftIcon = computed<boolean>(() => props.leftIcon !== null ? props.leftIcon : parent?.leftIcon)
+  const cmpDuration = computed<number>(() => getDefaultData(props.duration, parent?.props?.duration, 300));
 
-  const cmpRightIcon = computed<boolean>(() => props.rightIcon !== null ? props.rightIcon : parent?.rightIcon)
+  const cmpLeftIcon = computed<boolean>(() => getDefaultData(props.leftIcon, parent?.props?.leftIcon, false));
+
+  const cmpRightIcon = computed<boolean>(() => getDefaultData(props.rightIcon, parent?.props?.rightIcon, false));
 
   const cmpTransform = computed<StyleValue>(() => ({
     transform: `translateX(${translateX.value}px)`,

package/components/ste-swipe-action-group/ATTRIBUTES.md

@@ -1,4 +1,6 @@
-#### Props
+## API
+
+### Props
 | 属性名 | 说明  | 类型 | 默认值  | 可选值 | 支持版本 |
 | ----- | ----- | --- | ------- | ------ | -------- |
 | `mode` | 模式 | `string` | `right` | `right`：右滑(默认)<br/>`left`：左滑<br/>`all`：左右滑 | - |
@@ -10,8 +12,10 @@
 | `rightIcon` | 是否显示右侧图标 | `boolean` | `false` | - | - |
 
 
-#### Events
+### Events
 | 事件名 | 说明  | 事件参数 | 支持版本 |
 | ----- | ----- | ------- | -------- |
 | `open` | 打开滑块时触发，参数为方向 | `direction`：方向（值为left或right）<br/>`index`：当前单元格索引 | - |
 | `close` | 关闭滑块时触发 | `index`：当前单元格索引 | - |
+
+

package/components/ste-swipe-action-group/ste-swipe-action-group.easycom.json

@@ -63,7 +63,6 @@
         {
             "name": "[event]open",
             "description": "打开滑块时触发，参数为方向",
-            "type": "(d:string,index:number)=>void",
             "params": [
                 {
                     "name": "direction",
@@ -78,7 +77,6 @@
         {
             "name": "[event]close",
             "description": "关闭滑块时触发",
-            "type": "(index:number)=>void",
             "params": [
                 {
                     "name": "index",
@@ -87,4 +85,4 @@
             ]
         }
     ]
-}
+}

package/components/ste-swiper/ATTRIBUTES.md

@@ -1,4 +1,6 @@
-#### Props
+## API
+
+### Props
 | 属性名 | 说明  | 类型 | 默认值  | 可选值 | 支持版本 |
 | ----- | ----- | --- | ------- | ------ | -------- |
 | `current` | 当前显示滑块的 index | `number` | `0` | - | - |
@@ -19,8 +21,10 @@
 | `highlightActive` | 是否启用突出显示模式（当前项正常大小，非当前项缩小） | `boolean` | `false` | - | `1.22.20` |
 
 
-#### Events
+### Events
 | 事件名 | 说明  | 事件参数 | 支持版本 |
 | ----- | ----- | ------- | -------- |
 | `change` | 监听item切换 | `index`：当前显示滑块的 index<br/>`source`：触发切换的来源 | - |
 | `error` | 错误监听 | `error`：错误信息<br/>`context`：提示内容 | - |
+
+

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` |
+
+