@tarojs/components 3.6.2 → 3.6.3

package/types/PageMeta.d.ts

@@ -5,71 +5,58 @@ interface PageMetaProps extends StandardProps {
    * @supported weapp
    */
   backgroundTextStyle?: string
-
   /** 窗口的背景色，必须为十六进制颜色值
    * @supported weapp, alipay
    */
   backgroundColor?: string
-
   /** 顶部窗口的背景色，必须为十六进制颜色值，仅 iOS 支持
    * @supported weapp, alipay
    */
   backgroundColorTop?: string
-
   /** 底部窗口的背景色，必须为十六进制颜色值，仅 iOS 支持
    * @supported weapp, alipay
    */
   backgroundColorBottom?: string
-
   /** 滚动位置，可以使用 px 或者 rpx 为单位，在被设置时，页面会滚动到对应位置
    * @default ""
    * @supported weapp, alipay
    */
   scrollTop?: string
-
   /** 滚动动画时长
    * @default 300
    * @supported weapp, alipay
    */
   scrollDuration?: number
-
   /** 页面根节点样式，页面根节点是所有页面节点的祖先节点，相当于 HTML 中的 body 节点
    * @default ""
    * @supported weapp, alipay
    */
   pageStyle?: string
-
   /** 页面的根字体大小，页面中的所有 rem 单位，将使用这个字体大小作为参考值，即 1rem 等于这个字体大小
    * @default ""
    * @supported weapp, alipay
    */
   rootFontSize?: string
-
   /** 页面内容的背景色，用于页面中的空白部分和页面大小变化 resize 动画期间的临时空闲区域
    * @supported weapp, alipay
    */
   rootBackgroundColor?: string
-
   /** 页面 page 的字体大小，可以设置为 system ，表示使用当前用户设置的微信字体大小
    * @supported weapp, alipay
    */
   pageFontSize?: string
-
   /** 页面的方向，可为 auto portrait 或 landscape
    * @supported weapp
    */
   pageOrientation?: string
-
   /** 页面尺寸变化时会触发 resize 事件
    * @supported weapp
    */
   onResize?: CommonEventFunction<PageMetaProps.onResizeEventDetail>
-
   /** 页面滚动时会触发 scroll 事件
    * @supported weapp, alipay
    */
   onScroll?: CommonEventFunction<PageMetaProps.onScrollEventDetail>
-
   /** 如果通过改变 scroll-top 属性来使页面滚动，页面滚动结束后会触发 scrolldone 事件
    * @supported weapp
    */
@@ -80,12 +67,10 @@ declare namespace PageMetaProps {
     /** 窗口尺寸 */
     size: resizeType
   }
-
   /** 窗口尺寸类型 */
   interface resizeType {
     /** 窗口宽度 */
     windowWidth: number
-
     /** 窗口高度 */
     windowHeight: number
   }
@@ -93,7 +78,6 @@ declare namespace PageMetaProps {
     scrollTop: number
   }
 }
-
 /** 页面属性配置节点，用于指定页面的一些属性、监听页面事件。只能是页面内的第一个节点。可以配合 navigation-bar 组件一同使用。
  * 通过这个节点可以获得类似于调用 Taro.setBackgroundTextStyle Taro.setBackgroundColor 等接口调用的效果。
  * @supported weapp, alipay

package/types/Picker.d.ts

@@ -1,7 +1,6 @@
 import { ComponentType } from 'react'
 import { StyleProp, TextStyle, ViewStyle } from 'react-native'
 import { StandardProps, CommonEventFunction, FormItemProps } from './common'
-
 /** 选择器通用参数 */
 interface PickerStandardProps extends StandardProps, FormItemProps {
   /**
@@ -10,14 +9,12 @@ 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
@@ -29,60 +26,49 @@ declare namespace PickerStandardProps {
   interface Mode {
     /** 普通选择器 */
     selector
-
     /** 多列选择器 */
     multiSelector
-
     /** 时间选择器 */
     time
-
     /** 日期选择器 */
     date
-
     /** 省市区选择器 */
     region
   }
 }
