给Web开发者的HarmonyOS指南02-布局样式

原创

苏杰豪

修改于 2025-03-28 10:04:54

800

文章被收录于专栏：鸿蒙开发专栏教程鸿蒙开发专栏教程

给Web开发者的HarmonyOS指南02-布局样式

本系列教程适合鸿蒙 HarmonyOS 初学者，为那些熟悉用 HTML 与 CSS 语法的 Web 前端开发者准备的。

本系列教程会将 HTML/CSS 代码片段替换为等价的 HarmonyOS/ArkUI 代码。

开发环境准备

DevEco Studio 5.0.3
HarmonyOS Next API 15

布局基础对比

在Web开发中，我们使用CSS来控制元素的布局和样式。而在HarmonyOS的ArkUI中，我们使用声明式UI和链式API来实现相同的效果。本文将对比两种框架在布局方面的异同。

盒子模型

在Web开发中，CSS盒子模型包含内容(content)、内边距(padding)、边框(border)和外边距(margin)。

在ArkUI中，这些概念依然存在，只是写法有所不同，容易上手。

HTML/CSS代码：

<div class="box">
  盒子模型
</div>

<style>
  .box {
    box-sizing: border-box;
    /* 内容 */
    width: 150px;
    height: 100px;
    /* 内边距 */
    padding: 10px;
    /* 边框 */
    border: 10px solid pink;
    /* 底部外边距 */
    margin-bottom: 10px;
  }
</style>

ArkUI代码：

Text('盒子模型')
  .width(150)
  .height(100)
  .padding(10)
  .border({ width: 10, style: BorderStyle.Solid, color: Color.Pink })
  .margin({ bottom: 10 })

背景色和文字颜色

在Web开发中，我们使用 background-color 和 color 属性来设置背景色和文字颜色。

在ArkUI中，我们使用 backgroundColor 和 fontColor 方法。

HTML/CSS代码：

<div class="box">
  背景色、文字色
</div>

<style>
  .box {
    /* 背景色 */
    background-color: #36d;
    /* 文字色 */
    color: #fff;
  }
</style>

ArkUI代码：

Text('背景色、文字色')
  .backgroundColor('#36d')
  .fontColor('#fff')

内容居中

在Web开发中，我们使用 display: flex 配合 justify-content 和 align-items 实现内容居中。

在ArkUI中，我们可以使用 Column 或 Row 组件配合 justifyContent 和 alignItems 属性。

HTML/CSS代码：

<div class="box">
  内容居中
</div>

<style>
  .box {
    display: flex;
    justify-content: center;
    align-items: center;
  }
</style>

ArkUI代码：

Column() {
  Text('内容居中')
}
.backgroundColor('#36D')
.justifyContent(FlexAlign.Center)
.alignItems(HorizontalAlign.Center)
.width(150)
.height(100)
.padding(10)

圆角

在Web开发中，我们使用border-radius属性来设置圆角。

在ArkUI中，我们使用borderRadius方法。

HTML/CSS代码：

<div class="box">
  圆角
</div>

<style>
  .box {
    border-radius: 10px;
  }
</style>

ArkUI代码：

Text('圆角')
  .width(150)
  .height(100)
  .backgroundColor('#36D')
  .borderRadius(10)

阴影效果

在Web开发中，我们使用box-shadow属性来设置阴影效果。

在ArkUI中，我们使用shadow方法。

HTML/CSS代码：

<div class="box">
  阴影
</div>

<style>
  .box {
    box-shadow: 0 6px 50px rgba(0, 0, 0, 0.5);
  }
</style>

ArkUI代码：

Text('阴影')
  .width(150)
  .height(100)
  .backgroundColor('#F5F5F5')
  .shadow({
    offsetX: 0,
    offsetY: 6,
    radius: 50,
    color: 'rgba(0, 0, 0, 0.5)',
  })

布局容器和轴向

基本容器

在Web开发中，我们使用<div>作为通用容器。

在ArkUI中，我们主要使用Column和Row组件，注意 alignItems 需区分轴向。

HTML/CSS代码：

<div class="column">
  <!-- 垂直方向布局 -->
</div>

<div class="row">
  <!-- 水平方向布局 -->
</div>


<style>
  .column {
    display: flex;
    flex-direction: column;
    align-items: center;
  }
  
  .row {
    display: flex;
    flex-direction: row;
    align-items: center;
  }
</style>

ArkUI代码：

Column() {
  // 垂直方向布局，交叉轴水平居中
}
.alignItems(HorizontalAlign.Center)

Row() {
  // 水平方向布局，交叉轴垂直居中
}
.alignItems(VerticalAlign.Center)

关键区别总结

样式应用方式：
- HTML/CSS：使用选择器和属性声明样式
- ArkUI：使用链式API直接在组件上设置样式
布局容器：
- HTML：使用 <div> 等标签，配合CSS实现布局
- ArkUI：使用专门的布局组件如 Column、Row 等组件，配合样式属性布局
单位使用：
- HTML/CSS：使用 px、em、rem、百分比等单位
- ArkUI：使用 px、vp、lpx 、百分比等单位，使用数字单位 vp 可省略
样式继承：
- HTML/CSS：通过CSS选择器实现样式继承
- ArkUI：没有样式继承