stellar-ui-plus 1.25.1 → 1.25.2

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

@@ -83,7 +83,6 @@
         {
             "name": "[event]change",
             "description": "进度变化且结束拖动后触发",
-            "type": "(percentage)=>void",
             "params": [
                 {
                     "name": "percentage",
@@ -94,7 +93,6 @@
         {
             "name": "[event]dragStart",
             "description": "开始拖动时触发",
-            "type": "(e)=>void",
             "params": [
                 {
                     "name": "e",
@@ -105,7 +103,6 @@
         {
             "name": "[event]dragEnd",
             "description": "结束拖动时触发",
-            "type": "(e)=>void",
             "params": [
                 {
                     "name": "e",
@@ -116,13 +113,24 @@
         {
             "name": "[event]input",
             "description": "进度变化时实时触发",
-            "type": "(percentage)=>void",
             "params": [
                 {
                     "name": "percentage",
                     "description": "进度百分比"
                 }
             ]
+        },
+        {
+            "name": "[slot]button",
+            "description": "自定义滑块按钮"
+        },
+        {
+            "name": "[slot]leftButton",
+            "description": "自定义左侧滑块按钮（范围选择下）"
+        },
+        {
+            "name": "[slot]rightButton",
+            "description": "自定义右侧滑块按钮（范围选择下）"
         }
     ]
 }

package/components/ste-stepper/ATTRIBUTES.md

@@ -1,4 +1,6 @@
-#### Props
+## API
+
+### Props
 | 属性名 | 说明  | 类型 | 默认值  | 可选值 | 支持版本 |
 | ----- | ----- | --- | ------- | ------ | -------- |
 | `v-model` | 当前输入的值 | `number` | `1` | - | - |
@@ -24,11 +26,13 @@
 | `badgeMax` | 徽标：徽标最大显示值 | `number` | `99` | - | - |
 
 
-#### Events
+### Events
 | 事件名 | 说明  | 事件参数 | 支持版本 |
 | ----- | ----- | ------- | -------- |
-| `change` | 当绑定值变化时触发的事件 `value`: 改变后的绑定值 | - | - |
+| `change` | 当绑定值变化时触发的事件 `value`: 改变后的绑定值 | `data`：(value: number) => void | - |
 | `plus` | 点击增加按钮时触发（可拦截change事件） | `value`：改变后的绑定值<br/>`suspend`：等待<br/>`next`：继续<br/>`stop`：停止 | - |
 | `minus` | 点击减少按钮时触发（可拦截change事件） | `value`：改变后的绑定值<br/>`suspend`：等待<br/>`next`：继续<br/>`stop`：停止 | - |
-| `focus` | 输入框聚焦时触发 | - | - |
-| `blur` | 输入框失焦时触发 | - | - |
+| `focus` | 输入框聚焦时触发 | `data`：() => void | - |
+| `blur` | 输入框失焦时触发 | `data`：() => void | - |
+
+

package/components/ste-stepper/README.md

@@ -4,9 +4,9 @@
 
 ---$
 
-### 代码演示
+## 代码演示
 
-#### 基础用法
+## 基础用法
 
 通过`value`属性，双向绑定，设置输入值
 
@@ -20,7 +20,7 @@
 </template>
 ```
 
-#### 限制输入范围
+## 限制输入范围
 
 通过 `min` 和 `max` 属性限制输入值的范围，默认超出范围后会自动校正最大值(默认值：`Infinity`)或最小值(默认值：`0`)
 
@@ -34,7 +34,7 @@
 </template>
 ```
 
-#### 步长设置
+## 步长设置
 
 通过 `step` 属性设置每次点击增加或减少按钮时变化的值，默认为 1。
 
@@ -48,7 +48,7 @@
 </template>
 ```
 
-#### 数值精度
+## 数值精度
 
 通过 `precision` 属性设置输入值的小数位，默认为 1。
 
@@ -62,7 +62,7 @@
 </template>
 ```
 
-#### 自定义大小
+## 自定义大小
 
 通过 `inputWidth` 属性设置输入框宽度，通过 `buttonSize` 属性设置按钮大小和输入框高度。
 
@@ -76,7 +76,7 @@
 </template>
 ```
 
-#### 主色
+## 主色
 
 通过 `mainColor` 属性设置步进器的主色，对`theme`为`line`时无效。
 
@@ -90,7 +90,7 @@
 </template>
 ```
 
-#### 禁用
+## 禁用
 
 - 通过 `disabled` 属性设置禁用步进器，默认为 `false`。
 - 通过 `disablePlus` 属性设置禁用增加按钮，默认为 `false`。
@@ -113,7 +113,7 @@
 </template>
 ```
 
-#### 样式风格：线性风格
+## 样式风格：线性风格
 
 通过 `theme` 属性设置步进器的样式风格，设置为线性 `line`，默认为 `card`。
 
@@ -137,10 +137,6 @@
 
 ---$
 
-### API
-
-#### 组件属性(Props)
-
 <!-- props -->
 
 ---$

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

@@ -172,12 +172,16 @@
         {
             "name": "[event]change",
             "description": "当绑定值变化时触发的事件 `value`: 改变后的绑定值",
-            "type": "(value: number) => void"
+            "params": [
+                {
+                    "name": "data",
+                    "description": "(value: number) => void"
+                }
+            ]
         },
         {
             "name": "[event]plus",
             "description": "点击增加按钮时触发（可拦截change事件）",
-            "type": "(value: number,suspend: ()=>void,next: ()=>void,stop: ()=>void) => void",
             "params": [
                 {
                     "name": "value",
@@ -200,7 +204,6 @@
         {
             "name": "[event]minus",
             "description": "点击减少按钮时触发（可拦截change事件）",
-            "type": "(value:string | number,suspend: ()=>void,next: ()=>void,stop: ()=>void) => void",
             "params": [
                 {
                     "name": "value",
@@ -223,12 +226,22 @@
         {
             "name": "[event]focus",
             "description": "输入框聚焦时触发",
-            "type": "() => void"
+            "params": [
+                {
+                    "name": "data",
+                    "description": "() => void"
+                }
+            ]
         },
         {
             "name": "[event]blur",
             "description": "输入框失焦时触发",
-            "type": "() => void"
+            "params": [
+                {
+                    "name": "data",
+                    "description": "() => void"
+                }
+            ]
         }
     ]
-}
+}

package/components/ste-steps/ATTRIBUTES.md

@@ -1,4 +1,6 @@
-#### Props
+## API
+
+### Props
 | 属性名 | 说明  | 类型 | 默认值  | 可选值 | 支持版本 |
 | ----- | ----- | --- | ------- | ------ | -------- |
 | `active` | 步骤进度 | `number` | `0` | - | - |
@@ -8,7 +10,9 @@
 | `lineStyle` | 线条样式（支持border-style全部属性） | `string` | `solid` | - | `1.22.27` |
 
 
-#### Events
+### Events
 | 事件名 | 说明  | 事件参数 | 支持版本 |
 | ----- | ----- | ------- | -------- |
 | `clickStep` | 点击步骤的标题或图标时触发 | `index`：点击的步骤序号 | - |
+
+

package/components/ste-steps/README.md

@@ -4,11 +4,11 @@
 
 ---$
 
-### 代码演示
+## 代码演示
 
 后面的演示代码中涉及到的变量和方法都使用该代码
 
-### 基础用法
+## 基础用法
 
 `active` 为步骤进度，为 `Number` 类型，步骤的下标。
 
@@ -33,7 +33,7 @@
 </template>
 ```
 
-### 设置标题和描述信息
+## 设置标题和描述信息
 
 可以通过 `title` 和 `description` 设置步骤的标题和描述信息。如果不设置标题，则会使用默认的文案。
 
@@ -52,7 +52,7 @@
 </template>
 ```
 
-### 修改图标
+## 修改图标
 
 - 可以通过 `icon` 属性设置步骤的图标，传入图标的名称，也可以通过 `icon` 的 slot 插槽自定义图标
 - 优先级：插槽 > 点状 > icon属性 > 默认图标
@@ -76,7 +76,7 @@
 </template>
 ```
 
-### 竖向步骤条
+## 竖向步骤条
 
 可以通过 `direction` 属性设置步骤条方向，`row`：横向，`column`：竖向，默认为`row`
 
@@ -97,7 +97,7 @@
 </template>
 ```
 
-### 点状步骤和垂直方向
+## 点状步骤和垂直方向
 
 可以通过 `dot` 属性设置点状步骤条
 
@@ -118,7 +118,7 @@
 </template>
 ```
 
-### 修改状态
+## 修改状态
 
 设置 `status`，支持 `finished`（完成）、`process`（进行中）、`error`（失败） 三种状态。
 
@@ -139,11 +139,9 @@
 
 ---$
 
-### API
-
 <!-- props -->
 
-#### Step组件属性(Props)
+## Step组件属性(Props)
 
 | 参数          | 说明                                 | 类型     | 默认值 | 可选值 | 支持版本 |
 | ------------- | ------------------------------------ | -------- | ------ | ------ | -------- |
@@ -152,7 +150,7 @@
 | `icon`        | 图标                                 | `String` | -      | -      | -        |
 | `status`      | 步骤状态                             | `String` | -      | -      | -        |
 
-#### Step Slots
+## Step Slots
 
 | 插槽名    | 说明     | 插槽参数 | 支持版本 |
 | --------- | -------- | -------- | -------- |

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

@@ -48,7 +48,6 @@
         {
             "name": "[event]clickStep",
             "description": "点击步骤的标题或图标时触发",
-            "type": "(index: number) => void",
             "params": [
                 {
                     "name": "index",
@@ -57,4 +56,4 @@
             ]
         }
     ]
-}
+}

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`：提示内容 | - |
+
+