# button

基礎(chǔ)庫 1.0.0 開始支持，低版本需做兼容處理。

微信 Windows 版：支持

微信 Mac 版：支持

微信 鴻蒙 OS 版：支持

相關(guān)文檔: 聊天工具模式

渲染框架支持情況：Skyline （使用最新 Nightly 工具調(diào)試）、WebView

# 功能描述

按鈕。

# 通用屬性

# Bug & Tip

1. tip: button-hover 默認(rèn)為{background-color: rgba(0, 0, 0, 0.1); opacity: 0.7;}
2. tip: bindgetphonenumber 從1.2.0 開始支持，但是在1.5.3以下版本中無法使用wx.canIUse進(jìn)行檢測，建議使用基礎(chǔ)庫版本進(jìn)行判斷。
3. tip: 在bindgetphonenumber 等返回加密信息的回調(diào)中調(diào)用 wx.login 登錄，可能會刷新登錄態(tài)。此時服務(wù)器使用 code 換取的 sessionKey 不是加密時使用的 sessionKey，導(dǎo)致解密失敗。建議開發(fā)者提前進(jìn)行 login；或者在回調(diào)中先使用 checkSession 進(jìn)行登錄態(tài)檢查，避免 login 刷新登錄態(tài)。
4. tip: 從 2.21.2 起，對getPhoneNumber接口進(jìn)行了安全升級，bindgetphonenumber 返回的信息中增加code參數(shù)，code是一個動態(tài)的令牌，開發(fā)者拿到code后需調(diào)用微信后臺接口換取手機(jī)號。詳情新版接口使用指南
5. tip: 從 2.1.0 起，button 可作為原生組件的子節(jié)點嵌入，以便在原生組件上使用 open-type 的能力。
6. tip: 目前設(shè)置了 form-type 的 button 只會對當(dāng)前組件中的 form 有效。因而，將 button 封裝在自定義組件中，而 form 在自定義組件外，將會使這個 button 的 form-type 失效。

# 發(fā)送文本到群示例代碼

需結(jié)合 form 和 textarea 組件使用。 button 需要設(shè)置 form-type="submitToGroup"，此時點擊按鈕將會發(fā)送 textarea 的內(nèi)容到聊天。

<form bind:submitToGroup="onSubmitToGroup">
	<textarea value="{{shareText}}" />
	<button
    form-type="submitToGroup"
    need-show-entrance="{{true}}"
    entrance-path=""
	></button>
</form>

# 示例代碼

在開發(fā)者工具中預(yù)覽效果