@tarojs/components 3.5.7 → 3.5.8

package/types/Swiper.d.ts

@@ -97,26 +97,23 @@ interface SwiperProps extends StandardProps {
    */
   easingFunction?: keyof SwiperProps.TEasingFunction
 
-  /** current 改变时会触发 change 事件
-   * @supported weapp, alipay, swan, tt, qq, jd, h5, rn
-   */
-  onChange?: CommonEventFunction<SwiperProps.onChangeEventDetail>
-
-  /** swiper-item 的位置发生改变时会触发 transition 事件
-   * @supported weapp, alipay, tt, qq, jd
+  /** 是否禁止用户 touch 操作
+   * @default false
+   * @supported alipay
    */
-  onTransition?: CommonEventFunction<SwiperProps.onTransitionEventDetail>
+  disableTouch?: boolean
 
-  /** 动画结束时会触发 animationfinish 事件
-   * @supported weapp, swan, tt, qq, jd, h5, rn
+  /** 是否启用缩放
+   * @default false
+   * @supported h5
    */
-  onAnimationFinish?: SwiperProps['onChange']
+  zoom?: boolean
 
-  /** 是否禁止用户 touch 操作
+  /** 是否开启全屏
    * @default false
-   * @supported alipay
+   * @supported h5
    */
-  disableTouch?: boolean
+  full?: boolean
 
   /** swiper-item 可见时的 class。
    * @supported alipay
@@ -140,11 +137,6 @@ interface SwiperProps extends StandardProps {
    */
   disableProgrammaticAnimation?: string
 
-  /** 动画结束时会触发 animationEnd 事件
-   * @supported alipay
-   */
-  onAnimationEnd?: CommonEventFunction<SwiperProps.onCommonEventDetail>
-
   /** 滑动距离阈值，当滑动距离超过阈值时进行 swiper-item 切换。
    * @supported alipay
    */
@@ -175,6 +167,26 @@ interface SwiperProps extends StandardProps {
    * @supported swan
    */
   disableTouchmove?: string
+
+  /** current 改变时会触发 change 事件
+   * @supported weapp, alipay, swan, tt, qq, jd, h5, rn
+   */
+  onChange?: CommonEventFunction<SwiperProps.onChangeEventDetail>
+
+  /** swiper-item 的位置发生改变时会触发 transition 事件
+   * @supported weapp, alipay, tt, qq, jd
+   */
+  onTransition?: CommonEventFunction<SwiperProps.onTransitionEventDetail>
+
+  /** 动画结束时会触发 animationfinish 事件
+   * @supported weapp, swan, tt, qq, jd, h5, rn
+   */
+  onAnimationFinish?: SwiperProps['onChange']
+
+  /** 动画结束时会触发 animationEnd 事件
+   * @supported alipay
+   */
+  onAnimationEnd?: CommonEventFunction<SwiperProps.onCommonEventDetail>
 }
 declare namespace SwiperProps {
   /** 导致变更的原因 */

package/types/Switch.d.ts

@@ -25,11 +25,6 @@ interface SwitchProps extends StandardProps, FormItemProps {
    */
   color?: string
 
-  /** checked 改变时触发 change 事件
-   * @supported weapp, alipay, swan, tt, qq, jd, rn
-   */
-  onChange?: CommonEventFunction<SwitchProps.onChangeEventDetail>
-
   /** 用于透传 `WebComponents` 上的属性到内部 H5 标签上
    * @supported h5
    */
@@ -50,6 +45,11 @@ interface SwitchProps extends StandardProps, FormItemProps {
    * @supported qq
    */
   ariaLabel?: string
+
+  /** checked 改变时触发 change 事件
+   * @supported weapp, alipay, swan, tt, qq, jd, rn
+   */
+  onChange?: CommonEventFunction<SwitchProps.onChangeEventDetail>
 }
 declare namespace SwitchProps {
   interface onChangeEventDetail {

package/types/TabItem.d.ts

@@ -0,0 +1,35 @@
+import { ComponentType } from 'react'
+import { StandardProps } from './common'
+interface TabItemProps extends StandardProps {
+  /** tab-item 内显示的文字
+   * @supported swan
+   * @default 无
+   */
+  label?: string
+
+  /** tab-item 对应的 name 值
+   * @supported swan
+   * @default 无
+   */
+  name?: string
+
+  /** 徽标类型 badge-type 分为圆点“dot”和文本“text”，不设置 badge-type 则不显示徽标
+   * @supported swan
+   * @default 无
+   */
+  badgeType?: string
+
+  /** badge-type 为 text 的时候，徽标内的数字，为空时badge-type="text"不生效
+   * @supported swan
+   * @default 无
+   */
+  badgeText?: string
+}
+
+/** 标签栏子项
+ * @classification navig
+ * @supported swan
+ * @see https://smartprogram.baidu.com/docs/develop/component/tab-item/
+ */
+declare const TabItem: ComponentType<TabItemProps>
+export { TabItem, TabItemProps }

package/types/Tabs.d.ts

@@ -0,0 +1,58 @@
+import { ComponentType } from 'react'
+import { StandardProps } from './common'
+interface TabsProps extends StandardProps {
+  /** tabs 背景色,必须填写十六进制颜色
+   * @supported swan
+   * @default "#fff"
+   */
+  tabsBackgroundColor?: string
+
+  /** tabs 激活 tab-item 文字颜色
+   * @supported swan
+   * @default "#000"
+   */
+  tabsActiveTextColor?: string
+
+  /** tabs 非激活 tab-item 文字颜色
+   * @supported swan
+   * @default "#666"
+   */
+  tabsInactiveTextColor?: string
+
+  /** tabs 激活 tab-item 下划线颜色
+   * @supported swan
+   * @default "#333"
+   */
+  tabsUnderlineColor?: string
+
+  /** 仅用于普通标签栏组件，当前激活 tab-item 的对应的 name 值，须搭配 bindtabchange 一起使用。
+   * @supported swan
+   * @default 无
+   */
+  activeName?: string
+
+  /** 仅用于可寻址标签栏组件，当前 tab 所改变的 url query 中参数 key，需要通过 tabs 修改页面 url 的时候设置。
+   * @supported swan
+   * @default 无
+   */
+  urlQueryName?: string
+
+  /** 当前 tabs 视图中最多容纳的 tab-item 数量，低于此数量均分排列，超出此数量划屏。默认五个，开发者可根据业务需求调整
+   * @supported swan
+   * @default 5
+   */
+  maxTabItemAmount?: number
+
+  /** tab 被点击的回调，可以在 e.detail.name 中取到当前点击的 tab-item 对应的 name 值
+   * @supported swan
+   */
+  onTabChange?: CommonEventFunction
+}
+
+/** 标签栏
+ * @classification navig
+ * @supported swan
+ * @see https://smartprogram.baidu.com/docs/develop/component/tabs/
+ */
+declare const Tabs: ComponentType<TabsProps>
+export { Tabs, TabsProps }

package/types/Textarea.d.ts

@@ -106,38 +106,6 @@ interface TextareaProps extends StandardProps, FormItemProps {
    */
   disableDefaultPadding?: boolean
 
-  /** 输入框聚焦时触发
-   * @supported weapp, alipay, swan, tt, qq, h5, rn
-   */
-  onFocus?: CommonEventFunction<TextareaProps.onFocusEventDetail>
-
-  /** 输入框失去焦点时触发
-   * @supported weapp, alipay, swan, tt, qq, h5, rn
-   */
-  onBlur?: CommonEventFunction<TextareaProps.onBlurEventDetail>
-
-  /** 输入框行数变化时调用
-   * @supported weapp, swan, tt, qq, rn
-   */
-  onLineChange?: CommonEventFunction<TextareaProps.onLineChangeEventDetail>
-
-  /** 当键盘输入时，触发 input 事件
-   *
-   * **onInput 处理函数的返回值并不会反映到 textarea 上**
-   * @supported weapp, alipay, swan, tt, qq, h5, rn
-   */
-  onInput?: CommonEventFunction<TextareaProps.onInputEventDetail>
-
-  /** 点击完成时， 触发 confirm 事件
-   * @supported weapp, alipay, swan, tt, qq, rn
-   */
-  onConfirm?: CommonEventFunction<TextareaProps.onConfirmEventDetail>
-
-  /** 键盘高度发生变化的时候触发此事件
-   * @supported weapp
-   */
-  onKeyboardHeightChange?: CommonEventFunction<TextareaProps.onKeyboardHeightChangeEventDetail>
-
   /** 用于透传 `WebComponents` 上的属性到内部 H5 标签上
    * @supported h5
    */
@@ -172,6 +140,38 @@ interface TextareaProps extends StandardProps, FormItemProps {
    * @supported qq
    */
   ariaLabel?: string
+
+  /** 输入框聚焦时触发
+   * @supported weapp, alipay, swan, tt, qq, h5, rn
+   */
+  onFocus?: CommonEventFunction<TextareaProps.onFocusEventDetail>
+
+  /** 输入框失去焦点时触发
+   * @supported weapp, alipay, swan, tt, qq, h5, rn
+   */
+  onBlur?: CommonEventFunction<TextareaProps.onBlurEventDetail>
+
+  /** 输入框行数变化时调用
+   * @supported weapp, swan, tt, qq, rn
+   */
+  onLineChange?: CommonEventFunction<TextareaProps.onLineChangeEventDetail>
+
+  /** 当键盘输入时，触发 input 事件
+   *
+   * **onInput 处理函数的返回值并不会反映到 textarea 上**
+   * @supported weapp, alipay, swan, tt, qq, h5, rn
+   */
+  onInput?: CommonEventFunction<TextareaProps.onInputEventDetail>
+
+  /** 点击完成时， 触发 confirm 事件
+   * @supported weapp, alipay, swan, tt, qq, rn
+   */
+  onConfirm?: CommonEventFunction<TextareaProps.onConfirmEventDetail>
+
+  /** 键盘高度发生变化的时候触发此事件
+   * @supported weapp
+   */
+  onKeyboardHeightChange?: CommonEventFunction<TextareaProps.onKeyboardHeightChangeEventDetail>
 }
 declare namespace TextareaProps {
   interface onFocusEventDetail {

package/types/Video.d.ts

@@ -221,71 +221,6 @@ interface VideoProps extends StandardProps {
    */
   backgroundPoster?: string
 
-  /** 当开始/继续播放时触发 play 事件
-   * @supported weapp, alipay, swan, tt, qq, jd, h5, rn
-   */
-  onPlay?: CommonEventFunction
-
-  /** 当暂停播放时触发 pause 事件
-   * @supported weapp, alipay, swan, tt, qq, jd, h5, rn
-   */
-  onPause?: CommonEventFunction
-
-  /** 当播放到末尾时触发 ended 事件
-   * @supported weapp, alipay, swan, tt, qq, jd, h5, rn
-   */
-  onEnded?: CommonEventFunction
-
-  /** 播放进度变化时触发, 触发频率 250ms 一次
-   * @supported weapp, alipay, swan, tt, qq, jd, h5, rn
-   */
-  onTimeUpdate?: CommonEventFunction<VideoProps.onTimeUpdateEventDetail>
-
-  /** 当视频进入和退出全屏时触发
-   *
-   * @supported h5, rn
-   */
-  onFullscreenChange?: CommonEventFunction<VideoProps.onFullscreenChangeEventDetail>
-
-  /** 视频出现缓冲时触发
-   *
-   * @supported weapp, swan, tt, qq, jd
-   */
-  onWaiting?: CommonEventFunction<VideoProps.onWaitingEventDetail>
-
-  /** 视频播放出错时触发
-   * @supported weapp, alipay, swan, tt, qq, jd, h5, rn
-   */
-  onError?: CommonEventFunction
-
-  /** 加载进度变化时触发，只支持一段加载
-   * @supported weapp, tt, qq, h5
-   */
-  onProgress?: CommonEventFunction<VideoProps.onProgressEventDetail>
-
-  /** 视频元数据加载完成时触发
-   * @supported weapp, swan, tt, jd, rn
-   */
-  onLoadedMetaData?: CommonEventFunction<VideoProps.onLoadedMetaDataEventDetail>
-
-  /**
-   * 播放器进入小窗
-   * @supported weapp
-   */
-  onEnterPictureInPicture?: CommonEventFunction
-
-  /**
-   * 播放器退出小窗
-   * @supported weapp
-   */
-  onLeavePictureInPicture?: CommonEventFunction
-
-  /**
-   * seek 完成时触发
-   * @supported weapp, tt
-   */
-  onSeekComplete?: CommonEventFunction
-
   /** 用于透传 `WebComponents` 上的属性到内部 H5 标签上
    * @supported h5
    */
@@ -326,16 +261,6 @@ interface VideoProps extends StandardProps {
    */
   licenseUrl?: string
 
-  /** 视频进入和退出全屏时触发
-   * @supported weapp, alipay, swan, tt, qq, jd
-   */
-  onFullScreenChange?: CommonEventFunction<VideoProps.onFullscreenChangeEventDetail>
-
-  /** 切换 controls 显示隐藏时触发。
-   * @supported weapp
-   */
-  onControlsToggle?: CommonEventFunction<VideoProps.onControlsToggleEventDetail>
-
   /** 当 poster 高宽比跟视频高宽不匹配时，如何显示 poster，设置规则同 background-size 一致。
    * @supported alipay
    */
@@ -357,31 +282,6 @@ interface VideoProps extends StandardProps {
    */
   mobilenetHintType?: string
 
-  /** 视频出现缓冲时触发。
-   * @supported alipay
-   */
-  onLoading?: CommonEventFunction
-
-  /** 点击视频 view 时触发
-   * @supported alipay
-   */
-  onTap?: CommonEventFunction<VideoProps.onTapEventDetail>
-
-  /** 用户操作事件
-   * @supported alipay
-   */
-  onUserAction?: CommonEventFunction<VideoProps.onUserActionEventDetail>
-
-  /** 视频播放终止。
-   * @supported alipay
-   */
-  onStop?: CommonEventFunction
-
-  /** 当视频加载完真正开始播放时触发。
-   * @supported alipay
-   */
-  onRenderStart?: CommonEventFunction
-
   /** 浮窗设置。暂时不支持全局浮窗。
    * 可选值：
    *
@@ -441,6 +341,111 @@ interface VideoProps extends StandardProps {
    */
   signature?: string
 
+  /** 指定码率上界，单位为比特每秒
+   * @supported weapp
+   */
+  preferredPeakBitRate?: number
+
+  /** 当开始/继续播放时触发 play 事件
+   * @supported weapp, alipay, swan, tt, qq, jd, h5, rn
+   */
+  onPlay?: CommonEventFunction
+
+  /** 当暂停播放时触发 pause 事件
+   * @supported weapp, alipay, swan, tt, qq, jd, h5, rn
+   */
+  onPause?: CommonEventFunction
+
+  /** 当播放到末尾时触发 ended 事件
+   * @supported weapp, alipay, swan, tt, qq, jd, h5, rn
+   */
+  onEnded?: CommonEventFunction
+
+  /** 播放进度变化时触发, 触发频率 250ms 一次
+   * @supported weapp, alipay, swan, tt, qq, jd, h5, rn
+   */
+  onTimeUpdate?: CommonEventFunction<VideoProps.onTimeUpdateEventDetail>
+
+  /** 当视频进入和退出全屏时触发
+   *
+   * @supported h5, rn
+   */
+  onFullscreenChange?: CommonEventFunction<VideoProps.onFullscreenChangeEventDetail>
+
+  /** 视频出现缓冲时触发
+   *
+   * @supported weapp, swan, tt, qq, jd
+   */
+  onWaiting?: CommonEventFunction<VideoProps.onWaitingEventDetail>
+
+  /** 视频播放出错时触发
+   * @supported weapp, alipay, swan, tt, qq, jd, h5, rn
+   */
+  onError?: CommonEventFunction
+
+  /** 加载进度变化时触发，只支持一段加载
+   * @supported weapp, tt, qq, h5
+   */
+  onProgress?: CommonEventFunction<VideoProps.onProgressEventDetail>
+
+  /** 视频元数据加载完成时触发
+   * @supported weapp, swan, tt, jd, rn
+   */
+  onLoadedMetaData?: CommonEventFunction<VideoProps.onLoadedMetaDataEventDetail>
+
+  /**
+   * 播放器进入小窗
+   * @supported weapp
+   */
+  onEnterPictureInPicture?: CommonEventFunction
+
+  /**
+   * 播放器退出小窗
+   * @supported weapp
+   */
+  onLeavePictureInPicture?: CommonEventFunction
+
+  /**
+   * seek 完成时触发
+   * @supported weapp, tt
+   */
+  onSeekComplete?: CommonEventFunction
+
+  /** 视频进入和退出全屏时触发
+   * @supported weapp, alipay, swan, tt, qq, jd
+   */
+  onFullScreenChange?: CommonEventFunction<VideoProps.onFullscreenChangeEventDetail>
+
+  /** 切换 controls 显示隐藏时触发。
+   * @supported weapp
+   */
+  onControlsToggle?: CommonEventFunction<VideoProps.onControlsToggleEventDetail>
+
+  /** 视频出现缓冲时触发。
+   * @supported alipay
+   */
+  onLoading?: CommonEventFunction
+
+  /** 点击视频 view 时触发
+   * @supported alipay
+   */
+  onTap?: CommonEventFunction<VideoProps.onTapEventDetail>
+
+  /** 用户操作事件
+   * @supported alipay
+   */
+  onUserAction?: CommonEventFunction<VideoProps.onUserActionEventDetail>
+
+  /** 视频播放终止。
+   * @supported alipay
+   */
+  onStop?: CommonEventFunction
+
+  /** 当视频加载完真正开始播放时触发。
+   * @supported alipay
+   */
+  onRenderStart?: CommonEventFunction
+
   /** 贴片广告开始播放时触发
    * @supported tt
    */
@@ -464,17 +469,23 @@ interface VideoProps extends StandardProps {
   /** 视频倍速改变完成时触发。返回改变后的倍速值
    * @supported tt
    */
-  onPlayBackRateChange?: CommonEventFunction<{ playbackRate: string }>
+  onPlayBackRateChange?: CommonEventFunction<{
+    playbackRate: string
+  }>
 
   /** 静音状态改变完成时触发。返回当前是否静音
    * @supported tt
    */
-  onMuteChange?: CommonEventFunction<{ isMuted: boolean }>
+  onMuteChange?: CommonEventFunction<{
+    isMuted: boolean
+  }>
 
   /** 点击控件时触发。返回当前点击的控件类型
    * @supported tt
    */
-  onControlTap?: CommonEventFunction<{ controlType }>
+  onControlTap?: CommonEventFunction<{
+    controlType
+  }>
 
   /** 进入小窗播放时触发
    * @supported tt
@@ -511,11 +522,6 @@ interface VideoProps extends StandardProps {
    */
   onSeeking?: CommonEventFunction
 
-  /** 指定码率上界，单位为比特每秒
-   * @supported weapp
-   */
-  preferredPeakBitRate?: number
-
   /** 贴片广告加载成功时触发，event.detail = { adType: 'preRollAd' | 'postRollAd' }
    * @supported tt
    */
@@ -607,14 +613,19 @@ declare namespace VideoProps {
   interface UserActionTag {
     /** 底部播放按钮 */
     play
+
     /** 中心播放按钮 */
     centerplay
+
     /** 静音按钮 */
     mute
+
     /** 全屏按钮 */
     fullscreen
+
     /** 重试按钮 */
     retry
+
     /** 网络提醒的播放按钮 */
     mobilenetplay
   }
@@ -625,10 +636,8 @@ declare namespace VideoProps {
 }
 
 /** 视频。相关api：Taro.createVideoContext
- *
- * 备注：h5上因为没有测试，所以暂时写了“待定”，需要`Video`来确认。
  * @classification media
- * @supported weapp, h5, swan, alipay, tt
+ * @supported weapp, swan, alipay, tt, h5, rn
  * @example_react
  * ```tsx
  * export default class PageView extends Component {

package/types/View.d.ts

@@ -52,6 +52,21 @@ interface ViewProps extends StandardProps {
    */
   animation?: TaroGeneral.IAnyObject
 
+  /** 表示组件的语义角色。设置为 img 时，组件聚焦后读屏软件会朗读出 图像 ；设置为 button 时，聚焦后读屏软件会朗读出 按钮 。详情请参见 aria-component。
+   * @supported alipay
+   */
+  role?: string
+
+  /** 无障碍访问，（角色）标识元素的作用
+   * @supported qq
+   */
+  ariaRole?: string
+
+  /** 无障碍访问，（属性）元素的额外描述
+   * @supported qq
+   */
+  ariaLabel?: string
+
   /** 点击。
    * @supported alipay
    */
@@ -117,20 +132,12 @@ interface ViewProps extends StandardProps {
    */
   onFirstAppear?: CommonEventFunction
 
-  /** 表示组件的语义角色。设置为 img 时，组件聚焦后读屏软件会朗读出 图像 ；设置为 button 时，聚焦后读屏软件会朗读出 按钮 。详情请参见 aria-component。
-   * @supported alipay
-   */
-  role?: string
-
-  /** 无障碍访问，（角色）标识元素的作用
-   * @supported qq
-   */
-  ariaRole?: string
-
-  /** 无障碍访问，（属性）元素的额外描述
-   * @supported qq
+  /** 是否以 catch 的形式绑定 touchmove 事件
+   * @supported weapp, alipay, swan, tt, qq, jd
+   * @version 3.1.0+
+   * @unique
    */
-  ariaLabel?: string
+  catchMove?: boolean
 }
 
 /** 视图容器

package/types/VoipRoom.d.ts

@@ -13,16 +13,16 @@ interface VoipRoomProps extends StandardProps {
    */
   devicePosition?: keyof VoipRoomProps.DevicePosition
 
-  /** 创建对话窗口失败时触发
+  /** 进入房间用户的 openid
+   * @default "none"
    * @supported weapp
    */
-  onError?: CommonEventFunction
+  openId?: string
 
-  /** 进入房间用户的 openid
-   * @default none
+  /** 创建对话窗口失败时触发
    * @supported weapp
    */
-  openid?: string
+  onError?: CommonEventFunction
 }
 declare namespace VoipRoomProps {
   /** 对话窗口类型 */

package/types/WebView.d.ts

@@ -6,6 +6,17 @@ interface WebViewProps extends StandardProps {
    */
   src: string
 
+  /** webview 的进度条颜色
+   * @supported tt
+   */
+  progressbarColor?: string
+
+  /** 若使用web-view组件引入第三方客服，必须填写type="im"
+   * @supported tt
+   * @default default
+   */
+  type?: string
+
   /** 网页向小程序 postMessage 时，会在特定时机（小程序后退、组件销毁、分享）触发并收到消息。e.detail = { data }
    * @supported weapp, alipay, swan, tt, qq, jd
    */
@@ -20,11 +31,6 @@ interface WebViewProps extends StandardProps {
    * @supported weapp, alipay, tt, qq, h5, rn
    */
   onError?: CommonEventFunction<WebViewProps.onErrorEventDetail>
-
-  /** webview 的进度条颜色
-   * @supported tt
-   */
-  progressbarColor?: string
 }
 declare namespace WebViewProps {
   interface onMessageEventDetail {