HarmonyOS Next开发学习手册——UI开发框架 (CSS语法参考)

CSS是描述HML页面结构的样式语言。所有组件均存在系统默认样式，也可在页面CSS样式文件中对组件、页面自定义不同的样式。请参考 通用样式 了解兼容JS的类Web开发范式支持的组件样式。

尺寸单位

• 逻辑像素px（文档中以表示）：

  • 默认屏幕具有的逻辑宽度为720px（配置见 配置文件 中的window小节），实际显示时会将页面布局缩放至屏幕实际宽度，如100px在实际宽度为1440物理像素的屏幕上，实际渲染为200物理像素（从720px向1440物理像素，所有尺寸放大2倍）。
  • 额外配置autoDesignWidth为true时，逻辑像素px将按照屏幕密度进行缩放，如100px在屏幕密度为3的设备上，实际渲染为300物理像素。应用需要适配多种设备时，建议采用此方法。

• 百分比（文档中以表示）：表示该组件占父组件尺寸的百分比，如组件的width设置为50%，代表其宽度为父组件的50%。

样式导入

为了模块化管理和代码复用，CSS样式文件支持 @import 语句，导入css文件。

声明样式

每个页面目录下存在一个与布局hml文件同名的css文件，用来描述该hml页面中组件的样式，决定组件应该如何显示。

1. 内部样式，支持使用style、class属性来控制组件的样式。例如：

<!-- index.hml -->
<div class="container">
  <text style="color: red">Hello World</text>
</div>

---

/* index.css */
.container {
  justify-content: center;
}

2. 文件导入，合并外部样式文件。例如，在common目录中定义样式文件style.css，并在index.css文件首行中进行导入：

/* style.css */
.title {
  font-size: 50px;
}

---

/* index.css */
@import '../../common/style.css';
.container {
  justify-content: center;
}

选择器

css选择器用于选择需要添加样式的元素，支持的选择器如下表所示：

选择器	样例	样例描述
.class	.container	用于选择class="container"的组件。
#id	#titleId	用于选择id="titleId"的组件。
tag	text	用于选择text组件。
,	.title, .content	用于选择class="title"和class="content"的组件。
#id .class tag