| 屬性 | 類型 | 默認值 | 必填 | 說明 | 最低版本 |
|---|---|---|---|---|---|
| size | string | default | 否 | 按鈕的大小 | 1.0.0 |
| type | string | default | 否 | 按鈕的樣式類型 | 1.0.0 |
| plain | boolean | false | 否 | 按鈕是否鏤空，背景色透明 | 1.0.0 |
| disabled | boolean | false | 否 | 是否禁用 | 1.0.0 |
| loading | boolean | false | 否 | 名稱前是否帶 loading 圖標 | 1.0.0 |
| form-type | string | 否 | 用於 form 組件，點擊分別會觸發 form 組件的 submit/reset 事件 | 1.0.0 | |
| open-type | string | 否 | 微信開放能力 | 1.1.0 | |
| hover-class | string | button-hover | 否 | 指定按鈕按下去的樣式類。當 hover-class="none" 時，沒有點擊態效果 |
1.0.0 |
| hover-stop-propagation | boolean | false | 否 | 指定是否阻止本節點的祖先節點出現點擊態 | 1.5.0 |
| hover-start-time | number | 20 | 否 | 按住后多久出現點擊態，單位毫秒 | 1.0.0 |
| hover-stay-time | number | 70 | 否 | 手指松開后點擊態保留時間，單位毫秒 | 1.0.0 |
| lang | string | en | 否 | 指定返回用戶信息的語言，zh_CN 簡體中文，zh_TW 繁體中文，en 英文。 | 1.3.0 |
| session-from | string | 否 | 會話來源，open-type="contact"時有效 | 1.4.0 | |
| send-message-title | string | 當前標題 | 否 | 會話內消息卡片標題，open-type="contact"時有效 | 1.5.0 |
| send-message-path | string | 當前分享路徑 | 否 | 會話內消息卡片點擊跳轉小程序路徑，open-type="contact"時有效 | 1.5.0 |
| send-message-img | string | 截圖 | 否 | 會話內消息卡片圖片，open-type="contact"時有效 | 1.5.0 |
| app-parameter | string | 否 | 打開 APP 時，向 APP 傳遞的參數，open-type=launchApp時有效 | 1.9.5 | |
| show-message-card | boolean | false | 否 | 是否顯示會話內消息卡片，設置此參數為 true，用戶進入客服會話會在右下角顯示"可能要發送的小程序"提示，用戶點擊后可以快速發送小程序消息，open-type="contact"時有效 | 1.5.0 |
| bindgetuserinfo | eventhandle | 否 | 用戶點擊該按鈕時，會返回獲取到的用戶信息，回調的detail數據與wx.getUserInfo返回的一致，open-type="getUserInfo"時有效 | 1.3.0 | |
| bindcontact | eventhandle | 否 | 客服消息回調，open-type="contact"時有效 | 1.5.0 | |
| bindgetphonenumber | eventhandle | 否 | 獲取用戶手機號回調，open-type=getPhoneNumber時有效 | 1.2.0 | |
| binderror | eventhandle | 否 | 當使用開放能力時，發生錯誤的回調，open-type=launchApp時有效 | 1.9.5 | |
| bindopensetting | eventhandle | 否 | 在打開授權設置頁后回調，open-type=openSetting時有效 | 2.0.7 | |
| bindlaunchapp | eventhandle | 否 | 打開 APP 成功的回調，open-type=launchApp時有效 | 2.4.4 |
size 的合法值
| 值 | 說明 | 最低版本 |
|---|---|---|
| default | 默認大小 | |
| mini | 小尺寸 |
type 的合法值
| 值 | 說明 | 最低版本 |
|---|---|---|
| primary | 綠色 | |
| default | 白色 | |
| warn | 紅色 |
form-type 的合法值
| 值 | 說明 | 最低版本 |
|---|---|---|
| submit | 提交表單 | |
| reset | 重置表單 |
open-type 的合法值
| 值 | 說明 | 最低版本 |
|---|---|---|
| contact | 打開客服會話，如果用戶在會話中點擊消息卡片后返回小程序，可以從 bindcontact 回調中獲得具體信息，具體說明 （小程序插件中不能使用） | 1.1.0 |
| share | 觸發用戶轉發，使用前建議先閱讀使用指引 | 1.2.0 |
| getPhoneNumber | 獲取用戶手機號，可以從bindgetphonenumber回調中獲取到用戶信息，具體說明 （小程序插件中不能使用） | 1.2.0 |
| getUserInfo | 獲取用戶信息，可以從bindgetuserinfo回調中獲取到用戶信息 （小程序插件中不能使用） | 1.3.0 |
| launchApp | 打開APP，可以通過app-parameter屬性設定向APP傳的參數具體說明 | 1.9.5 |
| openSetting | 打開授權設置頁 | 2.0.7 |
| feedback | 打開“意見反饋”頁面，用戶可提交反饋內容並上傳日志，開發者可以登錄小程序管理后台后進入左側菜單“客服反饋”頁面獲取到反饋內容 | 2.1.0 |
lang 的合法值
| 值 | 說明 | 最低版本 |
|---|---|---|
| en | 英文 | |
| zh_CN | 簡體中文 | |
| zh_TW | 繁體中文 |
下面舉例子：
外觀主要用到這幾個屬性：
button 標簽
1 外觀的屬性
1 size 控制按鈕的大小
1 default 默認大小
2 mini 小尺寸
2 type 用來控制按鈕的顏色
1 default 灰色 （字體顏色是綠色）
2 primary 綠色 （字體顏色是白色）
3 warn 紅色 （字體紅色）
3 plain 按鈕是否鏤空，背景色透明
4 loading 文字前顯示正在等待圖標
運行：
<button size="default" type="default">default 按鈕(type="default")</button> <button size="mini" type="primary">mini 按鈕(type="primary")</button> <button size="default" type="warn">warn 按鈕</button> <button plain>鏤空按鈕</button> <button loading >登錄中</button>
