@tarojs/components 3.5.7 → 3.5.8

package/types/NativeSlot.d.ts

@@ -0,0 +1,32 @@
+import { ComponentType } from 'react'
+
+interface NativeSlotProps {
+  /** 指定插入的 slot 位置
+   * @default none
+   * @supported weapp, swan, alipay, tt, jd, qq
+   */
+  name?: string
+}
+
+/** 编译的原生组件支持使用 slot 插槽
+ * @supported weapp, swan, alipay, tt, jd, qq
+ * @version 3.5.7+
+ * @example
+ * ```tsx
+ * import { NativeSlot, View } from '@tarojs/components'
+ *
+ * export default function () {
+ *   render () {
+ *     return (
+ *       <View>
+ *         <NativeSlot />
+ *       </View>
+ *     )
+ *   }
+ * }
+ * ```
+ * @see https://github.com/NervJS/taro/pull/12627
+ */
+declare const NativeSlot: ComponentType<NativeSlotProps>
+
+export { NativeSlot, NativeSlotProps }

package/types/Navigator.d.ts

@@ -67,6 +67,16 @@ interface NavigatorProps extends StandardProps {
    */
   hoverStayTime?: number
 
+  /** 当target="miniProgram"时有效，当传递该参数后，可以不传 app-id 和 path。链接可以通过【小程序菜单】->【复制链接】获取。
+   * @supported weapp
+   */
+  shortLink?: string
+
+  /** 无障碍访问，（属性）元素的额外描述
+   * @supported qq
+   */
+  ariaLabel?: string
+
   /** 当 `target="miniProgram"` 时有效，跳转小程序成功
    * @supported weapp, swan, qq
    */
@@ -81,16 +91,6 @@ interface NavigatorProps extends StandardProps {
    * @supported weapp, swan, qq
    */
   onComplete?: CommonEventFunction
-
-  /** 当target="miniProgram"时有效，当传递该参数后，可以不传 app-id 和 path。链接可以通过【小程序菜单】->【复制链接】获取。
-   * @supported weapp
-   */
-  shortLink?: string
-
-  /** 无障碍访问，（属性）元素的额外描述
-   * @supported qq
-   */
-  ariaLabel?: string
 }
 declare namespace NavigatorProps {
   /** target 的合法值 */

package/types/OpenData.d.ts

@@ -27,11 +27,6 @@ interface OpenDataProps extends StandardProps {
    */
   defaultAvatar?: string
 
-  /** 群名称或用户信息为空时触发
-   * @supported weapp, tt, qq
-   */
-  onError?: CommonEventFunction
-
   /** 当数据为空且未设置默认值时，是否显示官方默认值
    * @supported tt
    */
@@ -51,6 +46,11 @@ interface OpenDataProps extends StandardProps {
    * @supported qq
    */
   componentData?: string
+
+  /** 群名称或用户信息为空时触发
+   * @supported weapp, tt, qq
+   */
+  onError?: CommonEventFunction
 }
 declare namespace OpenDataProps {
   /** type 的合法值 */

package/types/PageContainer.d.ts

@@ -1,8 +1,5 @@
 import { ComponentType } from 'react'
-import {
-  StandardProps,
-  CommonEventFunction,
-} from './common'
+import { StandardProps, CommonEventFunction } from './common'
 interface PageContainerProps extends StandardProps {
   /** 是否显示容器组件
    * @default false
@@ -50,6 +47,12 @@ interface PageContainerProps extends StandardProps {
    */
   customStyle?: string
 
+  /** 是否在下滑一段距离后关闭
+   * @supported weapp
+   * @default false
+   */
+  closeOnSlideDown?: string
+
   /** 进入前触发
    * @supported weapp, rn
    */
@@ -84,12 +87,6 @@ interface PageContainerProps extends StandardProps {
    * @supported weapp
    */
   onClickOverlay?: CommonEventFunction
-
-  /** 是否在下滑一段距离后关闭
-   * @supported weapp
-   * @default false
-   */
-  closeOnSlideDown?: string
 }
 declare namespace PageContainerProps {
   /** 弹出位置 */

package/types/PageMeta.d.ts

@@ -45,35 +45,35 @@ interface PageMetaProps extends StandardProps {
    */
   rootFontSize?: string
 
-  /** 页面尺寸变化时会触发 resize 事件
-   * @supported weapp
+  /** 页面内容的背景色，用于页面中的空白部分和页面大小变化 resize 动画期间的临时空闲区域
+   * @supported weapp, alipay
    */
-  onResize?: CommonEventFunction<PageMetaProps.onResizeEventDetail>
+  rootBackgroundColor?: string
 
-  /** 页面滚动时会触发 scroll 事件
+  /** 页面 page 的字体大小，可以设置为 system ，表示使用当前用户设置的微信字体大小
    * @supported weapp, alipay
    */
-  onScroll?: CommonEventFunction<PageMetaProps.onScrollEventDetail>
+  pageFontSize?: string
 
-  /** 如果通过改变 scroll-top 属性来使页面滚动，页面滚动结束后会触发 scrolldone 事件
+  /** 页面的方向，可为 auto portrait 或 landscape
    * @supported weapp
    */
-  onScrollDone?: CommonEventFunction
+  pageOrientation?: string
 
-  /** 页面内容的背景色，用于页面中的空白部分和页面大小变化 resize 动画期间的临时空闲区域
-   * @supported weapp, alipay
+  /** 页面尺寸变化时会触发 resize 事件
+   * @supported weapp
    */
-  rootBackgroundColor?: string
+  onResize?: CommonEventFunction<PageMetaProps.onResizeEventDetail>
 
-  /** 页面 page 的字体大小，可以设置为 system ，表示使用当前用户设置的微信字体大小
+  /** 页面滚动时会触发 scroll 事件
    * @supported weapp, alipay
    */
-  pageFontSize?: string
+  onScroll?: CommonEventFunction<PageMetaProps.onScrollEventDetail>
 
-  /** 页面的方向，可为 auto portrait 或 landscape
+  /** 如果通过改变 scroll-top 属性来使页面滚动，页面滚动结束后会触发 scrolldone 事件
    * @supported weapp
    */
-  pageOrientation?: string
+  onScrollDone?: CommonEventFunction
 }
 declare namespace PageMetaProps {
   interface onResizeEventDetail {

package/types/Picker.d.ts

@@ -436,11 +436,7 @@ declare namespace PickerRegionProps {
  * @see https://developers.weixin.qq.com/miniprogram/dev/component/picker.html
  */
 declare const Picker: ComponentType<
-  | PickerMultiSelectorProps
-  | PickerTimeProps
-  | PickerDateProps
-  | PickerRegionProps
-  | PickerSelectorProps
+  PickerMultiSelectorProps | PickerTimeProps | PickerDateProps | PickerRegionProps | PickerSelectorProps
 >
 export {
   Picker,

package/types/PickerView.d.ts

@@ -32,21 +32,6 @@ interface PickerViewProps extends StandardProps {
    */
   immediateChange?: boolean
 
-  /** 当滚动选择，value 改变时触发 change 事件，event.detail = {value: value}；value为数组，表示 picker-view 内的 picker-view-column 当前选择的是第几项（下标从 0 开始）
-   * @supported weapp, alipay, swan, tt, qq, jd, rn
-   */
-  onChange?: CommonEventFunction<PickerViewProps.onChangeEventDetail>
-
-  /** 当滚动选择开始时候触发事件
-   * @supported weapp, tt, qq
-   */
-  onPickStart?: CommonEventFunction
-
-  /** 当滚动选择结束时候触发事件
-   * @supported weapp, tt, qq
-   */
-  onPickEnd?: CommonEventFunction
-
   /** 选择器标题，建议标题控制在 12 个中文汉字长度内，避免出现截断现象, 截断部分将以 ... 形式展示
    * @supported swan
    */
@@ -57,15 +42,20 @@ interface PickerViewProps extends StandardProps {
    */
   ariaLabel?: string
 
-  /** 当滚动选择开始时候触发事件。
-   * @supported alipay
+  /** 当滚动选择，value 改变时触发 change 事件，event.detail = {value: value}；value为数组，表示 picker-view 内的 picker-view-column 当前选择的是第几项（下标从 0 开始）
+   * @supported weapp, alipay, swan, tt, qq, jd, rn
    */
-  onPickerStart?: CommonEventFunction
+  onChange?: CommonEventFunction<PickerViewProps.onChangeEventDetail>
 
-  /** 当滚动选择结束时候触发事件。
-   * @supported alipay
+  /** 当滚动选择开始时候触发事件
+   * @supported weapp, alipay, tt, qq
    */
-  onPickerEnd?: CommonEventFunction
+  onPickStart?: CommonEventFunction
+
+  /** 当滚动选择结束时候触发事件
+   * @supported weapp, alipay, tt, qq
+   */
+  onPickEnd?: CommonEventFunction
 }
 declare namespace PickerViewProps {
   interface onChangeEventDetail {

package/types/Progress.d.ts

@@ -68,15 +68,15 @@ interface ProgressProps extends StandardProps {
    */
   duration?: number
 
-  /** 动画完成事件
-   * @supported weapp, qq, jd, h5
-   */
-  onActiveEnd?: CommonEventFunction
-
   /** 无障碍访问，（属性）元素的额外描述
    * @supported qq
    */
   ariaLabel?: string
+
+  /** 动画完成事件
+   * @supported weapp, qq, jd, h5
+   */
+  onActiveEnd?: CommonEventFunction
 }
 
 /** 进度条。组件属性的长度单位默认为 px

package/types/RadioGroup.d.ts

@@ -1,15 +1,15 @@
 import { ComponentType } from 'react'
 import { StandardProps, CommonEventFunction, FormItemProps } from './common'
 interface RadioGroupProps extends StandardProps, FormItemProps {
-  /** RadioGroup 中选中项发生改变时触发 change 事件，detail = {value:[选中的radio的value的数组]}
-   * @supported weapp, alipay, swan, tt, qq, h5
-   */
-  onChange?: CommonEventFunction
-
   /** 组件名字，用于表单提交获取数据。
    * @supported alipay, tt
    */
   name?: string
+
+  /** RadioGroup 中选中项发生改变时触发 change 事件，detail = {value:[选中的radio的value的数组]}
+   * @supported weapp, alipay, swan, tt, qq, h5
+   */
+  onChange?: CommonEventFunction
 }
 declare namespace RadioGroupProps {
   interface onChangeEventDetail {

package/types/RichText.d.ts

@@ -15,6 +15,23 @@ interface RichTextProps extends StandardProps {
    */
   space?: keyof RichTextProps.TSpace
 
+  /** 富文本是否可以长按选中，可用于复制，粘贴，长按搜索等场景
+   * @default false（基础库 3.150.1 以前版本）true（基础库 3.150.1 及以后版本）
+   * @supported swan
+   */
+  selectable?: string
+
+  /** 阻止长按图片时弹起默认菜单（将该属性设置为image-menu-prevent或image-menu-prevent="true"），只在初始化时有效，不能动态变更；若不想阻止弹起默认菜单，则不需要设置此属性
+   * @default false
+   * @supported swan
+   */
+  imageMenuPrevent?: string
+
+  /** 富文本中的图片是否可点击预览。在不设置的情况下，若 rich-text 未监听点击事件，则默认开启。未显示设置 preview 时会进行点击默认预览判断，建议显示设置 preview
+   * @supported swan
+   */
+  preview?: string
+
   /** 触摸。
    * @supported alipay
    */
@@ -44,23 +61,6 @@ interface RichTextProps extends StandardProps {
    * @supported alipay
    */
   onLongtap?: CommonEventFunction
-
-  /** 富文本是否可以长按选中，可用于复制，粘贴，长按搜索等场景
-   * @default false（基础库 3.150.1 以前版本）true（基础库 3.150.1 及以后版本）
-   * @supported swan
-   */
-  selectable?: string
-
-  /** 阻止长按图片时弹起默认菜单（将该属性设置为image-menu-prevent或image-menu-prevent="true"），只在初始化时有效，不能动态变更；若不想阻止弹起默认菜单，则不需要设置此属性
-   * @default false
-   * @supported swan
-   */
-  imageMenuPrevent?: string
-
-  /** 富文本中的图片是否可点击预览。在不设置的情况下，若 rich-text 未监听点击事件，则默认开启。未显示设置 preview 时会进行点击默认预览判断，建议显示设置 preview
-   * @supported swan
-   */
-  preview?: string
 }
 
 /** 节点类型

package/types/RtcRoom.d.ts

@@ -0,0 +1,104 @@
+import { ComponentType } from 'react'
+import { StandardProps } from './common'
+interface RtcRoomProps extends StandardProps {
+  /** rtc-room 组件的唯一标识符
+   * @supported swan
+   */
+  id?: string
+
+  /** 是否开启摄像头
+   * @supported swan
+   * @default true
+   */
+  enableCamera?: boolean
+
+  /** 是否开启摄像头自动对焦
+   * @supported swan
+   * @default true
+   */
+  enableAutoFocus?: boolean
+
+  /** 是否支持双手滑动调整摄像头聚焦
+   * @supported swan
+   * @default false
+   */
+  enableZoom?: boolean
+
+  /** 设置前置还是后置摄像头，有效值：front、back
+   * @supported swan
+   * @default "front"
+   */
+  devicePosition?: 'front' | 'back'
+
+  /** 是否开启麦克风
+   * @supported swan
+   * @default true
+   */
+  enableMic?: boolean
+
+  /** 是否开启音频自动增益
+   * @supported swan
+   * @default false
+   */
+  enableAgc?: boolean
+
+  /** 是否开启音频噪声抑制
+   * @supported swan
+   * @default false
+   */
+  enableAns?: boolean
+
+  /** 最大码率
+   * @supported swan
+   * @default 900
+   */
+  bitrate?: number
+
+  /** 视频分辨率宽
+   * @supported swan
+   * @default 360
+   */
+  videoWidth?: number
+
+  /** 视频分辨率高
+   * @supported swan
+   * @default 640
+   */
+  videoHeight?: number
+
+  /** 设置远端看到的画面的镜像效果，该属性的变化不会影响到本地画面，仅影响远端看到的画面效果
+   * @supported swan
+   * @default false
+   */
+  enableRemoteMirror?: boolean
+
+  /** 设置本地摄像头预览画面的镜像效果，有效值：auto、enable、disable
+   * @supported swan
+   * @default "auto"
+   */
+  localMirror?: 'auto' | 'enable' | 'disable'
+
+  /** 设置声音输出方式，有效值：speaker、ear
+   * @supported swan
+   * @default "speaker"
+   */
+  soundMode?: 'speaker' | 'ear'
+
+  /** 房间状态变化事件，参考下方状态码，detail = { code, msg, userInfo }
+   * @supported swan
+   */
+  onStateChange?: CommonEventFunction
+
+  /** 错误事件。参考下方错误码，detail = { errMsg, errCode }
+   * @supported swan
+   */
+  onError?: CommonEventFunction
+}
+
+/** 实时音视频通话房间
+ * @classification media
+ * @supported swan
+ * @see https://smartprogram.baidu.com/docs/develop/component/media_rtc-room/
+ */
+declare const RtcRoom: ComponentType<RtcRoomProps>
+export { RtcRoom, RtcRoomProps }

package/types/RtcRoomItem.d.ts

@@ -0,0 +1,26 @@
+import { ComponentType } from 'react'
+import { StandardProps } from './common'
+interface RtcRoomItemProps extends StandardProps {
+  /** rtc-room-item 组件的唯一标识符
+   * @supported swan
+   */
+  id?: string
+
+  /** 指定 item 展示本地 / 远端画面，有效值：local、remote ，不可动态变更
+   * @supported swan
+   */
+  type?: string
+
+  /** item 展示画面的用户 id
+   * @supported swan
+   */
+  userId?: number
+}
+
+/** 实时音视频通话画面
+ * @classification media
+ * @supported swan
+ * @see https://smartprogram.baidu.com/docs/develop/component/media_rtc-room-item/
+ */
+declare const RtcRoomItem: ComponentType<RtcRoomItemProps>
+export { RtcRoomItem, RtcRoomItemProps }

package/types/ScrollView.d.ts

@@ -126,6 +126,38 @@ interface ScrollViewProps extends StandardProps {
    */
   fastDeceleration?: boolean
 
+  /** 当 scroll-with-animation设置为 true 时，可以设置 scroll-animation-duration 来控制动画的执行时间，单位 ms。
+   * @supported alipay
+   */
+  scrollAnimationDuration?: string
+
+  /** 纵向滚动时，当滚动到顶部或底部时，强制禁止触发页面滚动，仍然只触发 scroll-view 自身的滚动。
+   * @supported alipay
+   * @default false
+   */
+  trapScroll?: string
+
+  /** 发生滚动前，对滚动方向进行判断，当方向是顶部/左边时，如果值为 always 将始终禁止滚动，如果值为 out-of-bounds 且当前已经滚动到顶部/左边，禁止滚动。
+   * @supported alipay
+   */
+  disableLowerScroll?: string
+
+  /** 发生滚动前，对滚动方向进行判断，当方向是底部/右边时，如果值为 always 将始终禁止滚动，如果值为 out-of-bounds 且当前已经滚动到底部/右边，禁止滚动。
+   * @supported alipay
+   */
+  disableUpperScroll?: string
+
+  /** 无障碍访问，（属性）元素的额外描述
+   * @supported qq
+   */
+  ariaLabel?: string
+
+  /** 开启 passive 特性，能优化一定的滚动性能
+   * @supported weapp
+   * @default false
+   */
+  enablePassive?: string
+
   /** 滚动到顶部/左边，会触发 scrolltoupper 事件
    * @supported weapp, alipay, swan, tt, qq, jd, h5, rn
    */
@@ -164,28 +196,17 @@ interface ScrollViewProps extends StandardProps {
   /** 滑动开始事件 (同时开启 enhanced 属性后生效)
    * @supported weapp
    */
-  onDragStart?: CommonEventFunction
+  onDragStart?: CommonEventFunction<ScrollViewProps.onDragDetail>
 
   /** 滑动事件 (同时开启 enhanced 属性后生效)
    * @supported weapp
    */
-  onDragging?: CommonEventFunction
+  onDragging?: CommonEventFunction<ScrollViewProps.onDragDetail>
 
-  /** 滑动结束事件 (同时开启 enhanced 属性后生效) detail { scrollTop, scrollLeft, velocity }
+  /** 滑动结束事件 (同时开启 enhanced 属性后生效)
    * @supported weapp
    */
-  onDragend?: CommonEventFunction
-
-  /** 当 scroll-with-animation设置为 true 时，可以设置 scroll-animation-duration 来控制动画的执行时间，单位 ms。
-   * @supported alipay
-   */
-  scrollAnimationDuration?: string
-
-  /** 纵向滚动时，当滚动到顶部或底部时，强制禁止触发页面滚动，仍然只触发 scroll-view 自身的滚动。
-   * @supported alipay
-   * @default false
-   */
-  trapScroll?: string
+  onDragEnd?: CommonEventFunction<ScrollViewProps.onDragDetail>
 
   /** 触摸动作开始。
    * @supported alipay
@@ -206,21 +227,6 @@ interface ScrollViewProps extends StandardProps {
    * @supported alipay
    */
   onTouchCancel?: CommonEventFunction
-
-  /** 发生滚动前，对滚动方向进行判断，当方向是顶部/左边时，如果值为 always 将始终禁止滚动，如果值为 out-of-bounds 且当前已经滚动到顶部/左边，禁止滚动。
-   * @supported alipay
-   */
-  disableLowerScroll?: string
-
-  /** 发生滚动前，对滚动方向进行判断，当方向是底部/右边时，如果值为 always 将始终禁止滚动，如果值为 out-of-bounds 且当前已经滚动到底部/右边，禁止滚动。
-   * @supported alipay
-   */
-  disableUpperScroll?: string
-
-  /** 无障碍访问，（属性）元素的额外描述
-   * @supported qq
-   */
-  ariaLabel?: string
 }
 declare namespace ScrollViewProps {
   interface onScrollDetail {
@@ -238,6 +244,16 @@ declare namespace ScrollViewProps {
     deltaX: number
     deltaY: number
   }
+  interface onDragDetail {
+    /** 横向滚动条位置 */
+    scrollLeft: number
+
+    /** 竖向滚动条位置 */
+    scrollTop: number
+
+    /** 滚动速度 */
+    velocity: number
+  }
 }
 
 /** 可滚动视图区域。使用竖向滚动时，需要给scroll-view一个固定高度，通过 WXSS 设置 height。组件属性的长度单位默认为 px

package/types/Slider.d.ts

@@ -73,16 +73,6 @@ interface SliderProps extends StandardProps, FormItemProps {
    */
   showValue?: boolean
 
-  /** 完成一次拖动后触发的事件
-   * @supported weapp, alipay, swan, tt, qq, jd, h5, rn
-   */
-  onChange?: CommonEventFunction<SliderProps.onChangeEventDetail>
-
-  /** 拖动过程中触发的事件
-   * @supported weapp, alipay, swan, tt, qq, jd, h5, rn
-   */
-  onChanging?: CommonEventFunction<SliderProps.onChangeEventDetail>
-
   /** 组件名字，用于表单提交获取数据。
    * @supported alipay
    */
@@ -109,6 +99,16 @@ interface SliderProps extends StandardProps, FormItemProps {
    * @supported qq
    */
   ariaLabel?: string
+
+  /** 完成一次拖动后触发的事件
+   * @supported weapp, alipay, swan, tt, qq, jd, h5, rn
+   */
+  onChange?: CommonEventFunction<SliderProps.onChangeEventDetail>
+
+  /** 拖动过程中触发的事件
+   * @supported weapp, alipay, swan, tt, qq, jd, h5, rn
+   */
+  onChanging?: CommonEventFunction<SliderProps.onChangeEventDetail>
 }
 declare namespace SliderProps {
   interface onChangeEventDetail {

package/types/Slot.d.ts

@@ -5,7 +5,7 @@ interface SlotProps {
    * @default none
    * @supported weapp, swan, alipay, tt, jd, qq
    */
-  name?: string,
+  name?: string
   /** scoped slot 传入数据源
    * @default none
    * @supported swan