@tarojs/components 3.7.0-alpha.2 → 3.7.0-alpha.22

package/types/ChannelVideo.d.ts

@@ -29,6 +29,10 @@ interface ChannelVideoProps extends StandardProps {
    * @default false
    */
   autoplay?: boolean
+  /** 仅内嵌小程序非同主体视频号视频时使用，获取方式参考本指引。
+   * @supported weapp
+   */
+  feedToken?: string
   /** 视频播放出错时触发
    * @supported weapp
    */

package/types/Form.d.ts

@@ -31,6 +31,17 @@ interface FormProps extends StandardProps {
    * @supported swan
    */
   subscribeId?: string
+  /** 用于分发目的。取值：0 或 1，其中 0 表示默认，1 表示留资目标，需要和留资分发配置一起使用，详情见留资分发配置
+   * @supported tt
+   * @default 0
+   */
+  conversionTarget?: number
+  /** 用于分发目的。开发者在【小程序开发者后台 -> 进入目标小程序 -> 运营 -> 流量配置 -> 抖音 -> 留资分发配置】复制创建的配置 ID，需要和留资分发配置一起使用，详情见留资分发配置
+   *
+   * @supported tt
+   * @default ""
+   */
+  clueComponentId?: string
   /** 携带 form 中的数据触发 submit 事件
    * @supported weapp, alipay, swan, tt, qq, jd, h5, rn
    */

package/types/GridView.d.ts

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

package/types/Image.d.ts

@@ -60,6 +60,11 @@ interface ImageProps extends StandardProps {
    * @supported qq
    */
   ariaLabel?: string
+  /** 是否渐显
+   * @supported weapp
+   * @default false
+   */
+  fadeIn?: boolean
   /** 当错误发生时，发布到 AppService 的事件名，事件对象
    * @supported weapp, alipay, swan, tt, qq, jd, h5, rn
    */

package/types/Input.d.ts

@@ -160,6 +160,11 @@ interface InputProps extends StandardProps, FormItemProps {
    * @supported qq
    */
   ariaLabel?: string
+  /** 用于分发目的。取值：0 和 1，其中 0 表示默认，1 表示手机号，需要和留资分发配置一起使用，详情见留资分发配置。
+   * @supported tt
+   * @default 0
+   */
+  clueType?: number
   /** 当键盘输入时，触发input事件，event.detail = {value, cursor, keyCode}，处理函数可以直接 return 一个字符串，将替换输入框的内容。
    * @supported weapp, alipay, swan, tt, qq, jd, h5, rn
    */
@@ -177,7 +182,7 @@ interface InputProps extends StandardProps, FormItemProps {
    */
   onConfirm?: CommonEventFunction<InputProps.inputValueEventDetail>
   /** 键盘高度发生变化的时候触发此事件
-   * @supported weapp, qq
+   * @supported weapp, tt, qq
    */
   onKeyboardHeightChange?: CommonEventFunction<InputProps.onKeyboardHeightChangeEventDetail>
   /** 用户昵称审核完毕后触发，仅在 type 为 "nickname" 时有效，event.detail = { pass, timeout }

package/types/ListView.d.ts

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

package/types/LivePlayer.d.ts

@@ -85,6 +85,11 @@ interface LivePlayerProps extends StandardProps {
    * @default false
    */
   enableAutoRotation?: boolean
+  /** 是否支持投屏。开启后，可以通过 LivePlayerContext 上相关方法进行操作。
+   * @supported weapp
+   * @default false
+   */
+  enableCasting?: boolean
   /** 播放状态变化事件，detail = {code}
    * @supported weapp, swan, tt, qq, jd
    */
@@ -117,6 +122,18 @@ interface LivePlayerProps extends StandardProps {
    * @supported qq
    */
   onMetaDataChange?: CommonEventFunction
+  /** 用户选择投屏设备时触发 detail = { state: "success"/"fail" }
+   * @supported weapp
+   */
+  onCastingUserSelect?: CommonEventFunction
+  /** 投屏成功/失败时触发 detail = { type, state: "success"/"fail" }
+   * @supported weapp
+   */
+  onCastingStateChange?: CommonEventFunction
+  /** 投屏被中断时触发
+   * @supported weapp
+   */
+  onCastingInterrupt?: CommonEventFunction
 }
 declare namespace LivePlayerProps {
   /** mode 的合法值 */

package/types/LivePusher.d.ts

@@ -189,6 +189,16 @@ interface LivePusherProps extends StandardProps {
    * @default 0
    */
   eyeBigness?: number
+  /** 0：关闭变声；1：熊孩子；2：萝莉；3：大叔；4：重金属；6：外国人；7：困兽；8：死肥仔；9：强电流；10：重机械；11：空灵
+   * @supported weapp
+   * @default 0
+   */
+  voiceChangerType?: number
+  /** 帧率，有效值为 1~30
+   * @supported weapp
+   * @default 15
+   */
+  fps?: number
   /** 状态变化事件，detail = {code}
    * @supported weapp, qq
    */

package/types/NativeSlot.d.ts

@@ -1,6 +1,8 @@
-import { ComponentType } from 'react'
+import { StandardProps } from './common'
 
-interface NativeSlotProps {
+import type { ComponentType, ReactNode } from 'react'
+
+interface NativeSlotProps extends StandardProps {
   /** 指定插入的 slot 位置
    * @default none
    * @supported weapp, swan, alipay, tt, jd, qq
@@ -10,7 +12,7 @@ interface NativeSlotProps {
 
 /** 编译的原生组件支持使用 slot 插槽
  * @classification viewContainer
- * @supported weapp, swan, alipay, tt, jd, qq
+ * @supported weapp, swan, alipay, tt, jd, qq, h5
  * @version 3.5.7+
  * @example
  * ```tsx

package/types/Picker.d.ts

@@ -35,6 +35,10 @@ declare namespace PickerStandardProps {
     /** 省市区选择器 */
     region
   }
+  interface PickerText {
+    okText?: string
+    cancelText?: string
+  }
 }
 /** 普通选择器：mode = selector */
 interface PickerSelectorProps extends PickerStandardProps {
@@ -74,6 +78,11 @@ interface PickerSelectorProps extends PickerStandardProps {
    * @supported weapp, h5, rn
    */
   onChange: CommonEventFunction<PickerSelectorProps.ChangeEventDetail>
+  /**
+   * 用于替换组件内部文本
+   * @supported h5
+   */
+  textProps?: PickerStandardProps.PickerText
 }
 declare namespace PickerSelectorProps {
   interface ChangeEventDetail {

package/types/Progress.d.ts

@@ -54,7 +54,7 @@ interface ProgressProps extends StandardProps {
   activeMode?: 'backwards' | 'forwards'
   /** 进度增加 1% 所需毫秒数
    * @default 30
-   * @supported weapp, swan, jd, h5
+   * @supported weapp, swan, tt, jd, h5
    */
   duration?: number
   /** 无障碍访问，（属性）元素的额外描述
@@ -62,7 +62,7 @@ interface ProgressProps extends StandardProps {
    */
   ariaLabel?: string
   /** 动画完成事件
-   * @supported weapp, qq, jd, h5
+   * @supported weapp, tt, qq, jd, h5
    */
   onActiveEnd?: CommonEventFunction
 }

package/types/RichText.d.ts

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

package/types/ScrollView.d.ts

@@ -1,5 +1,5 @@
 import { ComponentType } from 'react'
-import { StandardProps, CommonEventFunction, BaseEventOrigFunction } from './common'
+import { BaseEventOrigFunction, CommonEventFunction, StandardProps } from './common'
 interface ScrollViewProps extends StandardProps {
   /** 允许横向滚动
    * @default false
@@ -46,7 +46,7 @@ interface ScrollViewProps extends StandardProps {
    */
   enableBackToTop?: boolean
   /** 启用 flexbox 布局。开启后，当前节点声明了 `display: flex` 就会成为 flex container，并作用于其孩子节点。
-   * @supported weapp
+   * @supported weapp, jd
    * @default false
    */
   enableFlex?: boolean
@@ -81,12 +81,12 @@ interface ScrollViewProps extends StandardProps {
    */
   refresherTriggered?: boolean
   /** 启用 scroll-view 增强特性
-   * @supported weapp
+   * @supported weapp, swan
    * @default false
    */
   enhanced?: boolean
   /** iOS 下 scroll-view 边界弹性控制 (同时开启 enhanced 属性后生效)
-   * @supported weapp
+   * @supported weapp, swan
    * @default true
    */
   bounces?: 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,10 +172,45 @@ interface ScrollViewProps extends StandardProps {
    * center - 目标节点显示在视口中间
    * end - 目标节点显示在视口结束处
    * nearest - 目标节点在就近的视口边缘显示，若节点已在视口内则不触发滚动
-   * @supported weapp
+   * @supported weapp, h5
    * @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
    */
@@ -176,11 +226,11 @@ interface ScrollViewProps extends StandardProps {
   /** 滚动开始事件
    * @supported weapp
    */
-  onScrollStart?:BaseEventOrigFunction<ScrollViewProps.onScrollDetail>
+  onScrollStart?: BaseEventOrigFunction<ScrollViewProps.onScrollDetail>
   /** 滚动结束事件
    * @supported weapp
    */
-  onScrollEnd?:BaseEventOrigFunction<ScrollViewProps.onScrollDetail>
+  onScrollEnd?: BaseEventOrigFunction<ScrollViewProps.onScrollDetail>
   /** 自定义下拉刷新控件被下拉
    * @supported weapp
    */
@@ -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
  *

package/types/ShareElement.d.ts

@@ -3,8 +3,13 @@ import { StandardProps, CommonEventFunction } from './common'
 interface ShareElementProps extends StandardProps {
   /** 映射标记
    * @supported weapp
+   * @deprecated 使用mapkey替换key
    */
   key?: string
+  /** 映射标记
+   * @supported weapp
+   */
+  mapkey?: string
   /** 映射标记
    * @supported alipay
    */
@@ -24,12 +29,46 @@ interface ShareElementProps extends StandardProps {
    * @supported weapp, alipay
    */
   easingFunction?: string
+  /** 手势返回时是否进行动画
+   * @supported weapp
+   * @default false
+   */
+  transitionOnGesture?: boolean
+  /** 指定 push 阶段的飞跃物
+   * @supported weapp
+   * @default "to"
+   */
+  shuttleOnPush?: 'from' | 'to' | 'from' | 'to'
+  /** 指定 pop 阶段的飞跃物
+   * @supported weapp
+   * @default "to"
+   */
+  shuttleOnPop?: string
+  /** 动画插值曲线
+   * @supported weapp
+   * @default "materialRectArc"
+   */
+  rectTweenType?:
+    | 'materialRectArc'
+    | 'materialRectCenterArc'
+    | 'linear'
+    | 'elasticIn'
+    | 'elasticOut'
+    | 'elasticInOut'
+    | 'bounceIn'
+    | 'bounceOut'
+    | 'bounceInOut'
+    | 'cubic-bezier(x1,'
+  /** 动画帧回调
+   * @supported weapp
+   */
+  onFrame?: string
 }
 /** 共享元素
  *
  * 共享元素是一种动画形式，类似于 [`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/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, harmony, h5
  * @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

@@ -7,10 +7,9 @@ interface StickySectionProps extends StandardProps {
    */
   pushPinnedHeader?: boolean
 }
-
 /**
  * 吸顶布局容器，仅支持作为 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

@@ -139,6 +139,16 @@ interface SwiperProps extends StandardProps {
    * @supported swan
    */
   disableTouchmove?: string
+  /** 改变 current 时使用动画过渡
+   * @supported weapp
+   * @default true
+   */
+  scrollWithAnimation?: boolean
+  /** 缓存区域大小，值为 1 表示提前渲染上下各一屏区域（swiper 容器大小）
+   * @supported weapp
+   * @default 0
+   */
+  cacheExtent?: number
   /** current 改变时会触发 change 事件
    * @supported weapp, alipay, swan, tt, qq, jd, h5, rn
    */

package/types/Text.d.ts

@@ -8,22 +8,27 @@ interface TextProps extends StandardProps {
   selectable?: boolean
   /** 文本是否可选，该属性会使文本节点显示为 inline-block
    * @default false
-   * @supported weapp
+   * @supported weapp, h5
    */
   userSelect?: boolean
   /** 显示连续空格
-   * @supported weapp, alipay, swan, tt, qq, jd
+   * @supported weapp, alipay, swan, tt, qq, jd, h5
    */
   space?: keyof TextProps.TSpace
   /** 是否解码
    * @default false
    * @supported weapp, alipay, tt, qq, jd
+   * @h5 默认解码，不支持设置
    */
   decode?: boolean
   /** 多行省略，值须大于等于 1，表现同 css 的 -webkit-line-clamp 属性一致。
    * @supported alipay
    */
-  numberOfLines?: string
+  numberOfLines?: number
+  /** 限制文本最大行数
+   * @supported weapp
+   */
+  maxLines?: number
 }
 declare namespace TextProps {
   /** space 的合法值 */

package/types/Textarea.d.ts

@@ -99,23 +99,30 @@ interface TextareaProps extends StandardProps, FormItemProps {
   /** 点击键盘右下角按钮时是否保持键盘不收起
    * @supported weapp, swan, tt
    */
-  confirmHold?: string
+  confirmHold?: boolean
   /** 组件名字，用于表单提交获取数据。
    * @supported alipay
    */
   name?: string
   /** 是否渲染字数统计功能（是否删除默认计数器/是否显示字数统计）。
+   * @default true
    * @supported alipay
    */
-  showCount?: string
+  showCount?: boolean
   /** 是否为受控组件。为 true 时，value 内容会完全受 setData 控制。
+   * @default false
    * @supported alipay
    */
-  controlled?: string
+  controlled?: boolean
   /** 无障碍访问，（属性）元素的额外描述
    * @supported qq
    */
   ariaLabel?: string
+  /** 键盘对齐位置
+   * @supported weapp
+   * @default false
+   */
+  adjustKeyboardTo?: boolean
   /** 输入框聚焦时触发
    * @supported weapp, alipay, swan, tt, qq, jd, h5, rn
    */
@@ -139,7 +146,7 @@ interface TextareaProps extends StandardProps, FormItemProps {
    */
   onConfirm?: CommonEventFunction<TextareaProps.onConfirmEventDetail>
   /** 键盘高度发生变化的时候触发此事件
-   * @supported weapp
+   * @supported weapp, tt
    */
   onKeyboardHeightChange?: CommonEventFunction<TextareaProps.onKeyboardHeightChangeEventDetail>
 }

package/types/Video.d.ts

@@ -192,8 +192,9 @@ interface VideoProps extends StandardProps {
   nativeProps?: Record<string, unknown>
   /** 是否展示底部进度条
    * @supported weapp
+   * @default true
    */
-  showBottomProgress?: string
+  showBottomProgress?: boolean
   /** 是否在小窗模式下显示播放进度
    * @supported weapp
    */
@@ -205,7 +206,7 @@ interface VideoProps extends StandardProps {
   /** 是否是 DRM 视频源
    * @supported weapp
    */
-  isDrm?: string
+  isDrm?: boolean
   /** DRM 设备身份认证 url，仅 is-drm 为 true 时生效 (Android)
    * @supported weapp
    */
@@ -235,7 +236,7 @@ interface VideoProps extends StandardProps {
    *
    * @supported alipay, jd
    */
-  mobilenetHintType?: string
+  mobilenetHintType?: number
   /** 浮窗设置。暂时不支持全局浮窗。
    * 可选值：
    *
@@ -314,7 +315,7 @@ interface VideoProps extends StandardProps {
   onTimeUpdate?: CommonEventFunction<VideoProps.onTimeUpdateEventDetail>
   /** 当视频进入和退出全屏时触发
    *
-   * @supported h5, rn
+   * @supported h5, rn, alipay
    */
   onFullscreenChange?: CommonEventFunction<VideoProps.onFullscreenChangeEventDetail>
   /** 视频出现缓冲时触发
@@ -443,6 +444,18 @@ interface VideoProps extends StandardProps {
    * @supported tt
    */
   onAdLoad?: CommonEventFunction
+  /** 用户选择投屏设备时触发 detail = { state: "success"/"fail" }
+   * @supported weapp
+   */
+  onCastingUserSelect?: CommonEventFunction
+  /** 投屏成功/失败时触发 detail = { type, state: "success"/"fail" }
+   * @supported weapp
+   */
+  onCastingStateChange?: CommonEventFunction
+  /** 投屏被中断时触发
+   * @supported weapp
+   */
+  onCastingInterrupt?: CommonEventFunction
 }
 declare namespace VideoProps {
   /** direction 的合法值 */
@@ -475,6 +488,14 @@ declare namespace VideoProps {
     currentTime: number
     /** 持续时间 */
     duration: number
+    /** 用户实际观看时长
+     * @supported alipay
+     */
+    userPlayDuration: number
+    /** 视频总时长
+     * @supported alipay
+     */
+    videoDuration: number
   }
   interface onFullscreenChangeEventDetail {
     /** 方向 */