fix(Swiper): 移除 defaultCurrent 属性并调整导航器文档结构

Author: RSS1102

packages/products/tdesign-miniprogram/packages/components/swiper/README.en-US.md

@@ -25,12 +25,6 @@ pagination-position | String | bottom | options: top-left/top/top-right/bottom-l
 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
@@ -44,13 +38,7 @@ image-load | `(index: number)` | `1.1.4`
 
 name | Description
 -- | --
-navigation | \-
-
-### Swiper Slots
-
-name | Description
--- | --
-navigation | \-
+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 External Classes
 

packages/products/tdesign-miniprogram/packages/components/swiper/README.md

@@ -25,12 +25,6 @@ pagination-position | String | bottom | 页码信息展示位置。可选项：t
 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
 
 名称 | 参数 | 描述
@@ -44,13 +38,7 @@ image-load | `(index: number)` | `1.1.4`。图片加载时触发
 
 名称 | 描述
 -- | --
-navigation | 导航器全部配置
-
-### Swiper Slots
-
-名称 | 描述
--- | --
-navigation | 导航器全部配置
+navigation | 自定义 `navigation` 显示内容。TS 类型：`SwiperNavProps \| boolean`，[SwiperNav API Documents](./swiper-nav?tab=api)。[详细类型定义](https://github.com/Tencent/tdesign-miniprogram/blob/develop/packages/components/swiper/type.ts)
 
 ### Swiper External Classes
 

packages/products/tdesign-mobile-react/src/swiper/defaultProps.ts

@@ -7,7 +7,7 @@ import { TdSwiperProps } from './type';
 export const swiperDefaultProps: TdSwiperProps = {
   animation: 'slide',
   autoplay: true,
-  defaultCurrent: 0,
+  current: 0,
   direction: 'horizontal',
   duration: 300,
   interval: 5000,

packages/products/tdesign-mobile-react/src/swiper/swiper.en-US.md

@@ -11,7 +11,6 @@ style | Object | - | CSS(Cascading Style Sheets)，Typescript：`React.CSSProper
 animation | String | slide | options: slide | N
 autoplay | Boolean | true | \- | N
 current | Number | 0 | \- | N
-defaultCurrent | Number | 0 | uncontrolled property | N
 direction | String | horizontal | options: horizontal/vertical | N
 duration | Number | 300 | \- | N
 height | String / Number | - | \- | N

packages/products/tdesign-mobile-react/src/swiper/swiper.md

@@ -11,7 +11,6 @@ style | Object | - | 样式，TS 类型：`React.CSSProperties` | N
 animation | String | slide | 轮播切换动画效果类型。可选项：slide | N
 autoplay | Boolean | true | 是否自动播放 | N
 current | Number | 0 | 当前轮播在哪一项（下标） | N
-defaultCurrent | Number | 0 | 当前轮播在哪一项（下标）。非受控属性 | N
 direction | String | horizontal | 轮播滑动方向，包括横向滑动和纵向滑动两个方向。可选项：horizontal/vertical | N
 duration | Number | 300 | 滑动动画时长 | N
 height | String / Number | - | 当使用垂直方向滚动时的高度 | N

packages/products/tdesign-mobile-vue/src/swiper/swiper.en-US.md

@@ -81,7 +81,6 @@ 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
-defaultCurrent | Number | 0 | uncontrolled property | N
 direction | String | horizontal | options: horizontal/vertical | N
 duration | Number | 300 | \- | N
 height | String / Number | - | \- | N
@@ -108,12 +107,3 @@ 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
-
-### 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

packages/products/tdesign-mobile-vue/src/swiper/swiper.md

@@ -81,7 +81,6 @@ type | String | - | 导航器类型，点状(dots)、点条状(dots-bar)、分
 animation | String | slide | 轮播切换动画效果类型。可选项：slide | N
 autoplay | Boolean | true | 是否自动播放 | N
 current | Number | 0 | 当前轮播在哪一项（下标）。支持语法糖 `v-model` 或 `v-model:current` | N
-defaultCurrent | Number | 0 | 当前轮播在哪一项（下标）。非受控属性 | N
 direction | String | horizontal | 轮播滑动方向，包括横向滑动和纵向滑动两个方向。可选项：horizontal/vertical | N
 duration | Number | 300 | 滑动动画时长 | N
 height | String / Number | - | 轮播的高度 | N
@@ -108,12 +107,3 @@ 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
-
-### 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

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;
+  /**
+   * 导航器全部配置，`true` 的话使用默认配置
+   * @default true
+   */
+  navigation?: SwiperNavigation | TNode | 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';

packages/products/tdesign-react/packages/components/swiper/swiper.en-US.md

@@ -44,7 +44,6 @@ animation | String | slide | options: slide/fade | N
 autoplay | Boolean | true | \- | N
 cardScale | Number | 210/332 | \- | N
 current | Number | 0 | \- | N
-defaultCurrent | Number | 0 | uncontrolled property | N
 direction | String | horizontal | options: horizontal/vertical | N
 duration | Number | 300 | \- | N
 height | Number | - | \- | N

packages/products/tdesign-react/packages/components/swiper/swiper.md

@@ -44,7 +44,6 @@ animation | String | slide | 轮播切换动画效果类型：滑动、淡入淡
 autoplay | Boolean | true | 是否自动播放 | N
 cardScale | Number | 210/332 | 卡片模式下非当前展示轮播图的缩放比例 | N
 current | Number | 0 | 当前轮播在哪一项（下标） | N
-defaultCurrent | Number | 0 | 当前轮播在哪一项（下标）。非受控属性 | N
 direction | String | horizontal | 轮播滑动方向，包括横向滑动和纵向滑动两个方向。可选项：horizontal/vertical | N
 duration | Number | 300 | 滑动动画时长 | N
 height | Number | - | 当使用垂直方向滚动时的高度 | N