@open-dy/vibecoding-sdk-taro 0.0.1-beta.5 → 0.0.1

package/dist/reference/sdk-api/ui/button/Button.md

@@ -0,0 +1,210 @@
+# Button
+
+<!-- Generated by build/src/sdk-reference/skill-reference.ts. Do not edit. -->
+
+导入路径：`@open-dy/vibecoding-sdk-taro/ui/button`
+源码：[src/ui/button.tsx](../../../../../src/ui/button.tsx)（安装包内保留）
+
+#### 说明
+
+支持主题样式和抖音 openType 的小程序按钮；用于普通小程序和兴趣卡落地页。
+
+参数：
+
+| 名称 | 说明 |
+| --- | --- |
+| `props` | 按钮属性；variant 和 size 选择视觉样式，className 覆写容器，onClick 处理普通点击。 |
+
+返回：普通交互返回 View；传入 openType 时返回原生 Taro Button。
+
+备注：variant 默认 default（主题背景和前景色），size 默认 default（h-8）。className 合并在预置样式之后，可覆写背景、文字色、边框、圆角和尺寸。不要为获得另一种风格重写通用按钮；按 DESIGN.md 传入 className 或 variant。openType 走原生按钮能力，普通按钮走 View，两者使用同一组视觉样式。
+
+示例：
+
+```tsx
+import { Button } from '@open-dy/vibecoding-sdk-taro/ui/button'
+export function AddTaskButton() {
+  return <Button className="h-11 rounded-none border-4 border-black bg-black text-white" onClick={() => console.log('add task')}>添加</Button>
+}
+```
+
+#### AI 使用约束
+
+| 规则 | 内容 |
+| --- | --- |
+| 意图 | 普通小程序或兴趣卡落地页：支持主题样式和抖音 openType 的小程序按钮；用于普通小程序和兴趣卡落地页。 |
+| 适用时机 | 普通小程序或兴趣卡落地页需要该 UI 模块时，按模块示例组合使用。 |
+| 避免 | 不要用于 Feed OpenCard。variant 默认 default（主题背景和前景色），size 默认 default（h-8）。className 合并在预置样式之后，可覆写背景、文字色、边框、圆角和尺寸。不要为获得另一种风格重写通用按钮；按 DESIGN.md 传入 className 或 variant。openType 走原生按钮能力，普通按钮走 View，两者使用同一组视觉样式。 |
+
+#### 声明
+
+```ts
+declare function Button(props: ButtonProps): React.JSX.Element;
+```
+
+#### 参数
+
+| 参数 | 类型 | 说明 |
+| --- | --- | --- |
+| props | `ButtonProps` | 按钮属性；variant 和 size 选择视觉样式，className 覆写容器，onClick 处理普通点击。 |
+
+##### props 组件属性
+
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| className? | `string \| undefined` | 追加到预置样式之后的容器类名，可覆写色彩、边框、圆角和尺寸。普通分支应用于 View，openType 分支应用于原生 Button。 |
+| style? | `string \| React.CSSProperties \| undefined` | 传给渲染根节点的内联样式；普通分支为 View，openType 分支为原生 Button。 |
+| variant? | `"default" \| "outline" \| "secondary" \| "ghost" \| "destructive" \| "link" \| null \| undefined` | 视觉变体，默认 default（主题色）；outline 描边、secondary 次要、ghost 无底色、destructive 危险色、link 链接样式。只控制样式，不执行业务动作。 |
+| size? | `"default" \| "xs" \| "sm" \| "lg" \| "icon" \| "icon-xs" \| "icon-sm" \| "icon-lg" \| null \| undefined` | 尺寸，默认 default（h-8）；xs/sm/lg 分别为 h-6/h-7/h-9；icon/icon-xs/icon-sm/icon-lg 为 size-8/6/7/9 正方形图标按钮。 |
+| disabled? | `boolean \| undefined` | 原生 Taro Button 的禁用属性，仅 openType 分支有原生禁用保证。普通 View 分支透传该值但未实现点击拦截，请在业务回调中处理。 |
+| dataVideoId? | `string \| undefined` | navigateToVideoView 的视频标识；优先于 data-video-id，同时注入两种拼写给原生按钮。其他 openType 仅透传。 |
+| dataVideoType? | `string \| undefined` | 视频类型；优先于 data-video-type。navigateToVideoView 场景省略时为 "raw"，其他场景不设置默认值。 |
+| dataChannel? | `string \| undefined` | 原生视频能力的渠道参数；优先于 data-channel，未提供时不注入。不控制 SDK 网络通道。 |
+| data-video-id? | `string \| undefined` | dataVideoId 的兼容写法；两者都提供时以 dataVideoId 为准。 |
+| data-video-type? | `string \| undefined` | dataVideoType 的兼容写法；两者都提供时以 dataVideoType 为准。 |
+| data-channel? | `string \| undefined` | dataChannel 的兼容写法；两者都提供时以 dataChannel 为准。 |
+| onNavigateToVideoView? | `(((event: DouyinOpenTypeDetailEvent) => void) & ((event: OpenTypeDetailEvent) => void)) \| undefined` | 仅在原生 navigateToVideoView 能力分支中透传的结果回调；event.detail 可缺省，不代表业务点击回调。 |
+| onAddShortcut? | `(((event: DouyinOpenTypeDetailEvent) => void) & ((event: OpenTypeDetailEvent) => void)) \| undefined` | 仅在原生 addShortcut 能力分支中透传的结果回调；结果从 event.detail 读取，普通 View 按钮不会主动调用。 |
+
+- `openType?`
+
+```ts
+"contact" | "share" | "getPhoneNumber" | "getRealtimePhoneNumber" | "getUserInfo" | "launchApp" | "openSetting" | "feedback" | "chooseAvatar" | "agreePrivacyAuthorization" | "getPhoneNumber|agreePrivacyAuthorization" | "getRealtimePhoneNumber|agreePrivacyAuthorization" | "getUserInfo|agreePrivacyAuthorization" | "getAuthorize" | "contactShare" | "lifestyle" | "openGroupProfile" | "addFriend" | "addColorSign" | "openPublicProfile" | "addGroupApp" | "shareMessageToFriend" | "im" | "platformIm" | "navigateToVideoView" | "openAwemeUserProfile" | "openWebcastRoom" | "addCalendarEvent" | "addShortcut" | "joinGroup" | "privateMessage" | "authorizePrivateMessage" | "liveActivity" | "getPhoneNumberAndRiskLevel" | undefined
+```
+说明：抖音原生按钮能力类型；非空时改用 Taro Button 并透传该值，否则渲染 View。可用值和授权要求以目标平台能力为准。
+
+###### onNavigateToVideoView 回调参数
+
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| event | `OpenTypeDetailEvent` |  |
+
+###### onNavigateToVideoView.event 子字段
+
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| detail? | `{ errMsg?: string; errNo?: number; } \| undefined` | 原生能力回调的结果明细；平台未提供时可缺省，使用前需判空。 |
+
+###### onNavigateToVideoView.event.detail 子字段
+
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| errMsg? | `string \| undefined` | 平台提供的结果或错误描述；可缺省，请保留原文用于判断和诊断。 |
+| errNo? | `number \| undefined` | 平台提供的数值结果码；可缺省，含义以所用原生能力的契约为准。 |
+
+###### onAddShortcut 回调参数
+
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| event | `OpenTypeDetailEvent` |  |
+
+###### onAddShortcut.event 子字段
+
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| detail? | `{ errMsg?: string; errNo?: number; } \| undefined` | 原生能力回调的结果明细；平台未提供时可缺省，使用前需判空。 |
+
+###### onAddShortcut.event.detail 子字段
+
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| errMsg? | `string \| undefined` | 平台提供的结果或错误描述；可缺省，请保留原文用于判断和诊断。 |
+| errNo? | `number \| undefined` | 平台提供的数值结果码；可缺省，含义以所用原生能力的契约为准。 |
+
+<details>
+
+<summary>继承的 Taro / React 属性</summary>
+
+以下字段沿用上游类型；组件有特殊处理时，以本页组件属性说明为准。
+
+##### 继承属性
+
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| hoverClass? | `string \| undefined` | 指定按下去的样式类。当 `hover-class="none"` 时，没有点击态效果 |
+| hoverStyle? | `any` | 由于 RN 不支持 hoverClass，故 RN 端的 View 组件实现了 `hoverStyle`属性，写法和 style 类似，只不过 `hoverStyle` 的样式是指定按下去的样式。 |
+| hoverStopPropagation? | `boolean \| undefined` | 指定是否阻止本节点的祖先节点出现点击态 |
+| hoverStartTime? | `number \| undefined` | 按住后多久出现点击态，单位毫秒 |
+| hoverStayTime? | `number \| undefined` | 手指松开后点击态保留时间，单位毫秒 |
+| disableScroll? | `boolean \| undefined` | 是否阻止区域内滚动页面。 说明： 如果 view 中嵌套 view，外层 view 设置 disable-scroll 为 true 时禁止内部的滚动。 |
+| hidden? | `boolean \| undefined` | 是否隐藏。 |
+| animation? | `TaroGeneral.IAnyObject \| undefined` | 用于动画，详见 my.createAnimation 。使用 my.createAnimation 生成的动画是通过过渡（Transition）实现的，只会触发 onTransitionEnd，不会触发 onAnimationStart, onAnimationIteration, onAnimationEnd。 |
+| role? | `string \| undefined` | 表示组件的语义角色。设置为 img 时，组件聚焦后读屏软件会朗读出 图像 ；设置为 button 时，聚焦后读屏软件会朗读出 按钮 。详情请参见 aria-component。 |
+| ariaRole? | `string \| undefined` | 无障碍访问，（角色）标识元素的作用 |
+| ariaLabel? | `string \| undefined` | 无障碍访问，（属性）元素的额外描述 |
+| onTap? | `CommonEventFunction \| undefined` | 点击。 |
+| onTouchStart? | `CommonEventFunction \| undefined` | 触摸动作开始。 |
+| onTouchMove? | `CommonEventFunction \| undefined` | 触摸后移动。 |
+| onTouchEnd? | `CommonEventFunction \| undefined` | 触摸动作结束。 |
+| onTouchCancel? | `CommonEventFunction \| undefined` | 触摸动作被打断，如来电提醒，弹窗。 |
+| onLongTap? | `CommonEventFunction \| undefined` | 长按 500ms 之后触发，触发了长按事件后进行移动将不会触发屏幕的滚动。 |
+| onTransitionEnd? | `CommonEventFunction \| undefined` | 过渡（Transition）结束时触发。 |
+| onAnimationIteration? | `CommonEventFunction \| undefined` | 每开启一次新的动画过程时触发。（第一次不触发） |
+| onAnimationStart? | `CommonEventFunction \| undefined` | 动画开始时触发。 |
+| onAnimationEnd? | `CommonEventFunction \| undefined` | 动画结束时触发。 |
+| onAppear? | `CommonEventFunction \| undefined` | 当前元素可见面积超过50%时触发。 |
+| onDisappear? | `CommonEventFunction \| undefined` | 当前元素不可见面积超过50%时触发。 |
+| onFirstAppear? | `CommonEventFunction \| undefined` | 当前元素首次可见面积达到50%时触发。 |
+| catchMove? | `boolean \| undefined` | 是否以 catch 的形式绑定 touchmove 事件 |
+| id? | `string \| undefined` | 组件的唯一标示, 保持整个页面唯一 |
+| children? | `React.ReactNode` | 子节点 |
+| key? | `string \| number \| undefined` | 如果列表中项目的位置会动态改变或者有新的项目添加到列表中， 需要使用 `wx:key` 来指定列表中项目的唯一的标识符。 |
+| ref? | `React.LegacyRef<any> \| undefined` | 引用 |
+| dangerouslySetInnerHTML? | `{ __html: string; } \| undefined` | 渲染 HTML |
+| compileMode? | `string \| boolean \| undefined` | 是否开启编译模式 或者 是否是编译模式的子渲染函数 |
+| harmonyDirection? | `"row" \| "column" \| "flex" \| undefined` | 自定义容器组件的方向 |
+| onClick? | `((event: ITouchEvent) => void) \| undefined` | 手指触摸后马上离开 |
+| onLongPress? | `((event: CommonEvent) => void) \| undefined` | 手指触摸后，超过350ms再离开，如果指定了事件回调函数并触发了这个事件，tap事件将不被触发 |
+| onLongClick? | `((event: CommonEvent) => void) \| undefined` | 手指触摸后，超过350ms再离开（推荐使用 longpress 事件代替） |
+| onTouchForceChange? | `((event: CommonEvent) => void) \| undefined` | 在支持 3D Touch 的 iPhone 设备，重按时会触发 |
+| onError? | `CommonEventFunction \| undefined` | 当使用开放能力时，发生错误的回调 生效时机：`open-type="launchApp"` |
+| plain? | `boolean \| undefined` | 按钮是否镂空，背景色透明 |
+| loading? | `boolean \| undefined` | 名称前是否带 loading 图标 |
+| formType? | `keyof ButtonProps.FormType \| undefined` | 用于 `<form/>` 组件，点击分别会触发 `<form/>` 组件的 submit/reset 事件 |
+| lang? | `keyof ButtonProps.Lang \| undefined` | 指定返回用户信息的语言，zh_CN 简体中文，zh_TW 繁体中文，en 英文。 生效时机: `open-type="getUserInfo"` |
+| sessionFrom? | `string \| undefined` | 会话来源 生效时机：`open-type="contact"` |
+| sendMessageTitle? | `string \| undefined` | 会话内消息卡片标题 生效时机：`open-type="contact"` |
+| sendMessagePath? | `string \| undefined` | 会话内消息卡片点击跳转小程序路径 生效时机：`open-type="contact"` |
+| sendMessageImg? | `string \| undefined` | 会话内消息卡片图片 生效时机：`open-type="contact"` |
+| appParameter? | `string \| undefined` | 打开 APP 时，向 APP 传递的参数 生效时机：`open-type="launchApp"` |
+| scope? | `"userInfo" \| "phoneNumber" \| undefined` | 支付宝小程序 scope 生效时机：`open-type="getAuthorize"` |
+| showMessageCard? | `boolean \| undefined` | 显示会话内消息卡片 生效时机：`open-type="contact"` |
+| publicId? | `string \| undefined` | 生活号 id，必须是当前小程序同主体且已关联的生活号，open-type="lifestyle" 时有效。 |
+| templateId? | `string \| string[] \| undefined` | 发送订阅类模板消息所用的模板库标题 ID ，可通过 getTemplateLibraryList 获取 当参数类型为 Array 时，可传递 1~3 个模板库标题 ID |
+| subscribeId? | `string \| undefined` | 发送订阅类模板消息时所使用的唯一标识符，内容由开发者自定义，用来标识订阅场景 注意：同一用户在同一 subscribe-id 下的多次授权不累积下发权限，只能下发一条。若要订阅多条，需要不同 subscribe-id |
+| groupId? | `string \| undefined` | 群聊 id |
+| guildId? | `string \| undefined` | 打开频道页面时，传递的频道号 |
+| shareType? | `string \| undefined` | 分享类型集合，请参考下面share-type有效值说明。share-type后续将不再维护，请更新为share-mode |
+| shareMode? | `string \| undefined` | 分享类型集合，请参考下面share-mode有效值说明 |
+| openId? | `string \| undefined` | 添加好友时，对方的 openid |
+| shareMessageFriendInfo? | `string \| undefined` | 发送对象的 FriendInfo |
+| shareMessageTitle? | `string \| undefined` | 转发标题，不传则默认使用当前小程序的昵称。 FriendInfo |
+| shareMessageImg? | `string \| undefined` | 转发显示图片的链接，可以是网络图片路径（仅 QQ CDN 域名路径）或本地图片文件路径或相对代码包根目录的图片文件路径。显示图片长宽比是 5:4FriendInfo |
+| dataAwemeId? | `string \| undefined` | 跳转抖音号个人页，只支持小程序绑定的品牌号、员工号、合作号 |
+| dataIsHalfPage? | `boolean \| undefined` | 是否开启半屏模式 |
+| onGetUserInfo? | `CommonEventFunction<ButtonProps.onGetUserInfoEventDetail> \| undefined` | 用户点击该按钮时，会返回获取到的用户信息，回调的detail数据与 Taro.getUserInfo 返回的一致 生效时机: `open-type="getUserInfo"` |
+| onGetAuthorize? | `CommonEventFunction \| undefined` | 支付宝获取会员基础信息授权回调 生效时机：`open-type="getAuthorize"` |
+| onContact? | `CommonEventFunction<ButtonProps.onContactEventDetail> \| undefined` | 客服消息回调 生效时机：`open-type="contact"` |
+| onGetPhoneNumber? | `CommonEventFunction<ButtonProps.onGetPhoneNumberEventDetail> \| undefined` | 获取用户手机号回调 生效时机：`open-type="getPhoneNumber"` |
+| onGetPhoneNumberAndRiskLevel? | `CommonEventFunction<ButtonProps.onGetPhoneNumberAndRiskLevelEventDetail> \| undefined` | 获取手机号和风险等级的回调 生效时机：`open-type="getPhoneNumberAndRiskLevel"` |
+| onGetRealTimePhoneNumber? | `CommonEventFunction<ButtonProps.onGetRealTimePhoneNumberEventDetail> \| undefined` | 手机号实时验证回调，`open-type="getRealtimePhoneNumber"` 时有效 |
+| onOpenSetting? | `CommonEventFunction<ButtonProps.onOpenSettingEventDetail> \| undefined` | 在打开授权设置页后回调 生效时机：`open-type="openSetting"` |
+| onLaunchApp? | `CommonEventFunction \| undefined` | 打开 APP 成功的回调 生效时机：`open-type="launchApp"` |
+| onChooseAvatar? | `CommonEventFunction \| undefined` | 获取用户头像回调 生效时机：`open-type="chooseAvatar"` |
+| onAgreePrivacyAuthorization? | `CommonEventFunction \| undefined` | 用户同意隐私协议事件回调，`open-type="agreePrivacyAuthorization"`时有效 |
+| onFollowLifestyle? | `CommonEventFunction<{ followStatus: 1 \| 2 \| 3 \| true; }> \| undefined` | 当 open-type 为 lifestyle 时有效。 当点击按钮时触发。 event.detail = { followStatus }，followStatus 合法值有 1、2、3，其中 1 表示已关注。2 表示用户不允许关注。3 表示发生未知错误； 已知问题：基础库 1.0，当用户在点击按钮前已关注生活号，event.detail.followStatus 的值为 true。 |
+| onChooseAddress? | `CommonEventFunction \| undefined` | 用户点击该按钮时，调起用户编辑收货地址原生界面，并在编辑完成后返回用户选择的地址，从返回参数的 detail 中获取，和 swan.chooseAddress 一样的。和 open-type 搭配使用，使用时机：open-type="chooseAddress" |
+| onChooseInvoiceTitle? | `CommonEventFunction \| undefined` | 用户点击该按钮时，选择用户的发票抬头，和 swan.chooseInvoiceTitle 一样的。和 open-type 搭配使用，使用时机：open-type="chooseInvoiceTitle" |
+| onLogin? | `CommonEventFunction \| undefined` | 登录回调，和 open-type 搭配使用，使用时机：open-type="login"。可以通过返回参数的 detail 判断是否登录成功，当 errMsg 为'login:ok'时即为成功。如想获取登录凭证请使用 swan.getLoginCode |
+| onSubscribe? | `CommonEventFunction \| undefined` | 订阅消息授权回调，和 open-type 搭配使用，使用时机：open-type="subscribe" |
+| onAddFriend? | `CommonEventFunction \| undefined` | 添加好友的回调 |
+| onAddGroupApp? | `CommonEventFunction \| undefined` | 添加群应用的回调。errCode 错误码：41004（当前用户非管理员或群主，无权操作），41005（超过可添加群应用的群数量） |
+| onOpenAwemeUserProfile? | `CommonEventFunction \| undefined` | 监听跳转抖音号个人页的回调 生效时机：`open-type="openAwemeUserProfile"` |
+| onJoinGroup? | `CommonEventFunction<{ errMsg: string; errNo: number; }> \| undefined` | 加群后触发 |
+| hideBorder? | `boolean \| undefined` |  |
+
+</details>
+
+#### 返回值
+
+- 类型：`React.JSX.Element`

