@tarojs/components 3.5.7 → 3.5.8

package/types/Camera.d.ts

@@ -3,48 +3,48 @@ import { StandardProps, CommonEventFunction } from './common'
 interface CameraProps extends StandardProps {
   /** 模式，有效值为normal, scanCode
    * @default "normal"
-   * @supported weapp, tt, qq, jd, rn, alipay
+   * @supported weapp, alipay, tt, qq, jd, rn
    */
   mode?: keyof CameraProps.Mode
 
   /** 分辨率，不支持动态修改
    * @default "medium"
-   * @supported weapp, tt, alipay
+   * @supported weapp, tt
    */
   resolution?: keyof CameraProps.Resolution
 
   /** 摄像头朝向
    * @default "back"
-   * @supported weapp, swan, tt, qq, jd, rn, alipay
+   * @supported weapp, alipay, swan, tt, qq, jd, rn
    */
   devicePosition?: keyof CameraProps.DevicePosition
 
   /** 闪光灯
    * @default "auto"
-   * @supported weapp, swan, tt, qq, jd, rn, alipay
+   * @supported weapp, alipay, swan, tt, qq, jd, rn
    */
   flash?: keyof CameraProps.Flash
 
-  /** 相机拍照，录制的分辨率。有效值为 360P、540P、720P、1080P、max
-   * @default "720P"
-   * @supported alipay
-   */
-  outputDimension?: '360P'|'540P'|'720P'|'1080P'|'max'
-
   /** 指定期望的相机帧数据尺寸
    * @default "medium"
-   * @supported weapp, tt, alipay
+   * @supported weapp, alipay, tt
    */
   frameSize?: keyof CameraProps.FrameSize
 
+  /** 相机拍照，录制的分辨率。
+   * @supported alipay
+   * @default "720P"
+   */
+  outputDimension?: '360P' | '540P' | '720P' | '1080P' | 'max'
+
   /** 摄像头在非正常终止时触发，
    * 如退出后台等情况
-   * @supported weapp, swan, tt, qq, jd, rn, alipay
+   * @supported weapp, alipay, swan, tt, qq, jd, rn
    */
   onStop?: CommonEventFunction
 
   /** 用户不允许使用摄像头时触发
-   * @supported weapp, swan, tt, qq, jd, rn, alipay
+   * @supported weapp, alipay, swan, tt, qq, jd, rn
    */
   onError?: CommonEventFunction
 
@@ -53,14 +53,14 @@ interface CameraProps extends StandardProps {
    */
   onInitDone?: CommonEventFunction<CameraProps.onInitDoneEventDetail>
 
-  /** 相机初始化完成时触发
+  /** 相机初始化成功时触发。
    * @supported alipay
    */
   onReady?: CommonEventFunction<CameraProps.onInitDoneEventDetail>
 
   /** 在成功识别到一维码时触发，
    * 仅在 mode="scanCode" 时生效
-   * @supported weapp, tt, qq, rn, alipay
+   * @supported weapp, alipay, tt, qq, rn
    */
   onScanCode?: CommonEventFunction<CameraProps.onScanCodeEventDetail>
 }
@@ -125,7 +125,6 @@ declare namespace CameraProps {
     /** 最大变焦 */
     maxZoom: number
   }
-
   interface onScanCodeEventDetail {
     /** 字符集 */
     charSet: string

package/types/Canvas.d.ts

@@ -1,10 +1,5 @@
 import { ComponentType } from 'react'
-import {
-  StandardProps,
-  CommonEventFunction,
-  CanvasTouchEventFunction,
-  CanvasTouchEvent,
-} from './common'
+import { StandardProps, CommonEventFunction, CanvasTouchEventFunction, CanvasTouchEvent } from './common'
 interface CanvasProps extends StandardProps<any, CanvasTouchEvent> {
   /** 指定 canvas 类型，支持 2d 和 webgl
    * @supported weapp, alipay, tt
@@ -22,6 +17,27 @@ interface CanvasProps extends StandardProps<any, CanvasTouchEvent> {
    */
   disableScroll?: boolean
 
+  /** 用于透传 `WebComponents` 上的属性到内部 H5 标签上
+   * @supported h5
+   */
+  nativeProps?: Record<string, unknown>
+
+  /** 组件唯一标识符。
+   * 注意：同一页面中的 id 不可重复。
+   * @supported alipay
+   */
+  id?: string
+
+  /**
+   * @supported alipay
+   */
+  width?: string
+
+  /**
+   * @supported alipay
+   */
+  height?: string
+
   /** 手指触摸动作开始
    * @supported weapp, alipay, swan, tt, qq, jd
    */
@@ -52,27 +68,6 @@ interface CanvasProps extends StandardProps<any, CanvasTouchEvent> {
    */
   onError?: CommonEventFunction<CanvasProps.onErrorEventDetail>
 
-  /** 用于透传 `WebComponents` 上的属性到内部 H5 标签上
-   * @supported h5
-   */
-  nativeProps?: Record<string, unknown>
-
-  /** 组件唯一标识符。
-   * 注意：同一页面中的 id 不可重复。
-   * @supported alipay
-   */
-  id?: string
-
-  /**
-   * @supported alipay
-   */
-  width?: string
-
-  /**
-   * @supported alipay
-   */
-  height?: string
-
   /** 点击。
    * @supported alipay
    */

package/types/Checkbox.d.ts

@@ -23,13 +23,6 @@ interface CheckboxProps extends StandardProps {
    */
   color?: string
 
-  /** 选中项发生变化时触发 change 事件，小程序无此 API
-   * @supported alipay, h5, rn
-   */
-  onChange?: CommonEventFunction<{
-    value: string[]
-  }>
-
   /** 用于透传 `WebComponents` 上的属性到内部 H5 标签上
    * @supported h5
    */
@@ -39,6 +32,13 @@ interface CheckboxProps extends StandardProps {
    * @supported qq
    */
   ariaLabel?: string
+
+  /** 选中项发生变化时触发 change 事件，小程序无此 API
+   * @supported alipay, h5, rn
+   */
+  onChange?: CommonEventFunction<{
+    value: string[]
+  }>
 }
 
 /** 多选项目

package/types/CommentDetail.d.ts

@@ -0,0 +1,72 @@
+import { ComponentType } from 'react'
+import { StandardProps } from './common'
+interface CommentDetailProps extends StandardProps {
+  /** 评论核心参数
+   * @supported swan
+   */
+  commentParam: CommentDetailProps.ICommentParam
+
+  /** 评论 ID
+   * @supported swan
+   */
+  srid: string
+
+  /** 滚动方式为页面滚动，若组件作为浮层使用，该参数需设为 false
+   * @supported swan
+   * @default true
+   */
+  isPageScroll?: boolean
+
+  /** 是否需要底部 toolbar，若使用开发者自定义的底部 toolbar，该参数需设为 false
+   * @supported swan
+   * @default true
+   */
+  needToolbar?: boolean
+
+  /** 是否需要详情顶部父级评论的点赞按钮，默认显示
+   * @supported swan
+   * @default true
+   */
+  needLikeBtn?: boolean
+
+  /** 删除详情后是否返回列表项，默认一站式逻辑。若使用浮层，请设置改属性为 false
+   * @supported swan
+   * @default true
+   */
+  backListAfterDelete?: boolean
+
+  /** 用于调起评论发布器发布评论
+   * @supported swan
+   * @default false
+   */
+  addComment?: boolean
+
+  /** 删除整体详情内容时触发，返回数据为{status, data:{srid}}
+   * @supported swan
+   */
+  onDelete?: CommonEventFunction
+}
+namespace CommentDetailProps {
+  interface ICommentParam {
+    /** 被点赞的文章的 id，与 path 参数一一对应
+     * @example "20200101"
+     */
+    snid: string
+
+    /** 文章标题 */
+    title: string
+
+    /** 智能小程序内页链接，最长不能超过 194 字符
+     * @example "/pages/index/index"
+     */
+    path: string
+  }
+}
+
+/** 评论详情
+ * @classification open
+ * @supported swan
+ * @see https://smartprogram.baidu.com/docs/develop/extended/component-content/comment-detail/
+ */
+declare const CommentDetail: ComponentType<CommentDetailProps>
+export { CommentDetail, CommentDetailProps }

package/types/CommentList.d.ts

@@ -0,0 +1,128 @@
+import { ComponentType } from 'react'
+import { StandardProps } from './common'
+interface CommentListProps extends StandardProps {
+  /** 评论核心参数
+   * @supported swan
+   */
+  commentParam: CommentListProps.ICommentParam
+
+  /** 底部 toolbar 的相关配置
+   * @supported swan
+   */
+  toolbarConfig?: CommentListProps.IToolbarConfig
+
+  /** 滚动方式为页面滚动，若组件作为浮层使用，该参数需设为 false
+   * @supported swan
+   * @default true
+   */
+  isPageScroll?: boolean
+
+  /** 是否需要底部 toolbar ，若使用开发者自定义的底部 toolbar ，该参数需设为 false
+   * @supported swan
+   * @default true
+   */
+  needToolbar?: boolean
+
+  /** 用于调起评论发布器发布评论，发布成功插入列表第一条，且滚动到列表顶部
+   * @supported swan
+   * @default false
+   */
+  addComment?: boolean
+
+  /** 点击单条评论跳转的详情页页面 path ，若没有配置则不会发生跳转；配置的前提是列表与详情均是页面级
+   * @supported swan
+   */
+  detailPath?: string
+
+  /** 是否折叠列表，默认全展示
+   * @supported swan
+   * @default false
+   */
+  isFolded?: boolean
+
+  /** 折叠后列表展示最大条数，默认 3 条，最多 10 条
+   * @supported swan
+   * @default 3
+   */
+  foldNum?: number
+
+  /** 传入放置评论组件的页面路径，如'/pages/list/index'，组件内部会触发跳转逻辑
+   * @supported swan
+   */
+  viewMorePath?: string
+
+  /** 『全部 xx 条』的样式，目前只支持开发者自定义字体颜色
+   * @supported swan
+   */
+  viewMoreStyle?: CommentListProps.IViewMoreStyle
+
+  /** 绑定点击单条评论的事件，点击单条评论时触发，返回数据为{status, data:{srid}}
+   * @supported swan
+   */
+  onClickComment?: CommonEventFunction
+
+  /** 绑定点击更多事件，若除了页面跳转还需要其他操作，可通过该回调执行；若为浮层，也可使用该回调自定义交互逻辑
+   * @supported swan
+   */
+  onViewMore?: CommonEventFunction
+}
+namespace CommentListProps {
+  interface ICommentParam {
+    /** 被点赞的文章的 id，与 path 参数一一对应
+     * @example "20200101"
+     */
+    snid: string
+
+    /** 文章标题 */
+    title: string
+
+    /** 智能小程序内页链接，最长不能超过 194 字符
+     * @example "/pages/index/index"
+     */
+    path: string
+
+    /** 数组第一项用于收藏功能的展示图片
+     * @default ['https://b.bdstatic.com/miniapp/images/demo-dog.png']
+     */
+    images?: string[]
+  }
+  interface IToolbarConfig {
+    /** 输入框提示文字 */
+    placeholder?: string
+
+    /** 显示的互动模块，对应默认值分别是：评论数、点赞、收藏、分享
+     * @default ['comment', 'like', 'favor', 'share']
+     */
+    moduleList?: string
+
+    /** 若 moduleList 里配置了 share 模块，该参数为必填 */
+    share?: IShare
+  }
+  interface IShare {
+    /** 分享标题 */
+    title: string
+
+    /** 分享内容 */
+    content?: string
+
+    /** 分享图标 */
+    imageUrl?: string
+
+    /** 页面 path ，必须是以 / 开头的完整路径，如果 path 中参数包含中文字符，需对中文字符进行编码 */
+    path?: string
+  }
+  interface IViewMoreStyle {
+    /** 『全部 xx 条』的字体颜色，默认为视觉提供色号，开发者可传入自定义色号
+     * @default "#3388ff"
+     */
+    color?: string
+  }
+}
+
+/** 评论列表
+ * @classification open
+ * @supported swan
+ * @see https://smartprogram.baidu.com/docs/develop/extended/component-content/comment-list/
+ */
+declare const CommentList: ComponentType<CommentListProps>
+export { CommentList, CommentListProps }

package/types/ContactButton.d.ts

@@ -0,0 +1,53 @@
+import { ComponentType } from 'react'
+import { StandardProps } from './common'
+interface ContactButtonProps extends StandardProps {
+  /** 必填。企业唯一编码，一个企业支付宝账号对应一个编码。
+   * @supported alipay
+   */
+  tntInstId: string
+
+  /** 必填。聊天窗编码，每个聊天窗的唯一编码。
+   * @supported alipay
+   */
+  scene: string
+
+  /** 选填。咨询按钮大小，正方形设置边长（如25*25 px）。
+   * @supported alipay
+   * @default 25
+   */
+  size?: number | string
+
+  /** 选填。咨询按钮颜色，默认白底蓝色。
+   * @supported alipay
+   * @default "#00A3FF"
+   */
+  color?: string
+
+  /** 选填。咨询按钮头像。
+   * @supported alipay
+   */
+  icon?: string
+
+  /** 选填。支付宝访客用户ID（2088开头）。
+   * 说明： 客服回答问题时，如客户已离开咨询窗口，则通过推送消息到支付宝 card 中提醒客户。
+   * @supported alipay
+   */
+  alipayCardNo?: string
+
+  /** 选填。该属性主要用于传递一些扩展信息给组件，以实现一些高级功能。该属性值的生成方式为：encodeURIComponent({"字段名":"字段值"})， 其中，字段名和字段值要根据实际使用的功能进行替换。
+   * 目前通过传入扩展信息可支持的 3 个功能：
+   * 1.访客名片。需传 cinfo 和 key 两个扩展字段，代码形如在云客服中进入 设置 > 服务窗配置 > 聊天窗 URL。点击操作栏中的 聊天窗 URL ，获取 tntInstId（企业编码）和 scene（聊天窗编码）。encodeURIComponent({"cinfo":"生成的 cinfo","key":"生成的key"})，cinfo 和 key 的值说明 支付宝小程序接入访客名片；
+   * 2.聊天窗默认带出用户的小程序订单数据。需传 appId 字段，代码形如encodeURIComponent({"appId":"商户小程序appid"})
+   * 3.未读客服消息同步至"我的小程序-我的"。同样需传 appId 字段，代码形如 encodeURIComponent({"appId":"商户小程序appid"})。
+   * @supported alipay
+   */
+  extInfo?: string
+}
+
+/** 智能客服
+ * @classification open
+ * @supported alipay
+ * @see https://opendocs.alipay.com/mini/component/contact-button
+ */
+declare const ContactButton: ComponentType<ContactButtonProps>
+export { ContactButton, ContactButtonProps }

package/types/CoverImage.d.ts

@@ -6,26 +6,11 @@ interface CoverImageProps extends StandardProps {
    */
   src: string
 
-  /** 图片加载成功时触发
-   * @supported weapp, swan, qq, h5
-   */
-  onLoad?: CommonEventFunction
-
-  /** 图片加载失败时触发
-   * @supported weapp, swan, qq, h5
-   */
-  onError?: CommonEventFunction
-
   /** 格式固定为 https://servicewechat.com/{appid}/{version}/page-frame.html，其中 {appid} 为小程序的 appid，{version} 为小程序的版本号，版本号为 0 表示为开发版、体验版以及审核版本，版本号为 devtools 表示为开发者工具，其余为正式版本；
    * @supported weapp
    */
   referrerPolicy?: 'origin' | 'no-referrer'
 
-  /** 点击事件回调。
-   * @supported alipay
-   */
-  onTap?: CommonEventFunction
-
   /** 设置与容器顶部的固定距离，效果相当于在 CSS 中设置 position: fixed 和 top 值，该属性优先级高于 fixed-bottom，CSS 设置的 position、top、bottom 值
    * @supported swan
    */
@@ -55,6 +40,21 @@ interface CoverImageProps extends StandardProps {
    * @supported qq
    */
   ariaLabel?: string
+
+  /** 图片加载成功时触发
+   * @supported weapp, swan, qq, h5
+   */
+  onLoad?: CommonEventFunction
+
+  /** 图片加载失败时触发
+   * @supported weapp, swan, qq, h5
+   */
+  onError?: CommonEventFunction
+
+  /** 点击事件回调。
+   * @supported alipay
+   */
+  onTap?: CommonEventFunction
 }
 
 /** 覆盖在原生组件之上的图片视图。可覆盖的原生组件同cover-view，支持嵌套在cover-view里。

package/types/CoverView.d.ts

@@ -7,11 +7,6 @@ interface CoverViewProps extends ViewProps {
    */
   scrollTop?: number
 
-  /** 点击事件回调。
-   * @supported alipay
-   */
-  onTap?: CommonEventFunction
-
   /** 设置与容器顶部的固定距离，效果相当于在 CSS 中设置 position: fixed 和 top 值，该属性优先级高于 fixed-bottom，CSS 设置的 position、top、bottom 值
    * @supported swan
    */
@@ -41,6 +36,11 @@ interface CoverViewProps extends ViewProps {
    * @supported qq
    */
   ariaLabel?: string
+
+  /** 点击事件回调。
+   * @supported alipay
+   */
+  onTap?: CommonEventFunction
 }
 
 /** 覆盖在原生组件之上的文本视图。可覆盖的原生组件包括 map、video、canvas、camera、live-player、live-pusher 只支持嵌套 cover-view、cover-image，可在 cover-view 中使用 button。

package/types/FollowSwan.d.ts

@@ -0,0 +1,28 @@
+import { ComponentType } from 'react'
+import { StandardProps } from './common'
+interface FollowSwanProps extends StandardProps {
+  /** 组件大小
+   * @supported swan
+   * @default "default"
+   */
+  size?: string
+
+  /** 组件样式
+   * @supported swan
+   * @default "primary"
+   */
+  type?: string
+
+  /** 关注和取消关注成功的回调，返回关注状态 {isFavor: true|false}
+   * @supported swan
+   */
+  onFavorStatusChange?: CommonEventFunction
+}
+
+/** 关注小程序
+ * @classification open
+ * @supported swan
+ * @see https://smartprogram.baidu.com/docs/develop/extended/component-content/follow-swan/
+ */
+declare const FollowSwan: ComponentType<FollowSwanProps>
+export { FollowSwan, FollowSwanProps }

package/types/Form.d.ts

@@ -17,16 +17,6 @@ interface FormProps extends StandardProps {
    */
   reportSubmitTimeout?: number
 
-  /** 携带 form 中的数据触发 submit 事件
-   * @supported weapp, alipay, swan, tt, qq, jd, rn
-   */
-  onSubmit?: CommonEventFunction<FormProps.onSubmitEventDetail>
-
-  /** 表单重置时会触发 reset 事件
-   * @supported weapp, alipay, swan, tt, qq, jd, h5, rn
-   */
-  onReset?: CommonEventFunction
-
   /** 模板消息的类型，report-submit 为 true 时填写有效
    * 取值：default / subscribe
    * @default 'default'
@@ -45,6 +35,16 @@ interface FormProps extends StandardProps {
    * @supported swan
    */
   subscribeId?: string
+
+  /** 携带 form 中的数据触发 submit 事件
+   * @supported weapp, alipay, swan, tt, qq, jd, rn
+   */
+  onSubmit?: CommonEventFunction<FormProps.onSubmitEventDetail>
+
+  /** 表单重置时会触发 reset 事件
+   * @supported weapp, alipay, swan, tt, qq, jd, h5, rn
+   */
+  onReset?: CommonEventFunction
 }
 declare namespace FormProps {
   interface onSubmitEventDetail {

package/types/Image.d.ts

@@ -37,16 +37,6 @@ interface ImageProps extends StandardProps {
    */
   showMenuByLongpress?: boolean
 
-  /** 当错误发生时，发布到 AppService 的事件名，事件对象
-   * @supported weapp, alipay, swan, tt, qq, jd, h5, rn
-   */
-  onError?: CommonEventFunction<ImageProps.onErrorEventDetail>
-
-  /** 当图片载入完毕时，发布到 AppService 的事件名，事件对象
-   * @supported weapp, alipay, swan, tt, qq, jd, h5, rn
-   */
-  onLoad?: CommonEventFunction<ImageProps.onLoadEventDetail>
-
   /**
    * 为 img 标签额外增加的属性
    * @supported h5
@@ -63,16 +53,6 @@ interface ImageProps extends StandardProps {
    */
   defaultSource?: string
 
-  /** 点击图片时触发。
-   * @supported alipay
-   */
-  onTap?: CommonEventFunction
-
-  /** 点击图片时触发，阻止事件冒泡。
-   * @supported alipay
-   */
-  catchTap?: CommonEventFunction
-
   /** 阻止长按图片时弹起默认菜单（即将该属性设置为image-menu-prevent="true"或image-menu-prevent），只在初始化时有效，不能动态变更；若不想阻止弹起默认菜单，则不需要设置此属性。注：长按菜单后的操作暂不支持 svg 格式
    * @supported swan
    */
@@ -92,6 +72,26 @@ interface ImageProps extends StandardProps {
    * @supported qq
    */
   ariaLabel?: string
+
+  /** 当错误发生时，发布到 AppService 的事件名，事件对象
+   * @supported weapp, alipay, swan, tt, qq, jd, h5, rn
+   */
+  onError?: CommonEventFunction<ImageProps.onErrorEventDetail>
+
+  /** 当图片载入完毕时，发布到 AppService 的事件名，事件对象
+   * @supported weapp, alipay, swan, tt, qq, jd, h5, rn
+   */
+  onLoad?: CommonEventFunction<ImageProps.onLoadEventDetail>
+
+  /** 点击图片时触发。
+   * @supported alipay
+   */
+  onTap?: CommonEventFunction
+
+  /** 点击图片时触发，阻止事件冒泡。
+   * @supported alipay
+   */
+  catchTap?: CommonEventFunction
 }
 declare namespace ImageProps {
   /** mode 的合法值 */

package/types/InlinePaymentPanel.d.ts

@@ -0,0 +1,58 @@
+import { ComponentType } from 'react'
+import { StandardProps } from './common'
+interface InlinePaymentPanelProps extends StandardProps {
+  /** 总金额，金额单位分，tip：仅支持整数型字符串
+   * @supported swan
+   */
+  totalAmount?: string
+
+  /** 百度收银台的财务结算凭证，详见平台术语
+   * @supported swan
+   */
+  dealId?: string
+
+  /** 支付能力开通后分配的支付 appKey，详见平台术语
+   * @supported swan
+   */
+  appKey?: string
+
+  /** 平台营销信息，此处传当前订单中可使用平台券的 spuid，同时需在 支付能力中搭配使用传入该参数；注：仅与百度合作平台类目券的开发者需要填写该参数
+   * @supported swan
+   */
+  promotionTag?: string | Array<string>
+
+  /** 是否设置挽留弹窗
+   * @supported swan
+   * @default false
+   */
+  enablePageBackModal?: boolean
+
+  /** 自定义样式设置
+   * @supported swan
+   */
+  customStyle?: string
+
+  /** 自定义样式档位配置，各档位配置项包括支付渠道/优惠券条高度、渠道图标大小、支付渠道文案字体大小、营销文案字体大小、选择器图标大小
+   * @supported swan
+   * @default "default"
+   */
+  styleType?: 'tiny' | 'small' | 'default' | 'medium' | 'large'
+
+  /** 获取支付相关信息，具体信息在返回值的 detail 字段中
+   * @supported swan
+   */
+  onGetPaymentInfo?: CommonEventFunction
+
+  /** 当发生错误时触发 error 事件，具体信息在返回值的 detail 字段中，例如 {detail: {errMsg: "something is wrong"}}
+   * @supported swan
+   */
+  onError?: CommonEventFunction
+}
+
+/** 内嵌支付组件
+ * @classification open
+ * @supported swan
+ * @see https://smartprogram.baidu.com/docs/develop/component/inline_payment_panel/
+ */
+declare const InlinePaymentPanel: ComponentType<InlinePaymentPanelProps>
+export { InlinePaymentPanel, InlinePaymentPanelProps }