-
 /** 普通选择器：mode = selector */
 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 事件
    * @supported weapp, h5, rn
@@ -95,52 +81,44 @@ declare namespace PickerSelectorProps {
     value: string | number
   }
 }
-
 /** 多列选择器：mode = multiSelector */
 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 事件
    * @supported weapp, h5, rn
    */
   onChange: CommonEventFunction<PickerMultiSelectorProps.ChangeEventDetail>
-
   /**
    * 列改变时触发
    * @supported weapp, h5, rn
@@ -155,35 +133,29 @@ declare namespace PickerMultiSelectorProps {
   interface ColumnChangeEventDetail {
     /** 表示改变了第几列（下标从0开始） */
     column: number
-
     /** 表示变更值的下标 */
     value: number
   }
 }
-
 /** 时间选择器：mode = time */
 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 事件
    * @supported weapp, h5, rn
@@ -196,38 +168,32 @@ declare namespace PickerTimeProps {
     value: string
   }
 }
-
 /** 日期选择器：mode = date */
 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 事件
    * @supported weapp, h5, rn
@@ -238,10 +204,8 @@ declare namespace PickerDateProps {
   interface Fields {
     /** 选择器粒度为年 */
     year
-
     /** 选择器粒度为月份 */
     month
-
     /** 选择器粒度为天 */
     day
   }
@@ -250,31 +214,32 @@ declare namespace PickerDateProps {
     value: string
   }
 }
-
 /** 省市区选择器：mode = region */
 interface PickerRegionProps extends PickerStandardProps {
   /** 选择器类型 */
   mode: 'region'
-
   /**
    * 表示选中的省市区，默认选中每一列的第一个值
    * @supported weapp, h5, rn
    * @default []
    */
-  value: string[]
-
+  value?: string[]
   /**
    * 可为每一列的顶部添加一个自定义的项
    * @supported weapp, h5, rn
    */
   customItem?: string
-
+  /**
+   * 选择器层级
+   * @supported weapp
+   * @default "region"
+   */
+  level?: keyof PickerRegionProps.Level
   /**
    * 自定义省市区数据
    * @supported rn
    */
   regionData?: PickerRegionProps.RegionData[]
-
   /**
    * value 改变时触发 change 事件
    * @supported weapp, h5, rn
@@ -285,10 +250,8 @@ declare namespace PickerRegionProps {
   interface ChangeEventDetail {
     /** 表示选中的省市区 */
     value: string[]
-
     /** 统计用区划代码 */
     code: string[]
-
     /** 邮政编码 */
     postcode?: string
   }
@@ -297,8 +260,17 @@ declare namespace PickerRegionProps {
     code: string
     postcode?: string
   }
+  interface Level {
+    /** 省级选择器 */
+    province
+    /** 市级选择器 */
+    city
+    /** 区级选择器 */
+    region
+    /** 街道选择器 */
+    'sub-district'
+  }
 }
-
 /**
  * 从底部弹起的滚动选择器
  * @classification forms

package/types/PickerView.d.ts

@@ -5,53 +5,43 @@ interface PickerViewProps extends StandardProps {
    * @supported weapp, alipay, swan, tt, qq, jd, rn
    */
   value?: number[]
-
   /** 设置选择器中间选中框的样式
    * @supported weapp, alipay, swan, tt, qq, jd, rn
    */
   indicatorStyle?: string
-
   /** 设置选择器中间选中框的类名
    * @supported weapp, alipay, swan, tt, qq, jd
    */
   indicatorClass?: string
-
   /** 设置蒙层的样式
    * @supported weapp, alipay, swan, tt, qq, jd
    */
   maskStyle?: string
-
   /** 设置蒙层的类名
    * @supported weapp, alipay, swan, tt, qq, jd
    */
   maskClass?: string
