@tarojs/components 3.5.5 → 3.5.6

package/types/PageMeta.d.ts

@@ -1,6 +1,5 @@
 import { ComponentType } from 'react'
 import { StandardProps, CommonEventFunction } from './common'
-
 interface PageMetaProps extends StandardProps {
   /** 下拉背景字体、loading 图的样式，仅支持 dark 和 light
    * @supported weapp
@@ -8,51 +7,51 @@ interface PageMetaProps extends StandardProps {
   backgroundTextStyle?: string
 
   /** 窗口的背景色，必须为十六进制颜色值
-   * @supported weapp
+   * @supported weapp, alipay
    */
   backgroundColor?: string
 
   /** 顶部窗口的背景色，必须为十六进制颜色值，仅 iOS 支持
-   * @supported weapp
+   * @supported weapp, alipay
    */
   backgroundColorTop?: string
 
   /** 底部窗口的背景色，必须为十六进制颜色值，仅 iOS 支持
-   * @supported weapp
+   * @supported weapp, alipay
    */
   backgroundColorBottom?: string
 
   /** 滚动位置，可以使用 px 或者 rpx 为单位，在被设置时，页面会滚动到对应位置
    * @default ""
-   * @supported weapp
+   * @supported weapp, alipay
    */
   scrollTop?: string
 
   /** 滚动动画时长
    * @default 300
-   * @supported weapp
+   * @supported weapp, alipay
    */
   scrollDuration?: number
 
   /** 页面根节点样式，页面根节点是所有页面节点的祖先节点，相当于 HTML 中的 body 节点
    * @default ""
-   * @supported weapp
+   * @supported weapp, alipay
    */
   pageStyle?: string
 
   /** 页面的根字体大小，页面中的所有 rem 单位，将使用这个字体大小作为参考值，即 1rem 等于这个字体大小
    * @default ""
-   * @supported weapp
+   * @supported weapp, alipay
    */
   rootFontSize?: string
 
-  /** 页面尺寸变化时会触发 resize 事件，event.detail = { size: { windowWidth, windowHeight } }
+  /** 页面尺寸变化时会触发 resize 事件
    * @supported weapp
    */
   onResize?: CommonEventFunction<PageMetaProps.onResizeEventDetail>
 
-  /** 页面滚动时会触发 scroll 事件，event.detail = { scrollTop }
-   * @supported weapp
+  /** 页面滚动时会触发 scroll 事件
+   * @supported weapp, alipay
    */
   onScroll?: CommonEventFunction<PageMetaProps.onScrollEventDetail>
 
@@ -60,17 +59,33 @@ interface PageMetaProps extends StandardProps {
    * @supported weapp
    */
   onScrollDone?: CommonEventFunction
-}
 
+  /** 页面内容的背景色，用于页面中的空白部分和页面大小变化 resize 动画期间的临时空闲区域
+   * @supported weapp, alipay
+   */
+  rootBackgroundColor?: string
+
+  /** 页面 page 的字体大小，可以设置为 system ，表示使用当前用户设置的微信字体大小
+   * @supported weapp, alipay
+   */
+  pageFontSize?: string
+
+  /** 页面的方向，可为 auto portrait 或 landscape
+   * @supported weapp
+   */
+  pageOrientation?: string
+}
 declare namespace PageMetaProps {
   interface onResizeEventDetail {
     /** 窗口尺寸 */
     size: resizeType
   }
+
   /** 窗口尺寸类型 */
   interface resizeType {
     /** 窗口宽度 */
     windowWidth: number
+
     /** 窗口高度 */
     windowHeight: number
   }
@@ -85,5 +100,4 @@ declare namespace PageMetaProps {
  * @see https://developers.weixin.qq.com/miniprogram/dev/component/page-meta.html
  */
 declare const PageMeta: ComponentType<PageMetaProps>
-
 export { PageMeta, PageMetaProps }

package/types/Picker.d.ts

@@ -10,30 +10,35 @@ interface PickerStandardProps extends StandardProps, FormItemProps {
    * @supported weapp, h5, rn
    */
   mode?: keyof PickerStandardProps.Mode
+
   /**
    * 是否禁用
    * @default false
    * @supported weapp, h5, rn
    */
   disabled?: boolean
+
   /**
    * 取消选择或点遮罩层收起 picker 时触发
    * @supported weapp, h5, rn
    */
   onCancel?: CommonEventFunction
 }
-
 declare namespace PickerStandardProps {
   /** 选择器类型 */
   interface Mode {
     /** 普通选择器 */
     selector
+
     /** 多列选择器 */
     multiSelector
+
     /** 时间选择器 */
     time
+
     /** 日期选择器 */
     date
+
     /** 省市区选择器 */
     region
   }
@@ -43,42 +48,47 @@ declare namespace PickerStandardProps {
 interface PickerSelectorProps extends PickerStandardProps {
   /** 选择器类型 */
   mode?: 'selector'
+
   /**
    * mode为 selector 或 multiSelector 时，range 有效
    * @supported weapp, h5, rn
    * @default []
    */
   range: string[] | number[] | Record<string, any>[]
+
   /**
    * 当 range 是一个 Object Array 时，通过 rangeKey 来指定 Object 中 key 的值作为选择器显示内容
    * @supported weapp, h5, rn
    */
   rangeKey?: string
+
   /**
    * 表示选择了 range 中的第几个（下标从 0 开始）
    * @supported weapp, h5, rn
    * @default 0
    */
   value?: number
+
   /**
    * mode为 selector 或 multiSelector 时 itemStyle 有效
    * @supported rn
    * @default {}
    */
   itemStyle?: StyleProp<TextStyle>
+
   /**
    * mode为 selector 或 multiSelector 时 indicatorStyle 有效
    * @supported rn
    * @default {}
    */
   indicatorStyle?: StyleProp<ViewStyle>
+
   /**
-   * value 改变时触发 change 事件，event.detail = {value}
+   * value 改变时触发 change 事件
    * @supported weapp, h5, rn
    */
   onChange: CommonEventFunction<PickerSelectorProps.ChangeEventDetail>
 }
-
 declare namespace PickerSelectorProps {
   interface ChangeEventDetail {
     /** 表示变更值的下标 */
@@ -90,47 +100,53 @@ declare namespace PickerSelectorProps {
 interface PickerMultiSelectorProps extends PickerStandardProps {
   /** 选择器类型 */
   mode: 'multiSelector'
+
   /**
    * mode为 selector 或 multiSelector 时，range 有效
    * @supported weapp, h5, rn
    * @default []
    */
   range: Array<string[]> | Array<number[]> | Array<Record<string, any>[]>
+
   /**
    * 当 range 是一个 Object Array 时，通过 rangeKey 来指定 Object 中 key 的值作为选择器显示内容
    * @supported weapp, h5, rn
    */
   rangeKey?: string
+
   /**
    * 表示选择了 range 中的第几个（下标从 0 开始）
    * @supported weapp, h5, rn
    * @default []
    */
   value: number[] | string[] | Record<string, any>[]
+
   /**
    * mode为 selector 或 multiSelector 时 itemStyle 有效
    * @supported rn
    * @default {}
    */
   itemStyle?: StyleProp<TextStyle>
+
   /**
    * mode为 selector 或 multiSelector 时 indicatorStyle 有效
    * @supported rn
    * @default {}
    */
   indicatorStyle?: StyleProp<ViewStyle>
+
   /**
-   * 当 value 改变时触发 change 事件，event.detail = {value}
+   * 当 value 改变时触发 change 事件
    * @supported weapp, h5, rn
    */
   onChange: CommonEventFunction<PickerMultiSelectorProps.ChangeEventDetail>
+
   /**
    * 列改变时触发
    * @supported weapp, h5, rn
    */
   onColumnChange?: CommonEventFunction<PickerMultiSelectorProps.ColumnChangeEventDetail>
 }
-
 declare namespace PickerMultiSelectorProps {
   interface ChangeEventDetail {
     /** 表示变更值的下标 */
@@ -139,6 +155,7 @@ declare namespace PickerMultiSelectorProps {
   interface ColumnChangeEventDetail {
     /** 表示改变了第几列（下标从0开始） */
     column: number
+
     /** 表示变更值的下标 */
     value: number
   }
@@ -148,28 +165,31 @@ declare namespace PickerMultiSelectorProps {
 interface PickerTimeProps extends PickerStandardProps {
   /** 选择器类型 */
   mode: 'time'
+
   /**
    * value 的值表示选择了 range 中的第几个（下标从 0 开始）
    * @supported weapp, h5, rn
    */
   value: string
+
   /**
    * 仅当 mode = time|date 时有效，表示有效时间范围的开始，字符串格式为"hh:mm"
    * @supported weapp, h5, rn
    */
   start?: string
+
   /**
    * 仅当 mode = time|date 时有效，表示有效时间范围的结束，字符串格式为"hh:mm"
    * @supported weapp, h5, rn
    */
   end?: string
+
   /**
-   * value 改变时触发 change 事件，event.detail = {value}
+   * value 改变时触发 change 事件
    * @supported weapp, h5, rn
    */
   onChange: CommonEventFunction<PickerTimeProps.ChangeEventDetail>
 }
-
 declare namespace PickerTimeProps {
   interface ChangeEventDetail {
     /** 表示选中的时间 */
@@ -181,41 +201,47 @@ declare namespace PickerTimeProps {
 interface PickerDateProps extends PickerStandardProps {
   /** 选择器类型 */
   mode: 'date'
+
   /**
    * 表示选中的日期，格式为"YYYY-MM-DD"
    * @supported weapp, h5, rn
    * @default 0
    */
   value: string
+
   /**
    * 仅当 mode = time|date 时有效，表示有效时间范围的开始，字符串格式为"hh:mm"
    * @supported weapp, h5, rn
    */
   start?: string
+
   /**
    * 仅当 mode = time|date 时有效，表示有效时间范围的结束，字符串格式为"hh:mm"
    * @supported weapp, h5, rn
    */
   end?: string
+
   /**
    * 有效值 year, month, day，表示选择器的粒度
    * @supported weapp, h5, rn
    * @default "day"
    */
   fields?: keyof PickerDateProps.Fields
+
   /**
-   * value 改变时触发 change 事件，event.detail = {value}
+   * value 改变时触发 change 事件
    * @supported weapp, h5, rn
    */
   onChange: CommonEventFunction<PickerDateProps.ChangeEventDetail>
 }
-
 declare namespace PickerDateProps {
   interface Fields {
     /** 选择器粒度为年 */
     year
+
     /** 选择器粒度为月份 */
     month
+
     /** 选择器粒度为天 */
     day
   }
@@ -229,35 +255,40 @@ declare namespace PickerDateProps {
 interface PickerRegionProps extends PickerStandardProps {
   /** 选择器类型 */
   mode: 'region'
+
   /**
    * 表示选中的省市区，默认选中每一列的第一个值
    * @supported weapp, h5, rn
    * @default []
    */
   value: string[]
+
   /**
    * 可为每一列的顶部添加一个自定义的项
    * @supported weapp, h5, rn
    */
   customItem?: string
+
   /**
    * 自定义省市区数据
    * @supported rn
    */
   regionData?: PickerRegionProps.RegionData[]
+
   /**
-   * value 改变时触发 change 事件，event.detail = {value, code, postcode}，其中字段 code 是统计用区划代码，postcode 是邮政编码
+   * value 改变时触发 change 事件
    * @supported weapp, h5, rn
    */
   onChange: CommonEventFunction<PickerRegionProps.ChangeEventDetail>
 }
-
 declare namespace PickerRegionProps {
   interface ChangeEventDetail {
     /** 表示选中的省市区 */
     value: string[]
+
     /** 统计用区划代码 */
     code: string[]
+
     /** 邮政编码 */
     postcode?: string
   }
@@ -404,8 +435,13 @@ declare namespace PickerRegionProps {
  * ```
  * @see https://developers.weixin.qq.com/miniprogram/dev/component/picker.html
  */
-declare const Picker: ComponentType<PickerMultiSelectorProps | PickerTimeProps | PickerDateProps | PickerRegionProps | PickerSelectorProps>
-
+declare const Picker: ComponentType<
+  | PickerMultiSelectorProps
+  | PickerTimeProps
+  | PickerDateProps
+  | PickerRegionProps
+  | PickerSelectorProps
+>
 export {
   Picker,
   PickerStandardProps,
@@ -413,5 +449,5 @@ export {
   PickerMultiSelectorProps,
   PickerTimeProps,
   PickerDateProps,
-  PickerRegionProps
+  PickerRegionProps,
 }

package/types/PickerView.d.ts

@@ -1,55 +1,74 @@
 import { ComponentType } from 'react'
 import { StandardProps, CommonEventFunction } from './common'
-
 interface PickerViewProps extends StandardProps {
-
   /** 数组中的数字依次表示 picker-view 内的 picker-view-column 选择的第几项（下标从 0 开始），数字大于 picker-view-column 可选项长度时，选择最后一项。
-   * @supported weapp, swan, alipay, tt, rn
+   * @supported weapp, alipay, swan, tt, qq, jd, rn
    */
   value?: number[]
 
   /** 设置选择器中间选中框的样式
-   * @supported weapp, swan, alipay, tt, rn
+   * @supported weapp, alipay, swan, tt, qq, jd, rn
    */
   indicatorStyle?: string
 
   /** 设置选择器中间选中框的类名
-   * @supported weapp, swan, alipay
+   * @supported weapp, alipay, swan, tt, qq, jd
    */
   indicatorClass?: string
 
   /** 设置蒙层的样式
-   * @supported weapp, swan, alipay, tt
+   * @supported weapp, alipay, swan, tt, qq, jd
    */
   maskStyle?: string
 
   /** 设置蒙层的类名
-   * @supported weapp, swan, alipay
+   * @supported weapp, alipay, swan, tt, qq, jd
    */
   maskClass?: string
 
   /** 是否在手指松开时立即触发 change 事件。若不开启则会在滚动动画结束后触发 change 事件。
-   * @supported weapp
+   * @supported weapp, tt
    * @default false
    */
   immediateChange?: boolean
 
   /** 当滚动选择，value 改变时触发 change 事件，event.detail = {value: value}；value为数组，表示 picker-view 内的 picker-view-column 当前选择的是第几项（下标从 0 开始）
-   * @supported weapp, swan, alipay, tt, rn
+   * @supported weapp, alipay, swan, tt, qq, jd, rn
    */
   onChange?: CommonEventFunction<PickerViewProps.onChangeEventDetail>
 
   /** 当滚动选择开始时候触发事件
-   * @supported weapp
+   * @supported weapp, tt, qq
    */
   onPickStart?: CommonEventFunction
 
   /** 当滚动选择结束时候触发事件
-   * @supported weapp
+   * @supported weapp, tt, qq
    */
   onPickEnd?: CommonEventFunction
-}
 
+  /** 选择器标题，建议标题控制在 12 个中文汉字长度内，避免出现截断现象, 截断部分将以 ... 形式展示
+   * @supported swan
+   */
+  title?: string
+
+  /** 无障碍访问，（属性）元素的额外描述
+   * @supported qq
+   */
+  ariaLabel?: string
+
+  /** 当滚动选择开始时候触发事件。
+   * 版本要求： 基础库 2.7.23 及以上
+   * @supported alipay
+   */
+  onPickerStart?: CommonEventFunction
+
+  /** 当滚动选择结束时候触发事件。
+   * 版本要求： 基础库 2.7.23 及以上
+   * @supported alipay
+   */
+  onPickerEnd?: CommonEventFunction
+}
 declare namespace PickerViewProps {
   interface onChangeEventDetail {
     value: number[]
@@ -194,5 +213,4 @@ declare namespace PickerViewProps {
  * @see https://developers.weixin.qq.com/miniprogram/dev/component/picker-view.html
  */
 declare const PickerView: ComponentType<PickerViewProps>
-
 export { PickerView, PickerViewProps }

package/types/PickerViewColumn.d.ts

@@ -1,6 +1,5 @@
 import { ComponentType } from 'react'
 import { StandardProps } from './common'
-
 type PickerViewColumnProps = StandardProps
 
 /** 滚动选择器子项
@@ -10,5 +9,4 @@ type PickerViewColumnProps = StandardProps
  * @see https://developers.weixin.qq.com/miniprogram/dev/component/picker-view-column.html
  */
 declare const PickerViewColumn: ComponentType<StandardProps>
-
 export { PickerViewColumn, PickerViewColumnProps }

package/types/Progress.d.ts

@@ -1,57 +1,56 @@
 import { ComponentType } from 'react'
 import { StandardProps, CommonEventFunction } from './common'
-
 interface ProgressProps extends StandardProps {
   /** 百分比 0~100
-   * @supported weapp, swan, alipay, tt, h5, rn
+   * @supported weapp, alipay, swan, tt, qq, jd, h5, rn
    */
   percent?: number
 
   /** 在进度条右侧显示百分比
    * @default false
-   * @supported weapp, swan, alipay, h5, rn
+   * @supported weapp, alipay, swan, qq, jd, h5, rn
    */
   showInfo?: boolean
 
   /** 圆角大小
    * @default 0
-   * @supported weapp, h5
+   * @supported weapp, swan, qq, jd, h5
    */
   borderRadius?: number | string
 
   /** 右侧百分比字体大小
    * @default 16
-   * @supported weapp, h5
+   * @supported weapp, swan, qq, jd, h5
    */
   fontSize?: number | string
 
   /** 进度条线的宽度
    * @default 6
-   * @supported weapp, swan, alipay, tt, h5, rn
+   * @supported weapp, alipay, swan, tt, qq, jd, h5, rn
    */
   strokeWidth?: number | string
 
   /** 进度条颜色 (请使用 activeColor)
    * @default "#09BB07"
-   * @supported weapp, swan, alipay, h5, tt
+   * @supported weapp, swan, qq, jd, h5
    */
   color?: string
 
   /** 已选择的进度条的颜色
    * @default "#09BB07"
-   * @supported weapp, swan, alipay, tt, h5, rn
+   * @supported weapp, alipay, swan, tt, qq, jd, h5, rn
    */
   activeColor?: string
 
   /** 未选择的进度条的颜色
    * @default "#EBEBEB"
-   * @supported weapp, swan, alipay, tt, h5, rn
+   * @supported weapp, alipay, swan, tt, qq, jd, h5, rn
    */
   backgroundColor?: string
 
   /** 进度条从左往右的动画
    * @default false
-   * @supported weapp, swan, alipay, tt, h5, rn
+   * @supported weapp, alipay, swan, tt, qq, jd, h5, rn
    */
   active?: boolean
 
@@ -59,20 +58,25 @@ interface ProgressProps extends StandardProps {
    *
    * forwards: 动画从上次结束点接着播
    * @default backwards
-   * @supported weapp, swan, tt, rn, h5
+   * @supported weapp, swan, tt, qq, jd, h5, rn
    */
   activeMode?: 'backwards' | 'forwards'
 
   /** 进度增加 1% 所需毫秒数
    * @default 30
-   * @supported weapp, h5
+   * @supported weapp, swan, jd, h5
    */
   duration?: number
 
   /** 动画完成事件
-   * @supported weapp, h5
+   * @supported weapp, qq, jd, h5
    */
   onActiveEnd?: CommonEventFunction
+
+  /** 无障碍访问，（属性）元素的额外描述
+   * @supported qq
+   */
+  ariaLabel?: string
 }
 
 /** 进度条。组件属性的长度单位默认为 px
@@ -111,5 +115,4 @@ interface ProgressProps extends StandardProps {
  * @see https://developers.weixin.qq.com/miniprogram/dev/component/progress.html
  */
 declare const Progress: ComponentType<ProgressProps>
-
 export { Progress, ProgressProps }

package/types/Radio.d.ts

@@ -1,27 +1,26 @@
 import { ComponentType } from 'react'
 import { StandardProps, CommonEventFunction, FormItemProps } from './common'
-
 interface RadioProps extends StandardProps {
   /** `<Radio/>` 标识。当该`<Radio/>` 选中时，`<RadioGroup/>`的 change 事件会携带`<Radio/>`的 value
-   * @supported weapp, rn, tt
+   * @supported weapp, alipay, swan, tt, qq, rn
    */
   value?: string
 
   /** 当前是否选中
    * @default false
-   * @supported weapp, h5, rn, tt
+   * @supported weapp, alipay, swan, tt, qq, h5, rn
    */
   checked?: boolean
 
   /** 是否禁用
    * @default false
-   * @supported weapp, h5, rn, tt
+   * @supported weapp, alipay, swan, tt, qq, h5, rn
    */
   disabled?: boolean
 
   /** Radio 的颜色，同 css 的 color
    * @default "#09BB07"
-   * @supported weapp, rn, tt
+   * @supported weapp, alipay, swan, tt, qq, rn
    */
   color?: string
 
@@ -29,6 +28,18 @@ interface RadioProps extends StandardProps {
    * @supported h5
    */
   nativeProps?: Record<string, unknown>
+
+  /** 无障碍访问，（属性）元素的额外描述
+   * @supported qq
+   */
+  ariaLabel?: string
+
+  /** <radio-group/> 中的选中项发生变化时触发 change 事件，event.detail = {value: 选中项radio的value}
+   * @supported jd
+   */
+  onChange?: CommonEventFunction<{
+    value?: string
+  }>
 }
 
 /** 单选项目
@@ -175,5 +186,4 @@ interface RadioProps extends StandardProps {
  * @see https://developers.weixin.qq.com/miniprogram/dev/component/radio.html
  */
 declare const Radio: ComponentType<RadioProps>
-
 export { Radio, RadioProps }

package/types/RadioGroup.d.ts

@@ -1,13 +1,16 @@
 import { ComponentType } from 'react'
 import { StandardProps, CommonEventFunction, FormItemProps } from './common'
-
 interface RadioGroupProps extends StandardProps, FormItemProps {
   /** RadioGroup 中选中项发生改变时触发 change 事件，detail = {value:[选中的radio的value的数组]}
-   * @supported weapp, h5, tt
+   * @supported weapp, alipay, swan, tt, qq, h5
    */
   onChange?: CommonEventFunction
-}
 
+  /** 组件名字，用于表单提交获取数据。
+   * @supported alipay, tt
+   */
+  name?: string
+}
 declare namespace RadioGroupProps {
   interface onChangeEventDetail {
     value: string[]
@@ -20,5 +23,4 @@ declare namespace RadioGroupProps {
  * @see https://developers.weixin.qq.com/miniprogram/dev/component/radio-group.html
  */
 declare const RadioGroup: ComponentType<RadioGroupProps>
-
 export { RadioGroup, RadioGroupProps }