stellar-ui-plus 1.25.1 → 1.25.2

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

@@ -238,7 +238,6 @@
         {
             "name": "[event]blur",
             "description": "输入框失去焦点事件",
-            "type": "(value: string | number) => void",
             "params": [
                 {
                     "name": "value",
@@ -249,7 +248,6 @@
         {
             "name": "[event]focus",
             "description": "聚焦事件",
-            "type": "(value: string | number) => void",
             "params": [
                 {
                     "name": "value",
@@ -260,7 +258,6 @@
         {
             "name": "[event]confirm",
             "description": "输入框输入键盘右下角点击事件",
-            "type": "(value: string | number) => void",
             "params": [
                 {
                     "name": "value",
@@ -271,18 +268,30 @@
         {
             "name": "[event]clear",
             "description": "清除输入框事件",
-            "type": "() => void"
+            "params": [
+                {
+                    "name": "data",
+                    "description": "() => void"
+                }
+            ]
         },
         {
             "name": "[event]input",
             "description": "输入事件",
-            "type": "(value: string | number) => void",
             "params": [
                 {
                     "name": "value",
                     "description": "输入框的值"
                 }
             ]
+        },
+        {
+            "name": "[slot]prefix",
+            "description": "输入框前置内容"
+        },
+        {
+            "name": "[slot]suffix",
+            "description": "输入框后置内容"
         }
     ]
 }

package/components/ste-line-chart/ATTRIBUTES.md

@@ -1,4 +1,6 @@
-#### Props
+## API
+
+### Props
 | 属性名 | 说明  | 类型 | 默认值  | 可选值 | 支持版本 |
 | ----- | ----- | --- | ------- | ------ | -------- |
 | `width` | 图表宽度，单位rpx | `number / string` | `750` | - | - |

package/components/ste-line-chart/README.md

@@ -3,9 +3,9 @@
 折线图主要用来展示数据项随着时间推移的趋势或变化
 ---$
 
-### 代码演示
+## 代码演示
 
-#### 默认配置
+## 默认配置
 
 ```html
 <template>
@@ -26,7 +26,7 @@
 </script>
 ```
 
-#### 多图例
+## 多图例
 
 ```html
 <template>
@@ -51,7 +51,7 @@
 </script>
 ```
 
-#### 曲线
+## 曲线
 
 ```html
 <template>
@@ -76,7 +76,7 @@
 </script>
 ```
 
-#### 迷你图表
+## 迷你图表
 
 ```html
 <template>
@@ -115,8 +115,6 @@
 
 ---$
 
-### API
-
 <!-- props -->
 
 ---$

package/components/ste-loading/ATTRIBUTES.md

@@ -1,4 +1,6 @@
-#### Props
+## API
+
+### Props
 | 属性名 | 说明  | 类型 | 默认值  | 可选值 | 支持版本 |
 | ----- | ----- | --- | ------- | ------ | -------- |
 | `color` | 图标颜色 | `String` | `#999999` | - | - |

package/components/ste-loading/README.md

@@ -6,7 +6,7 @@
 
 ## 代码演示
 
-### 加载类型
+## 加载类型
 
 通过 `type`设置加载动画类型，默认为类型`1`
 
@@ -20,7 +20,7 @@
 </template>
 ```
 
-### 自定义图标颜色
+## 自定义图标颜色
 
 通过 `color` 属性来设置图标的颜色
 
@@ -31,7 +31,7 @@
 </template>
 ```
 
-### 自定义图标大小
+## 自定义图标大小
 
 通过 `size` 属性来设置图标的尺寸大小，单位为 rpx，默认`60`
 
@@ -42,7 +42,7 @@
 </template>
 ```
 
-### 加载文案
+## 加载文案
 
 默认插槽`default`为加载文案
 
@@ -53,7 +53,7 @@
 </template>
 ```
 
-### 垂直排列
+## 垂直排列
 
 通过 `vertical` 是否垂直排列图标和文字内容，默认`false`
 
@@ -64,7 +64,7 @@
 </template>
 ```
 
-### 自定义文本样式
+## 自定义文本样式
 
 - 通过 `textSize`设置文本大小，单位rpx，默认为`28`
 - 通过 `textColor`设置文本颜色，默认和图标颜色同步
@@ -78,8 +78,6 @@
 
 ---$
 
-### API
-
 <!-- props -->
 
 ---$

package/components/ste-login/ATTRIBUTES.md

@@ -1,4 +1,6 @@
-#### Props
+## API
+
+### Props
 | 属性名 | 说明  | 类型 | 默认值  | 可选值 | 支持版本 |
 | ----- | ----- | --- | ------- | ------ | -------- |
 | `mode` | 登录模式 | `string` | `base` | `base`：基础登录<br/>`mode1`：复杂登录 | - |
@@ -15,7 +17,7 @@
 | `bottomTip` | 底部提示 | `string` | `` | - | - |
 
 
-#### Events
+### Events
 | 事件名 | 说明  | 事件参数 | 支持版本 |
 | ----- | ----- | ------- | -------- |
 | `protocolClick` | 协议点击时触发 | `item`：所点击的协议项 | - |
@@ -24,3 +26,11 @@
 | `tabChange` | 复杂登录时tab切换时触发 | `item`：当前选项卡项 | - |
 | `formDataChange` | 复杂登录时输入框或者下拉框改变时触发 | `data`：所有表单值 | - |
 | `getCode` | 当配置输入类型为验证码时，点击获取验证码时触发 | `suspend`：等待<br/>`next`：继续<br/>`stop`：停止 | - |
+
+
+### Slots
+| 插槽名 | 说明  | 参数 | 支持版本 |
+| ----- | ----- | --- | -------- |
+| `header` | 头部内容 | - | - |
+
+

package/components/ste-login/README.md

@@ -4,7 +4,7 @@
 
 ---$
 
-#### 简单登录
+## 简单登录
 
 - 此组件数组类型的数据都需要传入`key`字段，用于在事件监听中判断
 
@@ -65,7 +65,7 @@
 </script>
 ```
 
-#### 复杂登录 - 示例1
+## 复杂登录 - 示例1
 
 - `mode`值为`mode1`时为复杂登录
 - 此时`primaryBtnData`样式不变，`secondaryBtnData`为文字按钮
@@ -210,7 +210,7 @@
 </script>
 ```
 
-#### 复杂登录 - 示例2
+## 复杂登录 - 示例2
 
 - 当`loginGroup`配置为一个数据时，顶部tab栏会隐藏显示
 - 可在单个表单中配置`iconColor`改变图标颜色
@@ -306,9 +306,9 @@
 
 ---$
 
-### API
+<!-- props -->
 
-#### BaseConfigItem & ProtocolItem & BtnItem
+### BaseConfigItem & ProtocolItem & BtnItem
 
 | 属性名  | 说明                           | 是否必填 | 类型     |
 | ------- | ------------------------------ | -------- | -------- |
@@ -316,7 +316,7 @@
 | `key`   | 标识符                         | 是       | `string` |
 | `style` | 对应配置的样式(暂时只支持部分) | 否       | `object` |
 
-#### LoginGroupItem
+### LoginGroupItem
 
 | 属性名  | 说明         | 是否必填 | 类型          |
 | ------- | ------------ | -------- | ------------- |
@@ -324,7 +324,7 @@
 | `key`   | 标识符       | 是       | `string`      |
 | `items` | 输入表单配置 | 是       | `LoginItem[]` |
 
-#### LoginItem
+### LoginItem
 
 | 属性名        | 说明                                                          | 是否必填 | 类型               |
 | ------------- | ------------------------------------------------------------- | -------- | ------------------ |
@@ -338,13 +338,5 @@
 | `icon`        | 输入框模式下对应的前缀图标code                                | 否       | `string`           |
 | `placeholder` | 输入框模式下对应的placeholder                                 | 否       | `string`           |
 
-<!-- props -->
-
-#### Slots
-
-| 插槽名   | 说明     | 插槽参数 | 支持版本 |
-| -------- | -------- | -------- | -------- |
-| `header` | 头部内容 | -        | -        |
-
 ---$
 {{fuyuwei}}

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

@@ -62,7 +62,6 @@
             "type": "BtnItem[]",
             "default": "[]"
         },
-
         {
             "name": "loginGroup",
             "description": "登录表单配置",
@@ -90,7 +89,6 @@
         {
             "name": "[event]protocolClick",
             "description": "协议点击时触发",
-            "type": "(item: ProtocolItem) => void",
             "params": [
                 {
                     "name": "item",
@@ -101,7 +99,6 @@
         {
             "name": "[event]primaryBtnClick",
             "description": "主按钮点击时触发",
-            "type": "(item: BtnItem[]) => void",
             "params": [
                 {
                     "name": "item",
@@ -112,7 +109,6 @@
         {
             "name": "[event]secondaryBtnClick",
             "description": "次要按钮点击时触发",
-            "type": "(item: BtnItem[]) => void",
             "params": [
                 {
                     "name": "item",
@@ -123,7 +119,6 @@
         {
             "name": "[event]tabChange",
             "description": "复杂登录时tab切换时触发",
-            "type": "(item: BaseConfigItem[]) => void",
             "params": [
                 {
                     "name": "item",
@@ -134,7 +129,6 @@
         {
             "name": "[event]formDataChange",
             "description": "复杂登录时输入框或者下拉框改变时触发",
-            "type": "(data: {}) => void",
             "params": [
                 {
                     "name": "data",
@@ -145,7 +139,6 @@
         {
             "name": "[event]getCode",
             "description": "当配置输入类型为验证码时，点击获取验证码时触发",
-            "type": "(suspend: ()=>void,next: ()=>void,stop: ()=>void) => void",
             "params": [
                 {
                     "name": "suspend",
@@ -160,6 +153,10 @@
                     "description": "停止"
                 }
             ]
+        },
+        {
+            "name": "[slot]header",
+            "description": "头部内容"
         }
     ]
 }

package/components/ste-login-info/ATTRIBUTES.md

@@ -1,4 +1,6 @@
-#### Props
+## API
+
+### Props
 | 属性名 | 说明  | 类型 | 默认值  | 可选值 | 支持版本 |
 | ----- | ----- | --- | ------- | ------ | -------- |
 | `avatar` | 头像url | `string` | `` | - | - |
@@ -13,9 +15,11 @@
 | `loginTitle` | 未登录标题 | `string` | `` | - | - |
 
 
-#### Events
+### Events
 | 事件名 | 说明  | 事件参数 | 支持版本 |
 | ----- | ----- | ------- | -------- |
 | `avatar-click` | 头像点击时触发 | - | - |
 | `user-click` | 用户信息点击时触发 | - | - |
 | `loginTitleClick` | 未登录文本点击时触发 | - | - |
+
+

package/components/ste-login-info/README.md

@@ -2,7 +2,7 @@
 
 ---$
 
-#### 完整展示
+## 完整展示
 
 ```html
 <template>
@@ -28,7 +28,7 @@
 </script>
 ```
 
-#### 未登录
+## 未登录
 
 - 通过 `loginStatus`设置登录状态，`0`：未登录，`1`：登录，默认为`1`
 - 通过 `loginSrc`设置未登录头像，默认为``
@@ -44,8 +44,6 @@
 
 ---$
 
-### API
-
 <!-- props -->
 
 ---$

package/components/ste-login-info/ste-login-info.easycom.json

@@ -77,20 +77,17 @@
         {
             "name": "[event]avatar-click",
             "description": "头像点击时触发",
-            "type": "(]) => void",
             "params": []
         },
         {
             "name": "[event]user-click",
             "description": "用户信息点击时触发",
-            "type": "(]) => void",
             "params": []
         },
         {
             "name": "[event]loginTitleClick",
             "description": "未登录文本点击时触发",
-            "type": "(]) => void",
             "params": []
         }
     ]
-}
+}

package/components/ste-marquee/ATTRIBUTES.md

@@ -0,0 +1,44 @@
+## API
+
+### Props
+| 属性名 | 说明  | 类型 | 默认值  | 可选值 | 支持版本 |
+| ----- | ----- | --- | ------- | ------ | -------- |
+| `list` | 数据列表 | `MarqueeItem[]` | `[]` | - | - |
+| `speed` | 滚动速度(px/s) | `number` | `50` | - | - |
+| `pauseOnHover` | 悬停时是否暂停 | `boolean` | `true` | - | - |
+| `loop` | 是否循环播放 | `boolean` | `true` | - | - |
+| `gap` | 消息之间的间距(rpx) | `number` | `20` | - | - |
+| `height` | 容器高度 | `string` | `auto` | - | - |
+| `fillScreen` | 是否填满屏幕宽度 | `boolean` | `false` | - | - |
+| `clickable` | 是否可点击 | `boolean` | `true` | - | - |
+| `containerBg` | 容器背景色 | `string` | `transparent` | - | - |
+| `containerPadding` | 容器内边距 | `string` | `0rpx` | - | - |
+| `containerRadius` | 容器圆角 | `string` | `0rpx` | - | - |
+| `itemBg` | 消息项背景色 | `string` | `transparent` | - | - |
+| `itemPadding` | 消息项内边距 | `string` | `0rpx 20rpx` | - | - |
+| `itemRadius` | 消息项圆角 | `string` | `0rpx` | - | - |
+
+
+### Events
+| 事件名 | 说明  | 事件参数 | 支持版本 |
+| ----- | ----- | ------- | -------- |
+| `click` | 点击消息时触发 | `item`：点击的数据项<br/>`index`：数据项索引 | - |
+| `complete` | 一轮播放完成时触发 | - | - |
+
+
+### Methods
+| 方法名 | 说明  | 参数 | 返回值 | 支持版本 |
+| ----- | ----- | --- | ------ | -------- |
+| `play` | 开始播放 | - | - | - |
+| `pause` | 暂停播放 | - | - | - |
+| `resume` | 恢复播放 | - | - | - |
+| `stop` | 停止播放并回到初始位置 | - | - | - |
+
+
+### Slots
+| 插槽名 | 说明  | 参数 | 支持版本 |
+| ----- | ----- | --- | -------- |
+| `default` | 默认插槽，自定义整个内容区域 | - | - |
+| `item` | 自定义单项内容 | `item`：数据项对象<br/>`index`：数据项索引 | - |
+
+

package/components/ste-marquee/README.md

@@ -0,0 +1,123 @@
+# ste-marquee 走马灯
+
+用于展示滚动公告、中奖名单等水平滚动信息。
+
+---$
+
+## 使用场景
+
+- 抽奖活动中奖名单滚动展示
+- 系统公告、通知滚动
+- 实时交易动态
+- 新闻头条滚动
+
+## 基础用法
+
+```vue
+<template>
+    <ste-marquee :list="list" />
+</template>
+
+<script setup lang="ts">
+import { ref } from 'vue';
+
+const list = ref([
+    { id: 1, text: '恭喜用户138****1234获得一等奖' },
+    { id: 2, text: '恭喜用户139****5678获得二等奖' },
+    { id: 3, text: '恭喜用户137****9012获得三等奖' },
+]);
+</script>
+```
+
+## 自定义样式
+
+```vue
+<ste-marquee :list="list" containerBg="#f5f5f5" containerPadding="20rpx" containerRadius="16rpx" itemBg="#ffffff" itemPadding="16rpx 24rpx" itemRadius="8rpx" />
+```
+
+## 填满屏幕
+
+当数据较少时，使用 `fillScreen` 自动复制数据填满屏幕，实现流畅滚动：
+
+```vue
+<ste-marquee :list="shortList" :fillScreen="true" />
+```
+
+## 调整滚动速度
+
+```vue
+<ste-marquee :list="list" :speed="100" />
+```
+
+## 使用插槽自定义内容
+
+```vue
+<ste-marquee :list="list">
+    <template #item="{ item, index }">
+        <view class="custom-item">
+            <image :src="item.avatar" class="avatar" />
+            <text>{{ item.text }}</text>
+        </view>
+    </template>
+</ste-marquee>
+```
+
+## 播放控制
+
+通过 ref 可以控制走马灯的播放、暂停和停止：
+
+```vue
+<template>
+    <ste-marquee ref="marqueeRef" :list="list" />
+    <button @click="play">播放</button>
+    <button @click="pause">暂停</button>
+    <button @click="stop">停止</button>
+</template>
+
+<script setup>
+import { ref } from 'vue';
+
+const marqueeRef = ref();
+
+const play = () => marqueeRef.value?.play();
+const pause = () => marqueeRef.value?.pause();
+const stop = () => marqueeRef.value?.stop();
+</script>
+```
+
+## 点击事件
+
+```vue
+<ste-marquee :list="list" @click="onClick" />
+
+<script setup>
+const onClick = (item, index) => {
+    console.log('点击了:', item.text);
+};
+</script>
+```
+
+## 数据类型
+
+```typescript
+interface MarqueeItem {
+    /** 唯一标识 */
+    id: string | number;
+    /** 显示文本 */
+    text: string;
+    /** 图标URL（可选） */
+    icon?: string;
+    /** 文本颜色（可选） */
+    color?: string;
+    /** 背景色（可选） */
+    background?: string;
+}
+```
+
+---$
+
+<!-- props -->
+
+---$
+
+{{xuyajun}}

package/components/ste-marquee/config.json

@@ -0,0 +1,5 @@
+{
+	"group": "展示组件",
+	"title": "Marquee 走马灯",
+	"icon": "https://image.whzb.com/chain/StellarUI/%E7%BB%84%E4%BB%B6%E5%9B%BE%E6%A0%87/marquee.png"
+}

package/components/ste-marquee/props.ts

@@ -0,0 +1,106 @@
+// 走马灯组件 Props 类型定义
+
+export interface MarqueeItem {
+    /** 唯一标识 */
+    id: string | number;
+    /** 显示文本 */
+    text: string;
+    /** 图标URL（可选） */
+    icon?: string;
+    /** 文本颜色（可选） */
+    color?: string;
+    /** 背景色（可选） */
+    background?: string;
+    /** 自定义数据（可选） */
+    data?: any;
+}
+
+export interface MarqueeProps {
+    /** 数据列表 */
+    list: MarqueeItem[];
+    /** 滚动速度(px/s) */
+    speed: number;
+    /** 悬停是否暂停 */
+    pauseOnHover: boolean;
+    /** 是否循环播放 */
+    loop: boolean;
+    /** 消息间隔(px) */
+    gap: number;
+    /** 容器高度 */
+    height: string;
+    /** 是否填满屏幕 */
+    fillScreen: boolean;
+    /** 是否可点击 */
+    clickable: boolean;
+    /** 容器背景色 */
+    containerBg: string;
+    /** 容器内边距 */
+    containerPadding: string;
+    /** 容器圆角 */
+    containerRadius: string;
+    /** 消息项背景色 */
+    itemBg: string;
+    /** 消息项内边距 */
+    itemPadding: string;
+    /** 消息项圆角 */
+    itemRadius: string;
+}
+
+export default {
+    list: {
+        type: Array as () => MarqueeItem[],
+        default: () => [],
+    },
+    speed: {
+        type: Number,
+        default: 50,
+    },
+    pauseOnHover: {
+        type: Boolean,
+        default: true,
+    },
+    loop: {
+        type: Boolean,
+        default: true,
+    },
+    gap: {
+        type: Number,
+        default: 20,
+    },
+    height: {
+        type: String,
+        default: 'auto',
+    },
+    fillScreen: {
+        type: Boolean,
+        default: false,
+    },
+    clickable: {
+        type: Boolean,
+        default: true,
+    },
+    containerBg: {
+        type: String,
+        default: 'transparent',
+    },
+    containerPadding: {
+        type: String,
+        default: '0rpx',
+    },
+    containerRadius: {
+        type: String,
+        default: '0rpx',
+    },
+    itemBg: {
+        type: String,
+        default: 'transparent',
+    },
+    itemPadding: {
+        type: String,
+        default: '0rpx 20rpx',
+    },
+    itemRadius: {
+        type: String,
+        default: '0rpx',
+    },
+} satisfies Record<keyof MarqueeProps, any>;