• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# option
2<!--Kit: ArkUI-->
3<!--Subsystem: ArkUI-->
4<!--Owner: @Armstrong15-->
5<!--Designer: @zhanghaibo0-->
6<!--Tester: @lxl007-->
7<!--Adviser: @HelloCrease-->
8
9>  **说明:**
10>  从API version 4开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
11
12当作为&lt;[select](js-components-basic-select.md)&gt;的子组件时用来展示下拉选择的具体项目。
13
14
15当作为&lt;[menu](js-components-basic-menu.md)&gt;的子组件时用来展示弹出菜单的具体项目。
16
17
18## 权限列表
19
2021
22
23## 子组件
24
25不支持。
26
27
28## 属性
29
30除支持[通用属性](js-components-common-attributes.md)外,还支持如下属性:
31
32| 名称       | 类型      | 默认值  | 必填   | 描述                                       |
33| -------- | ------- | ---- | ---- | ---------------------------------------- |
34| selected | boolean | -    | 否    | 选择项是否为下拉列表的默认项,仅在父组件是select时生效。true表示该选项是下拉列表的默认项,false表示该选项不是下拉列表的默认项。          |
35| value    | string  | -    | 是    | 该属性定义选项值,将作为父组件select/menu的selected事件回调参数。<br/>option选项的UI展示值需要放在标签内,如:<br>`<option value="10">十月</option>` |
36| icon     | string  | -    | 否    | 图标资源路径,该图标展示在选项文本前,图标格式为jpg,png和svg。     |
37
38
39## 样式
40
41支持如下样式。
42
43| 名称              | 类型                         | 默认值        | 必填   | 描述                                       |
44| --------------- | -------------------------- | ---------- | ---- | ---------------------------------------- |
45| color           | &lt;color&gt;              | \#e6000000 | 否    | 选择项的文本颜色。                                |
46| font-size       | &lt;length&gt;             | 16px       | 否    | 选择项的文本尺寸。                                |
47| allow-scale     | boolean                    | true       | 否    | 选择项的文本尺寸是否跟随系统设置字体缩放尺寸进行放大缩小。true表示跟随系统放大缩小,false表示不跟随系统放大缩小。<br/>如果在config描述文件中针对ability配置了fontSize的config-changes标签,则应用不会重启而直接生效。 |
48| font-weight     | number&nbsp;\|&nbsp;string | normal     | 否    | 选择项的字体粗细,见[text组件font-weight的样式属性](js-components-basic-text.md#样式)。 |
49| text-decoration | string                     | none       | 否    | 选择项的文本修饰,见[text组件text-decoration的样式属性](js-components-basic-text.md#样式)。 |
50| font-family     | string                     | sans-serif | 否    | 选择项的字体列表,用逗号分隔,每个字体用字体名或者字体族名设置。列表中第一个系统中存在的或者通过[自定义字体](js-components-common-customizing-font.md)指定的字体,会被选中作为文本的字体。 |
51
52
53## 事件
54
55不支持。
56
57
58## 方法
59
60不支持。
61
62
63## 示例
64
65详见[menu示例](js-components-basic-menu.md#示例)。
66