package/dist/reference/sdk-api/ui/button/ButtonProps.md

@@ -0,0 +1,188 @@
+# ButtonProps
+
+<!-- Generated by build/src/sdk-reference/skill-reference.ts. Do not edit. -->
+
+导入路径：`@open-dy/vibecoding-sdk-taro/ui/button`
+源码：[src/ui/button.tsx](../../../../../src/ui/button.tsx)（安装包内保留）
+
+#### 说明
+
+按钮组件的属性类型；保留 Taro 原生能力，避免 size/type 与样式变体同名冲突。
+
+示例：
+
+```tsx
+import { ButtonProps } from '@open-dy/vibecoding-sdk-taro/ui/button'
+const props: ButtonProps = { children: '确认' }
+```
+
+#### AI 使用约束
+
+| 规则 | 内容 |
+| --- | --- |
+| 意图 | 普通小程序或兴趣卡落地页：按钮组件的属性类型；保留 Taro 原生能力，避免 size/type 与样式变体同名冲突。 |
+| 适用时机 | 普通小程序或兴趣卡落地页需要该 UI 模块时，按模块示例组合使用。 |
+| 避免 | 不要用于 Feed OpenCard。属性与组合方式以本页类型和示例为准。 |
+
+#### 声明
+
+```ts
+export type ButtonProps = ViewProps & VariantProps<typeof buttonVariants> & Omit<TaroButtonProps, TaroButtonNativeKeys> & DouyinButtonExtras;
+```
+
+##### 组件属性
+
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| variant? | `"default" \| "outline" \| "secondary" \| "ghost" \| "destructive" \| "link" \| null \| undefined` | 视觉变体，默认 default（主题色）；outline 描边、secondary 次要、ghost 无底色、destructive 危险色、link 链接样式。只控制样式，不执行业务动作。 |
+| size? | `"default" \| "xs" \| "sm" \| "lg" \| "icon" \| "icon-xs" \| "icon-sm" \| "icon-lg" \| null \| undefined` | 尺寸，默认 default（h-8）；xs/sm/lg 分别为 h-6/h-7/h-9；icon/icon-xs/icon-sm/icon-lg 为 size-8/6/7/9 正方形图标按钮。 |
+| dataVideoId? | `string \| undefined` | navigateToVideoView 的视频标识；优先于 data-video-id，同时注入两种拼写给原生按钮。其他 openType 仅透传。 |
+| dataVideoType? | `string \| undefined` | 视频类型；优先于 data-video-type。navigateToVideoView 场景省略时为 "raw"，其他场景不设置默认值。 |
+| dataChannel? | `string \| undefined` | 原生视频能力的渠道参数；优先于 data-channel，未提供时不注入。不控制 SDK 网络通道。 |
+| data-video-id? | `string \| undefined` | dataVideoId 的兼容写法；两者都提供时以 dataVideoId 为准。 |
+| data-video-type? | `string \| undefined` | dataVideoType 的兼容写法；两者都提供时以 dataVideoType 为准。 |
+| data-channel? | `string \| undefined` | dataChannel 的兼容写法；两者都提供时以 dataChannel 为准。 |
+| onNavigateToVideoView? | `(((event: DouyinOpenTypeDetailEvent) => void) & ((event: OpenTypeDetailEvent) => void)) \| undefined` | 仅在原生 navigateToVideoView 能力分支中透传的结果回调；event.detail 可缺省，不代表业务点击回调。 |
+| onAddShortcut? | `(((event: DouyinOpenTypeDetailEvent) => void) & ((event: OpenTypeDetailEvent) => void)) \| undefined` | 仅在原生 addShortcut 能力分支中透传的结果回调；结果从 event.detail 读取，普通 View 按钮不会主动调用。 |
+
+- `openType?`
+
+```ts
+"contact" | "share" | "getPhoneNumber" | "getRealtimePhoneNumber" | "getUserInfo" | "launchApp" | "openSetting" | "feedback" | "chooseAvatar" | "agreePrivacyAuthorization" | "getPhoneNumber|agreePrivacyAuthorization" | "getRealtimePhoneNumber|agreePrivacyAuthorization" | "getUserInfo|agreePrivacyAuthorization" | "getAuthorize" | "contactShare" | "lifestyle" | "openGroupProfile" | "addFriend" | "addColorSign" | "openPublicProfile" | "addGroupApp" | "shareMessageToFriend" | "im" | "platformIm" | "navigateToVideoView" | "openAwemeUserProfile" | "openWebcastRoom" | "addCalendarEvent" | "addShortcut" | "joinGroup" | "privateMessage" | "authorizePrivateMessage" | "liveActivity" | "getPhoneNumberAndRiskLevel" | undefined
+```
+说明：抖音原生按钮能力类型；非空时改用 Taro Button 并透传该值，否则渲染 View。可用值和授权要求以目标平台能力为准。
+
+###### onNavigateToVideoView 回调参数
+
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| event | `OpenTypeDetailEvent` |  |
+
+###### onNavigateToVideoView.event 子字段
+
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| detail? | `{ errMsg?: string; errNo?: number; } \| undefined` | 原生能力回调的结果明细；平台未提供时可缺省，使用前需判空。 |
+
+###### onNavigateToVideoView.event.detail 子字段
+
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| errMsg? | `string \| undefined` | 平台提供的结果或错误描述；可缺省，请保留原文用于判断和诊断。 |
+| errNo? | `number \| undefined` | 平台提供的数值结果码；可缺省，含义以所用原生能力的契约为准。 |
+
+###### onAddShortcut 回调参数
+
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| event | `OpenTypeDetailEvent` |  |
+
+###### onAddShortcut.event 子字段
+
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| detail? | `{ errMsg?: string; errNo?: number; } \| undefined` | 原生能力回调的结果明细；平台未提供时可缺省，使用前需判空。 |
+
+###### onAddShortcut.event.detail 子字段
+
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| errMsg? | `string \| undefined` | 平台提供的结果或错误描述；可缺省，请保留原文用于判断和诊断。 |
+| errNo? | `number \| undefined` | 平台提供的数值结果码；可缺省，含义以所用原生能力的契约为准。 |
+
+<details>
+
+<summary>继承的 Taro / React 属性</summary>
+
+以下字段沿用上游类型；组件有特殊处理时，以本页组件属性说明为准。
+
+##### 继承属性
+
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| hoverClass? | `string \| undefined` | 指定按下去的样式类。当 `hover-class="none"` 时，没有点击态效果 |
+| hoverStyle? | `any` | 由于 RN 不支持 hoverClass，故 RN 端的 View 组件实现了 `hoverStyle`属性，写法和 style 类似，只不过 `hoverStyle` 的样式是指定按下去的样式。 |
+| hoverStopPropagation? | `boolean \| undefined` | 指定是否阻止本节点的祖先节点出现点击态 |
+| hoverStartTime? | `number \| undefined` | 按住后多久出现点击态，单位毫秒 |
+| hoverStayTime? | `number \| undefined` | 手指松开后点击态保留时间，单位毫秒 |
+| disableScroll? | `boolean \| undefined` | 是否阻止区域内滚动页面。 说明： 如果 view 中嵌套 view，外层 view 设置 disable-scroll 为 true 时禁止内部的滚动。 |
+| hidden? | `boolean \| undefined` | 是否隐藏。 |
+| animation? | `TaroGeneral.IAnyObject \| undefined` | 用于动画，详见 my.createAnimation 。使用 my.createAnimation 生成的动画是通过过渡（Transition）实现的，只会触发 onTransitionEnd，不会触发 onAnimationStart, onAnimationIteration, onAnimationEnd。 |
+| role? | `string \| undefined` | 表示组件的语义角色。设置为 img 时，组件聚焦后读屏软件会朗读出 图像 ；设置为 button 时，聚焦后读屏软件会朗读出 按钮 。详情请参见 aria-component。 |
+| ariaRole? | `string \| undefined` | 无障碍访问，（角色）标识元素的作用 |
+| ariaLabel? | `string \| undefined` | 无障碍访问，（属性）元素的额外描述 |
+| onTap? | `CommonEventFunction \| undefined` | 点击。 |
+| onTouchStart? | `CommonEventFunction \| undefined` | 触摸动作开始。 |
+| onTouchMove? | `CommonEventFunction \| undefined` | 触摸后移动。 |
+| onTouchEnd? | `CommonEventFunction \| undefined` | 触摸动作结束。 |
+| onTouchCancel? | `CommonEventFunction \| undefined` | 触摸动作被打断，如来电提醒，弹窗。 |
+| onLongTap? | `CommonEventFunction \| undefined` | 长按 500ms 之后触发，触发了长按事件后进行移动将不会触发屏幕的滚动。 |
+| onTransitionEnd? | `CommonEventFunction \| undefined` | 过渡（Transition）结束时触发。 |
+| onAnimationIteration? | `CommonEventFunction \| undefined` | 每开启一次新的动画过程时触发。（第一次不触发） |
+| onAnimationStart? | `CommonEventFunction \| undefined` | 动画开始时触发。 |
+| onAnimationEnd? | `CommonEventFunction \| undefined` | 动画结束时触发。 |
+| onAppear? | `CommonEventFunction \| undefined` | 当前元素可见面积超过50%时触发。 |
+| onDisappear? | `CommonEventFunction \| undefined` | 当前元素不可见面积超过50%时触发。 |
+| onFirstAppear? | `CommonEventFunction \| undefined` | 当前元素首次可见面积达到50%时触发。 |
+| catchMove? | `boolean \| undefined` | 是否以 catch 的形式绑定 touchmove 事件 |
+| id? | `string \| undefined` | 组件的唯一标示, 保持整个页面唯一 |
+| className? | `string \| undefined` | 同 `class`，在 React/Preact 里一般使用 `className` 作为 `class` 的代称 |
+| style? | `string \| React.CSSProperties \| undefined` | 组件的内联样式, 可以动态设置的内联样式 |
+| children? | `React.ReactNode` | 子节点 |
+| key? | `string \| number \| undefined` | 如果列表中项目的位置会动态改变或者有新的项目添加到列表中， 需要使用 `wx:key` 来指定列表中项目的唯一的标识符。 |
+| ref? | `React.LegacyRef<any> \| undefined` | 引用 |
+| dangerouslySetInnerHTML? | `{ __html: string; } \| undefined` | 渲染 HTML |
+| compileMode? | `string \| boolean \| undefined` | 是否开启编译模式 或者 是否是编译模式的子渲染函数 |
+| harmonyDirection? | `"row" \| "column" \| "flex" \| undefined` | 自定义容器组件的方向 |
+| onClick? | `((event: ITouchEvent) => void) \| undefined` | 手指触摸后马上离开 |
+| onLongPress? | `((event: CommonEvent) => void) \| undefined` | 手指触摸后，超过350ms再离开，如果指定了事件回调函数并触发了这个事件，tap事件将不被触发 |
+| onLongClick? | `((event: CommonEvent) => void) \| undefined` | 手指触摸后，超过350ms再离开（推荐使用 longpress 事件代替） |
+| onTouchForceChange? | `((event: CommonEvent) => void) \| undefined` | 在支持 3D Touch 的 iPhone 设备，重按时会触发 |
+| onError? | `CommonEventFunction \| undefined` | 当使用开放能力时，发生错误的回调 生效时机：`open-type="launchApp"` |
+| plain? | `boolean \| undefined` | 按钮是否镂空，背景色透明 |
+| disabled? | `boolean \| undefined` | 是否禁用 |
+| loading? | `boolean \| undefined` | 名称前是否带 loading 图标 |
+| formType? | `keyof ButtonProps.FormType \| undefined` | 用于 `<form/>` 组件，点击分别会触发 `<form/>` 组件的 submit/reset 事件 |
+| lang? | `keyof ButtonProps.Lang \| undefined` | 指定返回用户信息的语言，zh_CN 简体中文，zh_TW 繁体中文，en 英文。 生效时机: `open-type="getUserInfo"` |
+| sessionFrom? | `string \| undefined` | 会话来源 生效时机：`open-type="contact"` |
+| sendMessageTitle? | `string \| undefined` | 会话内消息卡片标题 生效时机：`open-type="contact"` |
+| sendMessagePath? | `string \| undefined` | 会话内消息卡片点击跳转小程序路径 生效时机：`open-type="contact"` |
+| sendMessageImg? | `string \| undefined` | 会话内消息卡片图片 生效时机：`open-type="contact"` |
+| appParameter? | `string \| undefined` | 打开 APP 时，向 APP 传递的参数 生效时机：`open-type="launchApp"` |
+| scope? | `"userInfo" \| "phoneNumber" \| undefined` | 支付宝小程序 scope 生效时机：`open-type="getAuthorize"` |
+| showMessageCard? | `boolean \| undefined` | 显示会话内消息卡片 生效时机：`open-type="contact"` |
+| publicId? | `string \| undefined` | 生活号 id，必须是当前小程序同主体且已关联的生活号，open-type="lifestyle" 时有效。 |
+| templateId? | `string \| string[] \| undefined` | 发送订阅类模板消息所用的模板库标题 ID ，可通过 getTemplateLibraryList 获取 当参数类型为 Array 时，可传递 1~3 个模板库标题 ID |
+| subscribeId? | `string \| undefined` | 发送订阅类模板消息时所使用的唯一标识符，内容由开发者自定义，用来标识订阅场景 注意：同一用户在同一 subscribe-id 下的多次授权不累积下发权限，只能下发一条。若要订阅多条，需要不同 subscribe-id |
+| groupId? | `string \| undefined` | 群聊 id |
+| guildId? | `string \| undefined` | 打开频道页面时，传递的频道号 |
+| shareType? | `string \| undefined` | 分享类型集合，请参考下面share-type有效值说明。share-type后续将不再维护，请更新为share-mode |
+| shareMode? | `string \| undefined` | 分享类型集合，请参考下面share-mode有效值说明 |
+| openId? | `string \| undefined` | 添加好友时，对方的 openid |
+| shareMessageFriendInfo? | `string \| undefined` | 发送对象的 FriendInfo |
+| shareMessageTitle? | `string \| undefined` | 转发标题，不传则默认使用当前小程序的昵称。 FriendInfo |
+| shareMessageImg? | `string \| undefined` | 转发显示图片的链接，可以是网络图片路径（仅 QQ CDN 域名路径）或本地图片文件路径或相对代码包根目录的图片文件路径。显示图片长宽比是 5:4FriendInfo |
+| dataAwemeId? | `string \| undefined` | 跳转抖音号个人页，只支持小程序绑定的品牌号、员工号、合作号 |
+| dataIsHalfPage? | `boolean \| undefined` | 是否开启半屏模式 |
+| onGetUserInfo? | `CommonEventFunction<ButtonProps.onGetUserInfoEventDetail> \| undefined` | 用户点击该按钮时，会返回获取到的用户信息，回调的detail数据与 Taro.getUserInfo 返回的一致 生效时机: `open-type="getUserInfo"` |
+| onGetAuthorize? | `CommonEventFunction \| undefined` | 支付宝获取会员基础信息授权回调 生效时机：`open-type="getAuthorize"` |
+| onContact? | `CommonEventFunction<ButtonProps.onContactEventDetail> \| undefined` | 客服消息回调 生效时机：`open-type="contact"` |
+| onGetPhoneNumber? | `CommonEventFunction<ButtonProps.onGetPhoneNumberEventDetail> \| undefined` | 获取用户手机号回调 生效时机：`open-type="getPhoneNumber"` |
+| onGetPhoneNumberAndRiskLevel? | `CommonEventFunction<ButtonProps.onGetPhoneNumberAndRiskLevelEventDetail> \| undefined` | 获取手机号和风险等级的回调 生效时机：`open-type="getPhoneNumberAndRiskLevel"` |
+| onGetRealTimePhoneNumber? | `CommonEventFunction<ButtonProps.onGetRealTimePhoneNumberEventDetail> \| undefined` | 手机号实时验证回调，`open-type="getRealtimePhoneNumber"` 时有效 |
+| onOpenSetting? | `CommonEventFunction<ButtonProps.onOpenSettingEventDetail> \| undefined` | 在打开授权设置页后回调 生效时机：`open-type="openSetting"` |
+| onLaunchApp? | `CommonEventFunction \| undefined` | 打开 APP 成功的回调 生效时机：`open-type="launchApp"` |
+| onChooseAvatar? | `CommonEventFunction \| undefined` | 获取用户头像回调 生效时机：`open-type="chooseAvatar"` |
+| onAgreePrivacyAuthorization? | `CommonEventFunction \| undefined` | 用户同意隐私协议事件回调，`open-type="agreePrivacyAuthorization"`时有效 |
+| onFollowLifestyle? | `CommonEventFunction<{ followStatus: 1 \| 2 \| 3 \| true; }> \| undefined` | 当 open-type 为 lifestyle 时有效。 当点击按钮时触发。 event.detail = { followStatus }，followStatus 合法值有 1、2、3，其中 1 表示已关注。2 表示用户不允许关注。3 表示发生未知错误； 已知问题：基础库 1.0，当用户在点击按钮前已关注生活号，event.detail.followStatus 的值为 true。 |
+| onChooseAddress? | `CommonEventFunction \| undefined` | 用户点击该按钮时，调起用户编辑收货地址原生界面，并在编辑完成后返回用户选择的地址，从返回参数的 detail 中获取，和 swan.chooseAddress 一样的。和 open-type 搭配使用，使用时机：open-type="chooseAddress" |
+| onChooseInvoiceTitle? | `CommonEventFunction \| undefined` | 用户点击该按钮时，选择用户的发票抬头，和 swan.chooseInvoiceTitle 一样的。和 open-type 搭配使用，使用时机：open-type="chooseInvoiceTitle" |
+| onLogin? | `CommonEventFunction \| undefined` | 登录回调，和 open-type 搭配使用，使用时机：open-type="login"。可以通过返回参数的 detail 判断是否登录成功，当 errMsg 为'login:ok'时即为成功。如想获取登录凭证请使用 swan.getLoginCode |
+| onSubscribe? | `CommonEventFunction \| undefined` | 订阅消息授权回调，和 open-type 搭配使用，使用时机：open-type="subscribe" |
+| onAddFriend? | `CommonEventFunction \| undefined` | 添加好友的回调 |
+| onAddGroupApp? | `CommonEventFunction \| undefined` | 添加群应用的回调。errCode 错误码：41004（当前用户非管理员或群主，无权操作），41005（超过可添加群应用的群数量） |
+| onOpenAwemeUserProfile? | `CommonEventFunction \| undefined` | 监听跳转抖音号个人页的回调 生效时机：`open-type="openAwemeUserProfile"` |
+| onJoinGroup? | `CommonEventFunction<{ errMsg: string; errNo: number; }> \| undefined` | 加群后触发 |
+| hideBorder? | `boolean \| undefined` |  |
+
+</details>

