harmony 鸿蒙CSS语法参考

2023-06-24
浏览 (922)

CSS语法参考

CSS是描述HML页面结构的样式语言。所有组件均存在系统默认样式，也可在页面CSS样式文件中对组件、页面自定义不同的样式。

样式导入

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

声明样式

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

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

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

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

文件导入，合并外部样式文件。例如，在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”的组件。
,	.title, .content	用于选择class=“title”和class=“content”的组件。

示例：

<!-- 页面布局xxx.hml -->
<div id="containerId" class="container">
  <text id="titleId" class="title">标题</text>
  <div class="content">
    <text id="contentId">内容</text>
  </div>
</div>

/* 页面样式xxx.css */
/* 对class="title"的组件设置样式 */
.title {
  font-size: 30px;
}
/* 对id="contentId"的组件设置样式 */
#contentId {
  font-size: 20px;
}
/* 对所有class="title"以及class="content"的组件都设置padding为5px */
.title, .content {
  padding: 5px;
}

伪类

css伪类是选择器中的关键字，用于指定要选择元素的特殊状态。

名称	支持组件	描述
:active	input[type=“button”]	表示被用户激活的元素，如：被用户按下的按钮。轻量级智能穿戴上伪类选择器上仅支持background-color 和background-image 的样式设置。
:checked	input[type=“checkbox”、type=“radio”]	表示checked属性为true的元素。轻量级智能穿戴上伪类选择器上仅支持background-color 和background-image 的样式设置。

伪类示例如下，设置按钮的:active伪类可以控制被用户按下时的样式：

<!-- index.hml -->
<div class="container">
  <input type="button" class="button" value="Button"></input>
</div>

/* index.css */
.button:active {
  background-color: #888888;/*按钮被激活时，背景颜色变为#888888 */
}

样式预编译

预编译提供了利用特有语法生成css的程序，可以提供变量、运算等功能，令开发者更便捷地定义组件样式，目前支持less、sass和scss的预编译。使用样式预编译时，需要将原css文件后缀改为less、sass或scss，如index.css改为index.less、index.sass或index.scss。

当前文件使用样式预编译，例如将原index.css改为index.less：

  /* index.less */
  /* 定义变量 */
  @colorBackground: #000000;
  .container {
    background-color: @colorBackground; /* 使用当前less文件中定义的变量 */
  }

引用预编译文件，例如common中存在style.scss文件，将原index.css改为index.scss，并引入style.scss：

  /* style.scss */
  /* 定义变量 */
  $colorBackground: #000000;

在index.scss中引用：

  /* index.scss */
  /* 引入外部scss文件 */
  @import '../../common/style.scss';
  .container {
    background-color: $colorBackground; /* 使用style.scss中定义的变量 */
  }