1# button<a name="ZH-CN_TOPIC_0000001209570697"></a> 2 3提供按钮组件,包括胶囊按钮、圆形按钮、文本按钮、弧形按钮、下载按钮。 4 5## 子组件<a name="zh-cn_topic_0000001173324623_section9288143101012"></a> 6 7不支持。 8 9## 属性<a name="zh-cn_topic_0000001173324623_section2907183951110"></a> 10 11除支持[通用属性](js-components-common-attributes.md)外,还支持如下属性: 12 13<a name="zh-cn_topic_0000001173324623_table20633101642315"></a> 14<table><thead align="left"><tr id="zh-cn_topic_0000001173324623_row663331618238"><th class="cellrowborder" valign="top" width="23.119999999999997%" id="mcps1.1.6.1.1"><p id="zh-cn_topic_0000001173324623_aa872998ac2d84843a3c5161889afffef"><a name="zh-cn_topic_0000001173324623_aa872998ac2d84843a3c5161889afffef"></a><a name="zh-cn_topic_0000001173324623_aa872998ac2d84843a3c5161889afffef"></a>名称</p> 15</th> 16<th class="cellrowborder" valign="top" width="23.119999999999997%" id="mcps1.1.6.1.2"><p id="zh-cn_topic_0000001173324623_ab2111648ee0e4f6d881be8954e7acaab"><a name="zh-cn_topic_0000001173324623_ab2111648ee0e4f6d881be8954e7acaab"></a><a name="zh-cn_topic_0000001173324623_ab2111648ee0e4f6d881be8954e7acaab"></a>类型</p> 17</th> 18<th class="cellrowborder" valign="top" width="10.48%" id="mcps1.1.6.1.3"><p id="zh-cn_topic_0000001173324623_ab377d1c90900478ea4ecab51e9a058af"><a name="zh-cn_topic_0000001173324623_ab377d1c90900478ea4ecab51e9a058af"></a><a name="zh-cn_topic_0000001173324623_ab377d1c90900478ea4ecab51e9a058af"></a>默认值</p> 19</th> 20<th class="cellrowborder" valign="top" width="7.5200000000000005%" id="mcps1.1.6.1.4"><p id="zh-cn_topic_0000001173324623_p824610360217"><a name="zh-cn_topic_0000001173324623_p824610360217"></a><a name="zh-cn_topic_0000001173324623_p824610360217"></a>必填</p> 21</th> 22<th class="cellrowborder" valign="top" width="35.76%" id="mcps1.1.6.1.5"><p id="zh-cn_topic_0000001173324623_a1d574a0044ed42ec8a2603bc82734232"><a name="zh-cn_topic_0000001173324623_a1d574a0044ed42ec8a2603bc82734232"></a><a name="zh-cn_topic_0000001173324623_a1d574a0044ed42ec8a2603bc82734232"></a>描述</p> 23</th> 24</tr> 25</thead> 26<tbody><tr id="zh-cn_topic_0000001173324623_row1515165893313"><td class="cellrowborder" valign="top" width="23.119999999999997%" headers="mcps1.1.6.1.1 "><p id="zh-cn_topic_0000001173324623_p569785910333"><a name="zh-cn_topic_0000001173324623_p569785910333"></a><a name="zh-cn_topic_0000001173324623_p569785910333"></a>type</p> 27</td> 28<td class="cellrowborder" valign="top" width="23.119999999999997%" headers="mcps1.1.6.1.2 "><p id="zh-cn_topic_0000001173324623_p26971659203314"><a name="zh-cn_topic_0000001173324623_p26971659203314"></a><a name="zh-cn_topic_0000001173324623_p26971659203314"></a>string</p> 29</td> 30<td class="cellrowborder" valign="top" width="10.48%" headers="mcps1.1.6.1.3 "><p id="zh-cn_topic_0000001173324623_p869775913314"><a name="zh-cn_topic_0000001173324623_p869775913314"></a><a name="zh-cn_topic_0000001173324623_p869775913314"></a>-</p> 31</td> 32<td class="cellrowborder" valign="top" width="7.5200000000000005%" headers="mcps1.1.6.1.4 "><p id="zh-cn_topic_0000001173324623_p969714591338"><a name="zh-cn_topic_0000001173324623_p969714591338"></a><a name="zh-cn_topic_0000001173324623_p969714591338"></a>否</p> 33</td> 34<td class="cellrowborder" valign="top" width="35.76%" headers="mcps1.1.6.1.5 "><p id="zh-cn_topic_0000001173324623_p196974598338"><a name="zh-cn_topic_0000001173324623_p196974598338"></a><a name="zh-cn_topic_0000001173324623_p196974598338"></a>不支持动态修改。如果该属性缺省,展示类胶囊型按钮,不同于胶囊类型,四边圆角可以通过border-radius分别指定,如果需要设置该属性,则可选值包括如下:</p> 35<a name="zh-cn_topic_0000001173324623_ul16971659103317"></a><a name="zh-cn_topic_0000001173324623_ul16971659103317"></a><ul id="zh-cn_topic_0000001173324623_ul16971659103317"><li>capsule:胶囊型按钮,带圆角按钮,有背景色和文本;</li><li>circle:圆形按钮,支持放置图标;</li><li>text:文本按钮,仅包含文本显示;</li><li>arc:弧形按钮,仅支持智能穿戴;</li><li>download:下载按钮,额外增加下载进度条功能,仅支持手机和智慧屏。</li></ul> 36</td> 37</tr> 38<tr id="zh-cn_topic_0000001173324623_row6883454133320"><td class="cellrowborder" valign="top" width="23.119999999999997%" headers="mcps1.1.6.1.1 "><p id="zh-cn_topic_0000001173324623_p6698195910338"><a name="zh-cn_topic_0000001173324623_p6698195910338"></a><a name="zh-cn_topic_0000001173324623_p6698195910338"></a>value</p> 39</td> 40<td class="cellrowborder" valign="top" width="23.119999999999997%" headers="mcps1.1.6.1.2 "><p id="zh-cn_topic_0000001173324623_p369814598336"><a name="zh-cn_topic_0000001173324623_p369814598336"></a><a name="zh-cn_topic_0000001173324623_p369814598336"></a>string</p> 41</td> 42<td class="cellrowborder" valign="top" width="10.48%" headers="mcps1.1.6.1.3 "><p id="zh-cn_topic_0000001173324623_p269895912338"><a name="zh-cn_topic_0000001173324623_p269895912338"></a><a name="zh-cn_topic_0000001173324623_p269895912338"></a>-</p> 43</td> 44<td class="cellrowborder" valign="top" width="7.5200000000000005%" headers="mcps1.1.6.1.4 "><p id="zh-cn_topic_0000001173324623_p76981259193312"><a name="zh-cn_topic_0000001173324623_p76981259193312"></a><a name="zh-cn_topic_0000001173324623_p76981259193312"></a>否</p> 45</td> 46<td class="cellrowborder" valign="top" width="35.76%" headers="mcps1.1.6.1.5 "><p id="zh-cn_topic_0000001173324623_p369810591333"><a name="zh-cn_topic_0000001173324623_p369810591333"></a><a name="zh-cn_topic_0000001173324623_p369810591333"></a>button的文本值,circle类型不生效。</p> 47</td> 48</tr> 49<tr id="zh-cn_topic_0000001173324623_row8476152143316"><td class="cellrowborder" valign="top" width="23.119999999999997%" headers="mcps1.1.6.1.1 "><p id="zh-cn_topic_0000001173324623_p16698259173318"><a name="zh-cn_topic_0000001173324623_p16698259173318"></a><a name="zh-cn_topic_0000001173324623_p16698259173318"></a>icon</p> 50</td> 51<td class="cellrowborder" valign="top" width="23.119999999999997%" headers="mcps1.1.6.1.2 "><p id="zh-cn_topic_0000001173324623_p1169818599332"><a name="zh-cn_topic_0000001173324623_p1169818599332"></a><a name="zh-cn_topic_0000001173324623_p1169818599332"></a>string</p> 52</td> 53<td class="cellrowborder" valign="top" width="10.48%" headers="mcps1.1.6.1.3 "><p id="zh-cn_topic_0000001173324623_p1169855943315"><a name="zh-cn_topic_0000001173324623_p1169855943315"></a><a name="zh-cn_topic_0000001173324623_p1169855943315"></a>-</p> 54</td> 55<td class="cellrowborder" valign="top" width="7.5200000000000005%" headers="mcps1.1.6.1.4 "><p id="zh-cn_topic_0000001173324623_p1669865919337"><a name="zh-cn_topic_0000001173324623_p1669865919337"></a><a name="zh-cn_topic_0000001173324623_p1669865919337"></a>否</p> 56</td> 57<td class="cellrowborder" valign="top" width="35.76%" headers="mcps1.1.6.1.5 "><p id="zh-cn_topic_0000001173324623_p8698135914336"><a name="zh-cn_topic_0000001173324623_p8698135914336"></a><a name="zh-cn_topic_0000001173324623_p8698135914336"></a>button的图标路径,图标格式为jpg,png和svg。</p> 58</td> 59</tr> 60<tr id="zh-cn_topic_0000001173324623_row19478449411"><td class="cellrowborder" valign="top" width="23.119999999999997%" headers="mcps1.1.6.1.1 "><p id="zh-cn_topic_0000001173324623_p11904175316315"><a name="zh-cn_topic_0000001173324623_p11904175316315"></a><a name="zh-cn_topic_0000001173324623_p11904175316315"></a>placement<sup id="zh-cn_topic_0000001173324623_sup220512551047"><a name="zh-cn_topic_0000001173324623_sup220512551047"></a><a name="zh-cn_topic_0000001173324623_sup220512551047"></a><span>5+</span></sup></p> 61</td> 62<td class="cellrowborder" valign="top" width="23.119999999999997%" headers="mcps1.1.6.1.2 "><p id="zh-cn_topic_0000001173324623_p1390413531314"><a name="zh-cn_topic_0000001173324623_p1390413531314"></a><a name="zh-cn_topic_0000001173324623_p1390413531314"></a>string</p> 63</td> 64<td class="cellrowborder" valign="top" width="10.48%" headers="mcps1.1.6.1.3 "><p id="zh-cn_topic_0000001173324623_p390465317319"><a name="zh-cn_topic_0000001173324623_p390465317319"></a><a name="zh-cn_topic_0000001173324623_p390465317319"></a>end</p> 65</td> 66<td class="cellrowborder" valign="top" width="7.5200000000000005%" headers="mcps1.1.6.1.4 "><p id="zh-cn_topic_0000001173324623_p1990415317319"><a name="zh-cn_topic_0000001173324623_p1990415317319"></a><a name="zh-cn_topic_0000001173324623_p1990415317319"></a>否</p> 67</td> 68<td class="cellrowborder" valign="top" width="35.76%" headers="mcps1.1.6.1.5 "><p id="zh-cn_topic_0000001173324623_p1990410531316"><a name="zh-cn_topic_0000001173324623_p1990410531316"></a><a name="zh-cn_topic_0000001173324623_p1990410531316"></a>仅在type属性为缺省时生效,设置图标位于文本的位置,可选值为:</p> 69<a name="zh-cn_topic_0000001173324623_ul1190565393119"></a><a name="zh-cn_topic_0000001173324623_ul1190565393119"></a><ul id="zh-cn_topic_0000001173324623_ul1190565393119"><li>start:图标位于文本起始处;</li><li>end:图标位于文本结束处;</li><li>top:图标位于文本上方;</li><li>bottom:图标位于文本下方。</li></ul> 70</td> 71</tr> 72<tr id="zh-cn_topic_0000001173324623_row79691049103313"><td class="cellrowborder" valign="top" width="23.119999999999997%" headers="mcps1.1.6.1.1 "><p id="zh-cn_topic_0000001173324623_p1569817594334"><a name="zh-cn_topic_0000001173324623_p1569817594334"></a><a name="zh-cn_topic_0000001173324623_p1569817594334"></a>waiting</p> 73</td> 74<td class="cellrowborder" valign="top" width="23.119999999999997%" headers="mcps1.1.6.1.2 "><p id="zh-cn_topic_0000001173324623_p369818591338"><a name="zh-cn_topic_0000001173324623_p369818591338"></a><a name="zh-cn_topic_0000001173324623_p369818591338"></a>boolean</p> 75</td> 76<td class="cellrowborder" valign="top" width="10.48%" headers="mcps1.1.6.1.3 "><p id="zh-cn_topic_0000001173324623_p16981599336"><a name="zh-cn_topic_0000001173324623_p16981599336"></a><a name="zh-cn_topic_0000001173324623_p16981599336"></a>false</p> 77</td> 78<td class="cellrowborder" valign="top" width="7.5200000000000005%" headers="mcps1.1.6.1.4 "><p id="zh-cn_topic_0000001173324623_p1869875913332"><a name="zh-cn_topic_0000001173324623_p1869875913332"></a><a name="zh-cn_topic_0000001173324623_p1869875913332"></a>否</p> 79</td> 80<td class="cellrowborder" valign="top" width="35.76%" headers="mcps1.1.6.1.5 "><p id="zh-cn_topic_0000001173324623_p1069813596335"><a name="zh-cn_topic_0000001173324623_p1069813596335"></a><a name="zh-cn_topic_0000001173324623_p1069813596335"></a>waiting状态,waiting为true时展现等待中转圈效果,位于文本左侧。类型为download时不生效,不支持智能穿戴。</p> 81</td> 82</tr> 83</tbody> 84</table> 85 86## 样式<a name="zh-cn_topic_0000001173324623_section5775351116"></a> 87 88**type设置为非arc时:** 89 90除支持[通用样式](js-components-common-styles.md)外,还支持如下样式: 91 92<a name="zh-cn_topic_0000001173324623_table10836163016447"></a> 93<table><thead align="left"><tr id="zh-cn_topic_0000001173324623_row3836113016445"><th class="cellrowborder" valign="top" width="17.458254174582542%" id="mcps1.1.6.1.1"><p id="zh-cn_topic_0000001173324623_p1383783015444"><a name="zh-cn_topic_0000001173324623_p1383783015444"></a><a name="zh-cn_topic_0000001173324623_p1383783015444"></a>名称</p> 94</th> 95<th class="cellrowborder" valign="top" width="11.40885911408859%" id="mcps1.1.6.1.2"><p id="zh-cn_topic_0000001173324623_p9837193015448"><a name="zh-cn_topic_0000001173324623_p9837193015448"></a><a name="zh-cn_topic_0000001173324623_p9837193015448"></a>类型</p> 96</th> 97<th class="cellrowborder" valign="top" width="19.208079192080792%" id="mcps1.1.6.1.3"><p id="zh-cn_topic_0000001173324623_p483723014446"><a name="zh-cn_topic_0000001173324623_p483723014446"></a><a name="zh-cn_topic_0000001173324623_p483723014446"></a>默认值</p> 98</th> 99<th class="cellrowborder" valign="top" width="6.639336066393361%" id="mcps1.1.6.1.4"><p id="zh-cn_topic_0000001173324623_p18371430174413"><a name="zh-cn_topic_0000001173324623_p18371430174413"></a><a name="zh-cn_topic_0000001173324623_p18371430174413"></a>必填</p> 100</th> 101<th class="cellrowborder" valign="top" width="45.28547145285472%" id="mcps1.1.6.1.5"><p id="zh-cn_topic_0000001173324623_p1837133018449"><a name="zh-cn_topic_0000001173324623_p1837133018449"></a><a name="zh-cn_topic_0000001173324623_p1837133018449"></a>描述</p> 102</th> 103</tr> 104</thead> 105<tbody><tr id="zh-cn_topic_0000001173324623_row683733011442"><td class="cellrowborder" valign="top" width="17.458254174582542%" headers="mcps1.1.6.1.1 "><p id="zh-cn_topic_0000001173324623_p583715302445"><a name="zh-cn_topic_0000001173324623_p583715302445"></a><a name="zh-cn_topic_0000001173324623_p583715302445"></a>text-color</p> 106</td> 107<td class="cellrowborder" valign="top" width="11.40885911408859%" headers="mcps1.1.6.1.2 "><p id="zh-cn_topic_0000001173324623_p3837113014448"><a name="zh-cn_topic_0000001173324623_p3837113014448"></a><a name="zh-cn_topic_0000001173324623_p3837113014448"></a><color></p> 108</td> 109<td class="cellrowborder" valign="top" width="19.208079192080792%" headers="mcps1.1.6.1.3 "><p id="zh-cn_topic_0000001173324623_p13837123084418"><a name="zh-cn_topic_0000001173324623_p13837123084418"></a><a name="zh-cn_topic_0000001173324623_p13837123084418"></a>#ff007dff</p> 110</td> 111<td class="cellrowborder" valign="top" width="6.639336066393361%" headers="mcps1.1.6.1.4 "><p id="zh-cn_topic_0000001173324623_p1883753064418"><a name="zh-cn_topic_0000001173324623_p1883753064418"></a><a name="zh-cn_topic_0000001173324623_p1883753064418"></a>否</p> 112</td> 113<td class="cellrowborder" valign="top" width="45.28547145285472%" headers="mcps1.1.6.1.5 "><p id="zh-cn_topic_0000001173324623_p1683719306444"><a name="zh-cn_topic_0000001173324623_p1683719306444"></a><a name="zh-cn_topic_0000001173324623_p1683719306444"></a>按钮的文本颜色。</p> 114</td> 115</tr> 116<tr id="zh-cn_topic_0000001173324623_row198373300448"><td class="cellrowborder" valign="top" width="17.458254174582542%" headers="mcps1.1.6.1.1 "><p id="zh-cn_topic_0000001173324623_p18837130124418"><a name="zh-cn_topic_0000001173324623_p18837130124418"></a><a name="zh-cn_topic_0000001173324623_p18837130124418"></a>font-size</p> 117</td> 118<td class="cellrowborder" valign="top" width="11.40885911408859%" headers="mcps1.1.6.1.2 "><p id="zh-cn_topic_0000001173324623_p1283783094414"><a name="zh-cn_topic_0000001173324623_p1283783094414"></a><a name="zh-cn_topic_0000001173324623_p1283783094414"></a><length></p> 119</td> 120<td class="cellrowborder" valign="top" width="19.208079192080792%" headers="mcps1.1.6.1.3 "><p id="zh-cn_topic_0000001173324623_p1583717304445"><a name="zh-cn_topic_0000001173324623_p1583717304445"></a><a name="zh-cn_topic_0000001173324623_p1583717304445"></a>16px</p> 121</td> 122<td class="cellrowborder" valign="top" width="6.639336066393361%" headers="mcps1.1.6.1.4 "><p id="zh-cn_topic_0000001173324623_p6837133064415"><a name="zh-cn_topic_0000001173324623_p6837133064415"></a><a name="zh-cn_topic_0000001173324623_p6837133064415"></a>否</p> 123</td> 124<td class="cellrowborder" valign="top" width="45.28547145285472%" headers="mcps1.1.6.1.5 "><p id="zh-cn_topic_0000001173324623_p1283823019443"><a name="zh-cn_topic_0000001173324623_p1283823019443"></a><a name="zh-cn_topic_0000001173324623_p1283823019443"></a>按钮的文本尺寸。</p> 125</td> 126</tr> 127<tr id="zh-cn_topic_0000001173324623_row1883814304447"><td class="cellrowborder" valign="top" width="17.458254174582542%" headers="mcps1.1.6.1.1 "><p id="zh-cn_topic_0000001173324623_p1883810309447"><a name="zh-cn_topic_0000001173324623_p1883810309447"></a><a name="zh-cn_topic_0000001173324623_p1883810309447"></a>allow-scale</p> 128</td> 129<td class="cellrowborder" valign="top" width="11.40885911408859%" headers="mcps1.1.6.1.2 "><p id="zh-cn_topic_0000001173324623_p17838130144418"><a name="zh-cn_topic_0000001173324623_p17838130144418"></a><a name="zh-cn_topic_0000001173324623_p17838130144418"></a>boolean</p> 130</td> 131<td class="cellrowborder" valign="top" width="19.208079192080792%" headers="mcps1.1.6.1.3 "><p id="zh-cn_topic_0000001173324623_p2838830124416"><a name="zh-cn_topic_0000001173324623_p2838830124416"></a><a name="zh-cn_topic_0000001173324623_p2838830124416"></a>true</p> 132</td> 133<td class="cellrowborder" valign="top" width="6.639336066393361%" headers="mcps1.1.6.1.4 "><p id="zh-cn_topic_0000001173324623_p88386303449"><a name="zh-cn_topic_0000001173324623_p88386303449"></a><a name="zh-cn_topic_0000001173324623_p88386303449"></a>否</p> 134</td> 135<td class="cellrowborder" valign="top" width="45.28547145285472%" headers="mcps1.1.6.1.5 "><p id="zh-cn_topic_0000001173324623_p7838330184418"><a name="zh-cn_topic_0000001173324623_p7838330184418"></a><a name="zh-cn_topic_0000001173324623_p7838330184418"></a>按钮的文本尺寸是否跟随系统设置字体缩放尺寸进行放大缩小。</p> 136<div class="note" id="zh-cn_topic_0000001173324623_note583873013443"><a name="zh-cn_topic_0000001173324623_note583873013443"></a><a name="zh-cn_topic_0000001173324623_note583873013443"></a><span class="notetitle"> 说明: </span><div class="notebody"><p id="zh-cn_topic_0000001173324623_p1483818307443"><a name="zh-cn_topic_0000001173324623_p1483818307443"></a><a name="zh-cn_topic_0000001173324623_p1483818307443"></a>如果在config描述文件中针对ability配置了fontSize的config-changes标签,则应用不会重启而直接生效。</p> 137</div></div> 138</td> 139</tr> 140<tr id="zh-cn_topic_0000001173324623_row4838173004420"><td class="cellrowborder" valign="top" width="17.458254174582542%" headers="mcps1.1.6.1.1 "><p id="zh-cn_topic_0000001173324623_p1783843094414"><a name="zh-cn_topic_0000001173324623_p1783843094414"></a><a name="zh-cn_topic_0000001173324623_p1783843094414"></a>font-style</p> 141</td> 142<td class="cellrowborder" valign="top" width="11.40885911408859%" headers="mcps1.1.6.1.2 "><p id="zh-cn_topic_0000001173324623_p4838153011441"><a name="zh-cn_topic_0000001173324623_p4838153011441"></a><a name="zh-cn_topic_0000001173324623_p4838153011441"></a>string</p> 143</td> 144<td class="cellrowborder" valign="top" width="19.208079192080792%" headers="mcps1.1.6.1.3 "><p id="zh-cn_topic_0000001173324623_p178388308446"><a name="zh-cn_topic_0000001173324623_p178388308446"></a><a name="zh-cn_topic_0000001173324623_p178388308446"></a>normal</p> 145</td> 146<td class="cellrowborder" valign="top" width="6.639336066393361%" headers="mcps1.1.6.1.4 "><p id="zh-cn_topic_0000001173324623_p283853044418"><a name="zh-cn_topic_0000001173324623_p283853044418"></a><a name="zh-cn_topic_0000001173324623_p283853044418"></a>否</p> 147</td> 148<td class="cellrowborder" valign="top" width="45.28547145285472%" headers="mcps1.1.6.1.5 "><p id="zh-cn_topic_0000001173324623_p16838123015449"><a name="zh-cn_topic_0000001173324623_p16838123015449"></a><a name="zh-cn_topic_0000001173324623_p16838123015449"></a>按钮的字体样式。</p> 149</td> 150</tr> 151<tr id="zh-cn_topic_0000001173324623_row1183823015441"><td class="cellrowborder" valign="top" width="17.458254174582542%" headers="mcps1.1.6.1.1 "><p id="zh-cn_topic_0000001173324623_p3838143016449"><a name="zh-cn_topic_0000001173324623_p3838143016449"></a><a name="zh-cn_topic_0000001173324623_p3838143016449"></a>font-weight</p> 152</td> 153<td class="cellrowborder" valign="top" width="11.40885911408859%" headers="mcps1.1.6.1.2 "><p id="zh-cn_topic_0000001173324623_p3838133004413"><a name="zh-cn_topic_0000001173324623_p3838133004413"></a><a name="zh-cn_topic_0000001173324623_p3838133004413"></a>number | string</p> 154</td> 155<td class="cellrowborder" valign="top" width="19.208079192080792%" headers="mcps1.1.6.1.3 "><p id="zh-cn_topic_0000001173324623_p118381430204412"><a name="zh-cn_topic_0000001173324623_p118381430204412"></a><a name="zh-cn_topic_0000001173324623_p118381430204412"></a>normal</p> 156</td> 157<td class="cellrowborder" valign="top" width="6.639336066393361%" headers="mcps1.1.6.1.4 "><p id="zh-cn_topic_0000001173324623_p48381730174414"><a name="zh-cn_topic_0000001173324623_p48381730174414"></a><a name="zh-cn_topic_0000001173324623_p48381730174414"></a>否</p> 158</td> 159<td class="cellrowborder" valign="top" width="45.28547145285472%" headers="mcps1.1.6.1.5 "><p id="zh-cn_topic_0000001173324623_p183810309449"><a name="zh-cn_topic_0000001173324623_p183810309449"></a><a name="zh-cn_topic_0000001173324623_p183810309449"></a>按钮的字体粗细。见<a href="js-components-basic-text.md#zh-cn_topic_0000001127125018_section5775351116">text组件font-weight的样式属性</a>。</p> 160</td> 161</tr> 162<tr id="zh-cn_topic_0000001173324623_row683893044416"><td class="cellrowborder" valign="top" width="17.458254174582542%" headers="mcps1.1.6.1.1 "><p id="zh-cn_topic_0000001173324623_p1683810307443"><a name="zh-cn_topic_0000001173324623_p1683810307443"></a><a name="zh-cn_topic_0000001173324623_p1683810307443"></a>font-family</p> 163</td> 164<td class="cellrowborder" valign="top" width="11.40885911408859%" headers="mcps1.1.6.1.2 "><p id="zh-cn_topic_0000001173324623_p138391730124417"><a name="zh-cn_topic_0000001173324623_p138391730124417"></a><a name="zh-cn_topic_0000001173324623_p138391730124417"></a><string></p> 165</td> 166<td class="cellrowborder" valign="top" width="19.208079192080792%" headers="mcps1.1.6.1.3 "><p id="zh-cn_topic_0000001173324623_p68391530154419"><a name="zh-cn_topic_0000001173324623_p68391530154419"></a><a name="zh-cn_topic_0000001173324623_p68391530154419"></a>sans-serif</p> 167</td> 168<td class="cellrowborder" valign="top" width="6.639336066393361%" headers="mcps1.1.6.1.4 "><p id="zh-cn_topic_0000001173324623_p38391030164415"><a name="zh-cn_topic_0000001173324623_p38391030164415"></a><a name="zh-cn_topic_0000001173324623_p38391030164415"></a>否</p> 169</td> 170<td class="cellrowborder" valign="top" width="45.28547145285472%" headers="mcps1.1.6.1.5 "><p id="zh-cn_topic_0000001173324623_p38395308443"><a name="zh-cn_topic_0000001173324623_p38395308443"></a><a name="zh-cn_topic_0000001173324623_p38395308443"></a>按钮的字体列表,用逗号分隔,每个字体用字体名或者字体族名设置。列表中第一个系统中存在的或者通过<a href="js-components-common-customizing-font.md">自定义字体</a>指定的字体,会被选中作为文本的字体。</p> 171</td> 172</tr> 173<tr id="zh-cn_topic_0000001173324623_row783993094418"><td class="cellrowborder" valign="top" width="17.458254174582542%" headers="mcps1.1.6.1.1 "><p id="zh-cn_topic_0000001173324623_p78391530174414"><a name="zh-cn_topic_0000001173324623_p78391530174414"></a><a name="zh-cn_topic_0000001173324623_p78391530174414"></a>icon-width</p> 174</td> 175<td class="cellrowborder" valign="top" width="11.40885911408859%" headers="mcps1.1.6.1.2 "><p id="zh-cn_topic_0000001173324623_p68396304443"><a name="zh-cn_topic_0000001173324623_p68396304443"></a><a name="zh-cn_topic_0000001173324623_p68396304443"></a><length></p> 176</td> 177<td class="cellrowborder" valign="top" width="19.208079192080792%" headers="mcps1.1.6.1.3 "><p id="zh-cn_topic_0000001173324623_p168391130204415"><a name="zh-cn_topic_0000001173324623_p168391130204415"></a><a name="zh-cn_topic_0000001173324623_p168391130204415"></a>-</p> 178</td> 179<td class="cellrowborder" valign="top" width="6.639336066393361%" headers="mcps1.1.6.1.4 "><p id="zh-cn_topic_0000001173324623_p983933010448"><a name="zh-cn_topic_0000001173324623_p983933010448"></a><a name="zh-cn_topic_0000001173324623_p983933010448"></a>否</p> 180</td> 181<td class="cellrowborder" valign="top" width="45.28547145285472%" headers="mcps1.1.6.1.5 "><p id="zh-cn_topic_0000001173324623_p148391030114411"><a name="zh-cn_topic_0000001173324623_p148391030114411"></a><a name="zh-cn_topic_0000001173324623_p148391030114411"></a>设置圆形按钮内部图标的宽,默认填满整个圆形按钮。</p> 182<div class="note" id="zh-cn_topic_0000001173324623_note1983911301443"><a name="zh-cn_topic_0000001173324623_note1983911301443"></a><a name="zh-cn_topic_0000001173324623_note1983911301443"></a><span class="notetitle"> 说明: </span><div class="notebody"><p id="zh-cn_topic_0000001173324623_p183993054416"><a name="zh-cn_topic_0000001173324623_p183993054416"></a><a name="zh-cn_topic_0000001173324623_p183993054416"></a>icon使用svg图源时必须设置该样式。</p> 183</div></div> 184</td> 185</tr> 186<tr id="zh-cn_topic_0000001173324623_row158391630184416"><td class="cellrowborder" valign="top" width="17.458254174582542%" headers="mcps1.1.6.1.1 "><p id="zh-cn_topic_0000001173324623_p6840133016442"><a name="zh-cn_topic_0000001173324623_p6840133016442"></a><a name="zh-cn_topic_0000001173324623_p6840133016442"></a>icon-height</p> 187</td> 188<td class="cellrowborder" valign="top" width="11.40885911408859%" headers="mcps1.1.6.1.2 "><p id="zh-cn_topic_0000001173324623_p168401830194410"><a name="zh-cn_topic_0000001173324623_p168401830194410"></a><a name="zh-cn_topic_0000001173324623_p168401830194410"></a><length></p> 189</td> 190<td class="cellrowborder" valign="top" width="19.208079192080792%" headers="mcps1.1.6.1.3 "><p id="zh-cn_topic_0000001173324623_p2840830164417"><a name="zh-cn_topic_0000001173324623_p2840830164417"></a><a name="zh-cn_topic_0000001173324623_p2840830164417"></a>-</p> 191</td> 192<td class="cellrowborder" valign="top" width="6.639336066393361%" headers="mcps1.1.6.1.4 "><p id="zh-cn_topic_0000001173324623_p4840930204420"><a name="zh-cn_topic_0000001173324623_p4840930204420"></a><a name="zh-cn_topic_0000001173324623_p4840930204420"></a>否</p> 193</td> 194<td class="cellrowborder" valign="top" width="45.28547145285472%" headers="mcps1.1.6.1.5 "><p id="zh-cn_topic_0000001173324623_p1084018307444"><a name="zh-cn_topic_0000001173324623_p1084018307444"></a><a name="zh-cn_topic_0000001173324623_p1084018307444"></a>设置圆形按钮内部图标的高,默认填满整个圆形按钮。</p> 195<div class="note" id="zh-cn_topic_0000001173324623_note18840133012443"><a name="zh-cn_topic_0000001173324623_note18840133012443"></a><a name="zh-cn_topic_0000001173324623_note18840133012443"></a><span class="notetitle"> 说明: </span><div class="notebody"><p id="zh-cn_topic_0000001173324623_p178401630194412"><a name="zh-cn_topic_0000001173324623_p178401630194412"></a><a name="zh-cn_topic_0000001173324623_p178401630194412"></a>icon使用svg图源时必须设置该样式。</p> 196</div></div> 197</td> 198</tr> 199<tr id="zh-cn_topic_0000001173324623_row1284083054413"><td class="cellrowborder" valign="top" width="17.458254174582542%" headers="mcps1.1.6.1.1 "><p id="zh-cn_topic_0000001173324623_p4840173044413"><a name="zh-cn_topic_0000001173324623_p4840173044413"></a><a name="zh-cn_topic_0000001173324623_p4840173044413"></a>radius</p> 200</td> 201<td class="cellrowborder" valign="top" width="11.40885911408859%" headers="mcps1.1.6.1.2 "><p id="zh-cn_topic_0000001173324623_p18840143084414"><a name="zh-cn_topic_0000001173324623_p18840143084414"></a><a name="zh-cn_topic_0000001173324623_p18840143084414"></a><length></p> 202</td> 203<td class="cellrowborder" valign="top" width="19.208079192080792%" headers="mcps1.1.6.1.3 "><p id="zh-cn_topic_0000001173324623_p1584018301446"><a name="zh-cn_topic_0000001173324623_p1584018301446"></a><a name="zh-cn_topic_0000001173324623_p1584018301446"></a>-</p> 204</td> 205<td class="cellrowborder" valign="top" width="6.639336066393361%" headers="mcps1.1.6.1.4 "><p id="zh-cn_topic_0000001173324623_p168401030114412"><a name="zh-cn_topic_0000001173324623_p168401030114412"></a><a name="zh-cn_topic_0000001173324623_p168401030114412"></a>否</p> 206</td> 207<td class="cellrowborder" valign="top" width="45.28547145285472%" headers="mcps1.1.6.1.5 "><p id="zh-cn_topic_0000001173324623_p11841183004414"><a name="zh-cn_topic_0000001173324623_p11841183004414"></a><a name="zh-cn_topic_0000001173324623_p11841183004414"></a>圆形按钮半径或者胶囊按钮圆角半径。在圆形按钮类型下该样式优先于通用样式的width和height样式。</p> 208</td> 209</tr> 210</tbody> 211</table> 212 213> **说明:** 214>- 胶囊按钮(type=capsule)时,不支持border相关样式; 215>- 圆形按钮(type=circle)时,不支持文本相关样式; 216>- 文本按钮(type=text)时,自适应文本大小,不支持尺寸设置(radius,width,height),背景透明不支持background-color样式。 217 218**type设置为arc时:** 219 220除支持[通用样式](js-components-common-styles.md)中background-color、opacity、display、visibility、position、\[left|top|right|bottom外,还支持如下样式: 221 222<a name="zh-cn_topic_0000001173324623_table3882649131618"></a> 223<table><thead align="left"><tr id="zh-cn_topic_0000001173324623_row6883249141619"><th class="cellrowborder" valign="top" width="23.11768823117688%" id="mcps1.1.6.1.1"><p id="zh-cn_topic_0000001173324623_zh-cn_topic_0000001059340528_a14a0c012a26248cfbec6b13dcc4f2cbe"><a name="zh-cn_topic_0000001173324623_zh-cn_topic_0000001059340528_a14a0c012a26248cfbec6b13dcc4f2cbe"></a><a name="zh-cn_topic_0000001173324623_zh-cn_topic_0000001059340528_a14a0c012a26248cfbec6b13dcc4f2cbe"></a>名称</p> 224</th> 225<th class="cellrowborder" valign="top" width="20.477952204779523%" id="mcps1.1.6.1.2"><p id="zh-cn_topic_0000001173324623_zh-cn_topic_0000001059340528_a8dc328a555a74157a00de86181fc3a7b"><a name="zh-cn_topic_0000001173324623_zh-cn_topic_0000001059340528_a8dc328a555a74157a00de86181fc3a7b"></a><a name="zh-cn_topic_0000001173324623_zh-cn_topic_0000001059340528_a8dc328a555a74157a00de86181fc3a7b"></a>类型</p> 226</th> 227<th class="cellrowborder" valign="top" width="8.869113088691131%" id="mcps1.1.6.1.3"><p id="zh-cn_topic_0000001173324623_zh-cn_topic_0000001059340528_a41a31e48d0c74ad4982add2655515c82"><a name="zh-cn_topic_0000001173324623_zh-cn_topic_0000001059340528_a41a31e48d0c74ad4982add2655515c82"></a><a name="zh-cn_topic_0000001173324623_zh-cn_topic_0000001059340528_a41a31e48d0c74ad4982add2655515c82"></a>默认值</p> 228</th> 229<th class="cellrowborder" valign="top" width="7.519248075192481%" id="mcps1.1.6.1.4"><p id="zh-cn_topic_0000001173324623_p988314919169"><a name="zh-cn_topic_0000001173324623_p988314919169"></a><a name="zh-cn_topic_0000001173324623_p988314919169"></a>必填</p> 230</th> 231<th class="cellrowborder" valign="top" width="40.01599840015999%" id="mcps1.1.6.1.5"><p id="zh-cn_topic_0000001173324623_zh-cn_topic_0000001059340528_af7a726e456f7485c87bd4e0527bc6584"><a name="zh-cn_topic_0000001173324623_zh-cn_topic_0000001059340528_af7a726e456f7485c87bd4e0527bc6584"></a><a name="zh-cn_topic_0000001173324623_zh-cn_topic_0000001059340528_af7a726e456f7485c87bd4e0527bc6584"></a>描述</p> 232</th> 233</tr> 234</thead> 235<tbody><tr id="zh-cn_topic_0000001173324623_row8424144919409"><td class="cellrowborder" valign="top" width="23.11768823117688%" headers="mcps1.1.6.1.1 "><p id="zh-cn_topic_0000001173324623_p165029502409"><a name="zh-cn_topic_0000001173324623_p165029502409"></a><a name="zh-cn_topic_0000001173324623_p165029502409"></a>text-color</p> 236</td> 237<td class="cellrowborder" valign="top" width="20.477952204779523%" headers="mcps1.1.6.1.2 "><p id="zh-cn_topic_0000001173324623_p1450225084018"><a name="zh-cn_topic_0000001173324623_p1450225084018"></a><a name="zh-cn_topic_0000001173324623_p1450225084018"></a><color></p> 238</td> 239<td class="cellrowborder" valign="top" width="8.869113088691131%" headers="mcps1.1.6.1.3 "><p id="zh-cn_topic_0000001173324623_p0502175044017"><a name="zh-cn_topic_0000001173324623_p0502175044017"></a><a name="zh-cn_topic_0000001173324623_p0502175044017"></a>#de0000</p> 240</td> 241<td class="cellrowborder" valign="top" width="7.519248075192481%" headers="mcps1.1.6.1.4 "><p id="zh-cn_topic_0000001173324623_p35021750134015"><a name="zh-cn_topic_0000001173324623_p35021750134015"></a><a name="zh-cn_topic_0000001173324623_p35021750134015"></a>否</p> 242</td> 243<td class="cellrowborder" valign="top" width="40.01599840015999%" headers="mcps1.1.6.1.5 "><p id="zh-cn_topic_0000001173324623_p4502145044012"><a name="zh-cn_topic_0000001173324623_p4502145044012"></a><a name="zh-cn_topic_0000001173324623_p4502145044012"></a>弧形按钮的文本颜色。</p> 244</td> 245</tr> 246<tr id="zh-cn_topic_0000001173324623_row10425349104012"><td class="cellrowborder" valign="top" width="23.11768823117688%" headers="mcps1.1.6.1.1 "><p id="zh-cn_topic_0000001173324623_p950385020402"><a name="zh-cn_topic_0000001173324623_p950385020402"></a><a name="zh-cn_topic_0000001173324623_p950385020402"></a>font-size</p> 247</td> 248<td class="cellrowborder" valign="top" width="20.477952204779523%" headers="mcps1.1.6.1.2 "><p id="zh-cn_topic_0000001173324623_p15032505401"><a name="zh-cn_topic_0000001173324623_p15032505401"></a><a name="zh-cn_topic_0000001173324623_p15032505401"></a><length></p> 249</td> 250<td class="cellrowborder" valign="top" width="8.869113088691131%" headers="mcps1.1.6.1.3 "><p id="zh-cn_topic_0000001173324623_p75037503405"><a name="zh-cn_topic_0000001173324623_p75037503405"></a><a name="zh-cn_topic_0000001173324623_p75037503405"></a>37.5px</p> 251</td> 252<td class="cellrowborder" valign="top" width="7.519248075192481%" headers="mcps1.1.6.1.4 "><p id="zh-cn_topic_0000001173324623_p10503850144017"><a name="zh-cn_topic_0000001173324623_p10503850144017"></a><a name="zh-cn_topic_0000001173324623_p10503850144017"></a>否</p> 253</td> 254<td class="cellrowborder" valign="top" width="40.01599840015999%" headers="mcps1.1.6.1.5 "><p id="zh-cn_topic_0000001173324623_p8503150114014"><a name="zh-cn_topic_0000001173324623_p8503150114014"></a><a name="zh-cn_topic_0000001173324623_p8503150114014"></a>弧形按钮的文本尺寸。</p> 255</td> 256</tr> 257<tr id="zh-cn_topic_0000001173324623_row542518490406"><td class="cellrowborder" valign="top" width="23.11768823117688%" headers="mcps1.1.6.1.1 "><p id="zh-cn_topic_0000001173324623_p18503250164012"><a name="zh-cn_topic_0000001173324623_p18503250164012"></a><a name="zh-cn_topic_0000001173324623_p18503250164012"></a>allow-scale</p> 258</td> 259<td class="cellrowborder" valign="top" width="20.477952204779523%" headers="mcps1.1.6.1.2 "><p id="zh-cn_topic_0000001173324623_p1650315010404"><a name="zh-cn_topic_0000001173324623_p1650315010404"></a><a name="zh-cn_topic_0000001173324623_p1650315010404"></a>boolean</p> 260</td> 261<td class="cellrowborder" valign="top" width="8.869113088691131%" headers="mcps1.1.6.1.3 "><p id="zh-cn_topic_0000001173324623_p1250419505407"><a name="zh-cn_topic_0000001173324623_p1250419505407"></a><a name="zh-cn_topic_0000001173324623_p1250419505407"></a>true</p> 262</td> 263<td class="cellrowborder" valign="top" width="7.519248075192481%" headers="mcps1.1.6.1.4 "><p id="zh-cn_topic_0000001173324623_p2504125017408"><a name="zh-cn_topic_0000001173324623_p2504125017408"></a><a name="zh-cn_topic_0000001173324623_p2504125017408"></a>否</p> 264</td> 265<td class="cellrowborder" valign="top" width="40.01599840015999%" headers="mcps1.1.6.1.5 "><p id="zh-cn_topic_0000001173324623_p75041650194011"><a name="zh-cn_topic_0000001173324623_p75041650194011"></a><a name="zh-cn_topic_0000001173324623_p75041650194011"></a>弧形按钮的文本尺寸是否跟随系统设置字体缩放尺寸进行放大缩小。</p> 266</td> 267</tr> 268<tr id="zh-cn_topic_0000001173324623_row1642514912402"><td class="cellrowborder" valign="top" width="23.11768823117688%" headers="mcps1.1.6.1.1 "><p id="zh-cn_topic_0000001173324623_p050445014400"><a name="zh-cn_topic_0000001173324623_p050445014400"></a><a name="zh-cn_topic_0000001173324623_p050445014400"></a>font-style</p> 269</td> 270<td class="cellrowborder" valign="top" width="20.477952204779523%" headers="mcps1.1.6.1.2 "><p id="zh-cn_topic_0000001173324623_p250418501403"><a name="zh-cn_topic_0000001173324623_p250418501403"></a><a name="zh-cn_topic_0000001173324623_p250418501403"></a>string</p> 271</td> 272<td class="cellrowborder" valign="top" width="8.869113088691131%" headers="mcps1.1.6.1.3 "><p id="zh-cn_topic_0000001173324623_p18504155015409"><a name="zh-cn_topic_0000001173324623_p18504155015409"></a><a name="zh-cn_topic_0000001173324623_p18504155015409"></a>normal</p> 273</td> 274<td class="cellrowborder" valign="top" width="7.519248075192481%" headers="mcps1.1.6.1.4 "><p id="zh-cn_topic_0000001173324623_p175041150194017"><a name="zh-cn_topic_0000001173324623_p175041150194017"></a><a name="zh-cn_topic_0000001173324623_p175041150194017"></a>否</p> 275</td> 276<td class="cellrowborder" valign="top" width="40.01599840015999%" headers="mcps1.1.6.1.5 "><p id="zh-cn_topic_0000001173324623_p1850485012408"><a name="zh-cn_topic_0000001173324623_p1850485012408"></a><a name="zh-cn_topic_0000001173324623_p1850485012408"></a>弧形按钮的字体样式。</p> 277</td> 278</tr> 279<tr id="zh-cn_topic_0000001173324623_row187569336406"><td class="cellrowborder" valign="top" width="23.11768823117688%" headers="mcps1.1.6.1.1 "><p id="zh-cn_topic_0000001173324623_p2504550124019"><a name="zh-cn_topic_0000001173324623_p2504550124019"></a><a name="zh-cn_topic_0000001173324623_p2504550124019"></a>font-weight</p> 280</td> 281<td class="cellrowborder" valign="top" width="20.477952204779523%" headers="mcps1.1.6.1.2 "><p id="zh-cn_topic_0000001173324623_p950411503408"><a name="zh-cn_topic_0000001173324623_p950411503408"></a><a name="zh-cn_topic_0000001173324623_p950411503408"></a>number | string</p> 282</td> 283<td class="cellrowborder" valign="top" width="8.869113088691131%" headers="mcps1.1.6.1.3 "><p id="zh-cn_topic_0000001173324623_p155041050164019"><a name="zh-cn_topic_0000001173324623_p155041050164019"></a><a name="zh-cn_topic_0000001173324623_p155041050164019"></a>normal</p> 284</td> 285<td class="cellrowborder" valign="top" width="7.519248075192481%" headers="mcps1.1.6.1.4 "><p id="zh-cn_topic_0000001173324623_p2505185020407"><a name="zh-cn_topic_0000001173324623_p2505185020407"></a><a name="zh-cn_topic_0000001173324623_p2505185020407"></a>否</p> 286</td> 287<td class="cellrowborder" valign="top" width="40.01599840015999%" headers="mcps1.1.6.1.5 "><p id="zh-cn_topic_0000001173324623_p1750515044020"><a name="zh-cn_topic_0000001173324623_p1750515044020"></a><a name="zh-cn_topic_0000001173324623_p1750515044020"></a>弧形按钮的字体粗细。见<a href="js-components-basic-text.md#zh-cn_topic_0000001127125018_section5775351116">text组件font-weight的样式属性</a>。</p> 288</td> 289</tr> 290<tr id="zh-cn_topic_0000001173324623_row8251631144012"><td class="cellrowborder" valign="top" width="23.11768823117688%" headers="mcps1.1.6.1.1 "><p id="zh-cn_topic_0000001173324623_p750565004010"><a name="zh-cn_topic_0000001173324623_p750565004010"></a><a name="zh-cn_topic_0000001173324623_p750565004010"></a>font-family</p> 291</td> 292<td class="cellrowborder" valign="top" width="20.477952204779523%" headers="mcps1.1.6.1.2 "><p id="zh-cn_topic_0000001173324623_p125059504401"><a name="zh-cn_topic_0000001173324623_p125059504401"></a><a name="zh-cn_topic_0000001173324623_p125059504401"></a><string></p> 293</td> 294<td class="cellrowborder" valign="top" width="8.869113088691131%" headers="mcps1.1.6.1.3 "><p id="zh-cn_topic_0000001173324623_p115051650154015"><a name="zh-cn_topic_0000001173324623_p115051650154015"></a><a name="zh-cn_topic_0000001173324623_p115051650154015"></a>sans-serif</p> 295</td> 296<td class="cellrowborder" valign="top" width="7.519248075192481%" headers="mcps1.1.6.1.4 "><p id="zh-cn_topic_0000001173324623_p45051350164012"><a name="zh-cn_topic_0000001173324623_p45051350164012"></a><a name="zh-cn_topic_0000001173324623_p45051350164012"></a>否</p> 297</td> 298<td class="cellrowborder" valign="top" width="40.01599840015999%" headers="mcps1.1.6.1.5 "><p id="zh-cn_topic_0000001173324623_p9505195015402"><a name="zh-cn_topic_0000001173324623_p9505195015402"></a><a name="zh-cn_topic_0000001173324623_p9505195015402"></a>按钮的字体列表,用逗号分隔,每个字体用字体名或者字体族名设置。列表中第一个系统中存在的或者通过<a href="js-components-common-customizing-font.md">自定义字体</a>指定的字体,会被选中作为文本的字体。</p> 299</td> 300</tr> 301</tbody> 302</table> 303 304## 事件<a name="zh-cn_topic_0000001173324623_section71081937192815"></a> 305 306支持[通用事件](js-components-common-events.md)。 307 308## 方法<a name="zh-cn_topic_0000001173324623_section47669296127"></a> 309 310支持[通用方法](js-components-common-methods.md)。 311 312类型为download时,支持如下方法: 313 314<a name="zh-cn_topic_0000001173324623_t75606345ece64f818511af2963b4522d"></a> 315<table><thead align="left"><tr id="zh-cn_topic_0000001173324623_rf7e96304e96b4abcada899f917623b50"><th class="cellrowborder" valign="top" width="17.18%" id="mcps1.1.4.1.1"><p id="zh-cn_topic_0000001173324623_abdd98ec01df046a7ac2f66a3fa4eda04"><a name="zh-cn_topic_0000001173324623_abdd98ec01df046a7ac2f66a3fa4eda04"></a><a name="zh-cn_topic_0000001173324623_abdd98ec01df046a7ac2f66a3fa4eda04"></a>名称</p> 316</th> 317<th class="cellrowborder" valign="top" width="28.82%" id="mcps1.1.4.1.2"><p id="zh-cn_topic_0000001173324623_afa86bf0c638b4860a91ea0e6255b7744"><a name="zh-cn_topic_0000001173324623_afa86bf0c638b4860a91ea0e6255b7744"></a><a name="zh-cn_topic_0000001173324623_afa86bf0c638b4860a91ea0e6255b7744"></a>参数</p> 318</th> 319<th class="cellrowborder" valign="top" width="54%" id="mcps1.1.4.1.3"><p id="zh-cn_topic_0000001173324623_aa7783f4706e8434493b6e941e0100652"><a name="zh-cn_topic_0000001173324623_aa7783f4706e8434493b6e941e0100652"></a><a name="zh-cn_topic_0000001173324623_aa7783f4706e8434493b6e941e0100652"></a>描述</p> 320</th> 321</tr> 322</thead> 323<tbody><tr id="zh-cn_topic_0000001173324623_r51da7a66ad844356a54fc7d198bbc496"><td class="cellrowborder" valign="top" width="17.18%" headers="mcps1.1.4.1.1 "><p id="zh-cn_topic_0000001173324623_a37c62c3017bc4b85813051fedae5523a"><a name="zh-cn_topic_0000001173324623_a37c62c3017bc4b85813051fedae5523a"></a><a name="zh-cn_topic_0000001173324623_a37c62c3017bc4b85813051fedae5523a"></a>setProgress</p> 324</td> 325<td class="cellrowborder" valign="top" width="28.82%" headers="mcps1.1.4.1.2 "><p id="zh-cn_topic_0000001173324623_a0fa3cdedaab94e11b1c1df493e671084"><a name="zh-cn_topic_0000001173324623_a0fa3cdedaab94e11b1c1df493e671084"></a><a name="zh-cn_topic_0000001173324623_a0fa3cdedaab94e11b1c1df493e671084"></a>{ progress:percent }</p> 326</td> 327<td class="cellrowborder" valign="top" width="54%" headers="mcps1.1.4.1.3 "><p id="zh-cn_topic_0000001173324623_p157114142914"><a name="zh-cn_topic_0000001173324623_p157114142914"></a><a name="zh-cn_topic_0000001173324623_p157114142914"></a>设定下载按钮进度条进度,取值位于0-100区间内,当设置的值大于0时,下载按钮展现进度条。当设置的值大于等于100时,取消进度条显示。</p> 328<div class="note" id="zh-cn_topic_0000001173324623_note11137355291"><a name="zh-cn_topic_0000001173324623_note11137355291"></a><a name="zh-cn_topic_0000001173324623_note11137355291"></a><span class="notetitle"> 说明: </span><div class="notebody"><p id="zh-cn_topic_0000001173324623_p19137355592"><a name="zh-cn_topic_0000001173324623_p19137355592"></a><a name="zh-cn_topic_0000001173324623_p19137355592"></a>浮在进度条上的文字通过value值进行变更。</p> 329</div></div> 330</td> 331</tr> 332</tbody> 333</table> 334 335## 示例<a name="zh-cn_topic_0000001173324623_section16867208402"></a> 336 337``` 338<!-- xxx.hml --> 339<div class="div-button"> 340 <button class="first" type="capsule" value="Capsule button"></button> 341 <button class="button circle" type="circle" icon="common/ic_add_default.png"></button> 342 <button class="button text" type="text">Text button</button> 343 <button class="button download" type="download" id="download-btn" 344 onclick="progress">{{downloadText}}</button> 345 <button class="last" type="capsule" waiting="true">Loading</button> 346</div> 347``` 348 349``` 350/* xxx.css */ 351.div-button { 352 flex-direction: column; 353 align-items: center; 354} 355.first{ 356 background-color: #F2F2F2; 357 text-color: #0D81F2; 358} 359.button { 360 margin-top: 15px; 361} 362.last{ 363 background-color: #F2F2F2; 364 text-color: #969696; 365 margin-top: 15px; 366 width: 280px; 367 height:72px; 368} 369.button:waiting { 370 width: 280px; 371} 372.circle { 373 background-color: #007dff; 374 radius: 72px; 375 icon-width: 72px; 376 icon-height: 72px; 377} 378.text { 379 text-color: red; 380 font-size: 40px; 381 font-weight: 900; 382 font-family: sans-serif; 383 font-style: normal; 384} 385.download { 386 width: 280px; 387 text-color: white; 388 background-color: #007dff; 389} 390``` 391 392``` 393// xxx.js 394export default { 395 data: { 396 progress: 5, 397 downloadText: "Download" 398 }, 399 progress(e) { 400 this.progress += 10; 401 this.downloadText = this.progress + "%"; 402 this.$element('download-btn').setProgress({ progress: this.progress }); 403 if (this.progress >= 100) { 404 this.downloadText = "Done"; 405 } 406 } 407} 408``` 409 410 411 412