package/dist/reference/sdk-api/ui/button/buttonVariants.md

@@ -0,0 +1,84 @@
+# buttonVariants
+
+<!-- Generated by build/src/sdk-reference/skill-reference.ts. Do not edit. -->
+
+导入路径：`@open-dy/vibecoding-sdk-taro/ui/button`
+源码：[src/ui/button.tsx](../../../../../src/ui/button.tsx)（安装包内保留）
+
+#### 说明
+
+生成按钮的样式类名；接受其声明的样式变体。
+
+参数：
+
+| 名称 | 说明 |
+| --- | --- |
+| `props` | 样式变体以及附加的 class 或 className。 |
+
+返回：合并后的样式类名。
+
+示例：
+
+```tsx
+import { buttonVariants } from '@open-dy/vibecoding-sdk-taro/ui/button'
+buttonVariants()
+```
+
+#### AI 使用约束
+
+| 规则 | 内容 |
+| --- | --- |
+| 意图 | 普通小程序或兴趣卡落地页：生成按钮的样式类名；接受其声明的样式变体。 |
+| 适用时机 | 普通小程序或兴趣卡落地页需要该 UI 模块时，按模块示例组合使用。 |
+| 避免 | 不要用于 Feed OpenCard。属性与组合方式以本页类型和示例为准。 |
+
+#### 声明
+
+```ts
+declare function buttonVariants(props?: (ConfigVariants<{ variant: { default: string; outline: string; secondary: string; ghost: string; destructive: string; link: string; }; size: { default: string; xs: string; sm: string; lg: string; icon: string; "icon-xs": string; "icon-sm": string; "icon-lg": string; }; }> & ClassProp) | undefined): string;
+```
+
+#### 参数
+
+- `props?`
+
+```ts
+(ConfigVariants<{ variant: { default: string;
+  outline: string;
+  secondary: string;
+  ghost: string;
+  destructive: string;
+  link: string; };
+  size: { default: string;
+  xs: string;
+  sm: string;
+  lg: string;
+  icon: string; "icon-xs": string; "icon-sm": string; "icon-lg": string; }; }> & ClassProp) | undefined
+```
+说明：样式变体以及附加的 class 或 className。
+
+##### props 组件属性
+
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| variant? | `"default" \| "outline" \| "secondary" \| "ghost" \| "destructive" \| "link" \| null \| undefined` | 视觉变体，默认 default（主题色）；outline 描边、secondary 次要、ghost 无底色、destructive 危险色、link 链接样式。只控制样式，不执行业务动作。 |
+| size? | `"default" \| "xs" \| "sm" \| "lg" \| "icon" \| "icon-xs" \| "icon-sm" \| "icon-lg" \| null \| undefined` | 尺寸，默认 default（h-8）；xs/sm/lg 分别为 h-6/h-7/h-9；icon/icon-xs/icon-sm/icon-lg 为 size-8/6/7/9 正方形图标按钮。 |
+
+<details>
+
+<summary>继承的 Taro / React 属性</summary>
+
+以下字段沿用上游类型；组件有特殊处理时，以本页组件属性说明为准。
+
+##### 继承属性
+
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| class? | `ClassValue` |  |
+| className? | `ClassValue` |  |
+
+</details>
+
+#### 返回值
+
+- 类型：`string`

