From d40e1b6ac605dd5f7c88ecb8e67f040ee3b52333 Mon Sep 17 00:00:00 2001 From: RSS1102 Date: Thu, 16 Oct 2025 19:07:14 +0800 Subject: [PATCH 1/9] feat(Swiper): add Boolean type support for navigation --- db/TDesign.db | Bin 1056768 -> 1056768 bytes .../tdesign-mobile-vue/src/swiper/props.ts | 86 ++++++++++++++ .../src/swiper/swiper.en-US.md | 18 ++- .../tdesign-mobile-vue/src/swiper/swiper.md | 18 ++- .../tdesign-mobile-vue/src/swiper/type.ts | 108 ++++++++++++++++++ .../components/swiper/defaultProps.ts | 1 + .../components/swiper/swiper.en-US.md | 9 +- .../packages/components/swiper/swiper.md | 9 +- .../packages/components/swiper/type.ts | 3 +- .../packages/components/swiper/props.ts | 3 +- .../components/swiper/swiper.en-US.md | 38 ++++++ .../packages/components/swiper/swiper.md | 38 ++++++ .../packages/components/swiper/type.ts | 3 +- .../products/tdesign-vue/src/swiper/props.ts | 3 +- .../tdesign-vue/src/swiper/swiper.en-US.md | 10 +- .../products/tdesign-vue/src/swiper/swiper.md | 10 +- .../products/tdesign-vue/src/swiper/type.ts | 3 +- packages/scripts/api.json | 16 +-- 18 files changed, 331 insertions(+), 45 deletions(-) create mode 100644 packages/products/tdesign-mobile-vue/src/swiper/props.ts create mode 100644 packages/products/tdesign-mobile-vue/src/swiper/type.ts diff --git a/db/TDesign.db b/db/TDesign.db index 284abe4371afc905e2955ada58d37c31460ee032..73d037ff3362aed2aa0682592c77f48456f44672 100644 GIT binary patch delta 203 zcmZoT;LvcuVS+T{j)^kPj5`_=S`!#s6PQ{Pn71adEIcpH_k}@}!GeJ+mot*%CWkS5 zI?Dq73I>bm5*Jt$OdF+oI3<}FB{>xtMS0B`ICzbX88R6-Ie0mE893PgNC%f^7Ni#C zC6;BTCzfR9=jD_Xm8MQtz0VRXrck5cR+^U#5(P4y^7C_26Y~_dU%S8}$H&6Jz|hkE m;~onTvjQ<25VHd@2M}`tF&7YX12GQ}^8zv7_8<57IUE5`N=h#P delta 125 zcmZoT;LvcuVS+T{_K7mijN2O%S`!#s6PQ{Pn71adEIcpHz`!8NaE*a0mot*%CWkS5 zI?Dq73cfGXB`&ZiOjds|Z~L_iEOLA-jSM}U?LY3Z05K~NvjH(X5OV-ANSq6Zxq+Am Ph, + default: 'slide' as TdSwiperProps['animation'], + validator(val: TdSwiperProps['animation']): boolean { + if (!val) return true; + return ['slide'].includes(val); + }, + }, + /** 是否自动播放 */ + autoplay: { + type: Boolean, + default: true, + }, + /** 当前轮播在哪一项(下标) */ + current: { + type: Number, + default: undefined, + }, + modelValue: { + type: Number, + default: undefined, + }, + /** 当前轮播在哪一项(下标),非受控属性 */ + defaultCurrent: { + type: Number, + default: 0, + }, + /** 轮播滑动方向,包括横向滑动和纵向滑动两个方向 */ + direction: { + type: String as PropType, + default: 'horizontal' as TdSwiperProps['direction'], + validator(val: TdSwiperProps['direction']): boolean { + if (!val) return true; + return ['horizontal', 'vertical'].includes(val); + }, + }, + /** 滑动动画时长 */ + duration: { + type: Number, + default: 300, + }, + /** 轮播的高度 */ + height: { + type: [String, Number] as PropType, + }, + /** 轮播间隔时间 */ + interval: { + type: Number, + default: 5000, + }, + /** 是否循环播放 */ + loop: { + type: Boolean, + default: true, + }, + /** 导航器全部配置 */ + navigation: { + type: [Boolean, Object, Function, Function] as PropType, + default: true as TdSwiperProps['navigation'], + }, + /** 【开发中】后边距,可用于露出后一项的一小部分。默认单位 `px` */ + nextMargin: { + type: [String, Number] as PropType, + default: 0 as TdSwiperProps['nextMargin'], + }, + /** 【开发中】前边距,可用于露出前一项的一小部分。默认单位 `px` */ + previousMargin: { + type: [String, Number] as PropType, + default: 0 as TdSwiperProps['previousMargin'], + }, + /** 轮播切换时触发 */ + onChange: Function as PropType, + /** 点击轮播项时触发 */ + onClick: Function as PropType, +}; diff --git a/packages/products/tdesign-mobile-vue/src/swiper/swiper.en-US.md b/packages/products/tdesign-mobile-vue/src/swiper/swiper.en-US.md index 4dbc94491..f3ecd0b0e 100644 --- a/packages/products/tdesign-mobile-vue/src/swiper/swiper.en-US.md +++ b/packages/products/tdesign-mobile-vue/src/swiper/swiper.en-US.md @@ -1,7 +1,6 @@ -:: BASE_DOC :: - -## API - +:: BASE_DOC :: + +## API ### Swiper Props name | type | default | description | required @@ -14,7 +13,7 @@ duration | Number | 300 | \- | N height | String / Number | - | \- | N interval | Number | 5000 | \- | N loop | Boolean | true | \- | N -navigation | Object / Slot / Function | - | Typescript:`SwiperNavigation \| TNode`。[see more ts definition](https://github.com/Tencent/tdesign-mobile-vue/blob/develop/src/common.ts) | N +navigation | Boolean / Object / Function / Slot / Function | true | Typescript:`SwiperNavigation \| TNode \| Function \| Boolean `。[see more ts definition](https://github.com/Tencent/tdesign-mobile-vue/blob/develop/src/common.ts) | N nextMargin | String / Number | 0 | \- | N previousMargin | String / Number | 0 | \- | N onChange | Function | | Typescript:`(current: number, context: { source: SwiperChangeSource }) => void`
[see more ts definition](https://github.com/Tencent/tdesign-mobile-vue/tree/develop/src/swiper/type.ts)。
`type SwiperChangeSource = 'autoplay' \| 'touch' \| 'nav'`
| N @@ -26,3 +25,12 @@ name | params | description -- | -- | -- change | `(current: number, context: { source: SwiperChangeSource })` | [see more ts definition](https://github.com/Tencent/tdesign-mobile-vue/tree/develop/src/swiper/type.ts)。
`type SwiperChangeSource = 'autoplay' \| 'touch' \| 'nav'`
click | `(index: number)` | \- + +### SwiperNavigation + +name | type | default | description | required +-- | -- | -- | -- | -- +minShowNum | Number | - | \- | N +paginationPosition | String | bottom | options: top-left/top/top-right/bottom-left/bottom/bottom-right/left/right | N +showControls | Boolean | false | \- | N +type | String | - | Typescript:`SwiperNavigationType` `type SwiperNavigationType = 'dots' \| 'dots-bar' \| 'fraction'`。[see more ts definition](https://github.com/Tencent/tdesign-mobile-vue/tree/develop/src/swiper/type.ts) | N diff --git a/packages/products/tdesign-mobile-vue/src/swiper/swiper.md b/packages/products/tdesign-mobile-vue/src/swiper/swiper.md index a78ced3b2..93b21bd36 100644 --- a/packages/products/tdesign-mobile-vue/src/swiper/swiper.md +++ b/packages/products/tdesign-mobile-vue/src/swiper/swiper.md @@ -1,7 +1,6 @@ -:: BASE_DOC :: - -## API - +:: BASE_DOC :: + +## API ### Swiper Props 名称 | 类型 | 默认值 | 描述 | 必传 @@ -14,7 +13,7 @@ duration | Number | 300 | 滑动动画时长 | N height | String / Number | - | 轮播的高度 | N interval | Number | 5000 | 轮播间隔时间 | N loop | Boolean | true | 是否循环播放 | N -navigation | Object / Slot / Function | - | 导航器全部配置。TS 类型:`SwiperNavigation \| TNode`。[通用类型定义](https://github.com/Tencent/tdesign-mobile-vue/blob/develop/src/common.ts) | N +navigation | Boolean / Object / Function / Slot / Function | true | 导航器全部配置。TS 类型:`SwiperNavigation \| TNode \| Function \| Boolean `。[通用类型定义](https://github.com/Tencent/tdesign-mobile-vue/blob/develop/src/common.ts) | N nextMargin | String / Number | 0 | 【开发中】后边距,可用于露出后一项的一小部分。默认单位 `px` | N previousMargin | String / Number | 0 | 【开发中】前边距,可用于露出前一项的一小部分。默认单位 `px` | N onChange | Function | | TS 类型:`(current: number, context: { source: SwiperChangeSource }) => void`
轮播切换时触发。[详细类型定义](https://github.com/Tencent/tdesign-mobile-vue/tree/develop/src/swiper/type.ts)。
`type SwiperChangeSource = 'autoplay' \| 'touch' \| 'nav'`
| N @@ -26,3 +25,12 @@ onClick | Function | | TS 类型:`(index: number) => void`
点击轮播 -- | -- | -- change | `(current: number, context: { source: SwiperChangeSource })` | 轮播切换时触发。[详细类型定义](https://github.com/Tencent/tdesign-mobile-vue/tree/develop/src/swiper/type.ts)。
`type SwiperChangeSource = 'autoplay' \| 'touch' \| 'nav'`
click | `(index: number)` | 点击轮播项时触发 + +### SwiperNavigation + +名称 | 类型 | 默认值 | 描述 | 必传 +-- | -- | -- | -- | -- +minShowNum | Number | - | 小于这个数字不会显示导航器 | N +paginationPosition | String | bottom | 页码信息展示位置。可选项:top-left/top/top-right/bottom-left/bottom/bottom-right/left/right | N +showControls | Boolean | false | 是否显示两侧的控制按钮 | N +type | String | - | 导航器类型,点状(dots)、点条状(dots-bar)、分式(fraction)等。TS 类型:`SwiperNavigationType` `type SwiperNavigationType = 'dots' \| 'dots-bar' \| 'fraction'`。[详细类型定义](https://github.com/Tencent/tdesign-mobile-vue/tree/develop/src/swiper/type.ts) | N diff --git a/packages/products/tdesign-mobile-vue/src/swiper/type.ts b/packages/products/tdesign-mobile-vue/src/swiper/type.ts new file mode 100644 index 000000000..2ab88567a --- /dev/null +++ b/packages/products/tdesign-mobile-vue/src/swiper/type.ts @@ -0,0 +1,108 @@ +/* eslint-disable */ + +/** + * 该文件为脚本自动生成文件,请勿随意修改。如需修改请联系 PMC + * */ + +import { TNode } from '../common'; + +export interface TdSwiperProps { + /** + * 轮播切换动画效果类型 + * @default slide + */ + animation?: 'slide'; + /** + * 是否自动播放 + * @default true + */ + autoplay?: boolean; + /** + * 当前轮播在哪一项(下标) + * @default 0 + */ + current?: number; + /** + * 当前轮播在哪一项(下标),非受控属性 + * @default 0 + */ + defaultCurrent?: number; + /** + * 当前轮播在哪一项(下标) + * @default 0 + */ + modelValue?: number; + /** + * 轮播滑动方向,包括横向滑动和纵向滑动两个方向 + * @default horizontal + */ + direction?: 'horizontal' | 'vertical'; + /** + * 滑动动画时长 + * @default 300 + */ + duration?: number; + /** + * 轮播的高度 + */ + height?: string | number; + /** + * 轮播间隔时间 + * @default 5000 + */ + interval?: number; + /** + * 是否循环播放 + * @default true + */ + loop?: boolean; + /** + * 导航器全部配置 + * @default true + */ + navigation?: SwiperNavigation | TNode | Function | Boolean; + /** + * 【开发中】后边距,可用于露出后一项的一小部分。默认单位 `px` + * @default 0 + */ + nextMargin?: string | number; + /** + * 【开发中】前边距,可用于露出前一项的一小部分。默认单位 `px` + * @default 0 + */ + previousMargin?: string | number; + /** + * 轮播切换时触发 + */ + onChange?: (current: number, context: { source: SwiperChangeSource }) => void; + /** + * 点击轮播项时触发 + */ + onClick?: (index: number) => void; +} + +export interface SwiperNavigation { + /** + * 小于这个数字不会显示导航器 + */ + minShowNum?: number; + /** + * 页码信息展示位置 + * @default bottom + */ + paginationPosition?: 'top-left' | 'top' | 'top-right' | 'bottom-left' | 'bottom' | 'bottom-right' | 'left' | 'right'; + /** + * 是否显示两侧的控制按钮 + * @default false + */ + showControls?: boolean; + /** + * 导航器类型,点状(dots)、点条状(dots-bar)、分式(fraction)等 + * @default '' + */ + type?: SwiperNavigationType; +} + +export type SwiperChangeSource = 'autoplay' | 'touch' | 'nav'; + +export type SwiperNavigationType = 'dots' | 'dots-bar' | 'fraction'; diff --git a/packages/products/tdesign-react/packages/components/swiper/defaultProps.ts b/packages/products/tdesign-react/packages/components/swiper/defaultProps.ts index d6f346b1a..6399f9f6c 100644 --- a/packages/products/tdesign-react/packages/components/swiper/defaultProps.ts +++ b/packages/products/tdesign-react/packages/components/swiper/defaultProps.ts @@ -13,6 +13,7 @@ export const swiperDefaultProps: TdSwiperProps = { duration: 300, interval: 5000, loop: true, + navigation: true, stopOnHover: true, theme: 'light', trigger: 'hover', diff --git a/packages/products/tdesign-react/packages/components/swiper/swiper.en-US.md b/packages/products/tdesign-react/packages/components/swiper/swiper.en-US.md index c0619a6cb..6dc9e354a 100644 --- a/packages/products/tdesign-react/packages/components/swiper/swiper.en-US.md +++ b/packages/products/tdesign-react/packages/components/swiper/swiper.en-US.md @@ -1,7 +1,6 @@ -:: BASE_DOC :: - -## API - +:: BASE_DOC :: + +## API ### Swiper Props name | type | default | description | required @@ -17,7 +16,7 @@ duration | Number | 300 | \- | N height | Number | - | \- | N interval | Number | 5000 | \- | N loop | Boolean | true | \- | N -navigation | TNode | - | Typescript:`SwiperNavigation \| TNode`。[see more ts definition](https://github.com/Tencent/tdesign-react/blob/develop/packages/components/common.ts) | N +navigation | TNode | true | Typescript:`SwiperNavigation \| TNode \| Function \| Boolean `。[see more ts definition](https://github.com/Tencent/tdesign-react/blob/develop/packages/components/common.ts) | N stopOnHover | Boolean | true | \- | N theme | String | light | options: light/dark | N trigger | String | hover | options: hover/click | N diff --git a/packages/products/tdesign-react/packages/components/swiper/swiper.md b/packages/products/tdesign-react/packages/components/swiper/swiper.md index f922ca2a6..805184da8 100644 --- a/packages/products/tdesign-react/packages/components/swiper/swiper.md +++ b/packages/products/tdesign-react/packages/components/swiper/swiper.md @@ -1,7 +1,6 @@ -:: BASE_DOC :: - -## API - +:: BASE_DOC :: + +## API ### Swiper Props 名称 | 类型 | 默认值 | 描述 | 必传 @@ -17,7 +16,7 @@ duration | Number | 300 | 滑动动画时长 | N height | Number | - | 当使用垂直方向滚动时的高度 | N interval | Number | 5000 | 轮播间隔时间 | N loop | Boolean | true | 是否循环播放 | N -navigation | TNode | - | 导航器全部配置。TS 类型:`SwiperNavigation \| TNode`。[通用类型定义](https://github.com/Tencent/tdesign-react/blob/develop/packages/components/common.ts) | N +navigation | TNode | true | 导航器全部配置。TS 类型:`SwiperNavigation \| TNode \| Function \| Boolean `。[通用类型定义](https://github.com/Tencent/tdesign-react/blob/develop/packages/components/common.ts) | N stopOnHover | Boolean | true | 是否悬浮时停止轮播 | N theme | String | light | 深色模式和浅色模式。可选项:light/dark | N trigger | String | hover | 触发切换的方式:悬浮、点击等。可选项:hover/click | N diff --git a/packages/products/tdesign-react/packages/components/swiper/type.ts b/packages/products/tdesign-react/packages/components/swiper/type.ts index 366a9f8d8..74da4ba36 100644 --- a/packages/products/tdesign-react/packages/components/swiper/type.ts +++ b/packages/products/tdesign-react/packages/components/swiper/type.ts @@ -58,8 +58,9 @@ export interface TdSwiperProps { loop?: boolean; /** * 导航器全部配置 + * @default true */ - navigation?: SwiperNavigation | TNode; + navigation?: SwiperNavigation | TNode | Function | Boolean; /** * 是否悬浮时停止轮播 * @default true diff --git a/packages/products/tdesign-vue-next/packages/components/swiper/props.ts b/packages/products/tdesign-vue-next/packages/components/swiper/props.ts index eff3d4636..ea7e3ff47 100644 --- a/packages/products/tdesign-vue-next/packages/components/swiper/props.ts +++ b/packages/products/tdesign-vue-next/packages/components/swiper/props.ts @@ -70,7 +70,8 @@ export default { }, /** 导航器全部配置 */ navigation: { - type: [Object, Function] as PropType, + type: [Boolean, Object, Function, Function] as PropType, + default: true as TdSwiperProps['navigation'], }, /** 是否悬浮时停止轮播 */ stopOnHover: { diff --git a/packages/products/tdesign-vue-next/packages/components/swiper/swiper.en-US.md b/packages/products/tdesign-vue-next/packages/components/swiper/swiper.en-US.md index e2e520ee4..6d2857325 100644 --- a/packages/products/tdesign-vue-next/packages/components/swiper/swiper.en-US.md +++ b/packages/products/tdesign-vue-next/packages/components/swiper/swiper.en-US.md @@ -37,3 +37,41 @@ placement | String | inside | options: inside/outside | N showSlideBtn | String | always | options: always/hover/never | N size | String | medium | options: small/medium/large | N type | String | - | Typescript:`SwiperNavigationType` `type SwiperNavigationType = 'dots' \| 'dots-bar' \| 'bars' \| 'fraction'`。[see more ts definition](https://github.com/Tencent/tdesign-vue-next/blob/develop/packages/components/swiper/type.ts) | N + +## API + + +### Swiper Props + +name | type | default | description | required +-- | -- | -- | -- | -- +animation | String | slide | options: slide/fade | N +autoplay | Boolean | true | \- | N +cardScale | Number | 210/332 | \- | N +current | Number | 0 | `v-model` and `v-model:current` is supported | N +direction | String | horizontal | options: horizontal/vertical | N +duration | Number | 300 | \- | N +height | Number | - | \- | N +interval | Number | 5000 | \- | N +loop | Boolean | true | \- | N +navigation | Boolean / Object / Function / Slot / Function | true | Typescript:`SwiperNavigation \| TNode \| Function \| Boolean `。[see more ts definition](https://github.com/Tencent/tdesign-vue-next/blob/develop/packages/components/common.ts) | N +stopOnHover | Boolean | true | \- | N +theme | String | light | options: light/dark | N +trigger | String | hover | options: hover/click | N +type | String | default | options: default/card | N +onChange | Function | | Typescript:`(current: number, context: { source: SwiperChangeSource }) => void`
[see more ts definition](https://github.com/Tencent/tdesign-vue-next/blob/develop/packages/components/swiper/type.ts)。
`type SwiperChangeSource = 'autoplay' \| 'click' \| 'hover'`
| N + +### Swiper Events + +name | params | description +-- | -- | -- +change | `(current: number, context: { source: SwiperChangeSource })` | [see more ts definition](https://github.com/Tencent/tdesign-vue-next/blob/develop/packages/components/swiper/type.ts)。
`type SwiperChangeSource = 'autoplay' \| 'click' \| 'hover'`
+ +### SwiperNavigation + +name | type | default | description | required +-- | -- | -- | -- | -- +placement | String | inside | options: inside/outside | N +showSlideBtn | String | always | options: always/hover/never | N +size | String | medium | options: small/medium/large | N +type | String | - | Typescript:`SwiperNavigationType` `type SwiperNavigationType = 'dots' \| 'dots-bar' \| 'bars' \| 'fraction'`。[see more ts definition](https://github.com/Tencent/tdesign-vue-next/blob/develop/packages/components/swiper/type.ts) | N diff --git a/packages/products/tdesign-vue-next/packages/components/swiper/swiper.md b/packages/products/tdesign-vue-next/packages/components/swiper/swiper.md index 34f80d89a..02b6a069a 100644 --- a/packages/products/tdesign-vue-next/packages/components/swiper/swiper.md +++ b/packages/products/tdesign-vue-next/packages/components/swiper/swiper.md @@ -37,3 +37,41 @@ placement | String | inside | 导航器位置,位于主体的内侧或是外 showSlideBtn | String | always | 何时显示导航器的翻页按钮:始终显示、悬浮显示、永不显示。可选项:always/hover/never | N size | String | medium | 导航器尺寸。可选项:small/medium/large | N type | String | - | 导航器类型,点状(dots)、点条状(dots-bar)、条状(bars)、分式(fraction)等。TS 类型:`SwiperNavigationType` `type SwiperNavigationType = 'dots' \| 'dots-bar' \| 'bars' \| 'fraction'`。[详细类型定义](https://github.com/Tencent/tdesign-vue-next/blob/develop/packages/components/swiper/type.ts) | N + +## API + + +### Swiper Props + +名称 | 类型 | 默认值 | 描述 | 必传 +-- | -- | -- | -- | -- +animation | String | slide | 轮播切换动画效果类型:滑动、淡入淡出等。可选项:slide/fade | N +autoplay | Boolean | true | 是否自动播放 | N +cardScale | Number | 210/332 | 卡片模式下非当前展示轮播图的缩放比例 | N +current | Number | 0 | 当前轮播在哪一项(下标)。支持语法糖 `v-model` 或 `v-model:current` | N +direction | String | horizontal | 轮播滑动方向,包括横向滑动和纵向滑动两个方向。可选项:horizontal/vertical | N +duration | Number | 300 | 滑动动画时长 | N +height | Number | - | 当使用垂直方向滚动时的高度 | N +interval | Number | 5000 | 轮播间隔时间 | N +loop | Boolean | true | 是否循环播放 | N +navigation | Boolean / Object / Function / Slot / Function | true | 导航器全部配置。TS 类型:`SwiperNavigation \| TNode \| Function \| Boolean `。[通用类型定义](https://github.com/Tencent/tdesign-vue-next/blob/develop/packages/components/common.ts) | N +stopOnHover | Boolean | true | 是否悬浮时停止轮播 | N +theme | String | light | 深色模式和浅色模式。可选项:light/dark | N +trigger | String | hover | 触发切换的方式:悬浮、点击等。可选项:hover/click | N +type | String | default | 样式类型:默认样式、卡片样式。可选项:default/card | N +onChange | Function | | TS 类型:`(current: number, context: { source: SwiperChangeSource }) => void`
轮播切换时触发。[详细类型定义](https://github.com/Tencent/tdesign-vue-next/blob/develop/packages/components/swiper/type.ts)。
`type SwiperChangeSource = 'autoplay' \| 'click' \| 'hover'`
| N + +### Swiper Events + +名称 | 参数 | 描述 +-- | -- | -- +change | `(current: number, context: { source: SwiperChangeSource })` | 轮播切换时触发。[详细类型定义](https://github.com/Tencent/tdesign-vue-next/blob/develop/packages/components/swiper/type.ts)。
`type SwiperChangeSource = 'autoplay' \| 'click' \| 'hover'`
+ +### SwiperNavigation + +名称 | 类型 | 默认值 | 描述 | 必传 +-- | -- | -- | -- | -- +placement | String | inside | 导航器位置,位于主体的内侧或是外侧。可选项:inside/outside | N +showSlideBtn | String | always | 何时显示导航器的翻页按钮:始终显示、悬浮显示、永不显示。可选项:always/hover/never | N +size | String | medium | 导航器尺寸。可选项:small/medium/large | N +type | String | - | 导航器类型,点状(dots)、点条状(dots-bar)、条状(bars)、分式(fraction)等。TS 类型:`SwiperNavigationType` `type SwiperNavigationType = 'dots' \| 'dots-bar' \| 'bars' \| 'fraction'`。[详细类型定义](https://github.com/Tencent/tdesign-vue-next/blob/develop/packages/components/swiper/type.ts) | N diff --git a/packages/products/tdesign-vue-next/packages/components/swiper/type.ts b/packages/products/tdesign-vue-next/packages/components/swiper/type.ts index 796189505..ba048fe58 100644 --- a/packages/products/tdesign-vue-next/packages/components/swiper/type.ts +++ b/packages/products/tdesign-vue-next/packages/components/swiper/type.ts @@ -63,8 +63,9 @@ export interface TdSwiperProps { loop?: boolean; /** * 导航器全部配置 + * @default true */ - navigation?: SwiperNavigation | TNode; + navigation?: SwiperNavigation | TNode | Function | Boolean; /** * 是否悬浮时停止轮播 * @default true diff --git a/packages/products/tdesign-vue/src/swiper/props.ts b/packages/products/tdesign-vue/src/swiper/props.ts index 5b3b9abc1..0770f0ab9 100644 --- a/packages/products/tdesign-vue/src/swiper/props.ts +++ b/packages/products/tdesign-vue/src/swiper/props.ts @@ -66,7 +66,8 @@ export default { }, /** 导航器全部配置 */ navigation: { - type: [Object, Function] as PropType, + type: [Boolean, Object, Function, Function] as PropType, + default: true, }, /** 是否悬浮时停止轮播 */ stopOnHover: { diff --git a/packages/products/tdesign-vue/src/swiper/swiper.en-US.md b/packages/products/tdesign-vue/src/swiper/swiper.en-US.md index bc83214c9..1ad1f1e80 100644 --- a/packages/products/tdesign-vue/src/swiper/swiper.en-US.md +++ b/packages/products/tdesign-vue/src/swiper/swiper.en-US.md @@ -1,8 +1,6 @@ -:: BASE_DOC :: - -## API - - +:: BASE_DOC :: + +## API ### Swiper Props name | type | default | description | required @@ -16,7 +14,7 @@ duration | Number | 300 | \- | N height | Number | - | \- | N interval | Number | 5000 | \- | N loop | Boolean | true | \- | N -navigation | Object / Slot / Function | - | Typescript:`SwiperNavigation \| TNode`。[see more ts definition](https://github.com/Tencent/tdesign-vue/blob/develop/src/common.ts) | N +navigation | Boolean / Object / Function / Slot / Function | true | Typescript:`SwiperNavigation \| TNode \| Function \| Boolean `。[see more ts definition](https://github.com/Tencent/tdesign-vue/blob/develop/src/common.ts) | N stopOnHover | Boolean | true | \- | N theme | String | light | options: light/dark | N trigger | String | hover | options: hover/click | N diff --git a/packages/products/tdesign-vue/src/swiper/swiper.md b/packages/products/tdesign-vue/src/swiper/swiper.md index 1d3956613..8ce519f71 100644 --- a/packages/products/tdesign-vue/src/swiper/swiper.md +++ b/packages/products/tdesign-vue/src/swiper/swiper.md @@ -1,8 +1,6 @@ -:: BASE_DOC :: - -## API - - +:: BASE_DOC :: + +## API ### Swiper Props 名称 | 类型 | 默认值 | 描述 | 必传 @@ -16,7 +14,7 @@ duration | Number | 300 | 滑动动画时长 | N height | Number | - | 当使用垂直方向滚动时的高度 | N interval | Number | 5000 | 轮播间隔时间 | N loop | Boolean | true | 是否循环播放 | N -navigation | Object / Slot / Function | - | 导航器全部配置。TS 类型:`SwiperNavigation \| TNode`。[通用类型定义](https://github.com/Tencent/tdesign-vue/blob/develop/src/common.ts) | N +navigation | Boolean / Object / Function / Slot / Function | true | 导航器全部配置。TS 类型:`SwiperNavigation \| TNode \| Function \| Boolean `。[通用类型定义](https://github.com/Tencent/tdesign-vue/blob/develop/src/common.ts) | N stopOnHover | Boolean | true | 是否悬浮时停止轮播 | N theme | String | light | 深色模式和浅色模式。可选项:light/dark | N trigger | String | hover | 触发切换的方式:悬浮、点击等。可选项:hover/click | N diff --git a/packages/products/tdesign-vue/src/swiper/type.ts b/packages/products/tdesign-vue/src/swiper/type.ts index 366a9f8d8..74da4ba36 100644 --- a/packages/products/tdesign-vue/src/swiper/type.ts +++ b/packages/products/tdesign-vue/src/swiper/type.ts @@ -58,8 +58,9 @@ export interface TdSwiperProps { loop?: boolean; /** * 导航器全部配置 + * @default true */ - navigation?: SwiperNavigation | TNode; + navigation?: SwiperNavigation | TNode | Function | Boolean; /** * 是否悬浮时停止轮播 * @default true diff --git a/packages/scripts/api.json b/packages/scripts/api.json index 8f5c29ebf..7c8ecf26c 100644 --- a/packages/scripts/api.json +++ b/packages/scripts/api.json @@ -117353,19 +117353,19 @@ "platform_framework": [ "1", "2", - "4", "8", - "16", - "32" + "16" ], "component": "Swiper", "field_category": 1, "field_name": "navigation", "field_type": [ + "4", "8", + "32", "64" ], - "field_default_value": "", + "field_default_value": "true", "field_enum": "", "field_desc_zh": "导航器全部配置", "field_desc_en": null, @@ -117374,7 +117374,7 @@ "create_time": "2021-12-15 12:58:51", "update_time": "2022-01-25 11:57:28", "event_output": null, - "custom_field_type": "SwiperNavigation | TNode", + "custom_field_type": "SwiperNavigation | TNode | Function | Boolean ", "syntactic_sugar": null, "readonly": 1, "html_attribute": 0, @@ -117387,13 +117387,13 @@ "platform_framework_text": [ "Vue(PC)", "React(PC)", - "Angular(PC)", "Vue(Mobile)", - "React(Mobile)", - "Angular(Mobile)" + "React(Mobile)" ], "field_type_text": [ + "Boolean", "Object", + "Function", "TNode" ] }, From 0e0ef8e1321c1690dd054376c226c8c0ca8ac6a1 Mon Sep 17 00:00:00 2001 From: rss1102 Date: Thu, 16 Oct 2025 19:18:38 +0800 Subject: [PATCH 2/9] fix: add moble react docs --- .../src/swiper/defaultProps.ts | 1 + .../src/swiper/swiper.en-US.md | 2 +- .../tdesign-mobile-react/src/swiper/swiper.md | 2 +- .../tdesign-mobile-react/src/swiper/type.ts | 3 +- .../src/swiper/swiper.en-US.md | 37 ++++++++++++++++++ .../tdesign-mobile-vue/src/swiper/swiper.md | 37 ++++++++++++++++++ .../components/swiper/swiper.en-US.md | 34 ++++++++++++++++ .../packages/components/swiper/swiper.md | 34 ++++++++++++++++ .../components/swiper/swiper.en-US.md | 39 ------------------- .../packages/components/swiper/swiper.md | 39 ------------------- .../tdesign-vue/src/swiper/swiper.en-US.md | 38 ++++++++++++++++++ .../products/tdesign-vue/src/swiper/swiper.md | 38 ++++++++++++++++++ 12 files changed, 223 insertions(+), 81 deletions(-) diff --git a/packages/products/tdesign-mobile-react/src/swiper/defaultProps.ts b/packages/products/tdesign-mobile-react/src/swiper/defaultProps.ts index 3ec019f4c..7a4546502 100644 --- a/packages/products/tdesign-mobile-react/src/swiper/defaultProps.ts +++ b/packages/products/tdesign-mobile-react/src/swiper/defaultProps.ts @@ -12,6 +12,7 @@ export const swiperDefaultProps: TdSwiperProps = { duration: 300, interval: 5000, loop: true, + navigation: true, nextMargin: 0, previousMargin: 0, type: 'default', diff --git a/packages/products/tdesign-mobile-react/src/swiper/swiper.en-US.md b/packages/products/tdesign-mobile-react/src/swiper/swiper.en-US.md index c78f3dd5a..3243a215f 100644 --- a/packages/products/tdesign-mobile-react/src/swiper/swiper.en-US.md +++ b/packages/products/tdesign-mobile-react/src/swiper/swiper.en-US.md @@ -16,7 +16,7 @@ duration | Number | 300 | \- | N height | String / Number | - | \- | N interval | Number | 5000 | \- | N loop | Boolean | true | \- | N -navigation | TNode | - | Typescript:`SwiperNavigation \| TNode`。[see more ts definition](https://github.com/Tencent/tdesign-mobile-react/blob/develop/src/common.ts) | N +navigation | TNode | true | Typescript:`SwiperNavigation \| TNode \| Function \| Boolean `。[see more ts definition](https://github.com/Tencent/tdesign-mobile-react/blob/develop/src/common.ts) | N nextMargin | String / Number | 0 | \- | N previousMargin | String / Number | 0 | \- | N type | String | default | options: default/card | N diff --git a/packages/products/tdesign-mobile-react/src/swiper/swiper.md b/packages/products/tdesign-mobile-react/src/swiper/swiper.md index 2d581860c..aa3623832 100644 --- a/packages/products/tdesign-mobile-react/src/swiper/swiper.md +++ b/packages/products/tdesign-mobile-react/src/swiper/swiper.md @@ -16,7 +16,7 @@ duration | Number | 300 | 滑动动画时长 | N height | String / Number | - | 当使用垂直方向滚动时的高度 | N interval | Number | 5000 | 轮播间隔时间 | N loop | Boolean | true | 是否循环播放 | N -navigation | TNode | - | 导航器全部配置。TS 类型:`SwiperNavigation \| TNode`。[通用类型定义](https://github.com/Tencent/tdesign-mobile-react/blob/develop/src/common.ts) | N +navigation | TNode | true | 导航器全部配置。TS 类型:`SwiperNavigation \| TNode \| Function \| Boolean `。[通用类型定义](https://github.com/Tencent/tdesign-mobile-react/blob/develop/src/common.ts) | N nextMargin | String / Number | 0 | 后边距,可用于露出后一项的一小部分。默认单位 `px` | N previousMargin | String / Number | 0 | 前边距,可用于露出前一项的一小部分。默认单位 `px` | N type | String | default | 样式类型:默认样式、卡片样式。可选项:default/card | N diff --git a/packages/products/tdesign-mobile-react/src/swiper/type.ts b/packages/products/tdesign-mobile-react/src/swiper/type.ts index ce7124cf2..7385f551c 100644 --- a/packages/products/tdesign-mobile-react/src/swiper/type.ts +++ b/packages/products/tdesign-mobile-react/src/swiper/type.ts @@ -53,8 +53,9 @@ export interface TdSwiperProps { loop?: boolean; /** * 导航器全部配置 + * @default true */ - navigation?: SwiperNavigation | TNode; + navigation?: SwiperNavigation | TNode | Function | Boolean; /** * 后边距,可用于露出后一项的一小部分。默认单位 `px` * @default 0 diff --git a/packages/products/tdesign-mobile-vue/src/swiper/swiper.en-US.md b/packages/products/tdesign-mobile-vue/src/swiper/swiper.en-US.md index f3ecd0b0e..4a19b694b 100644 --- a/packages/products/tdesign-mobile-vue/src/swiper/swiper.en-US.md +++ b/packages/products/tdesign-mobile-vue/src/swiper/swiper.en-US.md @@ -34,3 +34,40 @@ minShowNum | Number | - | \- | N paginationPosition | String | bottom | options: top-left/top/top-right/bottom-left/bottom/bottom-right/left/right | N showControls | Boolean | false | \- | N type | String | - | Typescript:`SwiperNavigationType` `type SwiperNavigationType = 'dots' \| 'dots-bar' \| 'fraction'`。[see more ts definition](https://github.com/Tencent/tdesign-mobile-vue/tree/develop/src/swiper/type.ts) | N + +## API + + +### Swiper Props + +name | type | default | description | required +-- | -- | -- | -- | -- +animation | String | slide | options: slide | N +autoplay | Boolean | true | \- | N +current | Number | 0 | `v-model` and `v-model:current` is supported | N +direction | String | horizontal | options: horizontal/vertical | N +duration | Number | 300 | \- | N +height | String / Number | - | \- | N +interval | Number | 5000 | \- | N +loop | Boolean | true | \- | N +navigation | Boolean / Object / Function / Slot / Function | true | Typescript:`SwiperNavigation \| TNode \| Function \| Boolean `。[see more ts definition](https://github.com/Tencent/tdesign-mobile-vue/blob/develop/src/common.ts) | N +nextMargin | String / Number | 0 | \- | N +previousMargin | String / Number | 0 | \- | N +onChange | Function | | Typescript:`(current: number, context: { source: SwiperChangeSource }) => void`
[see more ts definition](https://github.com/Tencent/tdesign-mobile-vue/tree/develop/src/swiper/type.ts)。
`type SwiperChangeSource = 'autoplay' \| 'touch' \| 'nav'`
| N +onClick | Function | | Typescript:`(index: number) => void`
| N + +### Swiper Events + +name | params | description +-- | -- | -- +change | `(current: number, context: { source: SwiperChangeSource })` | [see more ts definition](https://github.com/Tencent/tdesign-mobile-vue/tree/develop/src/swiper/type.ts)。
`type SwiperChangeSource = 'autoplay' \| 'touch' \| 'nav'`
+click | `(index: number)` | \- + +### SwiperNavigation + +name | type | default | description | required +-- | -- | -- | -- | -- +minShowNum | Number | - | \- | N +paginationPosition | String | bottom | options: top-left/top/top-right/bottom-left/bottom/bottom-right/left/right | N +showControls | Boolean | false | \- | N +type | String | - | Typescript:`SwiperNavigationType` `type SwiperNavigationType = 'dots' \| 'dots-bar' \| 'fraction'`。[see more ts definition](https://github.com/Tencent/tdesign-mobile-vue/tree/develop/src/swiper/type.ts) | N diff --git a/packages/products/tdesign-mobile-vue/src/swiper/swiper.md b/packages/products/tdesign-mobile-vue/src/swiper/swiper.md index 93b21bd36..9d54ebfcf 100644 --- a/packages/products/tdesign-mobile-vue/src/swiper/swiper.md +++ b/packages/products/tdesign-mobile-vue/src/swiper/swiper.md @@ -34,3 +34,40 @@ minShowNum | Number | - | 小于这个数字不会显示导航器 | N paginationPosition | String | bottom | 页码信息展示位置。可选项:top-left/top/top-right/bottom-left/bottom/bottom-right/left/right | N showControls | Boolean | false | 是否显示两侧的控制按钮 | N type | String | - | 导航器类型,点状(dots)、点条状(dots-bar)、分式(fraction)等。TS 类型:`SwiperNavigationType` `type SwiperNavigationType = 'dots' \| 'dots-bar' \| 'fraction'`。[详细类型定义](https://github.com/Tencent/tdesign-mobile-vue/tree/develop/src/swiper/type.ts) | N + +## API + + +### Swiper Props + +名称 | 类型 | 默认值 | 描述 | 必传 +-- | -- | -- | -- | -- +animation | String | slide | 轮播切换动画效果类型。可选项:slide | N +autoplay | Boolean | true | 是否自动播放 | N +current | Number | 0 | 当前轮播在哪一项(下标)。支持语法糖 `v-model` 或 `v-model:current` | N +direction | String | horizontal | 轮播滑动方向,包括横向滑动和纵向滑动两个方向。可选项:horizontal/vertical | N +duration | Number | 300 | 滑动动画时长 | N +height | String / Number | - | 轮播的高度 | N +interval | Number | 5000 | 轮播间隔时间 | N +loop | Boolean | true | 是否循环播放 | N +navigation | Boolean / Object / Function / Slot / Function | true | 导航器全部配置。TS 类型:`SwiperNavigation \| TNode \| Function \| Boolean `。[通用类型定义](https://github.com/Tencent/tdesign-mobile-vue/blob/develop/src/common.ts) | N +nextMargin | String / Number | 0 | 【开发中】后边距,可用于露出后一项的一小部分。默认单位 `px` | N +previousMargin | String / Number | 0 | 【开发中】前边距,可用于露出前一项的一小部分。默认单位 `px` | N +onChange | Function | | TS 类型:`(current: number, context: { source: SwiperChangeSource }) => void`
轮播切换时触发。[详细类型定义](https://github.com/Tencent/tdesign-mobile-vue/tree/develop/src/swiper/type.ts)。
`type SwiperChangeSource = 'autoplay' \| 'touch' \| 'nav'`
| N +onClick | Function | | TS 类型:`(index: number) => void`
点击轮播项时触发 | N + +### Swiper Events + +名称 | 参数 | 描述 +-- | -- | -- +change | `(current: number, context: { source: SwiperChangeSource })` | 轮播切换时触发。[详细类型定义](https://github.com/Tencent/tdesign-mobile-vue/tree/develop/src/swiper/type.ts)。
`type SwiperChangeSource = 'autoplay' \| 'touch' \| 'nav'`
+click | `(index: number)` | 点击轮播项时触发 + +### SwiperNavigation + +名称 | 类型 | 默认值 | 描述 | 必传 +-- | -- | -- | -- | -- +minShowNum | Number | - | 小于这个数字不会显示导航器 | N +paginationPosition | String | bottom | 页码信息展示位置。可选项:top-left/top/top-right/bottom-left/bottom/bottom-right/left/right | N +showControls | Boolean | false | 是否显示两侧的控制按钮 | N +type | String | - | 导航器类型,点状(dots)、点条状(dots-bar)、分式(fraction)等。TS 类型:`SwiperNavigationType` `type SwiperNavigationType = 'dots' \| 'dots-bar' \| 'fraction'`。[详细类型定义](https://github.com/Tencent/tdesign-mobile-vue/tree/develop/src/swiper/type.ts) | N diff --git a/packages/products/tdesign-react/packages/components/swiper/swiper.en-US.md b/packages/products/tdesign-react/packages/components/swiper/swiper.en-US.md index 6dc9e354a..6fcf2e0c0 100644 --- a/packages/products/tdesign-react/packages/components/swiper/swiper.en-US.md +++ b/packages/products/tdesign-react/packages/components/swiper/swiper.en-US.md @@ -31,3 +31,37 @@ placement | String | inside | options: inside/outside | N showSlideBtn | String | always | options: always/hover/never | N size | String | medium | options: small/medium/large | N type | String | - | Typescript:`SwiperNavigationType` `type SwiperNavigationType = 'dots' \| 'dots-bar' \| 'bars' \| 'fraction'`。[see more ts definition](https://github.com/Tencent/tdesign-react/blob/develop/packages/components/swiper/type.ts) | N + +## API + + +### Swiper Props + +name | type | default | description | required +-- | -- | -- | -- | -- +className | String | - | className of component | N +style | Object | - | CSS(Cascading Style Sheets),Typescript:`React.CSSProperties` | N +animation | String | slide | options: slide/fade | N +autoplay | Boolean | true | \- | N +cardScale | Number | 210/332 | \- | N +current | Number | 0 | \- | N +direction | String | horizontal | options: horizontal/vertical | N +duration | Number | 300 | \- | N +height | Number | - | \- | N +interval | Number | 5000 | \- | N +loop | Boolean | true | \- | N +navigation | TNode | true | Typescript:`SwiperNavigation \| TNode \| Function \| Boolean `。[see more ts definition](https://github.com/Tencent/tdesign-react/blob/develop/packages/components/common.ts) | N +stopOnHover | Boolean | true | \- | N +theme | String | light | options: light/dark | N +trigger | String | hover | options: hover/click | N +type | String | default | options: default/card | N +onChange | Function | | Typescript:`(current: number, context: { source: SwiperChangeSource }) => void`
[see more ts definition](https://github.com/Tencent/tdesign-react/blob/develop/packages/components/swiper/type.ts)。
`type SwiperChangeSource = 'autoplay' \| 'click' \| 'hover'`
| N + +### SwiperNavigation + +name | type | default | description | required +-- | -- | -- | -- | -- +placement | String | inside | options: inside/outside | N +showSlideBtn | String | always | options: always/hover/never | N +size | String | medium | options: small/medium/large | N +type | String | - | Typescript:`SwiperNavigationType` `type SwiperNavigationType = 'dots' \| 'dots-bar' \| 'bars' \| 'fraction'`。[see more ts definition](https://github.com/Tencent/tdesign-react/blob/develop/packages/components/swiper/type.ts) | N diff --git a/packages/products/tdesign-react/packages/components/swiper/swiper.md b/packages/products/tdesign-react/packages/components/swiper/swiper.md index 805184da8..5aa9a41df 100644 --- a/packages/products/tdesign-react/packages/components/swiper/swiper.md +++ b/packages/products/tdesign-react/packages/components/swiper/swiper.md @@ -31,3 +31,37 @@ placement | String | inside | 导航器位置,位于主体的内侧或是外 showSlideBtn | String | always | 何时显示导航器的翻页按钮:始终显示、悬浮显示、永不显示。可选项:always/hover/never | N size | String | medium | 导航器尺寸。可选项:small/medium/large | N type | String | - | 导航器类型,点状(dots)、点条状(dots-bar)、条状(bars)、分式(fraction)等。TS 类型:`SwiperNavigationType` `type SwiperNavigationType = 'dots' \| 'dots-bar' \| 'bars' \| 'fraction'`。[详细类型定义](https://github.com/Tencent/tdesign-react/blob/develop/packages/components/swiper/type.ts) | N + +## API + + +### Swiper Props + +名称 | 类型 | 默认值 | 描述 | 必传 +-- | -- | -- | -- | -- +className | String | - | 类名 | N +style | Object | - | 样式,TS 类型:`React.CSSProperties` | N +animation | String | slide | 轮播切换动画效果类型:滑动、淡入淡出等。可选项:slide/fade | N +autoplay | Boolean | true | 是否自动播放 | N +cardScale | Number | 210/332 | 卡片模式下非当前展示轮播图的缩放比例 | N +current | Number | 0 | 当前轮播在哪一项(下标) | N +direction | String | horizontal | 轮播滑动方向,包括横向滑动和纵向滑动两个方向。可选项:horizontal/vertical | N +duration | Number | 300 | 滑动动画时长 | N +height | Number | - | 当使用垂直方向滚动时的高度 | N +interval | Number | 5000 | 轮播间隔时间 | N +loop | Boolean | true | 是否循环播放 | N +navigation | TNode | true | 导航器全部配置。TS 类型:`SwiperNavigation \| TNode \| Function \| Boolean `。[通用类型定义](https://github.com/Tencent/tdesign-react/blob/develop/packages/components/common.ts) | N +stopOnHover | Boolean | true | 是否悬浮时停止轮播 | N +theme | String | light | 深色模式和浅色模式。可选项:light/dark | N +trigger | String | hover | 触发切换的方式:悬浮、点击等。可选项:hover/click | N +type | String | default | 样式类型:默认样式、卡片样式。可选项:default/card | N +onChange | Function | | TS 类型:`(current: number, context: { source: SwiperChangeSource }) => void`
轮播切换时触发。[详细类型定义](https://github.com/Tencent/tdesign-react/blob/develop/packages/components/swiper/type.ts)。
`type SwiperChangeSource = 'autoplay' \| 'click' \| 'hover'`
| N + +### SwiperNavigation + +名称 | 类型 | 默认值 | 描述 | 必传 +-- | -- | -- | -- | -- +placement | String | inside | 导航器位置,位于主体的内侧或是外侧。可选项:inside/outside | N +showSlideBtn | String | always | 何时显示导航器的翻页按钮:始终显示、悬浮显示、永不显示。可选项:always/hover/never | N +size | String | medium | 导航器尺寸。可选项:small/medium/large | N +type | String | - | 导航器类型,点状(dots)、点条状(dots-bar)、条状(bars)、分式(fraction)等。TS 类型:`SwiperNavigationType` `type SwiperNavigationType = 'dots' \| 'dots-bar' \| 'bars' \| 'fraction'`。[详细类型定义](https://github.com/Tencent/tdesign-react/blob/develop/packages/components/swiper/type.ts) | N diff --git a/packages/products/tdesign-vue-next/packages/components/swiper/swiper.en-US.md b/packages/products/tdesign-vue-next/packages/components/swiper/swiper.en-US.md index 6d2857325..6e7bf74b5 100644 --- a/packages/products/tdesign-vue-next/packages/components/swiper/swiper.en-US.md +++ b/packages/products/tdesign-vue-next/packages/components/swiper/swiper.en-US.md @@ -2,45 +2,6 @@ ## API - -### Swiper Props - -name | type | default | description | required --- | -- | -- | -- | -- -animation | String | slide | options: slide/fade | N -autoplay | Boolean | true | \- | N -cardScale | Number | 210/332 | \- | N -current | Number | 0 | `v-model` and `v-model:current` is supported | N -direction | String | horizontal | options: horizontal/vertical | N -duration | Number | 300 | \- | N -height | Number | - | \- | N -interval | Number | 5000 | \- | N -loop | Boolean | true | \- | N -navigation | Object / Slot / Function | - | Typescript:`SwiperNavigation \| TNode`。[see more ts definition](https://github.com/Tencent/tdesign-vue-next/blob/develop/packages/components/common.ts) | N -stopOnHover | Boolean | true | \- | N -theme | String | light | options: light/dark | N -trigger | String | hover | options: hover/click | N -type | String | default | options: default/card | N -onChange | Function | | Typescript:`(current: number, context: { source: SwiperChangeSource }) => void`
[see more ts definition](https://github.com/Tencent/tdesign-vue-next/blob/develop/packages/components/swiper/type.ts)。
`type SwiperChangeSource = 'autoplay' \| 'click' \| 'hover'`
| N - -### Swiper Events - -name | params | description --- | -- | -- -change | `(current: number, context: { source: SwiperChangeSource })` | [see more ts definition](https://github.com/Tencent/tdesign-vue-next/blob/develop/packages/components/swiper/type.ts)。
`type SwiperChangeSource = 'autoplay' \| 'click' \| 'hover'`
- -### SwiperNavigation - -name | type | default | description | required --- | -- | -- | -- | -- -placement | String | inside | options: inside/outside | N -showSlideBtn | String | always | options: always/hover/never | N -size | String | medium | options: small/medium/large | N -type | String | - | Typescript:`SwiperNavigationType` `type SwiperNavigationType = 'dots' \| 'dots-bar' \| 'bars' \| 'fraction'`。[see more ts definition](https://github.com/Tencent/tdesign-vue-next/blob/develop/packages/components/swiper/type.ts) | N - -## API - - ### Swiper Props name | type | default | description | required diff --git a/packages/products/tdesign-vue-next/packages/components/swiper/swiper.md b/packages/products/tdesign-vue-next/packages/components/swiper/swiper.md index 02b6a069a..be1f7163b 100644 --- a/packages/products/tdesign-vue-next/packages/components/swiper/swiper.md +++ b/packages/products/tdesign-vue-next/packages/components/swiper/swiper.md @@ -2,45 +2,6 @@ ## API - -### Swiper Props - -名称 | 类型 | 默认值 | 描述 | 必传 --- | -- | -- | -- | -- -animation | String | slide | 轮播切换动画效果类型:滑动、淡入淡出等。可选项:slide/fade | N -autoplay | Boolean | true | 是否自动播放 | N -cardScale | Number | 210/332 | 卡片模式下非当前展示轮播图的缩放比例 | N -current | Number | 0 | 当前轮播在哪一项(下标)。支持语法糖 `v-model` 或 `v-model:current` | N -direction | String | horizontal | 轮播滑动方向,包括横向滑动和纵向滑动两个方向。可选项:horizontal/vertical | N -duration | Number | 300 | 滑动动画时长 | N -height | Number | - | 当使用垂直方向滚动时的高度 | N -interval | Number | 5000 | 轮播间隔时间 | N -loop | Boolean | true | 是否循环播放 | N -navigation | Object / Slot / Function | - | 导航器全部配置。TS 类型:`SwiperNavigation \| TNode`。[通用类型定义](https://github.com/Tencent/tdesign-vue-next/blob/develop/packages/components/common.ts) | N -stopOnHover | Boolean | true | 是否悬浮时停止轮播 | N -theme | String | light | 深色模式和浅色模式。可选项:light/dark | N -trigger | String | hover | 触发切换的方式:悬浮、点击等。可选项:hover/click | N -type | String | default | 样式类型:默认样式、卡片样式。可选项:default/card | N -onChange | Function | | TS 类型:`(current: number, context: { source: SwiperChangeSource }) => void`
轮播切换时触发。[详细类型定义](https://github.com/Tencent/tdesign-vue-next/blob/develop/packages/components/swiper/type.ts)。
`type SwiperChangeSource = 'autoplay' \| 'click' \| 'hover'`
| N - -### Swiper Events - -名称 | 参数 | 描述 --- | -- | -- -change | `(current: number, context: { source: SwiperChangeSource })` | 轮播切换时触发。[详细类型定义](https://github.com/Tencent/tdesign-vue-next/blob/develop/packages/components/swiper/type.ts)。
`type SwiperChangeSource = 'autoplay' \| 'click' \| 'hover'`
- -### SwiperNavigation - -名称 | 类型 | 默认值 | 描述 | 必传 --- | -- | -- | -- | -- -placement | String | inside | 导航器位置,位于主体的内侧或是外侧。可选项:inside/outside | N -showSlideBtn | String | always | 何时显示导航器的翻页按钮:始终显示、悬浮显示、永不显示。可选项:always/hover/never | N -size | String | medium | 导航器尺寸。可选项:small/medium/large | N -type | String | - | 导航器类型,点状(dots)、点条状(dots-bar)、条状(bars)、分式(fraction)等。TS 类型:`SwiperNavigationType` `type SwiperNavigationType = 'dots' \| 'dots-bar' \| 'bars' \| 'fraction'`。[详细类型定义](https://github.com/Tencent/tdesign-vue-next/blob/develop/packages/components/swiper/type.ts) | N - -## API - - ### Swiper Props 名称 | 类型 | 默认值 | 描述 | 必传 diff --git a/packages/products/tdesign-vue/src/swiper/swiper.en-US.md b/packages/products/tdesign-vue/src/swiper/swiper.en-US.md index 1ad1f1e80..07bdca2e0 100644 --- a/packages/products/tdesign-vue/src/swiper/swiper.en-US.md +++ b/packages/products/tdesign-vue/src/swiper/swiper.en-US.md @@ -35,3 +35,41 @@ placement | String | inside | options: inside/outside | N showSlideBtn | String | always | options: always/hover/never | N size | String | medium | options: small/medium/large | N type | String | - | Typescript:`SwiperNavigationType` `type SwiperNavigationType = 'dots' \| 'dots-bar' \| 'bars' \| 'fraction'`。[see more ts definition](https://github.com/Tencent/tdesign-vue/tree/develop/src/swiper/type.ts) | N + +## API + + +### Swiper Props + +name | type | default | description | required +-- | -- | -- | -- | -- +animation | String | slide | options: slide/fade | N +autoplay | Boolean | true | \- | N +cardScale | Number | 210/332 | \- | N +current | Number | 0 | `v-model` is supported | N +direction | String | horizontal | options: horizontal/vertical | N +duration | Number | 300 | \- | N +height | Number | - | \- | N +interval | Number | 5000 | \- | N +loop | Boolean | true | \- | N +navigation | Boolean / Object / Function / Slot / Function | true | Typescript:`SwiperNavigation \| TNode \| Function \| Boolean `。[see more ts definition](https://github.com/Tencent/tdesign-vue/blob/develop/src/common.ts) | N +stopOnHover | Boolean | true | \- | N +theme | String | light | options: light/dark | N +trigger | String | hover | options: hover/click | N +type | String | default | options: default/card | N +onChange | Function | | Typescript:`(current: number, context: { source: SwiperChangeSource }) => void`
[see more ts definition](https://github.com/Tencent/tdesign-vue/tree/develop/src/swiper/type.ts)。
`type SwiperChangeSource = 'autoplay' \| 'click' \| 'hover'`
| N + +### Swiper Events + +name | params | description +-- | -- | -- +change | `(current: number, context: { source: SwiperChangeSource })` | [see more ts definition](https://github.com/Tencent/tdesign-vue/tree/develop/src/swiper/type.ts)。
`type SwiperChangeSource = 'autoplay' \| 'click' \| 'hover'`
+ +### SwiperNavigation + +name | type | default | description | required +-- | -- | -- | -- | -- +placement | String | inside | options: inside/outside | N +showSlideBtn | String | always | options: always/hover/never | N +size | String | medium | options: small/medium/large | N +type | String | - | Typescript:`SwiperNavigationType` `type SwiperNavigationType = 'dots' \| 'dots-bar' \| 'bars' \| 'fraction'`。[see more ts definition](https://github.com/Tencent/tdesign-vue/tree/develop/src/swiper/type.ts) | N diff --git a/packages/products/tdesign-vue/src/swiper/swiper.md b/packages/products/tdesign-vue/src/swiper/swiper.md index 8ce519f71..21df3c701 100644 --- a/packages/products/tdesign-vue/src/swiper/swiper.md +++ b/packages/products/tdesign-vue/src/swiper/swiper.md @@ -35,3 +35,41 @@ placement | String | inside | 导航器位置,位于主体的内侧或是外 showSlideBtn | String | always | 何时显示导航器的翻页按钮:始终显示、悬浮显示、永不显示。可选项:always/hover/never | N size | String | medium | 导航器尺寸。可选项:small/medium/large | N type | String | - | 导航器类型,点状(dots)、点条状(dots-bar)、条状(bars)、分式(fraction)等。TS 类型:`SwiperNavigationType` `type SwiperNavigationType = 'dots' \| 'dots-bar' \| 'bars' \| 'fraction'`。[详细类型定义](https://github.com/Tencent/tdesign-vue/tree/develop/src/swiper/type.ts) | N + +## API + + +### Swiper Props + +名称 | 类型 | 默认值 | 描述 | 必传 +-- | -- | -- | -- | -- +animation | String | slide | 轮播切换动画效果类型:滑动、淡入淡出等。可选项:slide/fade | N +autoplay | Boolean | true | 是否自动播放 | N +cardScale | Number | 210/332 | 卡片模式下非当前展示轮播图的缩放比例 | N +current | Number | 0 | 当前轮播在哪一项(下标)。支持语法糖 `v-model` | N +direction | String | horizontal | 轮播滑动方向,包括横向滑动和纵向滑动两个方向。可选项:horizontal/vertical | N +duration | Number | 300 | 滑动动画时长 | N +height | Number | - | 当使用垂直方向滚动时的高度 | N +interval | Number | 5000 | 轮播间隔时间 | N +loop | Boolean | true | 是否循环播放 | N +navigation | Boolean / Object / Function / Slot / Function | true | 导航器全部配置。TS 类型:`SwiperNavigation \| TNode \| Function \| Boolean `。[通用类型定义](https://github.com/Tencent/tdesign-vue/blob/develop/src/common.ts) | N +stopOnHover | Boolean | true | 是否悬浮时停止轮播 | N +theme | String | light | 深色模式和浅色模式。可选项:light/dark | N +trigger | String | hover | 触发切换的方式:悬浮、点击等。可选项:hover/click | N +type | String | default | 样式类型:默认样式、卡片样式。可选项:default/card | N +onChange | Function | | TS 类型:`(current: number, context: { source: SwiperChangeSource }) => void`
轮播切换时触发。[详细类型定义](https://github.com/Tencent/tdesign-vue/tree/develop/src/swiper/type.ts)。
`type SwiperChangeSource = 'autoplay' \| 'click' \| 'hover'`
| N + +### Swiper Events + +名称 | 参数 | 描述 +-- | -- | -- +change | `(current: number, context: { source: SwiperChangeSource })` | 轮播切换时触发。[详细类型定义](https://github.com/Tencent/tdesign-vue/tree/develop/src/swiper/type.ts)。
`type SwiperChangeSource = 'autoplay' \| 'click' \| 'hover'`
+ +### SwiperNavigation + +名称 | 类型 | 默认值 | 描述 | 必传 +-- | -- | -- | -- | -- +placement | String | inside | 导航器位置,位于主体的内侧或是外侧。可选项:inside/outside | N +showSlideBtn | String | always | 何时显示导航器的翻页按钮:始终显示、悬浮显示、永不显示。可选项:always/hover/never | N +size | String | medium | 导航器尺寸。可选项:small/medium/large | N +type | String | - | 导航器类型,点状(dots)、点条状(dots-bar)、条状(bars)、分式(fraction)等。TS 类型:`SwiperNavigationType` `type SwiperNavigationType = 'dots' \| 'dots-bar' \| 'bars' \| 'fraction'`。[详细类型定义](https://github.com/Tencent/tdesign-vue/tree/develop/src/swiper/type.ts) | N From 29818facb373b8c916f99030ed0981fe4683cca3 Mon Sep 17 00:00:00 2001 From: rss1102 Date: Thu, 16 Oct 2025 19:32:48 +0800 Subject: [PATCH 3/9] fix: remove `Function` type --- db/TDesign.db | Bin 1056768 -> 1056768 bytes .../src/swiper/swiper.en-US.md | 2 +- .../tdesign-mobile-react/src/swiper/swiper.md | 2 +- .../tdesign-mobile-react/src/swiper/type.ts | 2 +- .../tdesign-mobile-vue/src/swiper/props.ts | 2 +- .../src/swiper/swiper.en-US.md | 3 +-- .../tdesign-mobile-vue/src/swiper/swiper.md | 3 +-- .../tdesign-mobile-vue/src/swiper/type.ts | 2 +- .../components/swiper/swiper.en-US.md | 3 +-- .../packages/components/swiper/swiper.md | 3 +-- .../packages/components/swiper/type.ts | 2 +- .../packages/components/swiper/props.ts | 2 +- .../components/swiper/swiper.en-US.md | 2 +- .../packages/components/swiper/swiper.md | 2 +- .../packages/components/swiper/type.ts | 2 +- .../products/tdesign-vue/src/swiper/props.ts | 2 +- .../tdesign-vue/src/swiper/swiper.en-US.md | 3 +-- .../products/tdesign-vue/src/swiper/swiper.md | 3 +-- .../products/tdesign-vue/src/swiper/type.ts | 2 +- packages/scripts/api.json | 6 ++---- 20 files changed, 20 insertions(+), 28 deletions(-) diff --git a/db/TDesign.db b/db/TDesign.db index 73d037ff3362aed2aa0682592c77f48456f44672..7458037e923a598d053b5051f8a8b272d3338201 100644 GIT binary patch delta 180 zcmZoT;LvcuVS+T{&WSS4j5`|>S`!#s6PQ{Pn71adEIaRL#K4uy8Od>z!z!X+`F3&7TEy_zQ%S=x!$;{8oDJd#VeY$?ni;h)KXRdhKy5eQ?ikGdu z&-bn~GBBEMd!NOcTcJk5tu!wgq`Lj|1r{J?1!6WJW(Q&pAm#*OE+FOxVjdvo1!BJK Kr!VlE`U3zc_*O3f diff --git a/packages/products/tdesign-mobile-react/src/swiper/swiper.en-US.md b/packages/products/tdesign-mobile-react/src/swiper/swiper.en-US.md index 3243a215f..ddf37708b 100644 --- a/packages/products/tdesign-mobile-react/src/swiper/swiper.en-US.md +++ b/packages/products/tdesign-mobile-react/src/swiper/swiper.en-US.md @@ -16,7 +16,7 @@ duration | Number | 300 | \- | N height | String / Number | - | \- | N interval | Number | 5000 | \- | N loop | Boolean | true | \- | N -navigation | TNode | true | Typescript:`SwiperNavigation \| TNode \| Function \| Boolean `。[see more ts definition](https://github.com/Tencent/tdesign-mobile-react/blob/develop/src/common.ts) | N +navigation | TNode | true | navigation config。Typescript:`SwiperNavigation \| TNode \| Boolean `。[see more ts definition](https://github.com/Tencent/tdesign-mobile-react/blob/develop/src/common.ts) | N nextMargin | String / Number | 0 | \- | N previousMargin | String / Number | 0 | \- | N type | String | default | options: default/card | N diff --git a/packages/products/tdesign-mobile-react/src/swiper/swiper.md b/packages/products/tdesign-mobile-react/src/swiper/swiper.md index aa3623832..0f674bbfb 100644 --- a/packages/products/tdesign-mobile-react/src/swiper/swiper.md +++ b/packages/products/tdesign-mobile-react/src/swiper/swiper.md @@ -16,7 +16,7 @@ duration | Number | 300 | 滑动动画时长 | N height | String / Number | - | 当使用垂直方向滚动时的高度 | N interval | Number | 5000 | 轮播间隔时间 | N loop | Boolean | true | 是否循环播放 | N -navigation | TNode | true | 导航器全部配置。TS 类型:`SwiperNavigation \| TNode \| Function \| Boolean `。[通用类型定义](https://github.com/Tencent/tdesign-mobile-react/blob/develop/src/common.ts) | N +navigation | TNode | true | 导航器全部配置。TS 类型:`SwiperNavigation \| TNode \| Boolean `。[通用类型定义](https://github.com/Tencent/tdesign-mobile-react/blob/develop/src/common.ts) | N nextMargin | String / Number | 0 | 后边距,可用于露出后一项的一小部分。默认单位 `px` | N previousMargin | String / Number | 0 | 前边距,可用于露出前一项的一小部分。默认单位 `px` | N type | String | default | 样式类型:默认样式、卡片样式。可选项:default/card | N diff --git a/packages/products/tdesign-mobile-react/src/swiper/type.ts b/packages/products/tdesign-mobile-react/src/swiper/type.ts index 7385f551c..89904ed41 100644 --- a/packages/products/tdesign-mobile-react/src/swiper/type.ts +++ b/packages/products/tdesign-mobile-react/src/swiper/type.ts @@ -55,7 +55,7 @@ export interface TdSwiperProps { * 导航器全部配置 * @default true */ - navigation?: SwiperNavigation | TNode | Function | Boolean; + navigation?: SwiperNavigation | TNode | Boolean; /** * 后边距,可用于露出后一项的一小部分。默认单位 `px` * @default 0 diff --git a/packages/products/tdesign-mobile-vue/src/swiper/props.ts b/packages/products/tdesign-mobile-vue/src/swiper/props.ts index 381471cda..66ffb40a1 100644 --- a/packages/products/tdesign-mobile-vue/src/swiper/props.ts +++ b/packages/products/tdesign-mobile-vue/src/swiper/props.ts @@ -66,7 +66,7 @@ export default { }, /** 导航器全部配置 */ navigation: { - type: [Boolean, Object, Function, Function] as PropType, + type: [Boolean, Object, Function] as PropType, default: true as TdSwiperProps['navigation'], }, /** 【开发中】后边距,可用于露出后一项的一小部分。默认单位 `px` */ diff --git a/packages/products/tdesign-mobile-vue/src/swiper/swiper.en-US.md b/packages/products/tdesign-mobile-vue/src/swiper/swiper.en-US.md index 4a19b694b..d9d5f4976 100644 --- a/packages/products/tdesign-mobile-vue/src/swiper/swiper.en-US.md +++ b/packages/products/tdesign-mobile-vue/src/swiper/swiper.en-US.md @@ -37,7 +37,6 @@ type | String | - | Typescript:`SwiperNavigationType` `type SwiperNavigationTy ## API - ### Swiper Props name | type | default | description | required @@ -50,7 +49,7 @@ duration | Number | 300 | \- | N height | String / Number | - | \- | N interval | Number | 5000 | \- | N loop | Boolean | true | \- | N -navigation | Boolean / Object / Function / Slot / Function | true | Typescript:`SwiperNavigation \| TNode \| Function \| Boolean `。[see more ts definition](https://github.com/Tencent/tdesign-mobile-vue/blob/develop/src/common.ts) | N +navigation | Boolean / Object / Slot / Function | true | navigation config。Typescript:`SwiperNavigation \| TNode \| Boolean `。[see more ts definition](https://github.com/Tencent/tdesign-mobile-vue/blob/develop/src/common.ts) | N nextMargin | String / Number | 0 | \- | N previousMargin | String / Number | 0 | \- | N onChange | Function | | Typescript:`(current: number, context: { source: SwiperChangeSource }) => void`
[see more ts definition](https://github.com/Tencent/tdesign-mobile-vue/tree/develop/src/swiper/type.ts)。
`type SwiperChangeSource = 'autoplay' \| 'touch' \| 'nav'`
| N diff --git a/packages/products/tdesign-mobile-vue/src/swiper/swiper.md b/packages/products/tdesign-mobile-vue/src/swiper/swiper.md index 9d54ebfcf..5728a5a99 100644 --- a/packages/products/tdesign-mobile-vue/src/swiper/swiper.md +++ b/packages/products/tdesign-mobile-vue/src/swiper/swiper.md @@ -37,7 +37,6 @@ type | String | - | 导航器类型,点状(dots)、点条状(dots-bar)、分 ## API - ### Swiper Props 名称 | 类型 | 默认值 | 描述 | 必传 @@ -50,7 +49,7 @@ duration | Number | 300 | 滑动动画时长 | N height | String / Number | - | 轮播的高度 | N interval | Number | 5000 | 轮播间隔时间 | N loop | Boolean | true | 是否循环播放 | N -navigation | Boolean / Object / Function / Slot / Function | true | 导航器全部配置。TS 类型:`SwiperNavigation \| TNode \| Function \| Boolean `。[通用类型定义](https://github.com/Tencent/tdesign-mobile-vue/blob/develop/src/common.ts) | N +navigation | Boolean / Object / Slot / Function | true | 导航器全部配置。TS 类型:`SwiperNavigation \| TNode \| Boolean `。[通用类型定义](https://github.com/Tencent/tdesign-mobile-vue/blob/develop/src/common.ts) | N nextMargin | String / Number | 0 | 【开发中】后边距,可用于露出后一项的一小部分。默认单位 `px` | N previousMargin | String / Number | 0 | 【开发中】前边距,可用于露出前一项的一小部分。默认单位 `px` | N onChange | Function | | TS 类型:`(current: number, context: { source: SwiperChangeSource }) => void`
轮播切换时触发。[详细类型定义](https://github.com/Tencent/tdesign-mobile-vue/tree/develop/src/swiper/type.ts)。
`type SwiperChangeSource = 'autoplay' \| 'touch' \| 'nav'`
| N diff --git a/packages/products/tdesign-mobile-vue/src/swiper/type.ts b/packages/products/tdesign-mobile-vue/src/swiper/type.ts index 2ab88567a..20d172e55 100644 --- a/packages/products/tdesign-mobile-vue/src/swiper/type.ts +++ b/packages/products/tdesign-mobile-vue/src/swiper/type.ts @@ -60,7 +60,7 @@ export interface TdSwiperProps { * 导航器全部配置 * @default true */ - navigation?: SwiperNavigation | TNode | Function | Boolean; + navigation?: SwiperNavigation | TNode | Boolean; /** * 【开发中】后边距,可用于露出后一项的一小部分。默认单位 `px` * @default 0 diff --git a/packages/products/tdesign-react/packages/components/swiper/swiper.en-US.md b/packages/products/tdesign-react/packages/components/swiper/swiper.en-US.md index 6fcf2e0c0..2810b6740 100644 --- a/packages/products/tdesign-react/packages/components/swiper/swiper.en-US.md +++ b/packages/products/tdesign-react/packages/components/swiper/swiper.en-US.md @@ -34,7 +34,6 @@ type | String | - | Typescript:`SwiperNavigationType` `type SwiperNavigationTy ## API - ### Swiper Props name | type | default | description | required @@ -50,7 +49,7 @@ duration | Number | 300 | \- | N height | Number | - | \- | N interval | Number | 5000 | \- | N loop | Boolean | true | \- | N -navigation | TNode | true | Typescript:`SwiperNavigation \| TNode \| Function \| Boolean `。[see more ts definition](https://github.com/Tencent/tdesign-react/blob/develop/packages/components/common.ts) | N +navigation | TNode | true | navigation config。Typescript:`SwiperNavigation \| TNode \| Boolean `。[see more ts definition](https://github.com/Tencent/tdesign-react/blob/develop/packages/components/common.ts) | N stopOnHover | Boolean | true | \- | N theme | String | light | options: light/dark | N trigger | String | hover | options: hover/click | N diff --git a/packages/products/tdesign-react/packages/components/swiper/swiper.md b/packages/products/tdesign-react/packages/components/swiper/swiper.md index 5aa9a41df..e703f811b 100644 --- a/packages/products/tdesign-react/packages/components/swiper/swiper.md +++ b/packages/products/tdesign-react/packages/components/swiper/swiper.md @@ -34,7 +34,6 @@ type | String | - | 导航器类型,点状(dots)、点条状(dots-bar)、条 ## API - ### Swiper Props 名称 | 类型 | 默认值 | 描述 | 必传 @@ -50,7 +49,7 @@ duration | Number | 300 | 滑动动画时长 | N height | Number | - | 当使用垂直方向滚动时的高度 | N interval | Number | 5000 | 轮播间隔时间 | N loop | Boolean | true | 是否循环播放 | N -navigation | TNode | true | 导航器全部配置。TS 类型:`SwiperNavigation \| TNode \| Function \| Boolean `。[通用类型定义](https://github.com/Tencent/tdesign-react/blob/develop/packages/components/common.ts) | N +navigation | TNode | true | 导航器全部配置。TS 类型:`SwiperNavigation \| TNode \| Boolean `。[通用类型定义](https://github.com/Tencent/tdesign-react/blob/develop/packages/components/common.ts) | N stopOnHover | Boolean | true | 是否悬浮时停止轮播 | N theme | String | light | 深色模式和浅色模式。可选项:light/dark | N trigger | String | hover | 触发切换的方式:悬浮、点击等。可选项:hover/click | N diff --git a/packages/products/tdesign-react/packages/components/swiper/type.ts b/packages/products/tdesign-react/packages/components/swiper/type.ts index 74da4ba36..0b039e8a7 100644 --- a/packages/products/tdesign-react/packages/components/swiper/type.ts +++ b/packages/products/tdesign-react/packages/components/swiper/type.ts @@ -60,7 +60,7 @@ export interface TdSwiperProps { * 导航器全部配置 * @default true */ - navigation?: SwiperNavigation | TNode | Function | Boolean; + navigation?: SwiperNavigation | TNode | Boolean; /** * 是否悬浮时停止轮播 * @default true diff --git a/packages/products/tdesign-vue-next/packages/components/swiper/props.ts b/packages/products/tdesign-vue-next/packages/components/swiper/props.ts index ea7e3ff47..a46617f6a 100644 --- a/packages/products/tdesign-vue-next/packages/components/swiper/props.ts +++ b/packages/products/tdesign-vue-next/packages/components/swiper/props.ts @@ -70,7 +70,7 @@ export default { }, /** 导航器全部配置 */ navigation: { - type: [Boolean, Object, Function, Function] as PropType, + type: [Boolean, Object, Function] as PropType, default: true as TdSwiperProps['navigation'], }, /** 是否悬浮时停止轮播 */ diff --git a/packages/products/tdesign-vue-next/packages/components/swiper/swiper.en-US.md b/packages/products/tdesign-vue-next/packages/components/swiper/swiper.en-US.md index 6e7bf74b5..5e8f6b393 100644 --- a/packages/products/tdesign-vue-next/packages/components/swiper/swiper.en-US.md +++ b/packages/products/tdesign-vue-next/packages/components/swiper/swiper.en-US.md @@ -15,7 +15,7 @@ duration | Number | 300 | \- | N height | Number | - | \- | N interval | Number | 5000 | \- | N loop | Boolean | true | \- | N -navigation | Boolean / Object / Function / Slot / Function | true | Typescript:`SwiperNavigation \| TNode \| Function \| Boolean `。[see more ts definition](https://github.com/Tencent/tdesign-vue-next/blob/develop/packages/components/common.ts) | N +navigation | Boolean / Object / Slot / Function | true | navigation config。Typescript:`SwiperNavigation \| TNode \| Boolean `。[see more ts definition](https://github.com/Tencent/tdesign-vue-next/blob/develop/packages/components/common.ts) | N stopOnHover | Boolean | true | \- | N theme | String | light | options: light/dark | N trigger | String | hover | options: hover/click | N diff --git a/packages/products/tdesign-vue-next/packages/components/swiper/swiper.md b/packages/products/tdesign-vue-next/packages/components/swiper/swiper.md index be1f7163b..badea7d25 100644 --- a/packages/products/tdesign-vue-next/packages/components/swiper/swiper.md +++ b/packages/products/tdesign-vue-next/packages/components/swiper/swiper.md @@ -15,7 +15,7 @@ duration | Number | 300 | 滑动动画时长 | N height | Number | - | 当使用垂直方向滚动时的高度 | N interval | Number | 5000 | 轮播间隔时间 | N loop | Boolean | true | 是否循环播放 | N -navigation | Boolean / Object / Function / Slot / Function | true | 导航器全部配置。TS 类型:`SwiperNavigation \| TNode \| Function \| Boolean `。[通用类型定义](https://github.com/Tencent/tdesign-vue-next/blob/develop/packages/components/common.ts) | N +navigation | Boolean / Object / Slot / Function | true | 导航器全部配置。TS 类型:`SwiperNavigation \| TNode \| Boolean `。[通用类型定义](https://github.com/Tencent/tdesign-vue-next/blob/develop/packages/components/common.ts) | N stopOnHover | Boolean | true | 是否悬浮时停止轮播 | N theme | String | light | 深色模式和浅色模式。可选项:light/dark | N trigger | String | hover | 触发切换的方式:悬浮、点击等。可选项:hover/click | N diff --git a/packages/products/tdesign-vue-next/packages/components/swiper/type.ts b/packages/products/tdesign-vue-next/packages/components/swiper/type.ts index ba048fe58..e20bdd2fa 100644 --- a/packages/products/tdesign-vue-next/packages/components/swiper/type.ts +++ b/packages/products/tdesign-vue-next/packages/components/swiper/type.ts @@ -65,7 +65,7 @@ export interface TdSwiperProps { * 导航器全部配置 * @default true */ - navigation?: SwiperNavigation | TNode | Function | Boolean; + navigation?: SwiperNavigation | TNode | Boolean; /** * 是否悬浮时停止轮播 * @default true diff --git a/packages/products/tdesign-vue/src/swiper/props.ts b/packages/products/tdesign-vue/src/swiper/props.ts index 0770f0ab9..fd5da3eb9 100644 --- a/packages/products/tdesign-vue/src/swiper/props.ts +++ b/packages/products/tdesign-vue/src/swiper/props.ts @@ -66,7 +66,7 @@ export default { }, /** 导航器全部配置 */ navigation: { - type: [Boolean, Object, Function, Function] as PropType, + type: [Boolean, Object, Function] as PropType, default: true, }, /** 是否悬浮时停止轮播 */ diff --git a/packages/products/tdesign-vue/src/swiper/swiper.en-US.md b/packages/products/tdesign-vue/src/swiper/swiper.en-US.md index 07bdca2e0..ccae49820 100644 --- a/packages/products/tdesign-vue/src/swiper/swiper.en-US.md +++ b/packages/products/tdesign-vue/src/swiper/swiper.en-US.md @@ -38,7 +38,6 @@ type | String | - | Typescript:`SwiperNavigationType` `type SwiperNavigationTy ## API - ### Swiper Props name | type | default | description | required @@ -52,7 +51,7 @@ duration | Number | 300 | \- | N height | Number | - | \- | N interval | Number | 5000 | \- | N loop | Boolean | true | \- | N -navigation | Boolean / Object / Function / Slot / Function | true | Typescript:`SwiperNavigation \| TNode \| Function \| Boolean `。[see more ts definition](https://github.com/Tencent/tdesign-vue/blob/develop/src/common.ts) | N +navigation | Boolean / Object / Slot / Function | true | navigation config。Typescript:`SwiperNavigation \| TNode \| Boolean `。[see more ts definition](https://github.com/Tencent/tdesign-vue/blob/develop/src/common.ts) | N stopOnHover | Boolean | true | \- | N theme | String | light | options: light/dark | N trigger | String | hover | options: hover/click | N diff --git a/packages/products/tdesign-vue/src/swiper/swiper.md b/packages/products/tdesign-vue/src/swiper/swiper.md index 21df3c701..4490ef732 100644 --- a/packages/products/tdesign-vue/src/swiper/swiper.md +++ b/packages/products/tdesign-vue/src/swiper/swiper.md @@ -38,7 +38,6 @@ type | String | - | 导航器类型,点状(dots)、点条状(dots-bar)、条 ## API - ### Swiper Props 名称 | 类型 | 默认值 | 描述 | 必传 @@ -52,7 +51,7 @@ duration | Number | 300 | 滑动动画时长 | N height | Number | - | 当使用垂直方向滚动时的高度 | N interval | Number | 5000 | 轮播间隔时间 | N loop | Boolean | true | 是否循环播放 | N -navigation | Boolean / Object / Function / Slot / Function | true | 导航器全部配置。TS 类型:`SwiperNavigation \| TNode \| Function \| Boolean `。[通用类型定义](https://github.com/Tencent/tdesign-vue/blob/develop/src/common.ts) | N +navigation | Boolean / Object / Slot / Function | true | 导航器全部配置。TS 类型:`SwiperNavigation \| TNode \| Boolean `。[通用类型定义](https://github.com/Tencent/tdesign-vue/blob/develop/src/common.ts) | N stopOnHover | Boolean | true | 是否悬浮时停止轮播 | N theme | String | light | 深色模式和浅色模式。可选项:light/dark | N trigger | String | hover | 触发切换的方式:悬浮、点击等。可选项:hover/click | N diff --git a/packages/products/tdesign-vue/src/swiper/type.ts b/packages/products/tdesign-vue/src/swiper/type.ts index 74da4ba36..0b039e8a7 100644 --- a/packages/products/tdesign-vue/src/swiper/type.ts +++ b/packages/products/tdesign-vue/src/swiper/type.ts @@ -60,7 +60,7 @@ export interface TdSwiperProps { * 导航器全部配置 * @default true */ - navigation?: SwiperNavigation | TNode | Function | Boolean; + navigation?: SwiperNavigation | TNode | Boolean; /** * 是否悬浮时停止轮播 * @default true diff --git a/packages/scripts/api.json b/packages/scripts/api.json index 7c8ecf26c..d4146de1f 100644 --- a/packages/scripts/api.json +++ b/packages/scripts/api.json @@ -117362,19 +117362,18 @@ "field_type": [ "4", "8", - "32", "64" ], "field_default_value": "true", "field_enum": "", "field_desc_zh": "导航器全部配置", - "field_desc_en": null, + "field_desc_en": "navigation config", "field_required": 0, "event_input": "", "create_time": "2021-12-15 12:58:51", "update_time": "2022-01-25 11:57:28", "event_output": null, - "custom_field_type": "SwiperNavigation | TNode | Function | Boolean ", + "custom_field_type": "SwiperNavigation | TNode | Boolean ", "syntactic_sugar": null, "readonly": 1, "html_attribute": 0, @@ -117393,7 +117392,6 @@ "field_type_text": [ "Boolean", "Object", - "Function", "TNode" ] }, From af8db3237832eacca1844e124880bc039882e502 Mon Sep 17 00:00:00 2001 From: RSS1102 Date: Fri, 24 Oct 2025 16:54:26 +0800 Subject: [PATCH 4/9] =?UTF-8?q?feat(Swiper):=20=E6=9B=B4=E6=96=B0=E5=AF=BC?= =?UTF-8?q?=E8=88=AA=E9=85=8D=E7=BD=AE=EF=BC=8C=E5=B0=86=E7=A7=BB=E5=8A=A8?= =?UTF-8?q?=E7=AB=AF=20navigation=20api=20=E7=8B=AC=E7=AB=8B=E5=87=BA?= =?UTF-8?q?=E6=9D=A5?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- db/TDesign.db | Bin 1056768 -> 1056768 bytes packages/scripts/api.json | 53 +++++++++++++++++++++++++++++++++----- 2 files changed, 46 insertions(+), 7 deletions(-) diff --git a/db/TDesign.db b/db/TDesign.db index 66fb4546c0a4943d47012e6ce576fefba25ac6c6..0ac2fc47eb8d9063b566653842abbef5cfe99de9 100644 GIT binary patch delta 303 zcmZoT;LvcuVS+T{xrs8)jOQ8?S`!#s6PQ{Pn71adEITh`%fOY(8Od>z!KHUnM6q3sc5#I}QG8+Z%fMTblS-IVUpktMkh6Y~(WIoVZ=lfUBNUsZnu$m?R6T zvjSnx0%@0kJ4{5`RM*fz*T_V{z{1MZ(8|=v$iN6)XnMkZ7K!PnFR*ZJHp} Cw_Q2_ delta 205 zcmZoT;LvcuVS+T{>4`GVjHeqDS`!#s6PQ{Pn71adEITh`#K4uy8Od>z!@r#q^HMTV5yw0BPGDasL+1x0t*nc0x=s9 zvjZ^)5OV@C7Z7s;F%J;)ZohVcPj5YA;C9vq{-sPz{9W7EH1Qwi5)?_he>9n|l9QQ* u3CQy0tJvPq%iq$(!@_08z^~3L!?TggY`dZX*96YV1`nofHpHNk?}8 diff --git a/packages/scripts/api.json b/packages/scripts/api.json index a88d15bbf..035e4275a 100644 --- a/packages/scripts/api.json +++ b/packages/scripts/api.json @@ -112506,9 +112506,7 @@ "id": 2044, "platform_framework": [ "1", - "2", - "8", - "16" + "2" ], "component": "Swiper", "field_category": 1, @@ -112527,7 +112525,7 @@ "create_time": "2021-12-15 12:58:51", "update_time": "2022-01-25 11:57:28", "event_output": null, - "custom_field_type": "SwiperNavigation | TNode | Boolean ", + "custom_field_type": "SwiperNavigation | TNode", "syntactic_sugar": null, "readonly": 1, "html_attribute": 0, @@ -112539,9 +112537,7 @@ "field_category_text": "Props", "platform_framework_text": [ "Vue(PC)", - "React(PC)", - "Vue(Mobile)", - "React(Mobile)" + "React(PC)" ], "field_type_text": [ "Boolean", @@ -112590,6 +112586,49 @@ "TNode" ] }, + { + "id": 1761295912, + "platform_framework": [ + "8", + "16" + ], + "component": "Swiper", + "field_category": 1, + "field_name": "navigation", + "field_type": [ + "4", + "8", + "64" + ], + "field_default_value": "true", + "field_enum": "", + "field_desc_zh": "导航器全部配置", + "field_desc_en": "navigation config", + "field_required": 0, + "event_input": "", + "create_time": "2025-10-24 08:51:52", + "update_time": "2025-10-24 08:51:52", + "event_output": null, + "custom_field_type": "SwiperNavigation | TNode | Boolean", + "syntactic_sugar": null, + "readonly": 1, + "html_attribute": 0, + "trigger_elements": "", + "deprecated": 0, + "version": "", + "test_description": null, + "support_default_value": 0, + "field_category_text": "Props", + "platform_framework_text": [ + "Vue(Mobile)", + "React(Mobile)" + ], + "field_type_text": [ + "Boolean", + "Object", + "TNode" + ] + }, { "id": 3245, "platform_framework": [ From 92a72d99ea6ee6156dae503e9e96909506dd0816 Mon Sep 17 00:00:00 2001 From: rss1102 Date: Fri, 24 Oct 2025 17:02:40 +0800 Subject: [PATCH 5/9] =?UTF-8?q?feat(Swiper):=20=E6=9B=B4=E6=96=B0=E5=AF=BC?= =?UTF-8?q?=E8=88=AA=E9=85=8D=E7=BD=AE=EF=BC=8Cpc=20=E7=AB=AF=E7=A7=BB?= =?UTF-8?q?=E9=99=A4=20navigation=20=E7=9A=84=20Boolean=20=E7=B1=BB?= =?UTF-8?q?=E5=9E=8B=E6=94=AF=E6=8C=81?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- db/TDesign.db | Bin 1056768 -> 1056768 bytes .../components/swiper/README.en-US.md | 8 +++++++- .../packages/components/swiper/README.md | 8 +++++++- .../packages/components/swiper/props.ts | 2 +- .../packages/components/swiper/type.ts | 2 +- .../src/swiper/swiper.en-US.md | 2 +- .../tdesign-mobile-react/src/swiper/swiper.md | 2 +- .../tdesign-mobile-react/src/swiper/type.ts | 2 +- .../tdesign-mobile-vue/src/swiper/props.ts | 2 +- .../src/swiper/swiper.en-US.md | 2 +- .../tdesign-mobile-vue/src/swiper/swiper.md | 2 +- .../tdesign-mobile-vue/src/swiper/type.ts | 2 +- .../components/swiper/swiper.en-US.md | 2 +- .../packages/components/swiper/swiper.md | 2 +- .../packages/components/swiper/type.ts | 2 +- .../packages/components/swiper/props.ts | 2 +- .../components/swiper/swiper.en-US.md | 2 +- .../packages/components/swiper/swiper.md | 2 +- .../packages/components/swiper/type.ts | 2 +- .../products/tdesign-vue/src/swiper/props.ts | 2 +- .../tdesign-vue/src/swiper/swiper.en-US.md | 2 +- .../products/tdesign-vue/src/swiper/swiper.md | 2 +- .../products/tdesign-vue/src/swiper/type.ts | 2 +- packages/scripts/api.json | 12 +++++------- 24 files changed, 39 insertions(+), 29 deletions(-) diff --git a/db/TDesign.db b/db/TDesign.db index 0ac2fc47eb8d9063b566653842abbef5cfe99de9..c8f60ab53afa8eb995598dfd46151f49f5d3449a 100644 GIT binary patch delta 522 zcmZoT;LvcuVS+T{jfpbOj5it+S`!#s6PQ{Pn71adEIe<>z`!8Nu$O`BBj;VtSdQ)N zuUS?2D;W0jz2=MKeZlL^bCD;TyNfZ3or6t*#hE#lNpiB{0}uYjm>y0^CPqn4MMhEH z>dNUp7g!XPJW7g6Q=hKi^P*$b)0r!twyt>D+$f2p&fFZVj?rU!-USvF=ER(w?GrDs zB=fab+-Ct|Rv=~rVs;?r0AkMV75BM1KZtXtGH|fjG4NOOE#^JMX2*4u%bsTghw*mB z4IFB0+wHD#t249kNHN^no_UjdGZPcTwCQqpxF_*9@lA1+LUQ7Q0#5tT1dtOG6rRs& zd9i-(lfC<&Pg(JD_ly_omb`53eZF^HUSe5hdSXdtex3r*bqdM(d1;yHItox-Y57G8 zrNxSX^EvdB~S&^FWlrVXg_?H8;E&;m=}oowjaLB?`*{5#lWx5E5oyq%Z$@& oyP^S?1t))F#{4iz7DU)BkQA_uc)zEIHg02-5)j@FB>uAk0FOAu;{X5v delta 380 zcmZoT;LvcuVS+T{xrs8)jOQ8?S`!#s6PQ{Pn71adEIjYc_k}@}!Ipt5mot*%CWkS5 zI?Dq73IBn70n@)FB3(-TWF^YgZgUSvt;Gh|?3Xo2eDaw%zU;w>mRRW7rhe?U^^ZH#0FYu9z-&hkMfW ztJk=HOy|A9E!BSLE;kVK05LBR^KCzLm*2&RXCec?IC+jd1cbK(iT|tsOfz-6 diff --git a/packages/products/tdesign-miniprogram/packages/components/swiper/README.en-US.md b/packages/products/tdesign-miniprogram/packages/components/swiper/README.en-US.md index 6a85830d7..e37625150 100644 --- a/packages/products/tdesign-miniprogram/packages/components/swiper/README.en-US.md +++ b/packages/products/tdesign-miniprogram/packages/components/swiper/README.en-US.md @@ -19,12 +19,18 @@ image-props | Object | - | `0.34.0` | N interval | Number | 5000 | \- | N list | Array | - | `0.32.0`。Typescript:`string[] \| SwiperList[]` `interface SwiperList { value: string, ariaLabel: string }`。[see more ts definition](https://github.com/Tencent/tdesign-miniprogram/blob/develop/packages/components/swiper/type.ts) | N loop | Boolean | true | \- | N -navigation | Boolean / Object / Slot | true | Typescript:`SwiperNavProps \| boolean`,[SwiperNav API Documents](./swiper-nav?tab=api)。[see more ts definition](https://github.com/Tencent/tdesign-miniprogram/blob/develop/packages/components/swiper/type.ts) | N +navigation | Boolean / Object | true | navigation all config, `true` for using default config。Typescript:`SwiperNavProps \| boolean`,[SwiperNav API Documents](./swiper-nav?tab=api)。[see more ts definition](https://github.com/Tencent/tdesign-miniprogram/blob/develop/packages/components/swiper/type.ts) | N next-margin | String / Number | 0 | `0.32.0` | N pagination-position | String | bottom | options: top-left/top/top-right/bottom-left/bottom/bottom-right | N previous-margin | String / Number | 0 | `0.32.0` | N snap-to-edge | Boolean | false | `0.32.0` | N +### Swiper Slots + +name | Description +-- | -- +navigation | navigation all config, `true` for using default config。Typescript:`SwiperNavProps \| boolean`,[SwiperNav API Documents](./swiper-nav?tab=api)。[see more ts definition](https://github.com/Tencent/tdesign-miniprogram/blob/develop/packages/components/swiper/type.ts) + ### Swiper Events name | params | description diff --git a/packages/products/tdesign-miniprogram/packages/components/swiper/README.md b/packages/products/tdesign-miniprogram/packages/components/swiper/README.md index 5b5196744..2ef095797 100644 --- a/packages/products/tdesign-miniprogram/packages/components/swiper/README.md +++ b/packages/products/tdesign-miniprogram/packages/components/swiper/README.md @@ -19,12 +19,18 @@ image-props | Object | - | `0.34.0`。透传至 Image 组件 | N interval | Number | 5000 | 轮播间隔时间 | N list | Array | - | `0.32.0`。图片列表。TS 类型:`string[] \| SwiperList[]` `interface SwiperList { value: string, ariaLabel: string }`。[详细类型定义](https://github.com/Tencent/tdesign-miniprogram/blob/develop/packages/components/swiper/type.ts) | N loop | Boolean | true | 是否循环播放 | N -navigation | Boolean / Object / Slot | true | 导航器全部配置,true 的话使用默认配置。TS 类型:`SwiperNavProps \| boolean`,[SwiperNav API Documents](./swiper-nav?tab=api)。[详细类型定义](https://github.com/Tencent/tdesign-miniprogram/blob/develop/packages/components/swiper/type.ts) | N +navigation | Boolean / Object | true | 导航器全部配置,`true` 的话使用默认配置。TS 类型:`SwiperNavProps \| boolean`,[SwiperNav API Documents](./swiper-nav?tab=api)。[详细类型定义](https://github.com/Tencent/tdesign-miniprogram/blob/develop/packages/components/swiper/type.ts) | N next-margin | String / Number | 0 | `0.32.0`。后边距,可用于露出后一项的一小部分。默认单位 `px` | N pagination-position | String | bottom | 页码信息展示位置。可选项:top-left/top/top-right/bottom-left/bottom/bottom-right | N previous-margin | String / Number | 0 | `0.32.0`。前边距,可用于露出前一项的一小部分。默认单位 `px` | N snap-to-edge | Boolean | false | `0.32.0`。当 swiper-item 的个数大于等于 2,关闭 circular 并且开启 previous-margin 或 next-margin 的时候,可以指定这个边距是否应用到第一个、最后一个元素 | N +### Swiper Slots + +名称 | 描述 +-- | -- +navigation | 导航器全部配置,`true` 的话使用默认配置。TS 类型:`SwiperNavProps \| boolean`,[SwiperNav API Documents](./swiper-nav?tab=api)。[详细类型定义](https://github.com/Tencent/tdesign-miniprogram/blob/develop/packages/components/swiper/type.ts) + ### Swiper Events 名称 | 参数 | 描述 diff --git a/packages/products/tdesign-miniprogram/packages/components/swiper/props.ts b/packages/products/tdesign-miniprogram/packages/components/swiper/props.ts index 03e087faa..218e5db7d 100644 --- a/packages/products/tdesign-miniprogram/packages/components/swiper/props.ts +++ b/packages/products/tdesign-miniprogram/packages/components/swiper/props.ts @@ -59,7 +59,7 @@ const props: TdSwiperProps = { type: Boolean, value: true, }, - /** 导航器全部配置,true 的话使用默认配置 */ + /** 导航器全部配置,`true` 的话使用默认配置 */ navigation: { type: null, value: true, diff --git a/packages/products/tdesign-miniprogram/packages/components/swiper/type.ts b/packages/products/tdesign-miniprogram/packages/components/swiper/type.ts index c985fdce7..4c36cdb19 100644 --- a/packages/products/tdesign-miniprogram/packages/components/swiper/type.ts +++ b/packages/products/tdesign-miniprogram/packages/components/swiper/type.ts @@ -94,7 +94,7 @@ export interface TdSwiperProps { value?: boolean; }; /** - * 导航器全部配置,true 的话使用默认配置 + * 导航器全部配置,`true` 的话使用默认配置 * @default true */ navigation?: { diff --git a/packages/products/tdesign-mobile-react/src/swiper/swiper.en-US.md b/packages/products/tdesign-mobile-react/src/swiper/swiper.en-US.md index ddf37708b..9946aefa6 100644 --- a/packages/products/tdesign-mobile-react/src/swiper/swiper.en-US.md +++ b/packages/products/tdesign-mobile-react/src/swiper/swiper.en-US.md @@ -16,7 +16,7 @@ duration | Number | 300 | \- | N height | String / Number | - | \- | N interval | Number | 5000 | \- | N loop | Boolean | true | \- | N -navigation | TNode | true | navigation config。Typescript:`SwiperNavigation \| TNode \| Boolean `。[see more ts definition](https://github.com/Tencent/tdesign-mobile-react/blob/develop/src/common.ts) | N +navigation | TNode | true | navigation all config, `true` for using default config。Typescript:`SwiperNavigation \| TNode \| Boolean`。[see more ts definition](https://github.com/Tencent/tdesign-mobile-react/blob/develop/src/common.ts) | N nextMargin | String / Number | 0 | \- | N previousMargin | String / Number | 0 | \- | N type | String | default | options: default/card | N diff --git a/packages/products/tdesign-mobile-react/src/swiper/swiper.md b/packages/products/tdesign-mobile-react/src/swiper/swiper.md index 0f674bbfb..4a0128ede 100644 --- a/packages/products/tdesign-mobile-react/src/swiper/swiper.md +++ b/packages/products/tdesign-mobile-react/src/swiper/swiper.md @@ -16,7 +16,7 @@ duration | Number | 300 | 滑动动画时长 | N height | String / Number | - | 当使用垂直方向滚动时的高度 | N interval | Number | 5000 | 轮播间隔时间 | N loop | Boolean | true | 是否循环播放 | N -navigation | TNode | true | 导航器全部配置。TS 类型:`SwiperNavigation \| TNode \| Boolean `。[通用类型定义](https://github.com/Tencent/tdesign-mobile-react/blob/develop/src/common.ts) | N +navigation | TNode | true | 导航器全部配置,`true` 的话使用默认配置。TS 类型:`SwiperNavigation \| TNode \| Boolean`。[通用类型定义](https://github.com/Tencent/tdesign-mobile-react/blob/develop/src/common.ts) | N nextMargin | String / Number | 0 | 后边距,可用于露出后一项的一小部分。默认单位 `px` | N previousMargin | String / Number | 0 | 前边距,可用于露出前一项的一小部分。默认单位 `px` | N type | String | default | 样式类型:默认样式、卡片样式。可选项:default/card | N diff --git a/packages/products/tdesign-mobile-react/src/swiper/type.ts b/packages/products/tdesign-mobile-react/src/swiper/type.ts index 89904ed41..b428286f4 100644 --- a/packages/products/tdesign-mobile-react/src/swiper/type.ts +++ b/packages/products/tdesign-mobile-react/src/swiper/type.ts @@ -52,7 +52,7 @@ export interface TdSwiperProps { */ loop?: boolean; /** - * 导航器全部配置 + * 导航器全部配置,`true` 的话使用默认配置 * @default true */ navigation?: SwiperNavigation | TNode | Boolean; diff --git a/packages/products/tdesign-mobile-vue/src/swiper/props.ts b/packages/products/tdesign-mobile-vue/src/swiper/props.ts index 66ffb40a1..7e9442a4a 100644 --- a/packages/products/tdesign-mobile-vue/src/swiper/props.ts +++ b/packages/products/tdesign-mobile-vue/src/swiper/props.ts @@ -64,7 +64,7 @@ export default { type: Boolean, default: true, }, - /** 导航器全部配置 */ + /** 导航器全部配置,`true` 的话使用默认配置 */ navigation: { type: [Boolean, Object, Function] as PropType, default: true as TdSwiperProps['navigation'], diff --git a/packages/products/tdesign-mobile-vue/src/swiper/swiper.en-US.md b/packages/products/tdesign-mobile-vue/src/swiper/swiper.en-US.md index d9d5f4976..76acc9412 100644 --- a/packages/products/tdesign-mobile-vue/src/swiper/swiper.en-US.md +++ b/packages/products/tdesign-mobile-vue/src/swiper/swiper.en-US.md @@ -49,7 +49,7 @@ duration | Number | 300 | \- | N height | String / Number | - | \- | N interval | Number | 5000 | \- | N loop | Boolean | true | \- | N -navigation | Boolean / Object / Slot / Function | true | navigation config。Typescript:`SwiperNavigation \| TNode \| Boolean `。[see more ts definition](https://github.com/Tencent/tdesign-mobile-vue/blob/develop/src/common.ts) | N +navigation | Boolean / Object / Slot / Function | true | navigation all config, `true` for using default config。Typescript:`SwiperNavigation \| TNode \| Boolean`。[see more ts definition](https://github.com/Tencent/tdesign-mobile-vue/blob/develop/src/common.ts) | N nextMargin | String / Number | 0 | \- | N previousMargin | String / Number | 0 | \- | N onChange | Function | | Typescript:`(current: number, context: { source: SwiperChangeSource }) => void`
[see more ts definition](https://github.com/Tencent/tdesign-mobile-vue/tree/develop/src/swiper/type.ts)。
`type SwiperChangeSource = 'autoplay' \| 'touch' \| 'nav'`
| N diff --git a/packages/products/tdesign-mobile-vue/src/swiper/swiper.md b/packages/products/tdesign-mobile-vue/src/swiper/swiper.md index 5728a5a99..675ecccf5 100644 --- a/packages/products/tdesign-mobile-vue/src/swiper/swiper.md +++ b/packages/products/tdesign-mobile-vue/src/swiper/swiper.md @@ -49,7 +49,7 @@ duration | Number | 300 | 滑动动画时长 | N height | String / Number | - | 轮播的高度 | N interval | Number | 5000 | 轮播间隔时间 | N loop | Boolean | true | 是否循环播放 | N -navigation | Boolean / Object / Slot / Function | true | 导航器全部配置。TS 类型:`SwiperNavigation \| TNode \| Boolean `。[通用类型定义](https://github.com/Tencent/tdesign-mobile-vue/blob/develop/src/common.ts) | N +navigation | Boolean / Object / Slot / Function | true | 导航器全部配置,`true` 的话使用默认配置。TS 类型:`SwiperNavigation \| TNode \| Boolean`。[通用类型定义](https://github.com/Tencent/tdesign-mobile-vue/blob/develop/src/common.ts) | N nextMargin | String / Number | 0 | 【开发中】后边距,可用于露出后一项的一小部分。默认单位 `px` | N previousMargin | String / Number | 0 | 【开发中】前边距,可用于露出前一项的一小部分。默认单位 `px` | N onChange | Function | | TS 类型:`(current: number, context: { source: SwiperChangeSource }) => void`
轮播切换时触发。[详细类型定义](https://github.com/Tencent/tdesign-mobile-vue/tree/develop/src/swiper/type.ts)。
`type SwiperChangeSource = 'autoplay' \| 'touch' \| 'nav'`
| N diff --git a/packages/products/tdesign-mobile-vue/src/swiper/type.ts b/packages/products/tdesign-mobile-vue/src/swiper/type.ts index 20d172e55..25d90b38e 100644 --- a/packages/products/tdesign-mobile-vue/src/swiper/type.ts +++ b/packages/products/tdesign-mobile-vue/src/swiper/type.ts @@ -57,7 +57,7 @@ export interface TdSwiperProps { */ loop?: boolean; /** - * 导航器全部配置 + * 导航器全部配置,`true` 的话使用默认配置 * @default true */ navigation?: SwiperNavigation | TNode | Boolean; diff --git a/packages/products/tdesign-react/packages/components/swiper/swiper.en-US.md b/packages/products/tdesign-react/packages/components/swiper/swiper.en-US.md index 2810b6740..e93260204 100644 --- a/packages/products/tdesign-react/packages/components/swiper/swiper.en-US.md +++ b/packages/products/tdesign-react/packages/components/swiper/swiper.en-US.md @@ -49,7 +49,7 @@ duration | Number | 300 | \- | N height | Number | - | \- | N interval | Number | 5000 | \- | N loop | Boolean | true | \- | N -navigation | TNode | true | navigation config。Typescript:`SwiperNavigation \| TNode \| Boolean `。[see more ts definition](https://github.com/Tencent/tdesign-react/blob/develop/packages/components/common.ts) | N +navigation | TNode | true | navigation all config。Typescript:`SwiperNavigation \| TNode`。[see more ts definition](https://github.com/Tencent/tdesign-react/blob/develop/packages/components/common.ts) | N stopOnHover | Boolean | true | \- | N theme | String | light | options: light/dark | N trigger | String | hover | options: hover/click | N diff --git a/packages/products/tdesign-react/packages/components/swiper/swiper.md b/packages/products/tdesign-react/packages/components/swiper/swiper.md index e703f811b..d6e7e65fb 100644 --- a/packages/products/tdesign-react/packages/components/swiper/swiper.md +++ b/packages/products/tdesign-react/packages/components/swiper/swiper.md @@ -49,7 +49,7 @@ duration | Number | 300 | 滑动动画时长 | N height | Number | - | 当使用垂直方向滚动时的高度 | N interval | Number | 5000 | 轮播间隔时间 | N loop | Boolean | true | 是否循环播放 | N -navigation | TNode | true | 导航器全部配置。TS 类型:`SwiperNavigation \| TNode \| Boolean `。[通用类型定义](https://github.com/Tencent/tdesign-react/blob/develop/packages/components/common.ts) | N +navigation | TNode | true | 导航器全部配置。TS 类型:`SwiperNavigation \| TNode`。[通用类型定义](https://github.com/Tencent/tdesign-react/blob/develop/packages/components/common.ts) | N stopOnHover | Boolean | true | 是否悬浮时停止轮播 | N theme | String | light | 深色模式和浅色模式。可选项:light/dark | N trigger | String | hover | 触发切换的方式:悬浮、点击等。可选项:hover/click | N diff --git a/packages/products/tdesign-react/packages/components/swiper/type.ts b/packages/products/tdesign-react/packages/components/swiper/type.ts index 0b039e8a7..385c41553 100644 --- a/packages/products/tdesign-react/packages/components/swiper/type.ts +++ b/packages/products/tdesign-react/packages/components/swiper/type.ts @@ -60,7 +60,7 @@ export interface TdSwiperProps { * 导航器全部配置 * @default true */ - navigation?: SwiperNavigation | TNode | Boolean; + navigation?: SwiperNavigation | TNode; /** * 是否悬浮时停止轮播 * @default true diff --git a/packages/products/tdesign-vue-next/packages/components/swiper/props.ts b/packages/products/tdesign-vue-next/packages/components/swiper/props.ts index a46617f6a..b6437603e 100644 --- a/packages/products/tdesign-vue-next/packages/components/swiper/props.ts +++ b/packages/products/tdesign-vue-next/packages/components/swiper/props.ts @@ -70,7 +70,7 @@ export default { }, /** 导航器全部配置 */ navigation: { - type: [Boolean, Object, Function] as PropType, + type: [Object, Function] as PropType, default: true as TdSwiperProps['navigation'], }, /** 是否悬浮时停止轮播 */ diff --git a/packages/products/tdesign-vue-next/packages/components/swiper/swiper.en-US.md b/packages/products/tdesign-vue-next/packages/components/swiper/swiper.en-US.md index 5e8f6b393..12b48b970 100644 --- a/packages/products/tdesign-vue-next/packages/components/swiper/swiper.en-US.md +++ b/packages/products/tdesign-vue-next/packages/components/swiper/swiper.en-US.md @@ -15,7 +15,7 @@ duration | Number | 300 | \- | N height | Number | - | \- | N interval | Number | 5000 | \- | N loop | Boolean | true | \- | N -navigation | Boolean / Object / Slot / Function | true | navigation config。Typescript:`SwiperNavigation \| TNode \| Boolean `。[see more ts definition](https://github.com/Tencent/tdesign-vue-next/blob/develop/packages/components/common.ts) | N +navigation | Object / Slot / Function | true | navigation all config。Typescript:`SwiperNavigation \| TNode`。[see more ts definition](https://github.com/Tencent/tdesign-vue-next/blob/develop/packages/components/common.ts) | N stopOnHover | Boolean | true | \- | N theme | String | light | options: light/dark | N trigger | String | hover | options: hover/click | N diff --git a/packages/products/tdesign-vue-next/packages/components/swiper/swiper.md b/packages/products/tdesign-vue-next/packages/components/swiper/swiper.md index badea7d25..cd09b07ad 100644 --- a/packages/products/tdesign-vue-next/packages/components/swiper/swiper.md +++ b/packages/products/tdesign-vue-next/packages/components/swiper/swiper.md @@ -15,7 +15,7 @@ duration | Number | 300 | 滑动动画时长 | N height | Number | - | 当使用垂直方向滚动时的高度 | N interval | Number | 5000 | 轮播间隔时间 | N loop | Boolean | true | 是否循环播放 | N -navigation | Boolean / Object / Slot / Function | true | 导航器全部配置。TS 类型:`SwiperNavigation \| TNode \| Boolean `。[通用类型定义](https://github.com/Tencent/tdesign-vue-next/blob/develop/packages/components/common.ts) | N +navigation | Object / Slot / Function | true | 导航器全部配置。TS 类型:`SwiperNavigation \| TNode`。[通用类型定义](https://github.com/Tencent/tdesign-vue-next/blob/develop/packages/components/common.ts) | N stopOnHover | Boolean | true | 是否悬浮时停止轮播 | N theme | String | light | 深色模式和浅色模式。可选项:light/dark | N trigger | String | hover | 触发切换的方式:悬浮、点击等。可选项:hover/click | N diff --git a/packages/products/tdesign-vue-next/packages/components/swiper/type.ts b/packages/products/tdesign-vue-next/packages/components/swiper/type.ts index e20bdd2fa..eb4922c5a 100644 --- a/packages/products/tdesign-vue-next/packages/components/swiper/type.ts +++ b/packages/products/tdesign-vue-next/packages/components/swiper/type.ts @@ -65,7 +65,7 @@ export interface TdSwiperProps { * 导航器全部配置 * @default true */ - navigation?: SwiperNavigation | TNode | Boolean; + navigation?: SwiperNavigation | TNode; /** * 是否悬浮时停止轮播 * @default true diff --git a/packages/products/tdesign-vue/src/swiper/props.ts b/packages/products/tdesign-vue/src/swiper/props.ts index fd5da3eb9..9e9166b3e 100644 --- a/packages/products/tdesign-vue/src/swiper/props.ts +++ b/packages/products/tdesign-vue/src/swiper/props.ts @@ -66,7 +66,7 @@ export default { }, /** 导航器全部配置 */ navigation: { - type: [Boolean, Object, Function] as PropType, + type: [Object, Function] as PropType, default: true, }, /** 是否悬浮时停止轮播 */ diff --git a/packages/products/tdesign-vue/src/swiper/swiper.en-US.md b/packages/products/tdesign-vue/src/swiper/swiper.en-US.md index ccae49820..11e2c4d5d 100644 --- a/packages/products/tdesign-vue/src/swiper/swiper.en-US.md +++ b/packages/products/tdesign-vue/src/swiper/swiper.en-US.md @@ -51,7 +51,7 @@ duration | Number | 300 | \- | N height | Number | - | \- | N interval | Number | 5000 | \- | N loop | Boolean | true | \- | N -navigation | Boolean / Object / Slot / Function | true | navigation config。Typescript:`SwiperNavigation \| TNode \| Boolean `。[see more ts definition](https://github.com/Tencent/tdesign-vue/blob/develop/src/common.ts) | N +navigation | Object / Slot / Function | true | navigation all config。Typescript:`SwiperNavigation \| TNode`。[see more ts definition](https://github.com/Tencent/tdesign-vue/blob/develop/src/common.ts) | N stopOnHover | Boolean | true | \- | N theme | String | light | options: light/dark | N trigger | String | hover | options: hover/click | N diff --git a/packages/products/tdesign-vue/src/swiper/swiper.md b/packages/products/tdesign-vue/src/swiper/swiper.md index 4490ef732..2a43bbaff 100644 --- a/packages/products/tdesign-vue/src/swiper/swiper.md +++ b/packages/products/tdesign-vue/src/swiper/swiper.md @@ -51,7 +51,7 @@ duration | Number | 300 | 滑动动画时长 | N height | Number | - | 当使用垂直方向滚动时的高度 | N interval | Number | 5000 | 轮播间隔时间 | N loop | Boolean | true | 是否循环播放 | N -navigation | Boolean / Object / Slot / Function | true | 导航器全部配置。TS 类型:`SwiperNavigation \| TNode \| Boolean `。[通用类型定义](https://github.com/Tencent/tdesign-vue/blob/develop/src/common.ts) | N +navigation | Object / Slot / Function | true | 导航器全部配置。TS 类型:`SwiperNavigation \| TNode`。[通用类型定义](https://github.com/Tencent/tdesign-vue/blob/develop/src/common.ts) | N stopOnHover | Boolean | true | 是否悬浮时停止轮播 | N theme | String | light | 深色模式和浅色模式。可选项:light/dark | N trigger | String | hover | 触发切换的方式:悬浮、点击等。可选项:hover/click | N diff --git a/packages/products/tdesign-vue/src/swiper/type.ts b/packages/products/tdesign-vue/src/swiper/type.ts index 0b039e8a7..385c41553 100644 --- a/packages/products/tdesign-vue/src/swiper/type.ts +++ b/packages/products/tdesign-vue/src/swiper/type.ts @@ -60,7 +60,7 @@ export interface TdSwiperProps { * 导航器全部配置 * @default true */ - navigation?: SwiperNavigation | TNode | Boolean; + navigation?: SwiperNavigation | TNode; /** * 是否悬浮时停止轮播 * @default true diff --git a/packages/scripts/api.json b/packages/scripts/api.json index 035e4275a..1660ff6d2 100644 --- a/packages/scripts/api.json +++ b/packages/scripts/api.json @@ -112512,14 +112512,13 @@ "field_category": 1, "field_name": "navigation", "field_type": [ - "4", "8", "64" ], "field_default_value": "true", "field_enum": "", "field_desc_zh": "导航器全部配置", - "field_desc_en": "navigation config", + "field_desc_en": "navigation all config", "field_required": 0, "event_input": "", "create_time": "2021-12-15 12:58:51", @@ -112540,7 +112539,6 @@ "React(PC)" ], "field_type_text": [ - "Boolean", "Object", "TNode" ] @@ -112560,8 +112558,8 @@ ], "field_default_value": "true", "field_enum": "", - "field_desc_zh": "导航器全部配置,true 的话使用默认配置", - "field_desc_en": null, + "field_desc_zh": "导航器全部配置,`true` 的话使用默认配置", + "field_desc_en": "navigation all config, `true` for using default config", "field_required": 0, "event_input": "", "create_time": "2023-01-05 02:11:32", @@ -112602,8 +112600,8 @@ ], "field_default_value": "true", "field_enum": "", - "field_desc_zh": "导航器全部配置", - "field_desc_en": "navigation config", + "field_desc_zh": "导航器全部配置,`true` 的话使用默认配置", + "field_desc_en": "navigation all config, `true` for using default config", "field_required": 0, "event_input": "", "create_time": "2025-10-24 08:51:52", From e683790b064acd625d9ab92bf113e70af95f77ca Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E9=98=BF=E8=8F=9C=20Cai?= Date: Tue, 11 Nov 2025 15:58:29 +0800 Subject: [PATCH 6/9] fix(swiper): update navigation prop description and default value handling --- db/TDesign.db | Bin 1056768 -> 1085440 bytes .../components/swiper/README.en-US.md | 12 ++--- .../packages/components/swiper/README.md | 8 +--- .../packages/components/swiper/props.ts | 2 +- .../packages/components/swiper/type.ts | 2 +- .../src/swiper/swiper.en-US.md | 10 ++-- .../tdesign-mobile-react/src/swiper/swiper.md | 2 +- .../tdesign-mobile-react/src/swiper/type.ts | 2 +- .../tdesign-mobile-vue/src/swiper/props.ts | 4 +- .../src/swiper/swiper.en-US.md | 45 ++---------------- .../tdesign-mobile-vue/src/swiper/swiper.md | 39 +-------------- .../tdesign-mobile-vue/src/swiper/type.ts | 2 +- .../components/swiper/defaultProps.ts | 1 - .../components/swiper/swiper.en-US.md | 42 ++-------------- .../packages/components/swiper/swiper.md | 36 +------------- .../packages/components/swiper/type.ts | 1 - .../packages/components/common.ts | 6 +-- .../packages/components/swiper/props.ts | 1 - .../components/swiper/swiper.en-US.md | 6 +-- .../packages/components/swiper/swiper.md | 2 +- .../packages/components/swiper/type.ts | 1 - .../products/tdesign-vue/src/swiper/props.ts | 1 - .../tdesign-vue/src/swiper/swiper.en-US.md | 7 ++- .../products/tdesign-vue/src/swiper/swiper.md | 2 +- .../products/tdesign-vue/src/swiper/type.ts | 1 - packages/scripts/api.json | 42 ++++++++-------- 26 files changed, 62 insertions(+), 215 deletions(-) diff --git a/db/TDesign.db b/db/TDesign.db index c8f60ab53afa8eb995598dfd46151f49f5d3449a..390a3a79d60df3de5226bc8217b7c5687483e483 100644 GIT binary patch delta 29264 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⩔F-n*u4vs63eIiNyQq58 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 diff --git a/packages/products/tdesign-miniprogram/packages/components/swiper/README.en-US.md b/packages/products/tdesign-miniprogram/packages/components/swiper/README.en-US.md index 407f45cc9..c8a3a4139 100644 --- a/packages/products/tdesign-miniprogram/packages/components/swiper/README.en-US.md +++ b/packages/products/tdesign-miniprogram/packages/components/swiper/README.en-US.md @@ -17,20 +17,14 @@ easing-function | String | default | `0.32.0`。options: default/linear/easeInCu height | String / Number | 192 | \- | N image-props | Object | - | `0.34.0` | N interval | Number | 5000 | \- | N -list | Array | - | `0.32.0`。Typescript:`string[] \| SwiperList[]` `interface SwiperList { value: string, ariaLabel: string }`。[see more ts definition](https://github.com/Tencent/tdesign-miniprogram/blob/develop/packages/components/swiper/type.ts) | N +list | Array | - | `0.32.0`。Typescript: `string[] \| SwiperList[]` `interface SwiperList { value: string, ariaLabel: string }`。[see more ts definition](https://github.com/Tencent/tdesign-miniprogram/blob/develop/packages/components/swiper/type.ts) | N loop | Boolean | true | \- | N -navigation | Boolean / Object | true | navigation all config, `true` for using default config。Typescript:`SwiperNavProps \| boolean`,[SwiperNav API Documents](./swiper-nav?tab=api)。[see more ts definition](https://github.com/Tencent/tdesign-miniprogram/blob/develop/packages/components/swiper/type.ts) | N +navigation | Boolean / Object | true | navigation all config, `true` for using default config。Typescript: `SwiperNavProps \| boolean`,[SwiperNav API Documents](./swiper-nav?tab=api)。[see more ts definition](https://github.com/Tencent/tdesign-miniprogram/blob/develop/packages/components/swiper/type.ts) | N next-margin | String / Number | 0 | `0.32.0` | N pagination-position | String | bottom | options: top-left/top/top-right/bottom-left/bottom/bottom-right | N previous-margin | String / Number | 0 | `0.32.0` | N snap-to-edge | Boolean | false | `0.32.0` | N -### Swiper Slots - -name | Description --- | -- -navigation | navigation all config, `true` for using default config。Typescript:`SwiperNavProps \| boolean`,[SwiperNav API Documents](./swiper-nav?tab=api)。[see more ts definition](https://github.com/Tencent/tdesign-miniprogram/blob/develop/packages/components/swiper/type.ts) - ### Swiper Events name | params | description @@ -69,7 +63,7 @@ min-show-num | Number | 2 | \- | N pagination-position | String | bottom | `0.34.0`。options: top-left/top/top-right/bottom-left/bottom/bottom-right | N show-controls | Boolean | false | `0.32.0` | N total | Number | 0 | `0.34.0` | N -type | String | dots | Typescript:`SwiperNavigationType` `type SwiperNavigationType = 'dots' \| 'dots-bar' \| 'fraction'`。[see more ts definition](https://github.com/Tencent/tdesign-miniprogram/blob/develop/packages/components/swiper-nav/type.ts) | N +type | String | dots | Typescript: `SwiperNavigationType` `type SwiperNavigationType = 'dots' \| 'dots-bar' \| 'fraction'`。[see more ts definition](https://github.com/Tencent/tdesign-miniprogram/blob/develop/packages/components/swiper-nav/type.ts) | N ### SwiperNav External Classes diff --git a/packages/products/tdesign-miniprogram/packages/components/swiper/README.md b/packages/products/tdesign-miniprogram/packages/components/swiper/README.md index 93b769a5c..7bd04fad1 100644 --- a/packages/products/tdesign-miniprogram/packages/components/swiper/README.md +++ b/packages/products/tdesign-miniprogram/packages/components/swiper/README.md @@ -19,18 +19,12 @@ image-props | Object | - | `0.34.0`。透传至 Image 组件 | N interval | Number | 5000 | 轮播间隔时间 | N list | Array | - | `0.32.0`。图片列表。TS 类型:`string[] \| SwiperList[]` `interface SwiperList { value: string, ariaLabel: string }`。[详细类型定义](https://github.com/Tencent/tdesign-miniprogram/blob/develop/packages/components/swiper/type.ts) | N loop | Boolean | true | 是否循环播放 | N -navigation | Boolean / Object | true | 导航器全部配置,`true` 的话使用默认配置。TS 类型:`SwiperNavProps \| boolean`,[SwiperNav API Documents](./swiper-nav?tab=api)。[详细类型定义](https://github.com/Tencent/tdesign-miniprogram/blob/develop/packages/components/swiper/type.ts) | N +navigation | Boolean / Object | true | 导航器全部配置,true 的话使用默认配置。TS 类型:`SwiperNavProps \| boolean`,[SwiperNav API Documents](./swiper-nav?tab=api)。[详细类型定义](https://github.com/Tencent/tdesign-miniprogram/blob/develop/packages/components/swiper/type.ts) | N next-margin | String / Number | 0 | `0.32.0`。后边距,可用于露出后一项的一小部分。默认单位 `px` | N pagination-position | String | bottom | 页码信息展示位置。可选项:top-left/top/top-right/bottom-left/bottom/bottom-right | N previous-margin | String / Number | 0 | `0.32.0`。前边距,可用于露出前一项的一小部分。默认单位 `px` | N snap-to-edge | Boolean | false | `0.32.0`。当 swiper-item 的个数大于等于 2,关闭 circular 并且开启 previous-margin 或 next-margin 的时候,可以指定这个边距是否应用到第一个、最后一个元素 | N -### Swiper Slots - -名称 | 描述 --- | -- -navigation | 导航器全部配置,`true` 的话使用默认配置。TS 类型:`SwiperNavProps \| boolean`,[SwiperNav API Documents](./swiper-nav?tab=api)。[详细类型定义](https://github.com/Tencent/tdesign-miniprogram/blob/develop/packages/components/swiper/type.ts) - ### Swiper Events 名称 | 参数 | 描述 diff --git a/packages/products/tdesign-miniprogram/packages/components/swiper/props.ts b/packages/products/tdesign-miniprogram/packages/components/swiper/props.ts index 218e5db7d..03e087faa 100644 --- a/packages/products/tdesign-miniprogram/packages/components/swiper/props.ts +++ b/packages/products/tdesign-miniprogram/packages/components/swiper/props.ts @@ -59,7 +59,7 @@ const props: TdSwiperProps = { type: Boolean, value: true, }, - /** 导航器全部配置,`true` 的话使用默认配置 */ + /** 导航器全部配置,true 的话使用默认配置 */ navigation: { type: null, value: true, diff --git a/packages/products/tdesign-miniprogram/packages/components/swiper/type.ts b/packages/products/tdesign-miniprogram/packages/components/swiper/type.ts index 4c36cdb19..c985fdce7 100644 --- a/packages/products/tdesign-miniprogram/packages/components/swiper/type.ts +++ b/packages/products/tdesign-miniprogram/packages/components/swiper/type.ts @@ -94,7 +94,7 @@ export interface TdSwiperProps { value?: boolean; }; /** - * 导航器全部配置,`true` 的话使用默认配置 + * 导航器全部配置,true 的话使用默认配置 * @default true */ navigation?: { diff --git a/packages/products/tdesign-mobile-react/src/swiper/swiper.en-US.md b/packages/products/tdesign-mobile-react/src/swiper/swiper.en-US.md index c5e258fbb..dae273feb 100644 --- a/packages/products/tdesign-mobile-react/src/swiper/swiper.en-US.md +++ b/packages/products/tdesign-mobile-react/src/swiper/swiper.en-US.md @@ -7,7 +7,7 @@ name | type | default | description | required -- | -- | -- | -- | -- className | String | - | className of component | N -style | Object | - | CSS(Cascading Style Sheets),Typescript:`React.CSSProperties` | N +style | Object | - | CSS(Cascading Style Sheets),Typescript: `React.CSSProperties` | N animation | String | slide | options: slide | N autoplay | Boolean | true | \- | N current | Number | 0 | \- | N @@ -17,12 +17,12 @@ duration | Number | 300 | \- | N height | String / Number | - | \- | N interval | Number | 5000 | \- | N loop | Boolean | true | \- | N -navigation | TNode | true | navigation all config, `true` for using default config。Typescript:`SwiperNavigation \| TNode \| Boolean`。[see more ts definition](https://github.com/Tencent/tdesign-mobile-react/blob/develop/src/common.ts) | N +navigation | TNode | true | navigation all config, `true` for using default config。Typescript: `SwiperNavigation \| TNode \| Boolean`。[see more ts definition](https://github.com/Tencent/tdesign-mobile-react/blob/develop/src/common.ts) | N nextMargin | String / Number | 0 | \- | N previousMargin | String / Number | 0 | \- | N type | String | default | options: default/card | N -onChange | Function | | Typescript:`(current: number, context: { source: SwiperChangeSource }) => void`
[see more ts definition](https://github.com/Tencent/tdesign-mobile-react/tree/develop/src/swiper/type.ts)。
`type SwiperChangeSource = 'autoplay' \| 'touch' \| 'nav'`
| N -onClick | Function | | Typescript:`(index: number) => void`
| N +onChange | Function | | Typescript: `(current: number, context: { source: SwiperChangeSource }) => void`
[see more ts definition](https://github.com/Tencent/tdesign-mobile-react/tree/develop/src/swiper/type.ts)。
`type SwiperChangeSource = 'autoplay' \| 'touch' \| 'nav'`
| N +onClick | Function | | Typescript: `(index: number) => void`
| N ### SwiperNavigation @@ -32,4 +32,4 @@ minShowNum | Number | - | \- | N paginationPosition | String | bottom | options: top-left/top/top-right/bottom-left/bottom/bottom-right/left/right | N placement | String | inside | options: inside/outside | N showControls | Boolean | false | \- | N -type | String | - | Typescript:`SwiperNavigationType` `type SwiperNavigationType = 'dots' \| 'dots-bar' \| 'fraction'`。[see more ts definition](https://github.com/Tencent/tdesign-mobile-react/tree/develop/src/swiper/type.ts) | N +type | String | - | Typescript: `SwiperNavigationType` `type SwiperNavigationType = 'dots' \| 'dots-bar' \| 'fraction'`。[see more ts definition](https://github.com/Tencent/tdesign-mobile-react/tree/develop/src/swiper/type.ts) | N diff --git a/packages/products/tdesign-mobile-react/src/swiper/swiper.md b/packages/products/tdesign-mobile-react/src/swiper/swiper.md index 13a6a5d79..17823091c 100644 --- a/packages/products/tdesign-mobile-react/src/swiper/swiper.md +++ b/packages/products/tdesign-mobile-react/src/swiper/swiper.md @@ -17,7 +17,7 @@ duration | Number | 300 | 滑动动画时长 | N height | String / Number | - | 当使用垂直方向滚动时的高度 | N interval | Number | 5000 | 轮播间隔时间 | N loop | Boolean | true | 是否循环播放 | N -navigation | TNode | true | 导航器全部配置,`true` 的话使用默认配置。TS 类型:`SwiperNavigation \| TNode \| Boolean`。[通用类型定义](https://github.com/Tencent/tdesign-mobile-react/blob/develop/src/common.ts) | N +navigation | TNode | true | 导航器全部配置,true 的话使用默认配置。TS 类型:`SwiperNavigation \| TNode \| Boolean`。[通用类型定义](https://github.com/Tencent/tdesign-mobile-react/blob/develop/src/common.ts) | N nextMargin | String / Number | 0 | 后边距,可用于露出后一项的一小部分。默认单位 `px` | N previousMargin | String / Number | 0 | 前边距,可用于露出前一项的一小部分。默认单位 `px` | N type | String | default | 样式类型:默认样式、卡片样式。可选项:default/card | N diff --git a/packages/products/tdesign-mobile-react/src/swiper/type.ts b/packages/products/tdesign-mobile-react/src/swiper/type.ts index b428286f4..513c6d993 100644 --- a/packages/products/tdesign-mobile-react/src/swiper/type.ts +++ b/packages/products/tdesign-mobile-react/src/swiper/type.ts @@ -52,7 +52,7 @@ export interface TdSwiperProps { */ loop?: boolean; /** - * 导航器全部配置,`true` 的话使用默认配置 + * 导航器全部配置,true 的话使用默认配置 * @default true */ navigation?: SwiperNavigation | TNode | Boolean; diff --git a/packages/products/tdesign-mobile-vue/src/swiper/props.ts b/packages/products/tdesign-mobile-vue/src/swiper/props.ts index 9a1f725b9..fa0b397d8 100644 --- a/packages/products/tdesign-mobile-vue/src/swiper/props.ts +++ b/packages/products/tdesign-mobile-vue/src/swiper/props.ts @@ -4,8 +4,8 @@ * 该文件为脚本自动生成文件,请勿随意修改。如需修改请联系 PMC * */ -import { PropType } from 'vue'; import { TdSwiperProps } from './type'; +import { PropType } from 'vue'; export default { /** 轮播切换动画效果类型 */ @@ -64,7 +64,7 @@ export default { type: Boolean, default: true, }, - /** 导航器全部配置,`true` 的话使用默认配置 */ + /** 导航器全部配置,true 的话使用默认配置 */ navigation: { type: [Boolean, Object, Function] as PropType, default: true as TdSwiperProps['navigation'], diff --git a/packages/products/tdesign-mobile-vue/src/swiper/swiper.en-US.md b/packages/products/tdesign-mobile-vue/src/swiper/swiper.en-US.md index e6e0bc3d0..e6d3972cb 100644 --- a/packages/products/tdesign-mobile-vue/src/swiper/swiper.en-US.md +++ b/packages/products/tdesign-mobile-vue/src/swiper/swiper.en-US.md @@ -1,39 +1,4 @@ -:: BASE_DOC :: - -## API -### Swiper Props - -name | type | default | description | required --- | -- | -- | -- | -- -animation | String | slide | options: slide | N -autoplay | Boolean | true | \- | N -current | Number | 0 | `v-model` and `v-model:current` is supported | N -direction | String | horizontal | options: horizontal/vertical | N -duration | Number | 300 | \- | N -height | String / Number | - | \- | N -interval | Number | 5000 | \- | N -loop | Boolean | true | \- | N -navigation | Boolean / Object / Function / Slot / Function | true | Typescript:`SwiperNavigation \| TNode \| Function \| Boolean `。[see more ts definition](https://github.com/Tencent/tdesign-mobile-vue/blob/develop/src/common.ts) | N -nextMargin | String / Number | 0 | \- | N -previousMargin | String / Number | 0 | \- | N -onChange | Function | | Typescript:`(current: number, context: { source: SwiperChangeSource }) => void`
[see more ts definition](https://github.com/Tencent/tdesign-mobile-vue/tree/develop/src/swiper/type.ts)。
`type SwiperChangeSource = 'autoplay' \| 'touch' \| 'nav'`
| N -onClick | Function | | Typescript:`(index: number) => void`
| N - -### Swiper Events - -name | params | description --- | -- | -- -change | `(current: number, context: { source: SwiperChangeSource })` | [see more ts definition](https://github.com/Tencent/tdesign-mobile-vue/tree/develop/src/swiper/type.ts)。
`type SwiperChangeSource = 'autoplay' \| 'touch' \| 'nav'`
-click | `(index: number)` | \- - -### SwiperNavigation - -name | type | default | description | required --- | -- | -- | -- | -- -minShowNum | Number | - | \- | N -paginationPosition | String | bottom | options: top-left/top/top-right/bottom-left/bottom/bottom-right/left/right | N -showControls | Boolean | false | \- | N -type | String | - | Typescript:`SwiperNavigationType` `type SwiperNavigationType = 'dots' \| 'dots-bar' \| 'fraction'`。[see more ts definition](https://github.com/Tencent/tdesign-mobile-vue/tree/develop/src/swiper/type.ts) | N +:: BASE_DOC :: ## API @@ -50,11 +15,11 @@ duration | Number | 300 | \- | N height | String / Number | - | \- | N interval | Number | 5000 | \- | N loop | Boolean | true | \- | N -navigation | Boolean / Object / Slot / Function | true | navigation all config, `true` for using default config。Typescript:`SwiperNavigation \| TNode \| Boolean`。[see more ts definition](https://github.com/Tencent/tdesign-mobile-vue/blob/develop/src/common.ts) | N +navigation | Boolean / Object / Slot / Function | true | navigation all config, `true` for using default config。Typescript: `SwiperNavigation \| TNode \| Boolean`。[see more ts definition](https://github.com/Tencent/tdesign-mobile-vue/blob/develop/src/common.ts) | N nextMargin | String / Number | 0 | \- | N previousMargin | String / Number | 0 | \- | N -onChange | Function | | Typescript:`(current: number, context: { source: SwiperChangeSource }) => void`
[see more ts definition](https://github.com/Tencent/tdesign-mobile-vue/tree/develop/src/swiper/type.ts)。
`type SwiperChangeSource = 'autoplay' \| 'touch' \| 'nav'`
| N -onClick | Function | | Typescript:`(index: number) => void`
| N +onChange | Function | | Typescript: `(current: number, context: { source: SwiperChangeSource }) => void`
[see more ts definition](https://github.com/Tencent/tdesign-mobile-vue/tree/develop/src/swiper/type.ts)。
`type SwiperChangeSource = 'autoplay' \| 'touch' \| 'nav'`
| N +onClick | Function | | Typescript: `(index: number) => void`
| N ### Swiper Events @@ -70,4 +35,4 @@ name | type | default | description | required minShowNum | Number | - | \- | N paginationPosition | String | bottom | options: top-left/top/top-right/bottom-left/bottom/bottom-right/left/right | N showControls | Boolean | false | \- | N -type | String | - | Typescript:`SwiperNavigationType` `type SwiperNavigationType = 'dots' \| 'dots-bar' \| 'fraction'`。[see more ts definition](https://github.com/Tencent/tdesign-mobile-vue/tree/develop/src/swiper/type.ts) | N +type | String | - | Typescript: `SwiperNavigationType` `type SwiperNavigationType = 'dots' \| 'dots-bar' \| 'fraction'`。[see more ts definition](https://github.com/Tencent/tdesign-mobile-vue/tree/develop/src/swiper/type.ts) | N diff --git a/packages/products/tdesign-mobile-vue/src/swiper/swiper.md b/packages/products/tdesign-mobile-vue/src/swiper/swiper.md index cf2973895..8886098c4 100644 --- a/packages/products/tdesign-mobile-vue/src/swiper/swiper.md +++ b/packages/products/tdesign-mobile-vue/src/swiper/swiper.md @@ -1,39 +1,4 @@ -:: BASE_DOC :: - -## API -### Swiper Props - -名称 | 类型 | 默认值 | 描述 | 必传 --- | -- | -- | -- | -- -animation | String | slide | 轮播切换动画效果类型。可选项:slide | N -autoplay | Boolean | true | 是否自动播放 | N -current | Number | 0 | 当前轮播在哪一项(下标)。支持语法糖 `v-model` 或 `v-model:current` | N -direction | String | horizontal | 轮播滑动方向,包括横向滑动和纵向滑动两个方向。可选项:horizontal/vertical | N -duration | Number | 300 | 滑动动画时长 | N -height | String / Number | - | 轮播的高度 | N -interval | Number | 5000 | 轮播间隔时间 | N -loop | Boolean | true | 是否循环播放 | N -navigation | Boolean / Object / Function / Slot / Function | true | 导航器全部配置。TS 类型:`SwiperNavigation \| TNode \| Function \| Boolean `。[通用类型定义](https://github.com/Tencent/tdesign-mobile-vue/blob/develop/src/common.ts) | N -nextMargin | String / Number | 0 | 【开发中】后边距,可用于露出后一项的一小部分。默认单位 `px` | N -previousMargin | String / Number | 0 | 【开发中】前边距,可用于露出前一项的一小部分。默认单位 `px` | N -onChange | Function | | TS 类型:`(current: number, context: { source: SwiperChangeSource }) => void`
轮播切换时触发。[详细类型定义](https://github.com/Tencent/tdesign-mobile-vue/tree/develop/src/swiper/type.ts)。
`type SwiperChangeSource = 'autoplay' \| 'touch' \| 'nav'`
| N -onClick | Function | | TS 类型:`(index: number) => void`
点击轮播项时触发 | N - -### Swiper Events - -名称 | 参数 | 描述 --- | -- | -- -change | `(current: number, context: { source: SwiperChangeSource })` | 轮播切换时触发。[详细类型定义](https://github.com/Tencent/tdesign-mobile-vue/tree/develop/src/swiper/type.ts)。
`type SwiperChangeSource = 'autoplay' \| 'touch' \| 'nav'`
-click | `(index: number)` | 点击轮播项时触发 - -### SwiperNavigation - -名称 | 类型 | 默认值 | 描述 | 必传 --- | -- | -- | -- | -- -minShowNum | Number | - | 小于这个数字不会显示导航器 | N -paginationPosition | String | bottom | 页码信息展示位置。可选项:top-left/top/top-right/bottom-left/bottom/bottom-right/left/right | N -showControls | Boolean | false | 是否显示两侧的控制按钮 | N -type | String | - | 导航器类型,点状(dots)、点条状(dots-bar)、分式(fraction)等。TS 类型:`SwiperNavigationType` `type SwiperNavigationType = 'dots' \| 'dots-bar' \| 'fraction'`。[详细类型定义](https://github.com/Tencent/tdesign-mobile-vue/tree/develop/src/swiper/type.ts) | N +:: BASE_DOC :: ## API @@ -50,7 +15,7 @@ duration | Number | 300 | 滑动动画时长 | N height | String / Number | - | 轮播的高度 | N interval | Number | 5000 | 轮播间隔时间 | N loop | Boolean | true | 是否循环播放 | N -navigation | Boolean / Object / Slot / Function | true | 导航器全部配置,`true` 的话使用默认配置。TS 类型:`SwiperNavigation \| TNode \| Boolean`。[通用类型定义](https://github.com/Tencent/tdesign-mobile-vue/blob/develop/src/common.ts) | N +navigation | Boolean / Object / Slot / Function | true | 导航器全部配置,true 的话使用默认配置。TS 类型:`SwiperNavigation \| TNode \| Boolean`。[通用类型定义](https://github.com/Tencent/tdesign-mobile-vue/blob/develop/src/common.ts) | N nextMargin | String / Number | 0 | 【开发中】后边距,可用于露出后一项的一小部分。默认单位 `px` | N previousMargin | String / Number | 0 | 【开发中】前边距,可用于露出前一项的一小部分。默认单位 `px` | N onChange | Function | | TS 类型:`(current: number, context: { source: SwiperChangeSource }) => void`
轮播切换时触发。[详细类型定义](https://github.com/Tencent/tdesign-mobile-vue/tree/develop/src/swiper/type.ts)。
`type SwiperChangeSource = 'autoplay' \| 'touch' \| 'nav'`
| N diff --git a/packages/products/tdesign-mobile-vue/src/swiper/type.ts b/packages/products/tdesign-mobile-vue/src/swiper/type.ts index 25d90b38e..b8ed69af5 100644 --- a/packages/products/tdesign-mobile-vue/src/swiper/type.ts +++ b/packages/products/tdesign-mobile-vue/src/swiper/type.ts @@ -57,7 +57,7 @@ export interface TdSwiperProps { */ loop?: boolean; /** - * 导航器全部配置,`true` 的话使用默认配置 + * 导航器全部配置,true 的话使用默认配置 * @default true */ navigation?: SwiperNavigation | TNode | Boolean; diff --git a/packages/products/tdesign-react/packages/components/swiper/defaultProps.ts b/packages/products/tdesign-react/packages/components/swiper/defaultProps.ts index 9da829c74..12dd7ccd7 100644 --- a/packages/products/tdesign-react/packages/components/swiper/defaultProps.ts +++ b/packages/products/tdesign-react/packages/components/swiper/defaultProps.ts @@ -13,7 +13,6 @@ export const swiperDefaultProps: TdSwiperProps = { duration: 300, interval: 5000, loop: true, - navigation: true, stopOnHover: true, theme: 'light', trigger: 'hover', diff --git a/packages/products/tdesign-react/packages/components/swiper/swiper.en-US.md b/packages/products/tdesign-react/packages/components/swiper/swiper.en-US.md index fd712c961..881730562 100644 --- a/packages/products/tdesign-react/packages/components/swiper/swiper.en-US.md +++ b/packages/products/tdesign-react/packages/components/swiper/swiper.en-US.md @@ -1,36 +1,4 @@ -:: BASE_DOC :: - -## API -### Swiper Props - -name | type | default | description | required --- | -- | -- | -- | -- -className | String | - | className of component | N -style | Object | - | CSS(Cascading Style Sheets),Typescript:`React.CSSProperties` | N -animation | String | slide | options: slide/fade | N -autoplay | Boolean | true | \- | N -cardScale | Number | 210/332 | \- | N -current | Number | 0 | \- | N -direction | String | horizontal | options: horizontal/vertical | N -duration | Number | 300 | \- | N -height | Number | - | \- | N -interval | Number | 5000 | \- | N -loop | Boolean | true | \- | N -navigation | TNode | true | Typescript:`SwiperNavigation \| TNode \| Function \| Boolean `。[see more ts definition](https://github.com/Tencent/tdesign-react/blob/develop/packages/components/common.ts) | N -stopOnHover | Boolean | true | \- | N -theme | String | light | options: light/dark | N -trigger | String | hover | options: hover/click | N -type | String | default | options: default/card | N -onChange | Function | | Typescript:`(current: number, context: { source: SwiperChangeSource }) => void`
[see more ts definition](https://github.com/Tencent/tdesign-react/blob/develop/packages/components/swiper/type.ts)。
`type SwiperChangeSource = 'autoplay' \| 'click' \| 'hover'`
| N - -### SwiperNavigation - -name | type | default | description | required --- | -- | -- | -- | -- -placement | String | inside | options: inside/outside | N -showSlideBtn | String | always | options: always/hover/never | N -size | String | medium | options: small/medium/large | N -type | String | - | Typescript:`SwiperNavigationType` `type SwiperNavigationType = 'dots' \| 'dots-bar' \| 'bars' \| 'fraction'`。[see more ts definition](https://github.com/Tencent/tdesign-react/blob/develop/packages/components/swiper/type.ts) | N +:: BASE_DOC :: ## API @@ -39,7 +7,7 @@ type | String | - | Typescript:`SwiperNavigationType` `type SwiperNavigationTy name | type | default | description | required -- | -- | -- | -- | -- className | String | - | className of component | N -style | Object | - | CSS(Cascading Style Sheets),Typescript:`React.CSSProperties` | N +style | Object | - | CSS(Cascading Style Sheets),Typescript: `React.CSSProperties` | N animation | String | slide | options: slide/fade | N autoplay | Boolean | true | \- | N cardScale | Number | 210/332 | \- | N @@ -50,12 +18,12 @@ duration | Number | 300 | \- | N height | Number | - | \- | N interval | Number | 5000 | \- | N loop | Boolean | true | \- | N -navigation | TNode | true | navigation all config。Typescript:`SwiperNavigation \| TNode`。[see more ts definition](https://github.com/Tencent/tdesign-react/blob/develop/packages/components/common.ts) | N +navigation | TNode | - | navigation all config。Typescript: `SwiperNavigation \| TNode`。[see more ts definition](https://github.com/Tencent/tdesign-react/blob/develop/packages/components/common.ts) | N stopOnHover | Boolean | true | \- | N theme | String | light | options: light/dark | N trigger | String | hover | options: hover/click | N type | String | default | options: default/card | N -onChange | Function | | Typescript:`(current: number, context: { source: SwiperChangeSource }) => void`
[see more ts definition](https://github.com/Tencent/tdesign-react/blob/develop/packages/components/swiper/type.ts)。
`type SwiperChangeSource = 'autoplay' \| 'click' \| 'hover'`
| N +onChange | Function | | Typescript: `(current: number, context: { source: SwiperChangeSource }) => void`
[see more ts definition](https://github.com/Tencent/tdesign-react/blob/develop/packages/components/swiper/type.ts)。
`type SwiperChangeSource = 'autoplay' \| 'click' \| 'hover'`
| N ### SwiperNavigation @@ -64,4 +32,4 @@ name | type | default | description | required placement | String | inside | options: inside/outside | N showSlideBtn | String | always | options: always/hover/never | N size | String | medium | options: small/medium/large | N -type | String | - | Typescript:`SwiperNavigationType` `type SwiperNavigationType = 'dots' \| 'dots-bar' \| 'bars' \| 'fraction'`。[see more ts definition](https://github.com/Tencent/tdesign-react/blob/develop/packages/components/swiper/type.ts) | N +type | String | - | Typescript: `SwiperNavigationType` `type SwiperNavigationType = 'dots' \| 'dots-bar' \| 'bars' \| 'fraction'`。[see more ts definition](https://github.com/Tencent/tdesign-react/blob/develop/packages/components/swiper/type.ts) | N diff --git a/packages/products/tdesign-react/packages/components/swiper/swiper.md b/packages/products/tdesign-react/packages/components/swiper/swiper.md index 680f0d53e..d287c7326 100644 --- a/packages/products/tdesign-react/packages/components/swiper/swiper.md +++ b/packages/products/tdesign-react/packages/components/swiper/swiper.md @@ -1,36 +1,4 @@ -:: BASE_DOC :: - -## API -### Swiper Props - -名称 | 类型 | 默认值 | 描述 | 必传 --- | -- | -- | -- | -- -className | String | - | 类名 | N -style | Object | - | 样式,TS 类型:`React.CSSProperties` | N -animation | String | slide | 轮播切换动画效果类型:滑动、淡入淡出等。可选项:slide/fade | N -autoplay | Boolean | true | 是否自动播放 | N -cardScale | Number | 210/332 | 卡片模式下非当前展示轮播图的缩放比例 | N -current | Number | 0 | 当前轮播在哪一项(下标) | N -direction | String | horizontal | 轮播滑动方向,包括横向滑动和纵向滑动两个方向。可选项:horizontal/vertical | N -duration | Number | 300 | 滑动动画时长 | N -height | Number | - | 当使用垂直方向滚动时的高度 | N -interval | Number | 5000 | 轮播间隔时间 | N -loop | Boolean | true | 是否循环播放 | N -navigation | TNode | true | 导航器全部配置。TS 类型:`SwiperNavigation \| TNode \| Function \| Boolean `。[通用类型定义](https://github.com/Tencent/tdesign-react/blob/develop/packages/components/common.ts) | N -stopOnHover | Boolean | true | 是否悬浮时停止轮播 | N -theme | String | light | 深色模式和浅色模式。可选项:light/dark | N -trigger | String | hover | 触发切换的方式:悬浮、点击等。可选项:hover/click | N -type | String | default | 样式类型:默认样式、卡片样式。可选项:default/card | N -onChange | Function | | TS 类型:`(current: number, context: { source: SwiperChangeSource }) => void`
轮播切换时触发。[详细类型定义](https://github.com/Tencent/tdesign-react/blob/develop/packages/components/swiper/type.ts)。
`type SwiperChangeSource = 'autoplay' \| 'click' \| 'hover'`
| N - -### SwiperNavigation - -名称 | 类型 | 默认值 | 描述 | 必传 --- | -- | -- | -- | -- -placement | String | inside | 导航器位置,位于主体的内侧或是外侧。可选项:inside/outside | N -showSlideBtn | String | always | 何时显示导航器的翻页按钮:始终显示、悬浮显示、永不显示。可选项:always/hover/never | N -size | String | medium | 导航器尺寸。可选项:small/medium/large | N -type | String | - | 导航器类型,点状(dots)、点条状(dots-bar)、条状(bars)、分式(fraction)等。TS 类型:`SwiperNavigationType` `type SwiperNavigationType = 'dots' \| 'dots-bar' \| 'bars' \| 'fraction'`。[详细类型定义](https://github.com/Tencent/tdesign-react/blob/develop/packages/components/swiper/type.ts) | N +:: BASE_DOC :: ## API @@ -50,7 +18,7 @@ duration | Number | 300 | 滑动动画时长 | N height | Number | - | 当使用垂直方向滚动时的高度 | N interval | Number | 5000 | 轮播间隔时间 | N loop | Boolean | true | 是否循环播放 | N -navigation | TNode | true | 导航器全部配置。TS 类型:`SwiperNavigation \| TNode`。[通用类型定义](https://github.com/Tencent/tdesign-react/blob/develop/packages/components/common.ts) | N +navigation | TNode | - | 导航器全部配置。TS 类型:`SwiperNavigation \| TNode`。[通用类型定义](https://github.com/Tencent/tdesign-react/blob/develop/packages/components/common.ts) | N stopOnHover | Boolean | true | 是否悬浮时停止轮播 | N theme | String | light | 深色模式和浅色模式。可选项:light/dark | N trigger | String | hover | 触发切换的方式:悬浮、点击等。可选项:hover/click | N diff --git a/packages/products/tdesign-react/packages/components/swiper/type.ts b/packages/products/tdesign-react/packages/components/swiper/type.ts index 385c41553..366a9f8d8 100644 --- a/packages/products/tdesign-react/packages/components/swiper/type.ts +++ b/packages/products/tdesign-react/packages/components/swiper/type.ts @@ -58,7 +58,6 @@ export interface TdSwiperProps { loop?: boolean; /** * 导航器全部配置 - * @default true */ navigation?: SwiperNavigation | TNode; /** diff --git a/packages/products/tdesign-vue-next/packages/components/common.ts b/packages/products/tdesign-vue-next/packages/components/common.ts index 2a381a710..b593c98fe 100644 --- a/packages/products/tdesign-vue-next/packages/components/common.ts +++ b/packages/products/tdesign-vue-next/packages/components/common.ts @@ -41,9 +41,6 @@ export interface UploadDisplayDragEvents { export type ImageEvent = Event; -/** - * 通用全局类型 - * */ export type PlainObject = { [key: string]: any }; export type OptionData = { @@ -63,6 +60,9 @@ export type TreeOptionData = { content?: string | TNode; } & PlainObject; +/** + * 通用全局类型 + * */ export type SizeEnum = 'small' | 'medium' | 'large'; export type ShapeEnum = 'circle' | 'round'; diff --git a/packages/products/tdesign-vue-next/packages/components/swiper/props.ts b/packages/products/tdesign-vue-next/packages/components/swiper/props.ts index e433e9a1b..0648e2d55 100644 --- a/packages/products/tdesign-vue-next/packages/components/swiper/props.ts +++ b/packages/products/tdesign-vue-next/packages/components/swiper/props.ts @@ -72,7 +72,6 @@ export default { /** 导航器全部配置 */ navigation: { type: [Object, Function] as PropType, - default: true as TdSwiperProps['navigation'], }, /** 是否悬浮时停止轮播 */ stopOnHover: { diff --git a/packages/products/tdesign-vue-next/packages/components/swiper/swiper.en-US.md b/packages/products/tdesign-vue-next/packages/components/swiper/swiper.en-US.md index 50087259f..46e4895c6 100644 --- a/packages/products/tdesign-vue-next/packages/components/swiper/swiper.en-US.md +++ b/packages/products/tdesign-vue-next/packages/components/swiper/swiper.en-US.md @@ -16,12 +16,12 @@ duration | Number | 300 | \- | N height | Number | - | \- | N interval | Number | 5000 | \- | N loop | Boolean | true | \- | N -navigation | Object / Slot / Function | true | navigation all config。Typescript:`SwiperNavigation \| TNode`。[see more ts definition](https://github.com/Tencent/tdesign-vue-next/blob/develop/packages/components/common.ts) | N +navigation | Object / Slot / Function | - | navigation all config。Typescript: `SwiperNavigation \| TNode`。[see more ts definition](https://github.com/Tencent/tdesign-vue-next/blob/develop/packages/components/common.ts) | N stopOnHover | Boolean | true | \- | N theme | String | light | options: light/dark | N trigger | String | hover | options: hover/click | N type | String | default | options: default/card | N -onChange | Function | | Typescript:`(current: number, context: { source: SwiperChangeSource }) => void`
[see more ts definition](https://github.com/Tencent/tdesign-vue-next/blob/develop/packages/components/swiper/type.ts)。
`type SwiperChangeSource = 'autoplay' \| 'click' \| 'hover'`
| N +onChange | Function | | Typescript: `(current: number, context: { source: SwiperChangeSource }) => void`
[see more ts definition](https://github.com/Tencent/tdesign-vue-next/blob/develop/packages/components/swiper/type.ts)。
`type SwiperChangeSource = 'autoplay' \| 'click' \| 'hover'`
| N ### Swiper Events @@ -36,4 +36,4 @@ name | type | default | description | required placement | String | inside | options: inside/outside | N showSlideBtn | String | always | options: always/hover/never | N size | String | medium | options: small/medium/large | N -type | String | - | Typescript:`SwiperNavigationType` `type SwiperNavigationType = 'dots' \| 'dots-bar' \| 'bars' \| 'fraction'`。[see more ts definition](https://github.com/Tencent/tdesign-vue-next/blob/develop/packages/components/swiper/type.ts) | N +type | String | - | Typescript: `SwiperNavigationType` `type SwiperNavigationType = 'dots' \| 'dots-bar' \| 'bars' \| 'fraction'`。[see more ts definition](https://github.com/Tencent/tdesign-vue-next/blob/develop/packages/components/swiper/type.ts) | N diff --git a/packages/products/tdesign-vue-next/packages/components/swiper/swiper.md b/packages/products/tdesign-vue-next/packages/components/swiper/swiper.md index cb0597b10..efb4ebbc7 100644 --- a/packages/products/tdesign-vue-next/packages/components/swiper/swiper.md +++ b/packages/products/tdesign-vue-next/packages/components/swiper/swiper.md @@ -16,7 +16,7 @@ duration | Number | 300 | 滑动动画时长 | N height | Number | - | 当使用垂直方向滚动时的高度 | N interval | Number | 5000 | 轮播间隔时间 | N loop | Boolean | true | 是否循环播放 | N -navigation | Object / Slot / Function | true | 导航器全部配置。TS 类型:`SwiperNavigation \| TNode`。[通用类型定义](https://github.com/Tencent/tdesign-vue-next/blob/develop/packages/components/common.ts) | N +navigation | Object / Slot / Function | - | 导航器全部配置。TS 类型:`SwiperNavigation \| TNode`。[通用类型定义](https://github.com/Tencent/tdesign-vue-next/blob/develop/packages/components/common.ts) | N stopOnHover | Boolean | true | 是否悬浮时停止轮播 | N theme | String | light | 深色模式和浅色模式。可选项:light/dark | N trigger | String | hover | 触发切换的方式:悬浮、点击等。可选项:hover/click | N diff --git a/packages/products/tdesign-vue-next/packages/components/swiper/type.ts b/packages/products/tdesign-vue-next/packages/components/swiper/type.ts index eb4922c5a..796189505 100644 --- a/packages/products/tdesign-vue-next/packages/components/swiper/type.ts +++ b/packages/products/tdesign-vue-next/packages/components/swiper/type.ts @@ -63,7 +63,6 @@ export interface TdSwiperProps { loop?: boolean; /** * 导航器全部配置 - * @default true */ navigation?: SwiperNavigation | TNode; /** diff --git a/packages/products/tdesign-vue/src/swiper/props.ts b/packages/products/tdesign-vue/src/swiper/props.ts index 74702734a..6435d4c9b 100644 --- a/packages/products/tdesign-vue/src/swiper/props.ts +++ b/packages/products/tdesign-vue/src/swiper/props.ts @@ -68,7 +68,6 @@ export default { /** 导航器全部配置 */ navigation: { type: [Object, Function] as PropType, - default: true, }, /** 是否悬浮时停止轮播 */ stopOnHover: { diff --git a/packages/products/tdesign-vue/src/swiper/swiper.en-US.md b/packages/products/tdesign-vue/src/swiper/swiper.en-US.md index 44c9c0103..f4aca1221 100644 --- a/packages/products/tdesign-vue/src/swiper/swiper.en-US.md +++ b/packages/products/tdesign-vue/src/swiper/swiper.en-US.md @@ -2,7 +2,6 @@ ## API - ### Swiper Props name | type | default | description | required @@ -17,12 +16,12 @@ duration | Number | 300 | \- | N height | Number | - | \- | N interval | Number | 5000 | \- | N loop | Boolean | true | \- | N -navigation | Object / Slot / Function | true | navigation all config。Typescript:`SwiperNavigation \| TNode`。[see more ts definition](https://github.com/Tencent/tdesign-vue/blob/develop/src/common.ts) | N +navigation | Object / Slot / Function | - | navigation all config。Typescript: `SwiperNavigation \| TNode`。[see more ts definition](https://github.com/Tencent/tdesign-vue/blob/develop/src/common.ts) | N stopOnHover | Boolean | true | \- | N theme | String | light | options: light/dark | N trigger | String | hover | options: hover/click | N type | String | default | options: default/card | N -onChange | Function | | Typescript:`(current: number, context: { source: SwiperChangeSource }) => void`
[see more ts definition](https://github.com/Tencent/tdesign-vue/tree/develop/src/swiper/type.ts)。
`type SwiperChangeSource = 'autoplay' \| 'click' \| 'hover'`
| N +onChange | Function | | Typescript: `(current: number, context: { source: SwiperChangeSource }) => void`
[see more ts definition](https://github.com/Tencent/tdesign-vue/tree/develop/src/swiper/type.ts)。
`type SwiperChangeSource = 'autoplay' \| 'click' \| 'hover'`
| N ### Swiper Events @@ -37,4 +36,4 @@ name | type | default | description | required placement | String | inside | options: inside/outside | N showSlideBtn | String | always | options: always/hover/never | N size | String | medium | options: small/medium/large | N -type | String | - | Typescript:`SwiperNavigationType` `type SwiperNavigationType = 'dots' \| 'dots-bar' \| 'bars' \| 'fraction'`。[see more ts definition](https://github.com/Tencent/tdesign-vue/tree/develop/src/swiper/type.ts) | N +type | String | - | Typescript: `SwiperNavigationType` `type SwiperNavigationType = 'dots' \| 'dots-bar' \| 'bars' \| 'fraction'`。[see more ts definition](https://github.com/Tencent/tdesign-vue/tree/develop/src/swiper/type.ts) | N diff --git a/packages/products/tdesign-vue/src/swiper/swiper.md b/packages/products/tdesign-vue/src/swiper/swiper.md index 41260e752..23936d253 100644 --- a/packages/products/tdesign-vue/src/swiper/swiper.md +++ b/packages/products/tdesign-vue/src/swiper/swiper.md @@ -16,7 +16,7 @@ duration | Number | 300 | 滑动动画时长 | N height | Number | - | 当使用垂直方向滚动时的高度 | N interval | Number | 5000 | 轮播间隔时间 | N loop | Boolean | true | 是否循环播放 | N -navigation | Object / Slot / Function | true | 导航器全部配置。TS 类型:`SwiperNavigation \| TNode`。[通用类型定义](https://github.com/Tencent/tdesign-vue/blob/develop/src/common.ts) | N +navigation | Object / Slot / Function | - | 导航器全部配置。TS 类型:`SwiperNavigation \| TNode`。[通用类型定义](https://github.com/Tencent/tdesign-vue/blob/develop/src/common.ts) | N stopOnHover | Boolean | true | 是否悬浮时停止轮播 | N theme | String | light | 深色模式和浅色模式。可选项:light/dark | N trigger | String | hover | 触发切换的方式:悬浮、点击等。可选项:hover/click | N diff --git a/packages/products/tdesign-vue/src/swiper/type.ts b/packages/products/tdesign-vue/src/swiper/type.ts index 385c41553..366a9f8d8 100644 --- a/packages/products/tdesign-vue/src/swiper/type.ts +++ b/packages/products/tdesign-vue/src/swiper/type.ts @@ -58,7 +58,6 @@ export interface TdSwiperProps { loop?: boolean; /** * 导航器全部配置 - * @default true */ navigation?: SwiperNavigation | TNode; /** diff --git a/packages/scripts/api.json b/packages/scripts/api.json index 90ede7ad1..ce5fe1532 100644 --- a/packages/scripts/api.json +++ b/packages/scripts/api.json @@ -116863,26 +116863,27 @@ { "id": 2044, "platform_framework": [ - "1", - "2" + "8", + "16" ], "component": "Swiper", "field_category": 1, "field_name": "navigation", "field_type": [ + "4", "8", "64" ], "field_default_value": "true", "field_enum": "", - "field_desc_zh": "导航器全部配置", - "field_desc_en": "navigation all config", + "field_desc_zh": "导航器全部配置,true 的话使用默认配置", + "field_desc_en": "navigation all config, `true` for using default config", "field_required": 0, "event_input": "", "create_time": "2021-12-15 12:58:51", "update_time": "2022-01-25 11:57:28", "event_output": null, - "custom_field_type": "SwiperNavigation | TNode", + "custom_field_type": "SwiperNavigation | TNode | Boolean", "syntactic_sugar": null, "readonly": 1, "html_attribute": 0, @@ -116893,10 +116894,11 @@ "support_default_value": 0, "field_category_text": "Props", "platform_framework_text": [ - "Vue(PC)", - "React(PC)" + "Vue(Mobile)", + "React(Mobile)" ], "field_type_text": [ + "Boolean", "Object", "TNode" ] @@ -116916,7 +116918,7 @@ ], "field_default_value": "true", "field_enum": "", - "field_desc_zh": "导航器全部配置,`true` 的话使用默认配置", + "field_desc_zh": "导航器全部配置,true 的话使用默认配置", "field_desc_en": "navigation all config, `true` for using default config", "field_required": 0, "event_input": "", @@ -116943,29 +116945,28 @@ ] }, { - "id": 1761295912, + "id": 1762847746, "platform_framework": [ - "8", - "16" + "1", + "2" ], "component": "Swiper", "field_category": 1, "field_name": "navigation", "field_type": [ - "4", "8", "64" ], - "field_default_value": "true", + "field_default_value": "", "field_enum": "", - "field_desc_zh": "导航器全部配置,`true` 的话使用默认配置", - "field_desc_en": "navigation all config, `true` for using default config", + "field_desc_zh": "导航器全部配置", + "field_desc_en": "navigation all config", "field_required": 0, "event_input": "", - "create_time": "2025-10-24 08:51:52", - "update_time": "2025-10-24 08:51:52", + "create_time": "2025-11-11 07:55:46", + "update_time": "2025-11-11 07:55:46", "event_output": null, - "custom_field_type": "SwiperNavigation | TNode | Boolean", + "custom_field_type": "SwiperNavigation | TNode", "syntactic_sugar": null, "readonly": 1, "html_attribute": 0, @@ -116976,11 +116977,10 @@ "support_default_value": 0, "field_category_text": "Props", "platform_framework_text": [ - "Vue(Mobile)", - "React(Mobile)" + "Vue(PC)", + "React(PC)" ], "field_type_text": [ - "Boolean", "Object", "TNode" ] From f788b0e18d7c4dab387be97b0718c3a0e4a420d0 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E9=98=BF=E8=8F=9C=20Cai?= Date: Tue, 11 Nov 2025 16:01:36 +0800 Subject: [PATCH 7/9] fix(api): update navigation field properties and descriptions for Swiper component --- db/TDesign.db | Bin 1085440 -> 1085440 bytes packages/scripts/api.json | 36 ++++++++++++++++++------------------ 2 files changed, 18 insertions(+), 18 deletions(-) diff --git a/db/TDesign.db b/db/TDesign.db index 390a3a79d60df3de5226bc8217b7c5687483e483..ed18bb4455f4759ebfdccdd0066fba3650153fac 100644 GIT binary patch delta 215 zcmZoz;MB0dX@WGP??f4AM&HJS)&$1Z1g6#m=B)`V%gzfOWZ?S9d6zSmV>|n6Ru%pV zhJ({3F0ibWZxrp}lw@L*@MiVqSM8`BnY sNwR<~66Gzg1X~mcvnW&O4b$|A7g$=RyEO_}PY<}r!nM7zQJ|g=0H%0DivR!s delta 188 zcmZoz;MB0dX@WGP*F+g-Mz6+%)&$1Z1g6#m=B)`V%gzfGF>rn4yvrHOv7P-js|tSw zL(z1J3oI+Azi1E$nJ#~k#hOc@M!_jRKPNRYuRZD_3lOscF&hxG12G2>a{@6J5OV`D z4-oSLG2iy6i~MWWF+Q8l-XNeiU9o|4qhh1@LM}-bMoCUZMqXZXa}Hi(V+LCWP7YoU cUIva#p*Kv^A6#IupKjAAV7 Date: Tue, 16 Dec 2025 18:57:30 +0800 Subject: [PATCH 8/9] fix: update API documentation and remove deprecated props --- packages/scripts/api.json | 825 ++++++-------------------------------- 1 file changed, 119 insertions(+), 706 deletions(-) diff --git a/packages/scripts/api.json b/packages/scripts/api.json index f174c35b3..547049f77 100644 --- a/packages/scripts/api.json +++ b/packages/scripts/api.json @@ -2688,7 +2688,7 @@ "create_time": "2021-09-02 12:06:15", "update_time": "2022-04-08 09:06:29", "event_output": null, - "custom_field_type": "Array【interface ActionSheetItem { label: string; description?: string; color?: string; disabled?: boolean; icon?: string; suffixIcon?: string }】", + "custom_field_type": "Array【interface ActionSheetItem { label: string; color?: string; disabled?: boolean; icon?: string; suffixIcon?: string }】", "syntactic_sugar": null, "readonly": 1, "html_attribute": 0, @@ -2726,7 +2726,7 @@ "create_time": "2024-04-10 02:45:01", "update_time": "2024-04-10 02:45:01", "event_output": null, - "custom_field_type": "Array【interface ActionSheetItem { label: string; description?: string; color?: string; disabled?: boolean; icon?: TNode; suffixIcon?: TNode; badge?: BadgeProps }】【import { BadgeProps } from '@Badge'】", + "custom_field_type": "Array【interface ActionSheetItem { label: string; color?: string; disabled?: boolean; icon?: TNode; badge?: BadgeProps }】【import { BadgeProps } from '@Badge'】", "syntactic_sugar": null, "readonly": 1, "html_attribute": 0, @@ -5119,9 +5119,9 @@ ], "field_default_value": "[]", "field_enum": "", - "field_desc_zh": "附件列表", + "field_desc_zh": "【实验】附件列表", "field_desc_en": null, - "field_required": 1, + "field_required": 0, "event_input": "", "create_time": "2025-11-06 09:26:24", "update_time": "2025-11-06 09:26:24", @@ -16505,47 +16505,6 @@ ], "field_type_text": [] }, - { - "id": 1762761101, - "platform_framework": [ - "8", - "16", - "64" - ], - "component": "Calendar", - "field_category": 1, - "field_name": "allowSameDay", - "field_type": [ - "4" - ], - "field_default_value": "false", - "field_enum": "", - "field_desc_zh": "是否允许区间选择日历的起止时间相同,仅当 `type='range'` 时有效", - "field_desc_en": null, - "field_required": 0, - "event_input": "", - "create_time": "2025-11-10 07:51:41", - "update_time": "2025-11-10 07:51:41", - "event_output": null, - "custom_field_type": null, - "syntactic_sugar": null, - "readonly": 1, - "html_attribute": 0, - "trigger_elements": "", - "deprecated": 0, - "version": "{\"Miniprogram\": \"1.11.2\"}", - "test_description": null, - "support_default_value": 0, - "field_category_text": "Props", - "platform_framework_text": [ - "Vue(Mobile)", - "React(Mobile)", - "Miniprogram" - ], - "field_type_text": [ - "Boolean" - ] - }, { "id": 3263, "platform_framework": [ @@ -16933,7 +16892,7 @@ "create_time": "2022-11-01 02:31:29", "update_time": "2022-11-01 02:31:29", "event_output": null, - "custom_field_type": "CalendarFormatType 【type CalendarFormatType = (day: TDate) => TDate】【type TDateType = 'selected' | 'disabled' | 'start' | 'start-end' |'centre' | 'end' | ''】【interface TDate { date: Date; day: number; type: TDateType; className?: string; prefix?: string; suffix?: string;}】", + "custom_field_type": "CalendarFormatType 【type CalendarFormatType = (day: TDate) => TDate】【type TDateType = 'selected' | 'disabled' | 'start' | 'centre' | 'end' | ''】【interface TDate { date: Date; day: number; type: TDateType; className?: string; prefix?: string; suffix?: string;}】", "syntactic_sugar": null, "readonly": 1, "html_attribute": 0, @@ -17599,7 +17558,7 @@ "field_type": [ "1" ], - "field_default_value": "single", + "field_default_value": "'single'", "field_enum": "single/multiple/range", "field_desc_zh": "日历的选择类型,single = 单选;multiple = 多选; range = 区间选择", "field_desc_en": null, @@ -17803,7 +17762,7 @@ ], "field_default_value": "", "field_enum": "", - "field_desc_zh": "当前选择的日期,不传则选用 minDate 属性值或今天,优先级:minDate > today。当 type = multiple 或 range 时传入数组", + "field_desc_zh": "当前选择的日期,不传则默认今天,当 type = multiple 或 range 时传入数组", "field_desc_en": null, "field_required": 0, "event_input": "", @@ -27438,7 +27397,7 @@ "1" ], "field_default_value": "skeleton", - "field_enum": "skeleton/moving/gradient/dot", + "field_enum": "skeleton/moving/gradient", "field_desc_zh": "动画效果,支持「渐变加载动画」,「闪烁加载动画」, 「骨架屏」三种", "field_desc_en": null, "field_required": 0, @@ -27483,7 +27442,7 @@ "create_time": "2025-11-06 07:26:46", "update_time": "2025-11-06 07:26:46", "event_output": null, - "custom_field_type": "Array【 interface TdChatItemMeta { avatar?: string; name?:string; role?:string; datetime?: string; content?: string; status?: string }】", + "custom_field_type": "Array【 interface TdChatItemMeta { avatar?: string; name?:string; role?:string; datetime?: string; content?: string; reasoning?: string }】", "syntactic_sugar": null, "readonly": 1, "html_attribute": 0, @@ -27513,7 +27472,7 @@ ], "field_default_value": "both", "field_enum": "both/single", - "field_desc_zh": "对话布局形式,支持两侧对齐与左对齐。使用插槽自定义对话内容时不生效,得用`t-chat-message`的`placement`属性", + "field_desc_zh": "对话布局形式,支持两侧对齐与左对齐。使用插槽自定义对话内容时不生效,得用`t-chat-message`的`placement`属性。", "field_desc_en": null, "field_required": 0, "event_input": "", @@ -27831,6 +27790,43 @@ ], "field_type_text": [] }, + { + "id": 1762417502, + "platform_framework": [ + "64" + ], + "component": "ChatMessage", + "field_category": 1, + "field_name": "allowContentSegmentCustom", + "field_type": [ + "4" + ], + "field_default_value": "false", + "field_enum": "", + "field_desc_zh": "【实验】 是否允许自定义局部消息内容,其他消息内容实用默认样式", + "field_desc_en": null, + "field_required": 0, + "event_input": "", + "create_time": "2025-11-06 08:25:02", + "update_time": "2025-11-06 08:25:02", + "event_output": null, + "custom_field_type": null, + "syntactic_sugar": null, + "readonly": 1, + "html_attribute": 0, + "trigger_elements": "", + "deprecated": 0, + "version": "", + "test_description": null, + "support_default_value": 0, + "field_category_text": "Props", + "platform_framework_text": [ + "Miniprogram" + ], + "field_type_text": [ + "Boolean" + ] + }, { "id": 1762417465, "platform_framework": [ @@ -28027,7 +28023,8 @@ "field_category": 1, "field_name": "datetime", "field_type": [ - "1" + "1", + "64" ], "field_default_value": "", "field_enum": "", @@ -28052,7 +28049,8 @@ "Miniprogram" ], "field_type_text": [ - "String" + "String", + "TNode" ] }, { @@ -28275,43 +28273,6 @@ ], "field_type_text": [] }, - { - "id": 1764755920, - "platform_framework": [ - "64" - ], - "component": "ChatMessage", - "field_category": 512, - "field_name": "content", - "field_type": [ - "16" - ], - "field_default_value": "", - "field_enum": "", - "field_desc_zh": "自定义消息内容", - "field_desc_en": "", - "field_required": 0, - "event_input": "", - "create_time": "2025-12-03 09:58:40", - "update_time": "2025-12-03 09:58:40", - "event_output": null, - "custom_field_type": "", - "syntactic_sugar": null, - "readonly": 1, - "html_attribute": 0, - "trigger_elements": "", - "deprecated": 0, - "version": "", - "test_description": null, - "support_default_value": 0, - "field_category_text": "Slots", - "platform_framework_text": [ - "Miniprogram" - ], - "field_type_text": [ - "Array" - ] - }, { "id": 1742886437, "platform_framework": [ @@ -29120,7 +29081,7 @@ "deprecated": 0, "version": "", "test_description": null, - "support_default_value": 0, + "support_default_value": 1, "field_category_text": "Props", "platform_framework_text": [ "Miniprogram" @@ -29594,7 +29555,7 @@ "1" ], "field_default_value": "moving", - "field_enum": "skeleton/moving/gradient/dot", + "field_enum": "circle/moving/gradient", "field_desc_zh": "内容区域最大高度,超出会自动滚动", "field_desc_en": null, "field_required": 0, @@ -45878,8 +45839,8 @@ ], "field_default_value": "false", "field_enum": "", - "field_desc_zh": "是否可以拖拽(对全屏对话框无效)", - "field_desc_en": "not effective in `full-screen` mode", + "field_desc_zh": "对话框是否可以拖拽(仅在非模态对话框时有效)", + "field_desc_en": null, "field_required": 0, "event_input": "", "create_time": "2020-10-27 10:35:03", @@ -52168,47 +52129,6 @@ "TNode" ] }, - { - "id": 1763542717, - "platform_framework": [ - "8", - "16" - ], - "component": "DropdownItem", - "field_category": 1, - "field_name": "icon", - "field_type": [ - "16", - "64" - ], - "field_default_value": "undefined", - "field_enum": "", - "field_desc_zh": "自定义菜单子项图标,值为 `undefined` 表示使用默认图标。[面板打开时的图标,面板关闭时的图标]", - "field_desc_en": null, - "field_required": 0, - "event_input": "", - "create_time": "2025-11-19 08:58:37", - "update_time": "2025-11-19 08:58:37", - "event_output": null, - "custom_field_type": "TNode | TNode[] | undefined", - "syntactic_sugar": null, - "readonly": 1, - "html_attribute": 0, - "trigger_elements": "", - "deprecated": 0, - "version": "", - "test_description": null, - "support_default_value": 0, - "field_category_text": "Props", - "platform_framework_text": [ - "Vue(Mobile)", - "React(Mobile)" - ], - "field_type_text": [ - "Array", - "TNode" - ] - }, { "id": 2815, "platform_framework": [ @@ -53210,45 +53130,6 @@ "Object" ] }, - { - "id": 1764862297, - "platform_framework": [ - "2" - ], - "component": "DropdownMenu", - "field_category": 1, - "field_name": "children", - "field_type": [ - "1", - "64" - ], - "field_default_value": "", - "field_enum": "", - "field_desc_zh": "内容,同 content", - "field_desc_en": null, - "field_required": 0, - "event_input": "", - "create_time": "2025-12-04 15:31:38", - "update_time": "2025-12-04 15:31:38", - "event_output": null, - "custom_field_type": null, - "syntactic_sugar": null, - "readonly": 1, - "html_attribute": 0, - "trigger_elements": "", - "deprecated": 0, - "version": "", - "test_description": null, - "support_default_value": 0, - "field_category_text": "Props", - "platform_framework_text": [ - "React(PC)" - ], - "field_type_text": [ - "String", - "TNode" - ] - }, { "id": 1698, "platform_framework": [ @@ -53290,86 +53171,6 @@ "Boolean" ] }, - { - "id": 1764862309, - "platform_framework": [ - "1", - "2" - ], - "component": "DropdownMenu", - "field_category": 1, - "field_name": "content", - "field_type": [ - "1", - "64" - ], - "field_default_value": "", - "field_enum": "", - "field_desc_zh": "内容", - "field_desc_en": null, - "field_required": 0, - "event_input": "", - "create_time": "2025-12-04 15:31:49", - "update_time": "2025-12-04 15:31:49", - "event_output": null, - "custom_field_type": null, - "syntactic_sugar": null, - "readonly": 1, - "html_attribute": 0, - "trigger_elements": "", - "deprecated": 0, - "version": "", - "test_description": null, - "support_default_value": 0, - "field_category_text": "Props", - "platform_framework_text": [ - "Vue(PC)", - "React(PC)" - ], - "field_type_text": [ - "String", - "TNode" - ] - }, - { - "id": 1764862362, - "platform_framework": [ - "1" - ], - "component": "DropdownMenu", - "field_category": 1, - "field_name": "default", - "field_type": [ - "1", - "64" - ], - "field_default_value": "", - "field_enum": "", - "field_desc_zh": "内容,同 content", - "field_desc_en": null, - "field_required": 0, - "event_input": "", - "create_time": "2025-12-04 15:32:42", - "update_time": "2025-12-04 15:32:42", - "event_output": null, - "custom_field_type": null, - "syntactic_sugar": null, - "readonly": 1, - "html_attribute": 0, - "trigger_elements": "", - "deprecated": 0, - "version": "", - "test_description": null, - "support_default_value": 0, - "field_category_text": "Props", - "platform_framework_text": [ - "Vue(PC)" - ], - "field_type_text": [ - "String", - "TNode" - ] - }, { "id": 1712718160, "platform_framework": [ @@ -69019,43 +68820,6 @@ "Boolean" ] }, - { - "id": 1764210910, - "platform_framework": [ - "64" - ], - "component": "ImageViewer", - "field_category": 1, - "field_name": "imageProps", - "field_type": [ - "8" - ], - "field_default_value": "", - "field_enum": "", - "field_desc_zh": "透传至 Image 组件", - "field_desc_en": null, - "field_required": 0, - "event_input": "", - "create_time": "2025-11-27 02:35:10", - "update_time": "2025-11-27 02:35:10", - "event_output": null, - "custom_field_type": "ImageProps【import { ImageProps } from '@Image'】", - "syntactic_sugar": null, - "readonly": 1, - "html_attribute": 0, - "trigger_elements": "", - "deprecated": 0, - "version": "{ \"Miniprogram\": \"1.12.0\" }", - "test_description": null, - "support_default_value": 0, - "field_category_text": "Props", - "platform_framework_text": [ - "Miniprogram" - ], - "field_type_text": [ - "Object" - ] - }, { "id": 1711596997, "platform_framework": [ @@ -73737,7 +73501,7 @@ "field_desc_zh": "输入框值发生变化时触发。`trigger=initial` 表示传入的数据不符合预期,组件自动处理后触发 change 告知父组件。如:初始值长度超过 `maxlength` 限制", "field_desc_en": "trigger on input value changed", "field_required": 0, - "event_input": "(value: InputValue, context?: { e?: InputEvent | MouseEvent | CompositionEvent; trigger: 'input' | 'initial' | 'clear' | 'blur'})", + "event_input": "(value: InputValue, context?: { e?: InputEvent | MouseEvent | CompositionEvent; trigger: 'input' | 'initial' | 'clear' })", "create_time": "2024-04-09 08:02:07", "update_time": "2024-04-09 08:02:07", "event_output": null, @@ -82852,47 +82616,6 @@ "String" ] }, - { - "id": 1765337621, - "platform_framework": [ - "8", - "16", - "64" - ], - "component": "Navbar", - "field_category": 1, - "field_name": "placeholder", - "field_type": [ - "4" - ], - "field_default_value": "false", - "field_enum": "", - "field_desc_zh": "固定在顶部时是否开启占位", - "field_desc_en": null, - "field_required": 0, - "event_input": "", - "create_time": "2025-12-10 03:33:41", - "update_time": "2025-12-10 03:33:41", - "event_output": null, - "custom_field_type": null, - "syntactic_sugar": null, - "readonly": 1, - "html_attribute": 0, - "trigger_elements": "", - "deprecated": 0, - "version": "{\n\"Miniprogram\": \"1.12.1\",\n\"Vue(Mobile)\": \"1.11.2\",\n\"React(Mobile)\": \"0.21.1\"\n}", - "test_description": null, - "support_default_value": 0, - "field_category_text": "Props", - "platform_framework_text": [ - "Vue(Mobile)", - "React(Mobile)", - "Miniprogram" - ], - "field_type_text": [ - "Boolean" - ] - }, { "id": 1629, "platform_framework": [ @@ -83135,47 +82858,6 @@ "Boolean" ] }, - { - "id": 1765356641, - "platform_framework": [ - "8", - "16", - "64" - ], - "component": "Navbar", - "field_category": 1, - "field_name": "zIndex", - "field_type": [ - "2" - ], - "field_default_value": "1", - "field_enum": "", - "field_desc_zh": "导航条层级", - "field_desc_en": null, - "field_required": 0, - "event_input": "", - "create_time": "2025-12-10 08:50:41", - "update_time": "2025-12-10 08:50:41", - "event_output": null, - "custom_field_type": null, - "syntactic_sugar": null, - "readonly": 1, - "html_attribute": 0, - "trigger_elements": "", - "deprecated": 0, - "version": "", - "test_description": null, - "support_default_value": 0, - "field_category_text": "Props", - "platform_framework_text": [ - "Vue(Mobile)", - "React(Mobile)", - "Miniprogram" - ], - "field_type_text": [ - "Number" - ] - }, { "id": 1648, "platform_framework": [ @@ -88081,9 +87763,9 @@ "field_type": [ "2" ], - "field_default_value": "40", + "field_default_value": "80", "field_enum": "", - "field_desc_zh": "PickerItem 的子项高度,单位 `px`", + "field_desc_zh": "PickerItem 的子项高度,单位 rpx", "field_desc_en": null, "field_required": 0, "event_input": "", @@ -88534,43 +88216,6 @@ "Boolean" ] }, - { - "id": 1762917807, - "platform_framework": [ - "64" - ], - "component": "Picker", - "field_category": 1, - "field_name": "visibleItemCount", - "field_type": [ - "2" - ], - "field_default_value": "5", - "field_enum": "", - "field_desc_zh": "可视区域 PickerItem 的子项个数", - "field_desc_en": null, - "field_required": 0, - "event_input": "", - "create_time": "2025-11-12 03:23:27", - "update_time": "2025-11-12 03:23:27", - "event_output": null, - "custom_field_type": null, - "syntactic_sugar": null, - "readonly": 1, - "html_attribute": 0, - "trigger_elements": "", - "deprecated": 0, - "version": "", - "test_description": null, - "support_default_value": 0, - "field_category_text": "Props", - "platform_framework_text": [ - "Miniprogram" - ], - "field_type_text": [ - "Number" - ] - }, { "id": 1475, "platform_framework": [ @@ -89832,8 +89477,7 @@ "id": 3526, "platform_framework": [ "8", - "16", - "64" + "16" ], "component": "Popover", "field_category": 1, @@ -89862,8 +89506,7 @@ "field_category_text": "Props", "platform_framework_text": [ "Vue(Mobile)", - "React(Mobile)", - "Miniprogram" + "React(Mobile)" ], "field_type_text": [ "Boolean" @@ -89873,8 +89516,7 @@ "id": 942, "platform_framework": [ "8", - "16", - "64" + "16" ], "component": "Popover", "field_category": 1, @@ -89904,8 +89546,7 @@ "field_category_text": "Props", "platform_framework_text": [ "Vue(Mobile)", - "React(Mobile)", - "Miniprogram" + "React(Mobile)" ], "field_type_text": [ "String", @@ -89955,8 +89596,7 @@ "id": 3514, "platform_framework": [ "8", - "16", - "64" + "16" ], "component": "Popover", "field_category": 1, @@ -89985,8 +89625,7 @@ "field_category_text": "Props", "platform_framework_text": [ "Vue(Mobile)", - "React(Mobile)", - "Miniprogram" + "React(Mobile)" ], "field_type_text": [ "String" @@ -89996,8 +89635,7 @@ "id": 3513, "platform_framework": [ "8", - "16", - "64" + "16" ], "component": "Popover", "field_category": 1, @@ -90026,8 +89664,7 @@ "field_category_text": "Props", "platform_framework_text": [ "Vue(Mobile)", - "React(Mobile)", - "Miniprogram" + "React(Mobile)" ], "field_type_text": [ "Boolean" @@ -90037,8 +89674,7 @@ "id": 3516, "platform_framework": [ "8", - "16", - "64" + "16" ], "component": "Popover", "field_category": 1, @@ -90067,8 +89703,7 @@ "field_category_text": "Props", "platform_framework_text": [ "Vue(Mobile)", - "React(Mobile)", - "Miniprogram" + "React(Mobile)" ], "field_type_text": [ "String" @@ -90119,8 +89754,7 @@ "id": 1160, "platform_framework": [ "8", - "16", - "64" + "16" ], "component": "Popover", "field_category": 1, @@ -90149,8 +89783,7 @@ "field_category_text": "Props", "platform_framework_text": [ "Vue(Mobile)", - "React(Mobile)", - "Miniprogram" + "React(Mobile)" ], "field_type_text": [ "Boolean" @@ -90160,8 +89793,7 @@ "id": 3519, "platform_framework": [ "8", - "16", - "64" + "16" ], "component": "Popover", "field_category": 2, @@ -90188,107 +89820,7 @@ "field_category_text": "Events", "platform_framework_text": [ "Vue(Mobile)", - "React(Mobile)", - "Miniprogram" - ], - "field_type_text": [] - }, - { - "id": 1762617354, - "platform_framework": [ - "64" - ], - "component": "Popover", - "field_category": 128, - "field_name": "t-class", - "field_type": [], - "field_default_value": "", - "field_enum": "", - "field_desc_zh": "根节点样式类", - "field_desc_en": null, - "field_required": 0, - "event_input": "", - "create_time": "2025-11-08 15:55:54", - "update_time": "2025-11-08 15:55:54", - "event_output": null, - "custom_field_type": null, - "syntactic_sugar": null, - "readonly": 1, - "html_attribute": 0, - "trigger_elements": "", - "deprecated": 0, - "version": "", - "test_description": null, - "support_default_value": 0, - "field_category_text": "External Classes", - "platform_framework_text": [ - "Miniprogram" - ], - "field_type_text": [] - }, - { - "id": 1762617306, - "platform_framework": [ - "64" - ], - "component": "Popover", - "field_category": 128, - "field_name": "t-class-content", - "field_type": [], - "field_default_value": "", - "field_enum": "", - "field_desc_zh": "内容样式类", - "field_desc_en": null, - "field_required": 0, - "event_input": "", - "create_time": "2025-11-08 15:55:06", - "update_time": "2025-11-08 15:55:06", - "event_output": null, - "custom_field_type": null, - "syntactic_sugar": null, - "readonly": 1, - "html_attribute": 0, - "trigger_elements": "", - "deprecated": 0, - "version": "", - "test_description": null, - "support_default_value": 0, - "field_category_text": "External Classes", - "platform_framework_text": [ - "Miniprogram" - ], - "field_type_text": [] - }, - { - "id": 1762944284, - "platform_framework": [ - "64" - ], - "component": "Popover", - "field_category": 512, - "field_name": "-", - "field_type": [], - "field_default_value": "", - "field_enum": "", - "field_desc_zh": "默认插槽,作用同 `content` 插槽", - "field_desc_en": null, - "field_required": 0, - "event_input": "", - "create_time": "2025-11-12 10:44:44", - "update_time": "2025-11-12 10:44:44", - "event_output": null, - "custom_field_type": null, - "syntactic_sugar": null, - "readonly": 1, - "html_attribute": 0, - "trigger_elements": "", - "deprecated": 0, - "version": "", - "test_description": null, - "support_default_value": 0, - "field_category_text": "Slots", - "platform_framework_text": [ - "Miniprogram" + "React(Mobile)" ], "field_type_text": [] }, @@ -91965,10 +91497,10 @@ ], "field_default_value": "false", "field_enum": "", - "field_desc_zh": "当浮层隐藏或显示时触发,trigger=document 表示点击弹出层元素触发", + "field_desc_zh": "当浮层隐藏或显示时触发", "field_desc_en": null, "field_required": 0, - "event_input": "(visible: boolean, trigger: PopupSource) 【type PopupSource = 'close-btn' | 'overlay' | 'document'】", + "event_input": "(visible: boolean, trigger: PopupSource) 【type PopupSource = 'close-btn' | 'overlay'】", "create_time": "2021-07-16 04:21:31", "update_time": "2022-04-06 14:23:54", "event_output": null, @@ -117726,6 +117258,45 @@ "Boolean" ] }, + { + "id": 2049, + "platform_framework": [ + "1", + "2" + ], + "component": "Swiper", + "field_category": 1, + "field_name": "theme", + "field_type": [ + "1" + ], + "field_default_value": "light", + "field_enum": "light/dark", + "field_desc_zh": "深色模式和浅色模式", + "field_desc_en": null, + "field_required": 0, + "event_input": "", + "create_time": "2021-12-15 13:04:30", + "update_time": "2021-12-15 13:04:30", + "event_output": null, + "custom_field_type": null, + "syntactic_sugar": null, + "readonly": 1, + "html_attribute": 0, + "trigger_elements": "", + "deprecated": 0, + "version": "", + "test_description": null, + "support_default_value": 0, + "field_category_text": "Props", + "platform_framework_text": [ + "Vue(PC)", + "React(PC)" + ], + "field_type_text": [ + "String" + ] + }, { "id": 2046, "platform_framework": [ @@ -120169,47 +119740,6 @@ "Boolean" ] }, - { - "id": 1765337747, - "platform_framework": [ - "8", - "16", - "64" - ], - "component": "TabBar", - "field_category": 1, - "field_name": "placeholder", - "field_type": [ - "4" - ], - "field_default_value": "false", - "field_enum": "", - "field_desc_zh": "固定在底部时是否开启占位", - "field_desc_en": null, - "field_required": 0, - "event_input": "", - "create_time": "2025-12-10 03:35:47", - "update_time": "2025-12-10 03:35:47", - "event_output": null, - "custom_field_type": null, - "syntactic_sugar": null, - "readonly": 1, - "html_attribute": 0, - "trigger_elements": "", - "deprecated": 0, - "version": "{\n\"Miniprogram\": \"1.12.1\",\n\"Vue(Mobile)\": \"1.11.2\",\n\"React(Mobile)\": \"0.21.1\"\n}", - "test_description": null, - "support_default_value": 0, - "field_category_text": "Props", - "platform_framework_text": [ - "Vue(Mobile)", - "React(Mobile)", - "Miniprogram" - ], - "field_type_text": [ - "Boolean" - ] - }, { "id": 1380, "platform_framework": [ @@ -120419,47 +119949,6 @@ "Array" ] }, - { - "id": 1765356622, - "platform_framework": [ - "8", - "16", - "64" - ], - "component": "TabBar", - "field_category": 1, - "field_name": "zIndex", - "field_type": [ - "2" - ], - "field_default_value": "1", - "field_enum": "", - "field_desc_zh": "标签栏层级", - "field_desc_en": null, - "field_required": 0, - "event_input": "", - "create_time": "2025-12-10 08:50:22", - "update_time": "2025-12-10 08:50:22", - "event_output": null, - "custom_field_type": null, - "syntactic_sugar": null, - "readonly": 1, - "html_attribute": 0, - "trigger_elements": "", - "deprecated": 0, - "version": "", - "test_description": null, - "support_default_value": 0, - "field_category_text": "Props", - "platform_framework_text": [ - "Vue(Mobile)", - "React(Mobile)", - "Miniprogram" - ], - "field_type_text": [ - "Number" - ] - }, { "id": 1761301442, "platform_framework": [ @@ -129018,47 +128507,6 @@ "String" ] }, - { - "id": 1765200398, - "platform_framework": [ - "1", - "2" - ], - "component": "Textarea", - "field_category": 1, - "field_name": "count", - "field_type": [ - "4", - "32" - ], - "field_default_value": "", - "field_enum": "", - "field_desc_zh": "文字计数元素。设置 `maxlength` 或 `maxchanacter` 时,默认为 true", - "field_desc_en": "Character counter. It is enabled by default when `maxLength` or `maxCharacter` is set.", - "field_required": 0, - "event_input": "", - "create_time": "2025-12-08 13:26:38", - "update_time": "2025-12-08 13:26:38", - "event_output": null, - "custom_field_type": "boolean | ((ctx: { value: string; count: number; maxLength?: number; maxCharacter?: number }) => TNode)", - "syntactic_sugar": null, - "readonly": 1, - "html_attribute": 0, - "trigger_elements": "", - "deprecated": 0, - "version": "", - "test_description": null, - "support_default_value": 0, - "field_category_text": "Props", - "platform_framework_text": [ - "Vue(PC)", - "React(PC)" - ], - "field_type_text": [ - "Boolean", - "Function" - ] - }, { "id": 3392, "platform_framework": [ @@ -143496,7 +142944,7 @@ "html_attribute": 0, "trigger_elements": "", "deprecated": 0, - "version": "{\n\"Vue(Mobile)\": \"1.11.1\",\n\"React(Mobile)\": \"0.20.2\"\n}", + "version": "", "test_description": null, "support_default_value": 0, "field_category_text": "Props", @@ -143594,6 +143042,8 @@ "platform_framework": [ "1", "2", + "8", + "16", "64" ], "component": "Upload", @@ -143624,46 +143074,9 @@ "platform_framework_text": [ "Vue(PC)", "React(PC)", - "Miniprogram" - ], - "field_type_text": [ - "Boolean" - ] - }, - { - "id": 1763624707, - "platform_framework": [ - "8", - "16" - ], - "component": "Upload", - "field_category": 1, - "field_name": "allowUploadDuplicateFile", - "field_type": [ - "4" - ], - "field_default_value": "false", - "field_enum": "", - "field_desc_zh": "是否允许重复上传相同文件名的文件。在 `capture = ''` + 拍照上传场景中,`allowUploadDuplicateFile` 应取 `true`,避免拍照上传的文件被同名文件校验过滤", - "field_desc_en": "allow to upload duplicate name files", - "field_required": 0, - "event_input": "", - "create_time": "2025-11-20 07:45:07", - "update_time": "2025-11-20 07:45:07", - "event_output": null, - "custom_field_type": null, - "syntactic_sugar": null, - "readonly": 1, - "html_attribute": 0, - "trigger_elements": "", - "deprecated": 0, - "version": "", - "test_description": null, - "support_default_value": 0, - "field_category_text": "Props", - "platform_framework_text": [ "Vue(Mobile)", - "React(Mobile)" + "React(Mobile)", + "Miniprogram" ], "field_type_text": [ "Boolean" @@ -145258,7 +144671,7 @@ "html_attribute": 0, "trigger_elements": "", "deprecated": 0, - "version": "{\n\"Vue(Mobile)\": \"1.10.0\"\n}", + "version": "", "test_description": null, "support_default_value": 0, "field_category_text": "Props", From c0ffa3f5964254fbc60cc5dc56c072b80df52121 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E9=98=BF=E8=8F=9C=20Cai?= Date: Mon, 12 Jan 2026 03:27:53 +0800 Subject: [PATCH 9/9] feat(SwiperNavigation): update field_default_value and descriptions in api.json --- db/TDesign.db | Bin 1085440 -> 1085440 bytes .../src/swiper/swiper.en-US.md | 2 +- .../tdesign-mobile-react/src/swiper/swiper.md | 2 +- .../tdesign-mobile-react/src/swiper/type.ts | 2 +- packages/scripts/api.json | 10 ++++------ 5 files changed, 7 insertions(+), 9 deletions(-) diff --git a/db/TDesign.db b/db/TDesign.db index ed18bb4455f4759ebfdccdd0066fba3650153fac..c24901bd7715e46711fcc64f2085cc2bbf83f498 100644 GIT binary patch delta 252 zcmZoz;MB0dX@WGP-$WT_M!&{{)&$1Z1g6#m=B)`V%g*bxGjM(6yvrHOv7P-jLpy&3 z<6gekd~v)lc)fWp@?>*&F@>>nuqm+GvqUnBPF8#nYSd)Z!!FIlsLLtJDazZZSjoX_ zY|PMT$-v3M%fZXQ!TwVsxID8Uwa72AEHgc^Br`v6`n?yNL1s{Xevv{+WkG7OLS|la zPH9T2LP~x~u@0EjO-d}%QAjIFOa|%FQAjOG)||n6Ru%pV zhJ$>s`QmtA@OtxH