@tarojs/components 3.8.0-canary.0 → 4.0.0-alpha.2

package/types/Radio.d.ts

@@ -2,26 +2,31 @@ import { ComponentType } from 'react'
 import { StandardProps, CommonEventFunction, FormItemProps } from './common'
 interface RadioProps extends StandardProps {
   /** `<Radio/>` 标识。当该`<Radio/>` 选中时，`<RadioGroup/>`的 change 事件会携带`<Radio/>`的 value
-   * @supported weapp, alipay, swan, tt, qq, jd, h5, rn
+   * @supported weapp, alipay, swan, tt, qq, jd, h5, rn, harmony, harmony_hybrid
    */
   value?: string
   /** 当前是否选中
    * @default false
-   * @supported weapp, alipay, swan, tt, qq, jd, h5, rn
+   * @supported weapp, alipay, swan, tt, qq, jd, h5, rn, harmony, harmony_hybrid
    */
   checked?: boolean
   /** 是否禁用
    * @default false
-   * @supported weapp, alipay, swan, tt, qq, jd, h5, rn
+   * @supported weapp, alipay, swan, tt, qq, jd, h5, rn, harmony, harmony_hybrid
    */
   disabled?: boolean
   /** Radio 的颜色，同 css 的 color
    * @default "#09BB07"
-   * @supported weapp, alipay, swan, tt, qq, jd, rn
+   * @supported weapp, alipay, swan, tt, qq, jd, rn, harmony
    */
   color?: string
+  /**
+   * Radio 的名字
+   * @supported h5, harmony, harmony_hybrid
+   */
+  name?: string
   /** 用于透传 `WebComponents` 上的属性到内部 H5 标签上
-   * @supported h5
+   * @supported h5, harmony_hybrid
    */
   nativeProps?: Record<string, unknown>
   /** 无障碍访问，（属性）元素的额外描述
@@ -29,7 +34,7 @@ interface RadioProps extends StandardProps {
    */
   ariaLabel?: string
   /** <radio-group/> 中的选中项发生变化时触发 change 事件
-   * @supported h5, rn
+   * @supported h5, rn, harmony, harmony_hybrid
    */
   onChange?: CommonEventFunction<{
     value?: string
@@ -37,7 +42,7 @@ interface RadioProps extends StandardProps {
 }
 /** 单选项目
  * @classification forms
- * @supported weapp, alipay, swan, tt, qq, h5, rn, harmony
+ * @supported weapp, alipay, swan, tt, qq, h5, rn, harmony, harmony_hybrid
  * @example_react
  * ```tsx
  * export default class PageRadio extends Component {

package/types/RadioGroup.d.ts

@@ -2,11 +2,11 @@ import { ComponentType } from 'react'
 import { StandardProps, CommonEventFunction, FormItemProps } from './common'
 interface RadioGroupProps extends StandardProps, FormItemProps {
   /** 组件名字，用于表单提交获取数据。
-   * @supported alipay, tt
+   * @supported alipay, tt, harmony
    */
   name?: string
   /** RadioGroup 中选中项发生改变时触发 change 事件，detail = {value:[选中的radio的value的数组]}
-   * @supported weapp, alipay, swan, tt, qq, jd, h5
+   * @supported weapp, alipay, swan, tt, qq, jd, h5, harmony_hybrid
    */
   onChange?: CommonEventFunction
 }
@@ -17,7 +17,7 @@ declare namespace RadioGroupProps {
 }
 /** 单项选择器，内部由多个 Radio 组成。
  * @classification forms
- * @supported weapp, alipay, swan, tt, qq, jd, h5, rn, harmony
+ * @supported weapp, alipay, swan, tt, qq, jd, h5, rn, harmony, harmony_hybrid
  * @see https://developers.weixin.qq.com/miniprogram/dev/component/radio-group.html
  */
 declare const RadioGroup: ComponentType<RadioGroupProps>

package/types/RichText.d.ts

@@ -3,20 +3,20 @@ import { CommonEventFunction, StandardProps } from './common'
 interface RichTextProps extends StandardProps {
   /** 文本是否可选，该属性会使节点显示为 block
    * @default false
-   * @supported weapp, h5
+   * @supported weapp, h5, harmony_hybrid
    */
   userSelect?: boolean
   /** 节点列表/ HTML String
-   * @supported weapp, alipay, swan, tt, qq, h5, rn, harmony
+   * @supported weapp, alipay, swan, tt, qq, h5, rn, harmony, harmony_hybrid
    */
   nodes?: Nodes
   /** 显示连续空格
-   * @supported weapp, alipay, tt, qq, h5, rn
+   * @supported weapp, alipay, tt, qq, h5, rn, harmony_hybrid
    */
   space?: keyof RichTextProps.TSpace
   /** 富文本是否可以长按选中，可用于复制，粘贴，长按搜索等场景
    * @default false（基础库 3.150.1 以前版本）true（基础库 3.150.1 及以后版本）
-   * @supported swan, h5
+   * @supported swan, h5, harmony_hybrid
    */
   selectable?: string
   /** 阻止长按图片时弹起默认菜单（将该属性设置为image-menu-prevent或image-menu-prevent="true"），只在初始化时有效，不能动态变更；若不想阻止弹起默认菜单，则不需要设置此属性
@@ -99,7 +99,7 @@ declare namespace RichTextProps {
 }
 /** 富文本
  * @classification base
- * @supported weapp, swan, alipay, tt, h5, rn, harmony
+ * @supported weapp, swan, alipay, tt, h5, rn, harmony, harmony_hybrid
  * @example_react
  * ```tsx
  * class App extends Components {

package/types/ScrollView.d.ts

@@ -3,40 +3,40 @@ import { BaseEventOrigFunction, CommonEventFunction, StandardProps } from './com
 interface ScrollViewProps extends StandardProps {
   /** 允许横向滚动
    * @default false
-   * @supported weapp, alipay, swan, tt, qq, jd, h5, rn
+   * @supported weapp, alipay, swan, tt, qq, jd, h5, rn, harmony, harmony_hybrid
    * @rn 二选一
    */
   scrollX?: boolean
   /** 允许纵向滚动
    * @default false
-   * @supported weapp, alipay, swan, tt, qq, jd, h5, rn
+   * @supported weapp, alipay, swan, tt, qq, jd, h5, rn, harmony, harmony_hybrid
    * @rn 二选一
    */
   scrollY?: boolean
   /** 距顶部/左边多远时（单位px），触发 scrolltoupper 事件
    * @default 50
-   * @supported weapp, alipay, swan, tt, qq, jd, h5, rn
+   * @supported weapp, alipay, swan, tt, qq, jd, h5, rn, harmony_hybrid
    */
   upperThreshold?: number
   /** 距底部/右边多远时（单位px），触发 scrolltolower 事件
    * @default 50
-   * @supported weapp, alipay, swan, tt, qq, jd, h5, rn
+   * @supported weapp, alipay, swan, tt, qq, jd, h5, rn, harmony_hybrid
    */
   lowerThreshold?: number
   /** 设置竖向滚动条位置
-   * @supported weapp, alipay, swan, tt, qq, jd, h5, rn
+   * @supported weapp, alipay, swan, tt, qq, jd, h5, rn, harmony_hybrid
    */
   scrollTop?: number
   /** 设置横向滚动条位置
-   * @supported weapp, alipay, swan, tt, qq, jd, h5, rn
+   * @supported weapp, alipay, swan, tt, qq, jd, h5, rn, harmony_hybrid
    */
   scrollLeft?: number
   /** 值应为某子元素id（id不能以数字开头）。设置哪个方向可滚动，则在哪个方向滚动到该元素
-   * @supported weapp, alipay, swan, tt, qq, jd, h5
+   * @supported weapp, alipay, swan, tt, qq, jd, h5, harmony_hybrid
    */
   scrollIntoView?: string
   /** 在设置滚动条位置时使用动画过渡
-   * @supported weapp, alipay, swan, tt, qq, jd, h5, rn
+   * @supported weapp, alipay, swan, tt, qq, jd, h5, rn, harmony_hybrid
    * @default false
    */
   scrollWithAnimation?: boolean
@@ -91,7 +91,7 @@ interface ScrollViewProps extends StandardProps {
    */
   bounces?: boolean
   /** 滚动条显隐控制 (同时开启 enhanced 属性后生效)
-   * @supported weapp
+   * @supported weapp, harmony
    * @default true
    */
   showScrollbar?: boolean
@@ -130,7 +130,7 @@ interface ScrollViewProps extends StandardProps {
    * @supported weapp
    * @default false
    */
-  enablePassive?: string
+  enablePassive?: boolean
   /** 渲染模式
    * list - 列表模式。只会渲染在屏节点，会根据直接子节点是否在屏来按需渲染，若只有一个直接子节点则性能会退化
    * custom - 自定义模式。只会渲染在屏节点，子节点可以是 sticky-section list-view grid-view 等组件
@@ -143,10 +143,25 @@ interface ScrollViewProps extends StandardProps {
    * @default false
    */
   reverse?: boolean
+  /** 是否对溢出进行裁剪，默认开启
+   * @supported weapp
+   * @default true
+   */
+  clip?: boolean
   /** 指定视口外渲染区域的距离，默认情况下视口外节点不渲染。指定 cache-extent 可优化滚动体验和加载速度，但会提高内存占用且影响首屏速度，可按需启用。
    * @supported weapp
    */
   cacheExtent?: number
+  /** 指定 scroll-view 触发滚动的最小拖动距离。仅在 scroll-view 和其他组件存在手势冲突时使用，可通过调整该属性使得滚动更加灵敏。
+   * @supported weapp
+   * @default 18
+   */
+  minDragDistance?: number
+  /** 长度为 4 的数组，按 top、right、bottom、left 顺序指定内边距
+   * @supported weapp
+   * @default [0,0,0,0]
+   */
+  padding?: [number, number, number, number]
   /** 只 scroll-into-view 到 cacheExtent 以内的目标节点，性能更佳
    * @supported weapp
    * @default false
@@ -157,20 +172,55 @@ interface ScrollViewProps extends StandardProps {
    * center - 目标节点显示在视口中间
    * end - 目标节点显示在视口结束处
    * nearest - 目标节点在就近的视口边缘显示，若节点已在视口内则不触发滚动
-   * @supported weapp, h5
+   * @supported weapp, h5, harmony_hybrid
    * @default 'start'
    */
   scrollIntoViewAlignment?: 'start' | 'center' | 'end' | 'nearest'
+  /** 开启下拉二级能力
+   * @supported weapp
+   * @default false
+   */
+  refresherTwoLevelEnabled?: boolean
+  /** 设置打开/关闭二级
+   * @supported weapp
+   * @default false
+   */
+  refresherTwoLevelTriggered?: boolean
+  /** 下拉二级阈值
+   * @supported weapp
+   * @default 150
+   */
+  refresherTwoLevelThreshold?: number
+  /** 滑动返回时关闭二级的阈值
+   * @supported weapp
+   * @default 80
+   */
+  refresherTwoLevelCloseThreshold?: number
+  /** 处于二级状态时是否可滑动
+   * @supported weapp
+   * @default false
+   */
+  refresherTwoLevelScrollEnabled?: boolean
+  /** 惯性滚动是否触发下拉刷新
+   * @supported weapp
+   * @default false
+   */
+  refresherBallisticRefreshEnabled?: boolean
+  /** 即将打开二级时否定住
+   * @supported weapp
+   * @default false
+   */
+  refresherTwoLevelPinned?: boolean
   /** 滚动到顶部/左边，会触发 scrolltoupper 事件
-   * @supported weapp, alipay, swan, tt, qq, jd, h5, rn
+   * @supported weapp, alipay, swan, tt, qq, jd, h5, rn, harmony_hybrid
    */
   onScrollToUpper?: CommonEventFunction
   /** 滚动到底部/右边，会触发 scrolltolower 事件
-   * @supported weapp, alipay, swan, tt, qq, jd, h5, rn
+   * @supported weapp, alipay, swan, tt, qq, jd, h5, rn, harmony_hybrid
    */
   onScrollToLower?: CommonEventFunction
   /** 滚动时触发
-   * @supported weapp, alipay, swan, tt, qq, jd, h5, rn
+   * @supported weapp, alipay, swan, tt, qq, jd, h5, rn, harmony, harmony_hybrid
    */
   onScroll?: BaseEventOrigFunction<ScrollViewProps.onScrollDetail>
   /** 滚动开始事件
@@ -201,6 +251,10 @@ interface ScrollViewProps extends StandardProps {
    * @supported weapp
    */
   onRefresherWillRefresh?: CommonEventFunction
+  /** 下拉刷新状态回调
+   * @supported weapp
+   */
+  onRefresherStatusChange?: CommonEventFunction<ScrollViewProps.RefresherStatusChange>
   /** 滑动开始事件 (同时开启 enhanced 属性后生效)
    * @supported weapp
    */
@@ -252,6 +306,30 @@ declare namespace ScrollViewProps {
     /** 滚动速度 */
     velocity: number
   }
+  interface RefresherStatusChange {
+    status: RefreshStatus
+    dy: number
+  }
+  const enum RefreshStatus {
+    // 空闲
+    Idle,
+    // 超过下拉刷新阈值，同 bind:refresherwillRefresh 触发时机
+    CanRefresh,
+    // 下拉刷新，同 bind:refresherrefresh 触发时机
+    Refreshing,
+    // 下拉刷新完成，同 bind:refresherrestore 触发时机
+    Completed,
+    // 下拉刷新失败
+    Failed,
+    // 超过下拉二级阈值
+    CanTwoLevel,
+    // 开始打开二级
+    TwoLevelOpening,
+    // 打开二级
+    TwoLeveling,
+    // 开始关闭二级
+    TwoLevelClosing,
+  }
 }
 /** 可滚动视图区域。使用竖向滚动时，需要给scroll-view一个固定高度，通过 WXSS 设置 height。组件属性的长度单位默认为 px
  *
@@ -259,7 +337,7 @@ declare namespace ScrollViewProps {
  * H5 中 ScrollView 组件是通过一个高度（或宽度）固定的容器内部滚动来实现的，因此务必正确的设置容器的高度。例如: 如果 ScrollView 的高度将 body 撑开，就会同时存在两个滚动条（body 下的滚动条，以及 ScrollView 的滚动条）。
  * 微信小程序 中 ScrollView 组件如果设置 scrollX 横向滚动时，并且子元素为多个时（单个子元素时设置固定宽度则可以正常横向滚动），需要通过 WXSS 设置 `white-space: nowrap` 来保证元素不换行，并对 ScrollView 内部元素设置 `display: inline-block` 来使其能够横向滚动。
  * @classification viewContainer
- * @supported weapp, alipay, swan, tt, qq, jd, h5, rn, harmony
+ * @supported weapp, alipay, swan, tt, qq, jd, h5, rn, harmony, harmony_hybrid
  * @example_react
  * ```tsx
  * export default class PageView extends Component {

package/types/ShareElement.d.ts

@@ -8,6 +8,7 @@ interface ShareElementProps extends StandardProps {
   key?: string
   /** 映射标记
    * @supported weapp
+   * @unique
    */
   mapkey?: string
   /** 映射标记
@@ -68,7 +69,7 @@ interface ShareElementProps extends StandardProps {
  *
  * 共享元素是一种动画形式，类似于 [`flutter Hero`](https://flutterchina.club/animations/hero-animations/) 动画，表现为元素像是在页面间穿越一样。该组件需与 [`PageContainer`](/docs/components/viewContainer/page-container) 组件结合使用。
  * 使用时需在当前页放置 `ShareElement` 组件，同时在 `PageContainer` 容器中放置对应的 `ShareElement` 组件，对应关系通过属性值 key 映射。当设置 `PageContainer` `显示时，transform` 属性为 `true` 的共享元素会产生动画。当前页面容器退出时，会产生返回动画。
- * @classification viewContainer
+ * @classification skyline
  * @supported weapp, alipay
  * @example_react
  * ```tsx

package/types/Slider.d.ts

@@ -3,62 +3,67 @@ import { StandardProps, CommonEventFunction, FormItemProps } from './common'
 interface SliderProps extends StandardProps, FormItemProps {
   /** 最小值
    * @default 0
-   * @supported weapp, alipay, swan, tt, qq, jd, h5, rn
+   * @supported weapp, alipay, swan, tt, qq, jd, h5, rn, harmony, harmony_hybrid
    */
   min?: number
   /** 最大值
    * @default 100
-   * @supported weapp, alipay, swan, tt, qq, jd, h5, rn
+   * @supported weapp, alipay, swan, tt, qq, jd, h5, rn, harmony, harmony_hybrid
    */
   max?: number
   /** 步长，取值必须大于 0，并且可被(max - min)整除
    * @default 1
-   * @supported weapp, alipay, swan, tt, qq, jd, h5, rn
+   * @supported weapp, alipay, swan, tt, qq, jd, h5, rn, harmony, harmony_hybrid
    */
   step?: number
   /** 是否禁用
    * @default false
-   * @supported weapp, alipay, swan, tt, qq, jd, h5, rn
+   * @supported weapp, alipay, swan, tt, qq, jd, h5, rn, harmony, harmony_hybrid
    */
   disabled?: boolean
   /** 当前取值
    * @default 0
-   * @supported weapp, alipay, swan, tt, qq, jd, h5, rn
+   * @supported weapp, alipay, swan, tt, qq, jd, h5, rn, harmony, harmony_hybrid
    */
   value?: number
+  /** 设置 React 非受控状态下的初始取值
+   * @supported weapp, alipay, swan, tt, qq, jd, h5, rn, harmony_hybrid
+   * @unique
+   */
+  defaultValue?: string
   /** 背景条的颜色（请使用 backgroundColor）
    * @default "#e9e9e9"
-   * @supported weapp, tt, qq, jd
+   * @supported weapp, tt, qq, jd, harmony
    */
   color?: string
   /** 已选择的颜色（请使用 activeColor）
    * @default "#1aad19"
-   * @supported weapp, tt, qq, jd
+   * @supported weapp, tt, qq, jd, harmony
    */
   selectedColor?: string
   /** 已选择的颜色
    * @default "#1aad19"
-   * @supported weapp, alipay, swan, tt, qq, jd, h5, rn
+   * @supported weapp, alipay, swan, tt, qq, jd, h5, rn, harmony, harmony_hybrid
    */
   activeColor?: string
   /** 背景条的颜色
    * @default "#e9e9e9"
-   * @supported weapp, alipay, swan, tt, qq, jd, h5, rn
+   * @supported weapp, alipay, swan, tt, qq, jd, h5, rn, harmony, harmony_hybrid
    */
   backgroundColor?: string
   /** 滑块的大小，取值范围为 12 - 28
    * @default 28
-   *  @supported weapp, swan, tt, qq, jd, h5
+   *  @supported weapp, swan, tt, qq, jd, h5, harmony, harmony_hybrid
    */
   blockSize?: number
   /** 滑块的颜色
    * @default "#ffffff"
-   * @supported weapp, swan, tt, qq, jd, h5, rn
+   * @supported weapp, swan, tt, qq, jd, h5, rn, harmony, harmony_hybrid
    */
   blockColor?: string
   /** 是否显示当前 value
    * @default false
-   * @supported weapp, alipay, swan, tt, qq, jd, h5, rn
+   * @supported weapp, alipay, swan, tt, qq, jd, h5, rn, harmony, harmony_hybrid
    */
   showValue?: boolean
   /** 组件名字，用于表单提交获取数据。
@@ -84,11 +89,11 @@ interface SliderProps extends StandardProps, FormItemProps {
    */
   ariaLabel?: string
   /** 完成一次拖动后触发的事件
-   * @supported weapp, alipay, swan, tt, qq, jd, h5, rn
+   * @supported weapp, alipay, swan, tt, qq, jd, h5, rn, harmony, harmony_hybrid
    */
   onChange?: CommonEventFunction<SliderProps.onChangeEventDetail>
   /** 拖动过程中触发的事件
-   * @supported weapp, alipay, swan, tt, qq, jd, h5, rn
+   * @supported weapp, alipay, swan, tt, qq, jd, h5, rn, harmony, harmony_hybrid
    */
   onChanging?: CommonEventFunction<SliderProps.onChangeEventDetail>
 }
@@ -99,7 +104,7 @@ declare namespace SliderProps {
 }
 /** 滑动选择器
  * @classification forms
- * @supported weapp, alipay, swan, tt, qq, jd, h5, rn, harmony
+ * @supported weapp, alipay, swan, tt, qq, jd, h5, rn, harmony, harmony_hybrid
  * @example_react
  * ```tsx
  * export default class PageView extends Component {

package/types/Slot.d.ts

@@ -1,6 +1,8 @@
-import { ComponentType } from 'react'
+import { StandardProps } from './common'
 
-interface SlotProps {
+import type { ComponentType, ReactNode } from 'react'
+
+interface SlotProps extends StandardProps {
   /** 指定插入的 slot 位置
    * @default none
    * @supported weapp, swan, alipay, tt, jd, qq
@@ -15,7 +17,7 @@ interface SlotProps {
 
 /** slot 插槽
  * @classification viewContainer
- * @supported weapp, swan, alipay, tt, jd, qq, harmony
+ * @supported weapp, swan, alipay, tt, jd, qq, h5, harmony_hybrid
  * @example
  * ```tsx
  * import { Slot, View, Text } from '@tarojs/components'

package/types/Snapshot.d.ts

@@ -0,0 +1,16 @@
+import { ComponentType } from 'react'
+
+import { StandardProps } from './common'
+
+interface SnapshotProps extends StandardProps {
+  id: string
+}
+
+/** 截图组件。
+ * 支持将其子节点的渲染结果导出成图片，该组件需配合 snapshot 接口使用。 目前仅在 Skyline 渲染引擎 下支持。
+ * @classification skyline
+ * @supported weapp
+ * @see https://developers.weixin.qq.com/miniprogram/dev/component/snapshot.html
+ */
+declare const Snapshot: ComponentType<SnapshotProps>
+export { Snapshot, SnapshotProps }

package/types/StickyHeader.d.ts

@@ -4,7 +4,7 @@ interface StickyHeaderProps extends StandardProps {}
 
 /**
  * 吸顶布局容器，仅支持作为 scroll-view 自定义模式下的直接子节点或 sticky-section 组件直接子节点。仅 Skyline 支持。
- * @classification viewContainer
+ * @classification skyline
  * @supported weapp
  * @see https://developers.weixin.qq.com/miniprogram/dev/component/sticky-header.html
  */

package/types/StickySection.d.ts

@@ -9,7 +9,7 @@ interface StickySectionProps extends StandardProps {
 }
 /**
  * 吸顶布局容器，仅支持作为 scroll-view 自定义模式下的直接子节点。仅 Skyline 支持。
- * @classification viewContainer
+ * @classification skyline
  * @supported weapp
  * @see https://developers.weixin.qq.com/miniprogram/dev/component/sticky-section.html
  */

package/types/Swiper.d.ts

@@ -3,61 +3,63 @@ import { StandardProps, CommonEventFunction } from './common'
 interface SwiperProps extends StandardProps {
   /** 是否显示面板指示点
    * @default false
-   * @supported weapp, alipay, swan, tt, qq, jd, h5, rn
+   * @supported weapp, alipay, swan, tt, qq, jd, h5, rn, harmony, harmony_hybrid
    */
   indicatorDots?: boolean
   /** 指示点颜色
    * @default "rgba(0, 0, 0, .3)"
-   * @supported weapp, alipay, swan, tt, qq, jd, h5, rn
+   * @supported weapp, alipay, swan, tt, qq, jd, h5, rn, harmony, harmony_hybrid
    */
   indicatorColor?: string
   /** 当前选中的指示点颜色
    * @default "#000000"
-   * @supported weapp, alipay, swan, tt, qq, jd, h5, rn
+   * @supported weapp, alipay, swan, tt, qq, jd, h5, rn, harmony, harmony_hybrid
    */
   indicatorActiveColor?: string
   /** 是否自动切换
    * @default false
-   * @supported weapp, alipay, swan, tt, qq, jd, h5, rn
+   * @supported weapp, alipay, swan, tt, qq, jd, h5, rn, harmony, harmony_hybrid
    */
   autoplay?: boolean
   /** 当前所在滑块的 index
    * @default 0
-   * @supported weapp, alipay, swan, tt, qq, jd, h5, rn
+   * @supported weapp, alipay, swan, tt, qq, jd, h5, rn, harmony, harmony_hybrid
    */
   current?: number
   /** 当前所在滑块的 item-id ，不能与 current 被同时指定
+   * @supported swan, tt, qq, jd
+   * @weapp deprecated
    * @default ""
    */
   currentItemId?: string
   /** 自动切换时间间隔
    * @default 5000
-   * @supported weapp, alipay, swan, tt, qq, jd, h5, rn
+   * @supported weapp, alipay, swan, tt, qq, jd, h5, rn, harmony, harmony_hybrid
    */
   interval?: number
   /** 滑动动画时长
    * @default 500
-   * @supported weapp, alipay, swan, tt, qq, jd, h5
+   * @supported weapp, alipay, swan, tt, qq, jd, h5, harmony, harmony_hybrid
    */
   duration?: number
   /** 是否采用衔接滑动
    * @default false
-   * @supported weapp, alipay, swan, tt, qq, jd, h5, rn
+   * @supported weapp, alipay, swan, tt, qq, jd, h5, rn, harmony_hybrid
    */
   circular?: boolean
   /** 滑动方向是否为纵向
    * @default false
-   * @supported weapp, alipay, swan, tt, qq, jd, h5, rn
+   * @supported weapp, alipay, swan, tt, qq, jd, h5, rn, harmony, harmony_hybrid
    */
   vertical?: boolean
   /** 前边距，可用于露出前一项的一小部分，接受 px 和 rpx 值
    * @default "0px"
-   * @supported weapp, alipay, swan, tt, qq, jd, h5
+   * @supported weapp, alipay, swan, tt, qq, jd, h5, harmony_hybrid
    */
   previousMargin?: string
   /** 后边距，可用于露出后一项的一小部分，接受 px 和 rpx 值
    * @default "0px"
-   * @supported weapp, alipay, swan, tt, qq, jd, h5
+   * @supported weapp, alipay, swan, tt, qq, jd, h5, harmony_hybrid
    */
   nextMargin?: string
   /**
@@ -68,7 +70,7 @@ interface SwiperProps extends StandardProps {
   snapToEdge?: boolean
   /** 同时显示的滑块数量
    * @default 1
-   * @supported weapp, alipay, swan, tt, qq, jd, h5
+   * @supported weapp, alipay, swan, tt, qq, jd, h5, harmony_hybrid
    */
   displayMultipleItems?: number
   /** 是否跳过未显示的滑块布局，设为 true 可优化复杂情况下的滑动性能，但会丢失隐藏状态滑块的布局信息
@@ -88,12 +90,12 @@ interface SwiperProps extends StandardProps {
   disableTouch?: boolean
   /** 是否启用缩放
    * @default false
-   * @supported h5
+   * @supported h5, harmony_hybrid
    */
   zoom?: boolean
   /** 是否开启全屏
    * @default false
-   * @supported h5
+   * @supported h5, harmony_hybrid
    */
   full?: boolean
   /** swiper-item 可见时的 class。
@@ -150,7 +152,7 @@ interface SwiperProps extends StandardProps {
    */
   cacheExtent?: number
   /** current 改变时会触发 change 事件
-   * @supported weapp, alipay, swan, tt, qq, jd, h5, rn
+   * @supported weapp, alipay, swan, tt, qq, jd, h5, rn, harmony, harmony_hybrid
    */
   onChange?: CommonEventFunction<SwiperProps.onChangeEventDetail>
   /** swiper-item 的位置发生改变时会触发 transition 事件
@@ -158,7 +160,7 @@ interface SwiperProps extends StandardProps {
    */
   onTransition?: CommonEventFunction<SwiperProps.onTransitionEventDetail>
   /** 动画结束时会触发 animationfinish 事件
-   * @supported weapp, swan, tt, qq, jd, h5, rn
+   * @supported weapp, swan, tt, qq, jd, h5, rn, harmony_hybrid
    */
   onAnimationFinish?: SwiperProps['onChange']
   /** 动画结束时会触发 animationEnd 事件
@@ -213,7 +215,7 @@ declare namespace SwiperProps {
 /** 滑块视图容器。其中只可放置 swiper-item 组件，否则会导致未定义的行为。
  * > 不要为 `SwiperItem` 设置 **style** 属性，可以通过 class 设置样式。[7147](https://github.com/NervJS/taro/issues/7147)
  * @classification viewContainer
- * @supported weapp, alipay, swan, tt, qq, jd, h5, rn, harmony
+ * @supported weapp, alipay, swan, tt, qq, jd, h5, rn, harmony, harmony_hybrid
  * @example_react
  * ```tsx
  * class App extends Component {

package/types/SwiperItem.d.ts

@@ -2,7 +2,7 @@ import { ComponentType } from 'react'
 import { StandardProps } from './common'
 interface SwiperItemProps extends StandardProps {
   /** 该 swiper-item 的标识符
-   * @supported weapp, swan, tt, jd, h5, rn
+   * @supported weapp, swan, tt, jd, h5, rn, harmony, harmony_hybrid
    */
   itemId?: string
   /** 是否跳过未显示的滑块布局，设为 true 可优化复杂情况下的滑动性能，但会丢失隐藏状态滑块的布局信息
@@ -10,11 +10,16 @@ interface SwiperItemProps extends StandardProps {
    * @supported weapp
    */
   skipHiddenItemLayout?: boolean
+  /** Swiper 循环状态下，前后垫片节点拷贝模式，用于修复 Vue 在 CustomElements 下的节点拷贝问题
+   * @default false
+   * @supported h5
+   */
+  deep?: boolean
 }
 /** 仅可放置在 swiper 组件中，宽高自动设置为100%
  * > 不要为 `SwiperItem` 设置 **style** 属性，可以通过 class 设置样式。[7147](https://github.com/NervJS/taro/issues/7147)
  * @classification viewContainer
- * @supported weapp, alipay, swan, tt, jd, h5, rn, harmony
+ * @supported weapp, alipay, swan, tt, jd, h5, rn, harmony, harmony_hybrid
  * @example_react
  * ```tsx
  * class App extends Component {