• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# switch<a name="ZH-CN_TOPIC_0000001209570707"></a>
2
3开关选择器,通过开关,开启或关闭某个功能。
4
5## 权限列表<a name="zh-cn_topic_0000001127125072_section11257113618419"></a>
6
78
9## 子组件<a name="zh-cn_topic_0000001127125072_section9288143101012"></a>
10
11不支持。
12
13## 属性<a name="zh-cn_topic_0000001127125072_section2907183951110"></a>
14
15除支持[通用属性](js-components-common-attributes.md)外,还支持如下属性:
16
17<a name="zh-cn_topic_0000001127125072_table20633101642315"></a>
18<table><thead align="left"><tr id="zh-cn_topic_0000001127125072_row663331618238"><th class="cellrowborder" valign="top" width="23.119999999999997%" id="mcps1.1.6.1.1"><p id="zh-cn_topic_0000001127125072_aa872998ac2d84843a3c5161889afffef"><a name="zh-cn_topic_0000001127125072_aa872998ac2d84843a3c5161889afffef"></a><a name="zh-cn_topic_0000001127125072_aa872998ac2d84843a3c5161889afffef"></a>名称</p>
19</th>
20<th class="cellrowborder" valign="top" width="23.119999999999997%" id="mcps1.1.6.1.2"><p id="zh-cn_topic_0000001127125072_ab2111648ee0e4f6d881be8954e7acaab"><a name="zh-cn_topic_0000001127125072_ab2111648ee0e4f6d881be8954e7acaab"></a><a name="zh-cn_topic_0000001127125072_ab2111648ee0e4f6d881be8954e7acaab"></a>类型</p>
21</th>
22<th class="cellrowborder" valign="top" width="10.48%" id="mcps1.1.6.1.3"><p id="zh-cn_topic_0000001127125072_ab377d1c90900478ea4ecab51e9a058af"><a name="zh-cn_topic_0000001127125072_ab377d1c90900478ea4ecab51e9a058af"></a><a name="zh-cn_topic_0000001127125072_ab377d1c90900478ea4ecab51e9a058af"></a>默认值</p>
23</th>
24<th class="cellrowborder" valign="top" width="7.5200000000000005%" id="mcps1.1.6.1.4"><p id="zh-cn_topic_0000001127125072_p824610360217"><a name="zh-cn_topic_0000001127125072_p824610360217"></a><a name="zh-cn_topic_0000001127125072_p824610360217"></a>必填</p>
25</th>
26<th class="cellrowborder" valign="top" width="35.76%" id="mcps1.1.6.1.5"><p id="zh-cn_topic_0000001127125072_a1d574a0044ed42ec8a2603bc82734232"><a name="zh-cn_topic_0000001127125072_a1d574a0044ed42ec8a2603bc82734232"></a><a name="zh-cn_topic_0000001127125072_a1d574a0044ed42ec8a2603bc82734232"></a>描述</p>
27</th>
28</tr>
29</thead>
30<tbody><tr id="zh-cn_topic_0000001127125072_row187510515582"><td class="cellrowborder" valign="top" width="23.119999999999997%" headers="mcps1.1.6.1.1 "><p id="zh-cn_topic_0000001127125072_p1126255375818"><a name="zh-cn_topic_0000001127125072_p1126255375818"></a><a name="zh-cn_topic_0000001127125072_p1126255375818"></a>checked</p>
31</td>
32<td class="cellrowborder" valign="top" width="23.119999999999997%" headers="mcps1.1.6.1.2 "><p id="zh-cn_topic_0000001127125072_p826225395810"><a name="zh-cn_topic_0000001127125072_p826225395810"></a><a name="zh-cn_topic_0000001127125072_p826225395810"></a>boolean</p>
33</td>
34<td class="cellrowborder" valign="top" width="10.48%" headers="mcps1.1.6.1.3 "><p id="zh-cn_topic_0000001127125072_p1126210533587"><a name="zh-cn_topic_0000001127125072_p1126210533587"></a><a name="zh-cn_topic_0000001127125072_p1126210533587"></a>false</p>
35</td>
36<td class="cellrowborder" valign="top" width="7.5200000000000005%" headers="mcps1.1.6.1.4 "><p id="zh-cn_topic_0000001127125072_p10262185375814"><a name="zh-cn_topic_0000001127125072_p10262185375814"></a><a name="zh-cn_topic_0000001127125072_p10262185375814"></a>否</p>
37</td>
38<td class="cellrowborder" valign="top" width="35.76%" headers="mcps1.1.6.1.5 "><p id="zh-cn_topic_0000001127125072_p526295335811"><a name="zh-cn_topic_0000001127125072_p526295335811"></a><a name="zh-cn_topic_0000001127125072_p526295335811"></a>是否选中。</p>
39</td>
40</tr>
41<tr id="zh-cn_topic_0000001127125072_row18459154995812"><td class="cellrowborder" valign="top" width="23.119999999999997%" headers="mcps1.1.6.1.1 "><p id="zh-cn_topic_0000001127125072_p17262853175817"><a name="zh-cn_topic_0000001127125072_p17262853175817"></a><a name="zh-cn_topic_0000001127125072_p17262853175817"></a>showtext</p>
42</td>
43<td class="cellrowborder" valign="top" width="23.119999999999997%" headers="mcps1.1.6.1.2 "><p id="zh-cn_topic_0000001127125072_p122621153175814"><a name="zh-cn_topic_0000001127125072_p122621153175814"></a><a name="zh-cn_topic_0000001127125072_p122621153175814"></a>boolean</p>
44</td>
45<td class="cellrowborder" valign="top" width="10.48%" headers="mcps1.1.6.1.3 "><p id="zh-cn_topic_0000001127125072_p1126365310589"><a name="zh-cn_topic_0000001127125072_p1126365310589"></a><a name="zh-cn_topic_0000001127125072_p1126365310589"></a>false</p>
46</td>
47<td class="cellrowborder" valign="top" width="7.5200000000000005%" headers="mcps1.1.6.1.4 "><p id="zh-cn_topic_0000001127125072_p11263195345814"><a name="zh-cn_topic_0000001127125072_p11263195345814"></a><a name="zh-cn_topic_0000001127125072_p11263195345814"></a>否</p>
48</td>
49<td class="cellrowborder" valign="top" width="35.76%" headers="mcps1.1.6.1.5 "><p id="zh-cn_topic_0000001127125072_p172631453135816"><a name="zh-cn_topic_0000001127125072_p172631453135816"></a><a name="zh-cn_topic_0000001127125072_p172631453135816"></a>是否显示文本。</p>
50</td>
51</tr>
52<tr id="zh-cn_topic_0000001127125072_row55711479587"><td class="cellrowborder" valign="top" width="23.119999999999997%" headers="mcps1.1.6.1.1 "><p id="zh-cn_topic_0000001127125072_p626355311584"><a name="zh-cn_topic_0000001127125072_p626355311584"></a><a name="zh-cn_topic_0000001127125072_p626355311584"></a>texton</p>
53</td>
54<td class="cellrowborder" valign="top" width="23.119999999999997%" headers="mcps1.1.6.1.2 "><p id="zh-cn_topic_0000001127125072_p72637533582"><a name="zh-cn_topic_0000001127125072_p72637533582"></a><a name="zh-cn_topic_0000001127125072_p72637533582"></a>string</p>
55</td>
56<td class="cellrowborder" valign="top" width="10.48%" headers="mcps1.1.6.1.3 "><p id="zh-cn_topic_0000001127125072_p182634538587"><a name="zh-cn_topic_0000001127125072_p182634538587"></a><a name="zh-cn_topic_0000001127125072_p182634538587"></a>"On"</p>
57</td>
58<td class="cellrowborder" valign="top" width="7.5200000000000005%" headers="mcps1.1.6.1.4 "><p id="zh-cn_topic_0000001127125072_p112631153185813"><a name="zh-cn_topic_0000001127125072_p112631153185813"></a><a name="zh-cn_topic_0000001127125072_p112631153185813"></a>否</p>
59</td>
60<td class="cellrowborder" valign="top" width="35.76%" headers="mcps1.1.6.1.5 "><p id="zh-cn_topic_0000001127125072_p3263753175817"><a name="zh-cn_topic_0000001127125072_p3263753175817"></a><a name="zh-cn_topic_0000001127125072_p3263753175817"></a>选中时显示的文本。</p>
61</td>
62</tr>
63<tr id="zh-cn_topic_0000001127125072_row116161444115812"><td class="cellrowborder" valign="top" width="23.119999999999997%" headers="mcps1.1.6.1.1 "><p id="zh-cn_topic_0000001127125072_p32631553145810"><a name="zh-cn_topic_0000001127125072_p32631553145810"></a><a name="zh-cn_topic_0000001127125072_p32631553145810"></a>textoff</p>
64</td>
65<td class="cellrowborder" valign="top" width="23.119999999999997%" headers="mcps1.1.6.1.2 "><p id="zh-cn_topic_0000001127125072_p11263253105816"><a name="zh-cn_topic_0000001127125072_p11263253105816"></a><a name="zh-cn_topic_0000001127125072_p11263253105816"></a>string</p>
66</td>
67<td class="cellrowborder" valign="top" width="10.48%" headers="mcps1.1.6.1.3 "><p id="zh-cn_topic_0000001127125072_p182632539586"><a name="zh-cn_topic_0000001127125072_p182632539586"></a><a name="zh-cn_topic_0000001127125072_p182632539586"></a>"Off"</p>
68</td>
69<td class="cellrowborder" valign="top" width="7.5200000000000005%" headers="mcps1.1.6.1.4 "><p id="zh-cn_topic_0000001127125072_p3263195375819"><a name="zh-cn_topic_0000001127125072_p3263195375819"></a><a name="zh-cn_topic_0000001127125072_p3263195375819"></a>否</p>
70</td>
71<td class="cellrowborder" valign="top" width="35.76%" headers="mcps1.1.6.1.5 "><p id="zh-cn_topic_0000001127125072_p19263185312583"><a name="zh-cn_topic_0000001127125072_p19263185312583"></a><a name="zh-cn_topic_0000001127125072_p19263185312583"></a>未选中时显示的文本。</p>
72</td>
73</tr>
74</tbody>
75</table>
76
77## 样式<a name="zh-cn_topic_0000001127125072_section5775351116"></a>
78
79除支持[通用样式](js-components-common-styles.md)外,还支持如下样式:
80
81<a name="zh-cn_topic_0000001127125072_table18141141019"></a>
82<table><thead align="left"><tr id="zh-cn_topic_0000001127125072_row17141841318"><th class="cellrowborder" valign="top" width="23.11768823117688%" id="mcps1.1.6.1.1"><p id="zh-cn_topic_0000001127125072_p814213411616"><a name="zh-cn_topic_0000001127125072_p814213411616"></a><a name="zh-cn_topic_0000001127125072_p814213411616"></a>名称</p>
83</th>
84<th class="cellrowborder" valign="top" width="20.477952204779523%" id="mcps1.1.6.1.2"><p id="zh-cn_topic_0000001127125072_p101428411816"><a name="zh-cn_topic_0000001127125072_p101428411816"></a><a name="zh-cn_topic_0000001127125072_p101428411816"></a>类型</p>
85</th>
86<th class="cellrowborder" valign="top" width="8.869113088691131%" id="mcps1.1.6.1.3"><p id="zh-cn_topic_0000001127125072_p1214219411518"><a name="zh-cn_topic_0000001127125072_p1214219411518"></a><a name="zh-cn_topic_0000001127125072_p1214219411518"></a>默认值</p>
87</th>
88<th class="cellrowborder" valign="top" width="7.519248075192481%" id="mcps1.1.6.1.4"><p id="zh-cn_topic_0000001127125072_p1814213417115"><a name="zh-cn_topic_0000001127125072_p1814213417115"></a><a name="zh-cn_topic_0000001127125072_p1814213417115"></a>必填</p>
89</th>
90<th class="cellrowborder" valign="top" width="40.01599840015999%" id="mcps1.1.6.1.5"><p id="zh-cn_topic_0000001127125072_p5142174112118"><a name="zh-cn_topic_0000001127125072_p5142174112118"></a><a name="zh-cn_topic_0000001127125072_p5142174112118"></a>描述</p>
91</th>
92</tr>
93</thead>
94<tbody><tr id="zh-cn_topic_0000001127125072_row15142941912"><td class="cellrowborder" valign="top" width="23.11768823117688%" headers="mcps1.1.6.1.1 "><p id="zh-cn_topic_0000001127125072_p141422413117"><a name="zh-cn_topic_0000001127125072_p141422413117"></a><a name="zh-cn_topic_0000001127125072_p141422413117"></a>texton-color(Rich)</p>
95</td>
96<td class="cellrowborder" valign="top" width="20.477952204779523%" headers="mcps1.1.6.1.2 "><p id="zh-cn_topic_0000001127125072_p21426411815"><a name="zh-cn_topic_0000001127125072_p21426411815"></a><a name="zh-cn_topic_0000001127125072_p21426411815"></a>&lt;color&gt;</p>
97</td>
98<td class="cellrowborder" valign="top" width="8.869113088691131%" headers="mcps1.1.6.1.3 "><p id="zh-cn_topic_0000001127125072_p1614210411718"><a name="zh-cn_topic_0000001127125072_p1614210411718"></a><a name="zh-cn_topic_0000001127125072_p1614210411718"></a>#000000</p>
99</td>
100<td class="cellrowborder" valign="top" width="7.519248075192481%" headers="mcps1.1.6.1.4 "><p id="zh-cn_topic_0000001127125072_p414264111119"><a name="zh-cn_topic_0000001127125072_p414264111119"></a><a name="zh-cn_topic_0000001127125072_p414264111119"></a>否</p>
101</td>
102<td class="cellrowborder" valign="top" width="40.01599840015999%" headers="mcps1.1.6.1.5 "><p id="zh-cn_topic_0000001127125072_p17142194118113"><a name="zh-cn_topic_0000001127125072_p17142194118113"></a><a name="zh-cn_topic_0000001127125072_p17142194118113"></a>选中时显示的文本颜色。</p>
103</td>
104</tr>
105<tr id="zh-cn_topic_0000001127125072_row01425413117"><td class="cellrowborder" valign="top" width="23.11768823117688%" headers="mcps1.1.6.1.1 "><p id="zh-cn_topic_0000001127125072_p31426419115"><a name="zh-cn_topic_0000001127125072_p31426419115"></a><a name="zh-cn_topic_0000001127125072_p31426419115"></a>textoff-color(Rich)</p>
106</td>
107<td class="cellrowborder" valign="top" width="20.477952204779523%" headers="mcps1.1.6.1.2 "><p id="zh-cn_topic_0000001127125072_p714211411914"><a name="zh-cn_topic_0000001127125072_p714211411914"></a><a name="zh-cn_topic_0000001127125072_p714211411914"></a>&lt;color&gt;</p>
108</td>
109<td class="cellrowborder" valign="top" width="8.869113088691131%" headers="mcps1.1.6.1.3 "><p id="zh-cn_topic_0000001127125072_p1614244112117"><a name="zh-cn_topic_0000001127125072_p1614244112117"></a><a name="zh-cn_topic_0000001127125072_p1614244112117"></a>#000000</p>
110</td>
111<td class="cellrowborder" valign="top" width="7.519248075192481%" headers="mcps1.1.6.1.4 "><p id="zh-cn_topic_0000001127125072_p1914294116111"><a name="zh-cn_topic_0000001127125072_p1914294116111"></a><a name="zh-cn_topic_0000001127125072_p1914294116111"></a>否</p>
112</td>
113<td class="cellrowborder" valign="top" width="40.01599840015999%" headers="mcps1.1.6.1.5 "><p id="zh-cn_topic_0000001127125072_p7142041512"><a name="zh-cn_topic_0000001127125072_p7142041512"></a><a name="zh-cn_topic_0000001127125072_p7142041512"></a>未选中时显示的文本颜色。</p>
114</td>
115</tr>
116<tr id="zh-cn_topic_0000001127125072_row21421741914"><td class="cellrowborder" valign="top" width="23.11768823117688%" headers="mcps1.1.6.1.1 "><p id="zh-cn_topic_0000001127125072_p15143441811"><a name="zh-cn_topic_0000001127125072_p15143441811"></a><a name="zh-cn_topic_0000001127125072_p15143441811"></a>text-padding(Rich)</p>
117</td>
118<td class="cellrowborder" valign="top" width="20.477952204779523%" headers="mcps1.1.6.1.2 "><p id="zh-cn_topic_0000001127125072_p12143741518"><a name="zh-cn_topic_0000001127125072_p12143741518"></a><a name="zh-cn_topic_0000001127125072_p12143741518"></a>number</p>
119</td>
120<td class="cellrowborder" valign="top" width="8.869113088691131%" headers="mcps1.1.6.1.3 "><p id="zh-cn_topic_0000001127125072_p9143241114"><a name="zh-cn_topic_0000001127125072_p9143241114"></a><a name="zh-cn_topic_0000001127125072_p9143241114"></a>0px</p>
121</td>
122<td class="cellrowborder" valign="top" width="7.519248075192481%" headers="mcps1.1.6.1.4 "><p id="zh-cn_topic_0000001127125072_p101439419117"><a name="zh-cn_topic_0000001127125072_p101439419117"></a><a name="zh-cn_topic_0000001127125072_p101439419117"></a>否</p>
123</td>
124<td class="cellrowborder" valign="top" width="40.01599840015999%" headers="mcps1.1.6.1.5 "><p id="zh-cn_topic_0000001127125072_p714374115110"><a name="zh-cn_topic_0000001127125072_p714374115110"></a><a name="zh-cn_topic_0000001127125072_p714374115110"></a>texton/textoff中最长文本两侧距离滑块边界的距离。</p>
125</td>
126</tr>
127<tr id="zh-cn_topic_0000001127125072_row19143194112115"><td class="cellrowborder" valign="top" width="23.11768823117688%" headers="mcps1.1.6.1.1 "><p id="zh-cn_topic_0000001127125072_p1614364119110"><a name="zh-cn_topic_0000001127125072_p1614364119110"></a><a name="zh-cn_topic_0000001127125072_p1614364119110"></a>font-size(Rich)</p>
128</td>
129<td class="cellrowborder" valign="top" width="20.477952204779523%" headers="mcps1.1.6.1.2 "><p id="zh-cn_topic_0000001127125072_p11436419111"><a name="zh-cn_topic_0000001127125072_p11436419111"></a><a name="zh-cn_topic_0000001127125072_p11436419111"></a>&lt;length&gt;</p>
130</td>
131<td class="cellrowborder" valign="top" width="8.869113088691131%" headers="mcps1.1.6.1.3 "><p id="zh-cn_topic_0000001127125072_p21431416117"><a name="zh-cn_topic_0000001127125072_p21431416117"></a><a name="zh-cn_topic_0000001127125072_p21431416117"></a>-</p>
132</td>
133<td class="cellrowborder" valign="top" width="7.519248075192481%" headers="mcps1.1.6.1.4 "><p id="zh-cn_topic_0000001127125072_p014313412014"><a name="zh-cn_topic_0000001127125072_p014313412014"></a><a name="zh-cn_topic_0000001127125072_p014313412014"></a>否</p>
134</td>
135<td class="cellrowborder" valign="top" width="40.01599840015999%" headers="mcps1.1.6.1.5 "><p id="zh-cn_topic_0000001127125072_p19143184110114"><a name="zh-cn_topic_0000001127125072_p19143184110114"></a><a name="zh-cn_topic_0000001127125072_p19143184110114"></a>文本尺寸,仅设置texton和textoff生效。</p>
136</td>
137</tr>
138<tr id="zh-cn_topic_0000001127125072_row514317411319"><td class="cellrowborder" valign="top" width="23.11768823117688%" headers="mcps1.1.6.1.1 "><p id="zh-cn_topic_0000001127125072_p1143241119"><a name="zh-cn_topic_0000001127125072_p1143241119"></a><a name="zh-cn_topic_0000001127125072_p1143241119"></a>allow-scale(Rich)</p>
139</td>
140<td class="cellrowborder" valign="top" width="20.477952204779523%" headers="mcps1.1.6.1.2 "><p id="zh-cn_topic_0000001127125072_p1914314117112"><a name="zh-cn_topic_0000001127125072_p1914314117112"></a><a name="zh-cn_topic_0000001127125072_p1914314117112"></a>boolean</p>
141</td>
142<td class="cellrowborder" valign="top" width="8.869113088691131%" headers="mcps1.1.6.1.3 "><p id="zh-cn_topic_0000001127125072_p514319415118"><a name="zh-cn_topic_0000001127125072_p514319415118"></a><a name="zh-cn_topic_0000001127125072_p514319415118"></a>true</p>
143</td>
144<td class="cellrowborder" valign="top" width="7.519248075192481%" headers="mcps1.1.6.1.4 "><p id="zh-cn_topic_0000001127125072_p71431411417"><a name="zh-cn_topic_0000001127125072_p71431411417"></a><a name="zh-cn_topic_0000001127125072_p71431411417"></a>否</p>
145</td>
146<td class="cellrowborder" valign="top" width="40.01599840015999%" headers="mcps1.1.6.1.5 "><p id="zh-cn_topic_0000001127125072_p71435417112"><a name="zh-cn_topic_0000001127125072_p71435417112"></a><a name="zh-cn_topic_0000001127125072_p71435417112"></a>文本尺寸是否跟随系统设置字体缩放尺寸进行放大缩小。</p>
147<div class="note" id="zh-cn_topic_0000001127125072_note214334112118"><a name="zh-cn_topic_0000001127125072_note214334112118"></a><a name="zh-cn_topic_0000001127125072_note214334112118"></a><span class="notetitle"> 说明: </span><div class="notebody"><p id="zh-cn_topic_0000001127125072_p3143174118114"><a name="zh-cn_topic_0000001127125072_p3143174118114"></a><a name="zh-cn_topic_0000001127125072_p3143174118114"></a>如果在config描述文件中针对ability配置了fontSize的config-changes标签,则应用不会重启而直接生效。</p>
148</div></div>
149</td>
150</tr>
151<tr id="zh-cn_topic_0000001127125072_row114334114116"><td class="cellrowborder" valign="top" width="23.11768823117688%" headers="mcps1.1.6.1.1 "><p id="zh-cn_topic_0000001127125072_p81431141814"><a name="zh-cn_topic_0000001127125072_p81431141814"></a><a name="zh-cn_topic_0000001127125072_p81431141814"></a>font-style(Rich)</p>
152</td>
153<td class="cellrowborder" valign="top" width="20.477952204779523%" headers="mcps1.1.6.1.2 "><p id="zh-cn_topic_0000001127125072_p20144941015"><a name="zh-cn_topic_0000001127125072_p20144941015"></a><a name="zh-cn_topic_0000001127125072_p20144941015"></a>string</p>
154</td>
155<td class="cellrowborder" valign="top" width="8.869113088691131%" headers="mcps1.1.6.1.3 "><p id="zh-cn_topic_0000001127125072_p1514464111120"><a name="zh-cn_topic_0000001127125072_p1514464111120"></a><a name="zh-cn_topic_0000001127125072_p1514464111120"></a>normal</p>
156</td>
157<td class="cellrowborder" valign="top" width="7.519248075192481%" headers="mcps1.1.6.1.4 "><p id="zh-cn_topic_0000001127125072_p1914484118112"><a name="zh-cn_topic_0000001127125072_p1914484118112"></a><a name="zh-cn_topic_0000001127125072_p1914484118112"></a>否</p>
158</td>
159<td class="cellrowborder" valign="top" width="40.01599840015999%" headers="mcps1.1.6.1.5 "><p id="zh-cn_topic_0000001127125072_p61446412015"><a name="zh-cn_topic_0000001127125072_p61446412015"></a><a name="zh-cn_topic_0000001127125072_p61446412015"></a>字体样式,仅设置texton和textoff生效。见<a href="js-components-basic-text.md#zh-cn_topic_0000001127125018_section5775351116">text组件font-style的样式属性</a>。</p>
160</td>
161</tr>
162<tr id="zh-cn_topic_0000001127125072_row1414434118113"><td class="cellrowborder" valign="top" width="23.11768823117688%" headers="mcps1.1.6.1.1 "><p id="zh-cn_topic_0000001127125072_p91441641917"><a name="zh-cn_topic_0000001127125072_p91441641917"></a><a name="zh-cn_topic_0000001127125072_p91441641917"></a>font-weight(Rich)</p>
163</td>
164<td class="cellrowborder" valign="top" width="20.477952204779523%" headers="mcps1.1.6.1.2 "><p id="zh-cn_topic_0000001127125072_p17144241417"><a name="zh-cn_topic_0000001127125072_p17144241417"></a><a name="zh-cn_topic_0000001127125072_p17144241417"></a>number | string</p>
165</td>
166<td class="cellrowborder" valign="top" width="8.869113088691131%" headers="mcps1.1.6.1.3 "><p id="zh-cn_topic_0000001127125072_p17144184118118"><a name="zh-cn_topic_0000001127125072_p17144184118118"></a><a name="zh-cn_topic_0000001127125072_p17144184118118"></a>normal</p>
167</td>
168<td class="cellrowborder" valign="top" width="7.519248075192481%" headers="mcps1.1.6.1.4 "><p id="zh-cn_topic_0000001127125072_p2144144115118"><a name="zh-cn_topic_0000001127125072_p2144144115118"></a><a name="zh-cn_topic_0000001127125072_p2144144115118"></a>否</p>
169</td>
170<td class="cellrowborder" valign="top" width="40.01599840015999%" headers="mcps1.1.6.1.5 "><p id="zh-cn_topic_0000001127125072_p1714484118114"><a name="zh-cn_topic_0000001127125072_p1714484118114"></a><a name="zh-cn_topic_0000001127125072_p1714484118114"></a>字体粗细,仅设置texton和textoff生效。见<a href="js-components-basic-text.md#zh-cn_topic_0000001127125018_section5775351116">text组件的font-weight的样式属性</a>。</p>
171</td>
172</tr>
173<tr id="zh-cn_topic_0000001127125072_row16144154118117"><td class="cellrowborder" valign="top" width="23.11768823117688%" headers="mcps1.1.6.1.1 "><p id="zh-cn_topic_0000001127125072_p1914419411613"><a name="zh-cn_topic_0000001127125072_p1914419411613"></a><a name="zh-cn_topic_0000001127125072_p1914419411613"></a>font-family(Rich)</p>
174</td>
175<td class="cellrowborder" valign="top" width="20.477952204779523%" headers="mcps1.1.6.1.2 "><p id="zh-cn_topic_0000001127125072_p61447411415"><a name="zh-cn_topic_0000001127125072_p61447411415"></a><a name="zh-cn_topic_0000001127125072_p61447411415"></a>string</p>
176</td>
177<td class="cellrowborder" valign="top" width="8.869113088691131%" headers="mcps1.1.6.1.3 "><p id="zh-cn_topic_0000001127125072_p191448411817"><a name="zh-cn_topic_0000001127125072_p191448411817"></a><a name="zh-cn_topic_0000001127125072_p191448411817"></a>sans-serif</p>
178</td>
179<td class="cellrowborder" valign="top" width="7.519248075192481%" headers="mcps1.1.6.1.4 "><p id="zh-cn_topic_0000001127125072_p314415411118"><a name="zh-cn_topic_0000001127125072_p314415411118"></a><a name="zh-cn_topic_0000001127125072_p314415411118"></a>否</p>
180</td>
181<td class="cellrowborder" valign="top" width="40.01599840015999%" headers="mcps1.1.6.1.5 "><p id="zh-cn_topic_0000001127125072_p614414411115"><a name="zh-cn_topic_0000001127125072_p614414411115"></a><a name="zh-cn_topic_0000001127125072_p614414411115"></a>字体列表,用逗号分隔,每个字体用字体名或者字体族名设置。列表中第一个系统中存在的或者通过<a href="js-components-common-customizing-font.md">自定义字体</a>指定的字体,会被选中作为文本的字体。仅设置texton和textoff生效。</p>
182</td>
183</tr>
184</tbody>
185</table>
186
187## 事件<a name="zh-cn_topic_0000001127125072_section1042893411015"></a>
188
189除支持[通用事件](js-components-common-events.md)外,还支持如下事件:
190
191<a name="zh-cn_topic_0000001127125072_table4429183420016"></a>
192<table><thead align="left"><tr id="zh-cn_topic_0000001127125072_row14295345017"><th class="cellrowborder" valign="top" width="24.852485248524854%" id="mcps1.1.4.1.1"><p id="zh-cn_topic_0000001127125072_p342910341105"><a name="zh-cn_topic_0000001127125072_p342910341105"></a><a name="zh-cn_topic_0000001127125072_p342910341105"></a>名称</p>
193</th>
194<th class="cellrowborder" valign="top" width="29.552955295529554%" id="mcps1.1.4.1.2"><p id="zh-cn_topic_0000001127125072_p142913343017"><a name="zh-cn_topic_0000001127125072_p142913343017"></a><a name="zh-cn_topic_0000001127125072_p142913343017"></a>参数</p>
195</th>
196<th class="cellrowborder" valign="top" width="45.5945594559456%" id="mcps1.1.4.1.3"><p id="zh-cn_topic_0000001127125072_p6429034005"><a name="zh-cn_topic_0000001127125072_p6429034005"></a><a name="zh-cn_topic_0000001127125072_p6429034005"></a>描述</p>
197</th>
198</tr>
199</thead>
200<tbody><tr id="zh-cn_topic_0000001127125072_row94293341601"><td class="cellrowborder" valign="top" width="24.852485248524854%" headers="mcps1.1.4.1.1 "><p id="zh-cn_topic_0000001127125072_p842910342010"><a name="zh-cn_topic_0000001127125072_p842910342010"></a><a name="zh-cn_topic_0000001127125072_p842910342010"></a>change</p>
201</td>
202<td class="cellrowborder" valign="top" width="29.552955295529554%" headers="mcps1.1.4.1.2 "><p id="zh-cn_topic_0000001127125072_p342917344013"><a name="zh-cn_topic_0000001127125072_p342917344013"></a><a name="zh-cn_topic_0000001127125072_p342917344013"></a>{ checked: checkedValue }</p>
203</td>
204<td class="cellrowborder" valign="top" width="45.5945594559456%" headers="mcps1.1.4.1.3 "><p id="zh-cn_topic_0000001127125072_p24295341304"><a name="zh-cn_topic_0000001127125072_p24295341304"></a><a name="zh-cn_topic_0000001127125072_p24295341304"></a>选中状态改变时触发该事件。</p>
205</td>
206</tr>
207</tbody>
208</table>
209
210## 方法<a name="zh-cn_topic_0000001127125072_section2279124532420"></a>
211
212支持[通用方法](js-components-common-methods.md)。
213
214## 示例<a name="zh-cn_topic_0000001127125072_section1149419101412"></a>
215
216```
217<!-- xxx.hml -->
218<div class="container">
219  <switch showtext="true" texton="开启" textoff="关闭" checked="true" @change="switchChange">
220  </switch>
221</div>
222```
223
224```
225/* xxx.css */
226.container {
227  display: flex;
228  justify-content: center;
229  align-items: center;
230}
231switch{
232  texton-color:#002aff;
233  textoff-color:silver;
234  text-padding:20px;
235}
236```
237
238```
239// xxx.js
240import prompt from '@system.prompt';
241export default {
242  data: {
243    title: 'World'
244  },
245  switchChange(e){
246    console.log(e.checked);
247    if(e.checked){
248      prompt.showToast({
249        message: "打开开关"
250      });
251    }else{
252      prompt.showToast({
253        message: "关闭开关"
254      });
255    }
256  }
257}
258```
259
260![](figures/zh-cn_image_0000001166920118.gif)
261
262