-
   /** 是否在手指松开时立即触发 change 事件。若不开启则会在滚动动画结束后触发 change 事件。
-   * @supported weapp, tt
+   * @supported weapp, alipay, tt
    * @default false
    */
   immediateChange?: boolean
-
   /** 选择器标题，建议标题控制在 12 个中文汉字长度内，避免出现截断现象, 截断部分将以 ... 形式展示
    * @supported swan
    */
   title?: string
-
   /** 无障碍访问，（属性）元素的额外描述
    * @supported qq
    */
   ariaLabel?: string
-
   /** 当滚动选择，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, alipay, tt, qq
    */
   onPickStart?: CommonEventFunction
-
   /** 当滚动选择结束时候触发事件
    * @supported weapp, alipay, tt, qq
    */
@@ -62,7 +52,6 @@ declare namespace PickerViewProps {
     value: number[]
   }
 }
-
 /** 嵌入页面的滚动选择器
  * 其中只可放置 picker-view-column 组件，其它节点不会显示
  * @classification forms

package/types/Progress.d.ts

@@ -5,55 +5,46 @@ interface ProgressProps extends StandardProps {
    * @supported weapp, alipay, swan, tt, qq, jd, h5, rn
    */
   percent?: number
-
   /** 在进度条右侧显示百分比
    * @default false
    * @supported weapp, alipay, swan, qq, jd, h5, rn
    */
   showInfo?: boolean
-
   /** 圆角大小
    * @default 0
    * @supported weapp, swan, qq, jd, h5
    */
   borderRadius?: number | string
-
   /** 右侧百分比字体大小
    * @default 16
    * @supported weapp, swan, qq, jd, h5
    */
   fontSize?: number | string
-
   /** 进度条线的宽度
    * @default 6
    * @supported weapp, alipay, swan, tt, qq, jd, h5, rn
    */
   strokeWidth?: number | string
-
   /** 进度条颜色 (请使用 activeColor)
    * @default "#09BB07"
    * @supported weapp, swan, qq, jd, h5
    */
   color?: string
-
   /** 已选择的进度条的颜色
    * @default "#09BB07"
    * @supported weapp, alipay, swan, tt, qq, jd, h5, rn
    */
   activeColor?: string
-
   /** 未选择的进度条的颜色
    * @default "#EBEBEB"
    * @supported weapp, alipay, swan, tt, qq, jd, h5, rn
    */
   backgroundColor?: string
-
   /** 进度条从左往右的动画
    * @default false
    * @supported weapp, alipay, swan, tt, qq, jd, h5, rn
    */
   active?: boolean
-
   /** backwards: 动画从头播
    *
    * forwards: 动画从上次结束点接着播
@@ -61,24 +52,20 @@ interface ProgressProps extends StandardProps {
    * @supported weapp, swan, tt, qq, jd, h5, rn
    */
   activeMode?: 'backwards' | 'forwards'
-
   /** 进度增加 1% 所需毫秒数
    * @default 30
    * @supported weapp, swan, jd, h5
    */
   duration?: number
-
   /** 无障碍访问，（属性）元素的额外描述
    * @supported qq
    */
   ariaLabel?: string
-
   /** 动画完成事件
    * @supported weapp, qq, jd, h5
    */
   onActiveEnd?: CommonEventFunction
 }
-
 /** 进度条。组件属性的长度单位默认为 px
  * @classification base
  * @supported weapp, alipay, swan, tt, qq, jd, h5, rn, harmony

package/types/Radio.d.ts

@@ -2,38 +2,32 @@ 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, rn
+   * @supported weapp, alipay, swan, tt, qq, jd, h5, rn
    */
   value?: string
-
   /** 当前是否选中
    * @default false
    * @supported weapp, alipay, swan, tt, qq, jd, h5, rn
    */
   checked?: boolean
-
   /** 是否禁用
    * @default false
    * @supported weapp, alipay, swan, tt, qq, jd, h5, rn
    */
   disabled?: boolean
