> For AI agents: the complete documentation index is available at /apps-plugin/docs/llms.txt, the full documentation bundle is available at /apps-plugin/docs/llms-full.txt.

# button

按钮组件。

<iframe src="https://developer.doubao.com/docs-preview/component-simulator/?caseId=button"
  title="组件示例 button"
  width="100%"
  height="700"
  loading="lazy"
  style="width:100%;height:700px;border:0;border-radius:16px;overflow:hidden;"
></iframe>

## 扫码预览

![扫码预览 button](https://api.qrserver.com/v1/create-qr-code/?size=200x200\&data=doubao%3A%2F%2Fdoubao_apps%3Fapp_id%3Ddb_1McM5Ni%26path%3D%252Fpages%252Fcomponent%252Fbutton%252Findex)

## Props

<table>
<thead>
<tr><th width="140">属性名</th><th width="240">类型</th><th width="120">默认值</th><th width="80">必填</th><th width="360">说明</th></tr>
</thead>
<tbody>
<tr><td>children</td><td><code>ReactNode</code></td><td>-</td><td>否</td><td>子元素，用于自定义内容。当同时提供 icon/text 和 children 时，children 优先。</td></tr>
<tr><td>className</td><td><code>string</code></td><td>-</td><td>否</td><td>组件类名</td></tr>
<tr><td>disabled</td><td><code>boolean</code></td><td>false</td><td>否</td><td>是否禁用</td></tr>
<tr><td>icon</td><td><code>ReactNode</code></td><td>-</td><td>否</td><td>图标，显示在文字前面</td></tr>
<tr><td>key</td><td><code>string | number | null</code></td><td>-</td><td>否</td><td>React key 属性</td></tr>
<tr><td>launchAppUrl</td><td><code>string</code></td><td>-</td><td>否</td><td>跳转外部应用的 deeplink URL，只在 openType=&quot;launchApp&quot; 时有效。<br>前端库版本不低于 0.1.1。</td></tr>
<tr><td>loading</td><td><code>boolean</code></td><td>false</td><td>否</td><td>是否显示加载状态</td></tr>
<tr><td>onAgreePrivacyAuthorization</td><td><code>(result?: AgreePrivacyResult) =&gt; void</code></td><td>-</td><td>否</td><td>授权隐私协议回调，只在 openType=&quot;agreePrivacyAuthorization&quot; 时有效</td></tr>
<tr><td>onClick</td><td><code>(event?: TouchEvent) =&gt; void</code></td><td>-</td><td>否</td><td>点击回调函数</td></tr>
<tr><td>onDisabledClick</td><td><code>(event?: TouchEvent) =&gt; void</code></td><td>-</td><td>否</td><td>禁用状态下的点击回调函数</td></tr>
<tr><td>onGetPhoneNumber</td><td><code>(result?: GetPhoneNumberResult) =&gt; void</code></td><td>-</td><td>否</td><td>获取用户手机号回调，只在 openType=&quot;getPhoneNumber&quot; 时有效</td></tr>
<tr><td>onLaunchApp</td><td><code>(result: OpenAppResult) =&gt; void</code></td><td>-</td><td>否</td><td>跳转外部应用回调，只在 openType=&quot;launchApp&quot; 时有效。<br><br>仅在跳转成功时返回跳转结果。<br>前端库版本不低于 0.1.1。</td></tr>
<tr><td>onLaunchAppError</td><td><code>(error: unknown) =&gt; void</code></td><td>-</td><td>否</td><td>跳转外部应用失败回调，只在 openType=&quot;launchApp&quot; 时有效。<br>前端库版本不低于 0.1.1。</td></tr>
<tr><td>onOpenSetting</td><td><code>(event: OpenSettingEvent) =&gt; void</code></td><td>-</td><td>否</td><td>打开授权设置页回调，只在 openType=&quot;openSetting&quot; 时有效<br><br>成功时 detail 包含 <code>errMsg: 'openSetting:ok'</code> 和最新 <code>authSetting</code>；<br>失败时 detail 仅包含 <code>openSetting:fail ...</code>，不会包含 <code>authSetting</code> 字段。</td></tr>
<tr><td>openType</td><td><code>&quot;getPhoneNumber&quot;<br>| &quot;agreePrivacyAuthorization&quot;<br>| &quot;agreePrivacyAuthorization|getPhoneNumber&quot;<br>| &quot;openSetting&quot;<br>| &quot;launchApp&quot;</code></td><td>-</td><td>否</td><td>开放能力类型</td></tr>
<tr><td>showDisabledStyle</td><td><code>boolean</code></td><td>true</td><td>否</td><td>是否展示组件内置的禁用态样式</td></tr>
<tr><td>size</td><td><code>ButtonSize</code></td><td>'default'</td><td>否</td><td>按钮尺寸</td></tr>
<tr><td>style</td><td><code>CSSProperties</code></td><td>-</td><td>否</td><td>组件样式</td></tr>
<tr><td>text</td><td><code>string</code></td><td>-</td><td>否</td><td>按钮文字</td></tr>
<tr><td>throttle</td><td><code>number</code></td><td>500</td><td>否</td><td>onClick 的节流时间，单位为毫秒</td></tr>
<tr><td>type</td><td><code>ButtonType</code></td><td>'primary'</td><td>否</td><td>按钮样式类型</td></tr>
</tbody>
</table>

## 使用建议

由于组件不开启 CSS 继承，button 的文本样式不会自动应用到 children。
因此提供了以下明确的 API 用法：

- `text`：传入字符串，按钮会应用默认文本样式
- `icon` + `text`：组合使用，显示图标和文字
- `children`：完全自定义内容，**不会**应用按钮的默认文本样式

```tsx
// 简单文字：用 text（推荐）
<button text="确定" />

// 图标+文字：用 icon + text
<button icon={<Icon />} text="提交" />

// 完全自定义：用 children（无默认样式）
<button>
  <text style={{ color: 'red' }}>自定义</text>
</button>
```
