• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# CSS语法参考
2
3CSS是描述HML页面结构的样式语言。所有组件均存在系统默认样式，也可在页面CSS样式文件中对组件、页面自定义不同的样式。请参考[通用样式](../reference/arkui-js/js-components-common-styles.md)了解兼容JS的类Web开发范式支持的组件样式。
4
5## 尺寸单位
6
7- 逻辑像素px（文档中以<length>表示）：
8
9   - 默认屏幕具有的逻辑宽度为720px（配置见[配置文件](js-framework-js-tag.md)中的window小节），实际显示时会将页面布局缩放至屏幕实际宽度，如100px在实际宽度为1440物理像素的屏幕上，实际渲染为200物理像素（从720px向1440物理像素，所有尺寸放大2倍）。
10   - 额外配置autoDesignWidth为true时（配置见[配置文件](js-framework-js-tag.md)中的window小节），逻辑像素px将按照屏幕密度进行缩放，如100px在屏幕密度为3的设备上，实际渲染为300物理像素。应用需要适配多种设备时，建议采用此方法。
11
12- 百分比（文档中以<percentage>表示）：表示该组件占父组件尺寸的百分比，如组件的width设置为50%，代表其宽度为父组件的50%。
13
14
15## 样式导入
16
17为了模块化管理和代码复用，CSS样式文件支持 \@import 语句，导入css文件。
18
19
20## 声明样式
21
22每个页面目录下存在一个与布局hml文件同名的css文件，用来描述该hml页面中组件的样式，决定组件应该如何显示。
23
241. 内部样式，支持使用style、class属性来控制组件的样式。例如：
25   ```html
26   <!-- index.hml -->
27   <div class="container">
28     <text style="color: red">Hello World</text>
29   </div>
30   ```
31
32   ```css
33   /* index.css */
34   .container {
35     justify-content: center;
36   }
37   ```
38
392. 文件导入，合并外部样式文件。例如，在common目录中定义样式文件style.css，并在index.css文件首行中进行导入：
40   ```css
41   /* style.css */
42   .title {
43     font-size: 50px;
44   }
45   ```
46
47   ```css
48   /* index.css */
49   @import '../../common/style.css';
50   .container {
51     justify-content: center;
52   }
53   ```
54
55
56## 选择器
57
58css选择器用于选择需要添加样式的元素，支持的选择器如下表所示：
59
60| 选择器                       | 样例                                    | 样例描述                                     |
61| ------------------------- | ------------------------------------- | ---------------------------------------- |
62| .class                    | .container                            | 用于选择class="container"的组件。                |
63| \#id                      | \#titleId                             | 用于选择id="titleId"的组件。                     |
64| tag                       | text                                  | 用于选择text组件。                              |
65| ,                         | .title,&nbsp;.content                 | 用于选择class="title"和class="content"的组件。    |
66| \#id&nbsp;.class&nbsp;tag | \#containerId&nbsp;.content&nbsp;text | 非严格父子关系的后代选择器，选择具有id="containerId"作为祖先元素，class="content"作为次级祖先元素的所有text组件。如需使用严格的父子关系，可以使用“&gt;”代替空格，如：\#containerId&gt;.content。 |
67
68示例：
69
70```html
71<!-- 页面布局xxx.hml -->
72<div id="containerId" class="container">
73  <text id="titleId" class="title">标题</text>
74  <div class="content">
75    <text id="contentId">内容</text>
76  </div>
77</div>
78```
79
80```css
81/* 页面样式xxx.css */
82/* 对所有div组件设置样式 */
83div {
84  flex-direction: column;
85}
86/* 对class="title"的组件设置样式 */
87.title {
88  font-size: 30px;
89}
90/* 对id="contentId"的组件设置样式 */
91#contentId {
92  font-size: 20px;
93}
94/* 对所有class="title"以及class="content"的组件都设置padding为5px */
95.title, .content {
96  padding: 5px;
97}
98/* 对class="container"的组件下的所有text设置样式 */
99.container text {
100  color: #007dff;
101}
102/* 对class="container"的组件下的直接后代text设置样式 */
103.container > text {
104  color: #fa2a2d;
105}
106```
107
108以上样式运行效果如下：
109
110![zh-cn_image_0000001127125270](figures/zh-cn_image_0000001127125270.png)
111
112其中“.container text”将“标题”和“内容”设置为蓝色，而“.container &gt; text”直接后代选择器将“标题”设置为红色。2者优先级相同，但直接后代选择器声明顺序靠后，将前者样式覆盖（优先级计算见[选择器优先级](#选择器优先级)）。
113
114## 选择器优先级
115
116选择器的优先级计算规则与w3c规则保持一致（只支持：内联样式，id，class，tag，后代和直接后代），其中内联样式为在元素style属性中声明的样式。
117
118当多条选择器声明匹配到同一元素时，各类选择器优先级由高到低顺序为：内联样式 &gt; id &gt; class &gt; tag。
119
120
121## 伪类
122
123css伪类是选择器中的关键字，用于指定要选择元素的特殊状态。例如，:disabled状态可以用来设置元素的disabled属性变为true时的样式。
124
125除了单个伪类之外，还支持伪类的组合，例如，:focus:checked状态可以用来设置元素的focus属性和checked属性同时为true时的样式。支持的单个伪类如下表所示，按照优先级降序排列：
126
127| 名称        | 支持组件                                     | 描述                                       |
128| --------- | ---------------------------------------- | ---------------------------------------- |
129| :disabled | 支持disabled属性的组件                          | 表示disabled属性变为true时的元素（不支持动画样式的设置）。      |
130| :active   | 支持click事件的组件<br/>                        | 表示被用户激活的元素，如：被用户按下的按钮、被激活的tab-bar页签（不支持动画样式的设置）。 |
131| :waiting  | button                                   | 表示waiting属性为true的元素（不支持动画样式的设置）。         |
132| :checked  | input[type="checkbox"、type="radio"]、&nbsp;switch | 表示checked属性为true的元素（不支持动画样式的设置）。         |
133
134伪类示例如下，设置按钮的:active伪类可以控制被用户按下时的样式：
135
136```html
137<!-- index.hml -->
138<div class="container">
139  <input type="button" class="button" value="Button"></input>
140</div>
141```
142
143```css
144/* index.css */
145.button:active {
146  background-color: #888888;/*按钮被激活时，背景颜色变为#888888 */
147}
148```
149
150> **说明：**
151> 针对弹窗类组件及其子元素不支持伪类效果，包括popup、dialog、menu、option、picker
152
153
154## 样式预编译
155
156预编译提供了利用特有语法生成css的程序，可以提供变量、运算等功能，令开发者更便捷地定义组件样式，目前支持less、sass和scss的预编译。使用样式预编译时，需要将原css文件后缀改为less、sass或scss，如index.css改为index.less、index.sass或index.scss。
157
158- 当前文件使用样式预编译，例如将原index.css改为index.less：
159  ```less
160  /* index.less */
161  /* 定义变量 */
162  @colorBackground: #000000;
163  .container {
164    background-color: @colorBackground; /* 使用当前less文件中定义的变量 */
165  }
166  ```
167
168- 引用预编译文件，例如common中存在style.scss文件，将原index.css改为index.scss，并引入style.scss：
169  ```scss
170  /* style.scss */
171  /* 定义变量 */
172  $colorBackground: #000000;
173  ```
174
175  在index.scss中引用：
176
177  ```scss
178  /* index.scss */
179  /* 引入外部scss文件 */
180  @import '../../common/style.scss';
181  .container {
182    background-color: $colorBackground; /* 使用style.scss中定义的变量 */
183  }
184  ```
185
186  > **说明：**
187  > 引用的预编译文件建议放在common目录进行管理。
188
189## CSS样式继承<sup>6+</sup>
190
191css样式继承提供了子节点继承父节点样式的能力，继承下来的样式在多选择器样式匹配的场景下，优先级排最低，当前支持以下样式的继承：
192
193- font-family
194
195- font-weight
196
197- font-size
198
199- font-style
200
201- text-align
202
203- line-height
204
205- letter-spacing
206
207- color
208
209- visibility
210