-
   /** Radio 的颜色，同 css 的 color
    * @default "#09BB07"
    * @supported weapp, alipay, swan, tt, qq, jd, rn
    */
   color?: string
-
   /** 用于透传 `WebComponents` 上的属性到内部 H5 标签上
    * @supported h5
    */
   nativeProps?: Record<string, unknown>
-
   /** 无障碍访问，（属性）元素的额外描述
    * @supported qq
    */
   ariaLabel?: string
-
   /** <radio-group/> 中的选中项发生变化时触发 change 事件
    * @supported h5, rn
    */
@@ -41,7 +35,6 @@ interface RadioProps extends StandardProps {
     value?: string
   }>
 }
-
 /** 单选项目
  * @classification forms
  * @supported weapp, alipay, swan, tt, qq, h5, rn, harmony

package/types/RadioGroup.d.ts

@@ -5,7 +5,6 @@ interface RadioGroupProps extends StandardProps, FormItemProps {
    * @supported alipay, tt
    */
   name?: string
-
   /** RadioGroup 中选中项发生改变时触发 change 事件，detail = {value:[选中的radio的value的数组]}
    * @supported weapp, alipay, swan, tt, qq, jd, h5
    */
@@ -16,7 +15,6 @@ declare namespace RadioGroupProps {
     value: string[]
   }
 }
-
 /** 单项选择器，内部由多个 Radio 组成。
  * @classification forms
  * @supported weapp, alipay, swan, tt, qq, jd, h5, rn, harmony

package/types/RichText.d.ts

@@ -6,63 +6,51 @@ interface RichTextProps extends StandardProps {
    * @supported weapp
    */
   userSelect?: boolean
-
   /** 节点列表/ HTML String */
   nodes?: Nodes
-
   /** 显示连续空格
-   * @supported weapp, qq, rn
+   * @supported weapp, alipay, qq, rn
    */
   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
    */
   onTap?: CommonEventFunction
-
   /** 触摸动作开始。
    * @supported alipay
    */
   onTouchstart?: CommonEventFunction
-
   /** 触摸移动事件。
    * @supported alipay
    */
   onTouchmove?: CommonEventFunction
-
   /** 触摸动作被打断。
    * @supported alipay
    */
   onTouchcancel?: CommonEventFunction
-
   /** 触摸动作结束。
    * @supported alipay
    */
   onTouchend?: CommonEventFunction
-
   /** 触摸后，超过 500ms 再离开。
    * @supported alipay
    */
   onLongtap?: CommonEventFunction
 }
-
 /** 节点类型
  * > 现支持两种节点，通过type来区分，分别是元素节点和文本节点，默认是元素节点，在富文本区域里显示的HTML节点 元素节点：type = node*
  */
@@ -72,50 +60,41 @@ declare namespace RichTextProps {
   interface TSpace {
     /** 中文字符空格一半大小 */
     ensp
-
     /** 中文字符空格大小 */
     emsp
-
     /** 根据字体设置的空格大小 */
     nbsp
   }
-
   /** 文本节点 */
   interface Text {
     /** 文本类型 */
     type: 'text'
-
     /** 文本字符串
      * @remarks 支持 entities
      * @default ""
      */
     text: string
   }
-
   /** 元素节点，默认为元素节点
    * 全局支持class和style属性，不支持 id 属性。
    */
   interface HTMLElement {
     /** HTML 类型 */
     type?: 'node'
-
     /** 标签名
      * @remarks 支持部分受信任的 HTML 节点
      */
     name: string
-
     /** 属性
      * @remarks 支持部分受信任的属性，遵循 Pascal 命名法
      */
     attrs?: Object
-
     /** 子节点列表
      * @remarks 结构和 nodes 一致
      */
     children?: Nodes
   }
 }
-
 /** 富文本
  * @classification base
  * @supported weapp, swan, alipay, tt, h5, rn, harmony