package/dist/reference/sdk-api/ui/button/index.md

@@ -0,0 +1,11 @@
+# ui/button
+
+<!-- Generated by build/src/sdk-reference/skill-reference.ts. Do not edit. -->
+
+导入路径前缀：`@open-dy/vibecoding-sdk-taro/ui/button`
+
+| API | 说明 | 文档 |
+| --- | --- | --- |
+| `Button` | 支持主题样式和抖音 openType 的小程序按钮；用于普通小程序和兴趣卡落地页。 | [查看](./Button.md) |
+| `ButtonProps` | 按钮组件的属性类型；保留 Taro 原生能力，避免 size/type 与样式变体同名冲突。 | [查看](./ButtonProps.md) |
+| `buttonVariants` | 生成按钮的样式类名；接受其声明的样式变体。 | [查看](./buttonVariants.md) |

package/dist/reference/sdk-api/ui/button-group/ButtonGroup.md

@@ -0,0 +1,106 @@
+# ButtonGroup
+
+<!-- Generated by build/src/sdk-reference/skill-reference.ts. Do not edit. -->
+
+导入路径：`@open-dy/vibecoding-sdk-taro/ui/button-group`
+源码：[src/ui/button-group.tsx](../../../../../src/ui/button-group.tsx)（安装包内保留）
+
+#### 说明
+
+按钮组组件。
+
+参数：
+
+| 名称 | 说明 |
+| --- | --- |
+| `props` | 组件属性；自有字段的用途及默认行为见下表，继承属性另列。 |
+
+返回：组件渲染结果；类型见返回值契约。
+
+示例：
+
+```tsx
+import { ButtonGroup } from '@open-dy/vibecoding-sdk-taro/ui/button-group'
+<ButtonGroup />
+```
+
+#### AI 使用约束
+
+| 规则 | 内容 |
+| --- | --- |
+| 意图 | 普通小程序或兴趣卡落地页：按钮组组件。 |
+| 适用时机 | 普通小程序或兴趣卡落地页需要该 UI 模块时，按模块示例组合使用。 |
+| 避免 | 不要用于 Feed OpenCard。属性与组合方式以本页类型和示例为准。 |
+
+#### 声明
+
+```ts
+declare function ButtonGroup(props: ViewProps & VariantProps<(props?: (ConfigVariants<{ orientation: { horizontal: string; vertical: string; }; }> & ClassProp) | undefined) => string>): React.JSX.Element;
+```
+
+#### 参数
+
+| 参数 | 类型 | 说明 |
+| --- | --- | --- |
+| props | `ViewProps & VariantProps<(props?: (ConfigVariants<{ orientation: { horizontal: string; vertical: string; }; }> & ClassProp) \| undefined) => string>` | 组件属性；自有字段的用途及默认行为见下表，继承属性另列。 |
+
+##### props 组件属性
+
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| orientation? | `"horizontal" \| "vertical" \| null \| undefined` | 排列方向，默认 horizontal（横排）；vertical 纵排。同时调整子按钮的相连边框和首尾圆角。 |
+
+<details>
+
+<summary>继承的 Taro / React 属性</summary>
+
+以下字段沿用上游类型；组件有特殊处理时，以本页组件属性说明为准。
+
+##### 继承属性
+
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| hoverClass? | `string \| undefined` | 指定按下去的样式类。当 `hover-class="none"` 时，没有点击态效果 |
+| hoverStyle? | `any` | 由于 RN 不支持 hoverClass，故 RN 端的 View 组件实现了 `hoverStyle`属性，写法和 style 类似，只不过 `hoverStyle` 的样式是指定按下去的样式。 |
+| hoverStopPropagation? | `boolean \| undefined` | 指定是否阻止本节点的祖先节点出现点击态 |
+| hoverStartTime? | `number \| undefined` | 按住后多久出现点击态，单位毫秒 |
+| hoverStayTime? | `number \| undefined` | 手指松开后点击态保留时间，单位毫秒 |
+| disableScroll? | `boolean \| undefined` | 是否阻止区域内滚动页面。 说明： 如果 view 中嵌套 view，外层 view 设置 disable-scroll 为 true 时禁止内部的滚动。 |
+| hidden? | `boolean \| undefined` | 是否隐藏。 |
+| animation? | `TaroGeneral.IAnyObject \| undefined` | 用于动画，详见 my.createAnimation 。使用 my.createAnimation 生成的动画是通过过渡（Transition）实现的，只会触发 onTransitionEnd，不会触发 onAnimationStart, onAnimationIteration, onAnimationEnd。 |
+| role? | `string \| undefined` | 表示组件的语义角色。设置为 img 时，组件聚焦后读屏软件会朗读出 图像 ；设置为 button 时，聚焦后读屏软件会朗读出 按钮 。详情请参见 aria-component。 |
+| ariaRole? | `string \| undefined` | 无障碍访问，（角色）标识元素的作用 |
+| ariaLabel? | `string \| undefined` | 无障碍访问，（属性）元素的额外描述 |
+| onTap? | `CommonEventFunction \| undefined` | 点击。 |
+| onTouchStart? | `CommonEventFunction \| undefined` | 触摸动作开始。 |
+| onTouchMove? | `CommonEventFunction \| undefined` | 触摸后移动。 |
+| onTouchEnd? | `CommonEventFunction \| undefined` | 触摸动作结束。 |
+| onTouchCancel? | `CommonEventFunction \| undefined` | 触摸动作被打断，如来电提醒，弹窗。 |
+| onLongTap? | `CommonEventFunction \| undefined` | 长按 500ms 之后触发，触发了长按事件后进行移动将不会触发屏幕的滚动。 |
+| onTransitionEnd? | `CommonEventFunction \| undefined` | 过渡（Transition）结束时触发。 |
+| onAnimationIteration? | `CommonEventFunction \| undefined` | 每开启一次新的动画过程时触发。（第一次不触发） |
+| onAnimationStart? | `CommonEventFunction \| undefined` | 动画开始时触发。 |
+| onAnimationEnd? | `CommonEventFunction \| undefined` | 动画结束时触发。 |
+| onAppear? | `CommonEventFunction \| undefined` | 当前元素可见面积超过50%时触发。 |
+| onDisappear? | `CommonEventFunction \| undefined` | 当前元素不可见面积超过50%时触发。 |
+| onFirstAppear? | `CommonEventFunction \| undefined` | 当前元素首次可见面积达到50%时触发。 |
+| catchMove? | `boolean \| undefined` | 是否以 catch 的形式绑定 touchmove 事件 |
+| id? | `string \| undefined` | 组件的唯一标示, 保持整个页面唯一 |
+| className? | `string \| undefined` | 同 `class`，在 React/Preact 里一般使用 `className` 作为 `class` 的代称 |
+| style? | `string \| React.CSSProperties \| undefined` | 组件的内联样式, 可以动态设置的内联样式 |
+| children? | `React.ReactNode` | 子节点 |
+| key? | `string \| number \| undefined` | 如果列表中项目的位置会动态改变或者有新的项目添加到列表中， 需要使用 `wx:key` 来指定列表中项目的唯一的标识符。 |
+| ref? | `React.LegacyRef<any> \| undefined` | 引用 |
+| dangerouslySetInnerHTML? | `{ __html: string; } \| undefined` | 渲染 HTML |
+| compileMode? | `string \| boolean \| undefined` | 是否开启编译模式 或者 是否是编译模式的子渲染函数 |
+| harmonyDirection? | `"row" \| "column" \| "flex" \| undefined` | 自定义容器组件的方向 |
+| onClick? | `((event: ITouchEvent) => void) \| undefined` | 手指触摸后马上离开 |
+| onLongPress? | `((event: CommonEvent) => void) \| undefined` | 手指触摸后，超过350ms再离开，如果指定了事件回调函数并触发了这个事件，tap事件将不被触发 |
+| onLongClick? | `((event: CommonEvent) => void) \| undefined` | 手指触摸后，超过350ms再离开（推荐使用 longpress 事件代替） |
+| onTouchForceChange? | `((event: CommonEvent) => void) \| undefined` | 在支持 3D Touch 的 iPhone 设备，重按时会触发 |
+
+</details>
+
+#### 返回值
+
+- 类型：`React.JSX.Element`