diff --git a/db/TDesign.db b/db/TDesign.db index 336ea3bf4..c058da2e7 100644 Binary files a/db/TDesign.db and b/db/TDesign.db differ diff --git a/packages/products/tdesign-mobile-vue/src/image-viewer/image-viewer.en-US.md b/packages/products/tdesign-mobile-vue/src/image-viewer/image-viewer.en-US.md index 349e250a7..390b15eff 100644 --- a/packages/products/tdesign-mobile-vue/src/image-viewer/image-viewer.en-US.md +++ b/packages/products/tdesign-mobile-vue/src/image-viewer/image-viewer.en-US.md @@ -28,3 +28,9 @@ name | params | description close | `(context: { trigger: ImageViewerCloseTrigger, visible: boolean, index: number })` | [see more ts definition](https://github.com/Tencent/tdesign-mobile-vue/tree/develop/src/image-viewer/type.ts)。
`type ImageViewerCloseTrigger = 'image' \| 'overlay' \| 'close-btn'`
delete | `(index: number)` | \- index-change | `(index: number, context: { trigger: 'prev' \| 'next' })` | \- + +### ImageViewerInstanceFunctions 组件实例方法 + +name | params | return | description +-- | -- | -- | -- +swipeTo | `(index: number, options?: SwiperToOptions)` | \- | `1.13.2`。[see more ts definition](https://github.com/Tencent/tdesign-mobile-vue/tree/develop/src/image-viewer/type.ts)。
`import { SwiperToOptions } from '@Swiper'`
diff --git a/packages/products/tdesign-mobile-vue/src/image-viewer/image-viewer.md b/packages/products/tdesign-mobile-vue/src/image-viewer/image-viewer.md index cce345b97..17e96d998 100644 --- a/packages/products/tdesign-mobile-vue/src/image-viewer/image-viewer.md +++ b/packages/products/tdesign-mobile-vue/src/image-viewer/image-viewer.md @@ -28,3 +28,9 @@ onIndexChange | Function | | TS 类型:`(index: number, context: { trigger: ' close | `(context: { trigger: ImageViewerCloseTrigger, visible: boolean, index: number })` | 关闭时触发。[详细类型定义](https://github.com/Tencent/tdesign-mobile-vue/tree/develop/src/image-viewer/type.ts)。
`type ImageViewerCloseTrigger = 'image' \| 'overlay' \| 'close-btn'`
delete | `(index: number)` | 点击删除操作按钮时触发 index-change | `(index: number, context: { trigger: 'prev' \| 'next' })` | 预览图片切换时触发,`context.prev` 切换到上一张图片,`context.next` 切换到下一张图片 + +### ImageViewerInstanceFunctions 组件实例方法 + +名称 | 参数 | 返回值 | 描述 +-- | -- | -- | -- +swipeTo | `(index: number, options?: SwiperToOptions)` | \- | `1.13.2`。切换到指定预览图片位置。[详细类型定义](https://github.com/Tencent/tdesign-mobile-vue/tree/develop/src/image-viewer/type.ts)。
`import { SwiperToOptions } from '@Swiper'`
diff --git a/packages/products/tdesign-mobile-vue/src/image-viewer/type.ts b/packages/products/tdesign-mobile-vue/src/image-viewer/type.ts index 5c1ca7b1d..ffd7af76a 100644 --- a/packages/products/tdesign-mobile-vue/src/image-viewer/type.ts +++ b/packages/products/tdesign-mobile-vue/src/image-viewer/type.ts @@ -4,6 +4,7 @@ * 该文件为脚本自动生成文件,请勿随意修改。如需修改请联系 PMC * */ +import { SwiperToOptions } from '../swiper'; import type { TNode } from '../common'; export interface TdImageViewerProps { @@ -77,6 +78,14 @@ export interface TdImageViewerProps { onIndexChange?: (index: number, context: { trigger: 'prev' | 'next' }) => void; } +/** 组件实例方法 */ +export interface ImageViewerInstanceFunctions { + /** + * 切换到指定预览图片位置 + */ + swipeTo?: (index: number, options?: SwiperToOptions) => void; +} + export interface ImageSlotParams { src: string; className?: string; 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 915999211..0cb97b697 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,5 +34,6 @@ 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 +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-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 8ecae1acb..d322a552c 100644 --- a/packages/products/tdesign-mobile-vue/src/swiper/swiper.md +++ b/packages/products/tdesign-mobile-vue/src/swiper/swiper.md @@ -34,5 +34,6 @@ click | `(index: number)` | 点击轮播项时触发 -- | -- | -- | -- | -- minShowNum | Number | - | 小于这个数字不会显示导航器 | N paginationPosition | String | bottom | 页码信息展示位置。可选项:top-left/top/top-right/bottom-left/bottom/bottom-right/left/right | N +placement | String | inside | 导航器位置,位于主体的内侧或是外侧。可选项:inside/outside | 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 index f63303c89..0879dd75a 100644 --- a/packages/products/tdesign-mobile-vue/src/swiper/type.ts +++ b/packages/products/tdesign-mobile-vue/src/swiper/type.ts @@ -90,6 +90,11 @@ export interface SwiperNavigation { * @default bottom */ paginationPosition?: 'top-left' | 'top' | 'top-right' | 'bottom-left' | 'bottom' | 'bottom-right' | 'left' | 'right'; + /** + * 导航器位置,位于主体的内侧或是外侧 + * @default inside + */ + placement?: 'inside' | 'outside'; /** * 是否显示两侧的控制按钮 * @default false diff --git a/packages/scripts/api.json b/packages/scripts/api.json index 50f95d126..a5a73d41d 100644 --- a/packages/scripts/api.json +++ b/packages/scripts/api.json @@ -74249,6 +74249,39 @@ ], "field_type_text": [] }, + { + "id": 1774433543, + "platform_framework": [ + "8" + ], + "component": "ImageViewer", + "field_category": 4, + "field_name": "swipeTo", + "field_type": [], + "field_default_value": "", + "field_enum": "", + "field_desc_zh": "切换到指定预览图片位置", + "field_desc_en": null, + "field_required": 0, + "event_input": "(index: number, options?: SwiperToOptions)【import { SwiperToOptions } from '@Swiper'】", + "create_time": "2026-03-25 10:12:23", + "update_time": "2026-03-25 10:12:23", + "event_output": null, + "custom_field_type": null, + "syntactic_sugar": null, + "readonly": 1, + "html_attribute": 0, + "trigger_elements": "", + "deprecated": 0, + "version": "{\n\"Vue(Mobile)\": \"1.13.2\"\n}", + "test_description": null, + "support_default_value": 0, + "field_category_text": "Functions", + "platform_framework_text": [ + "Vue(Mobile)" + ], + "field_type_text": [] + }, { "id": 1759199178, "platform_framework": [ @@ -125071,6 +125104,7 @@ { "id": 1734341852, "platform_framework": [ + "8", "16" ], "component": "SwiperNavigation", @@ -125099,6 +125133,7 @@ "support_default_value": 0, "field_category_text": "Props", "platform_framework_text": [ + "Vue(Mobile)", "React(Mobile)" ], "field_type_text": [