#button
按钮组件。
#扫码预览
#Props
| 属性名 | 类型 | 默认值 | 必填 | 说明 |
|---|---|---|---|---|
| children | ReactNode | - | 否 | 子元素,用于自定义内容。当同时提供 icon/text 和 children 时,children 优先。 |
| className | string | - | 否 | 组件类名 |
| disabled | boolean | false | 否 | 是否禁用 |
| icon | ReactNode | - | 否 | 图标,显示在文字前面 |
| key | string | number | null | - | 否 | React key 属性 |
| launchAppUrl | string | - | 否 | 跳转外部应用的 deeplink URL,只在 openType="launchApp" 时有效。 前端库版本不低于 0.1.1。 |
| loading | boolean | false | 否 | 是否显示加载状态 |
| onAgreePrivacyAuthorization | (result?: AgreePrivacyResult) => void | - | 否 | 授权隐私协议回调,只在 openType="agreePrivacyAuthorization" 时有效 |
| onClick | (event?: TouchEvent) => void | - | 否 | 点击回调函数 |
| onDisabledClick | (event?: TouchEvent) => void | - | 否 | 禁用状态下的点击回调函数 |
| onGetPhoneNumber | (result?: GetPhoneNumberResult) => void | - | 否 | 获取用户手机号回调,只在 openType="getPhoneNumber" 时有效 |
| onLaunchApp | (result: OpenAppResult) => void | - | 否 | 跳转外部应用回调,只在 openType="launchApp" 时有效。 仅在跳转成功时返回跳转结果。 前端库版本不低于 0.1.1。 |
| onLaunchAppError | (error: unknown) => void | - | 否 | 跳转外部应用失败回调,只在 openType="launchApp" 时有效。 前端库版本不低于 0.1.1。 |
| onOpenSetting | (event: OpenSettingEvent) => void | - | 否 | 打开授权设置页回调,只在 openType="openSetting" 时有效 成功时 detail 包含 errMsg: 'openSetting:ok' 和最新 authSetting;失败时 detail 仅包含 openSetting:fail ...,不会包含 authSetting 字段。 |
| openType | "getPhoneNumber" | - | 否 | 开放能力类型 |
| showDisabledStyle | boolean | true | 否 | 是否展示组件内置的禁用态样式 |
| size | ButtonSize | 'default' | 否 | 按钮尺寸 |
| style | CSSProperties | - | 否 | 组件样式 |
| text | string | - | 否 | 按钮文字 |
| throttle | number | 500 | 否 | onClick 的节流时间,单位为毫秒 |
| type | ButtonType | 'primary' | 否 | 按钮样式类型 |
#使用建议
由于组件不开启 CSS 继承,button 的文本样式不会自动应用到 children。 因此提供了以下明确的 API 用法:
text:传入字符串,按钮会应用默认文本样式icon+text:组合使用,显示图标和文字children:完全自定义内容,不会应用按钮的默认文本样式
// 简单文字:用 text(推荐)
<button text="确定" />
// 图标+文字:用 icon + text
<button icon={<Icon />} text="提交" />
// 完全自定义:用 children(无默认样式)
<button>
<text style={{ color: 'red' }}>自定义</text>
</button>