一、ArkUI官方要素

(1)@Entry:页面入口的装饰器,用于标记当前自定义组件作为页面入口的组件,可以独立运行。

(2)@Component:组件装饰器,用于定义自定义UI组件,被标记的结构体可以用于构建界面视图

二、arkUI布局

用于容纳,排列子组件的特殊组件, Column规定 从上而下的排列方式,主轴是垂直方向,交叉轴是水平方向 Row从左到右的排列方式,主轴是水平方向,交叉轴是垂直方向。

1. Column 垂直布局

垂直布局 = Column
组件从上到下竖直排列。
justifyContent:控制垂直方向对齐(上 / 中 / 下 / 均分)
alignItems:控制水平方向对齐(左 / 中 / 右)
spacing:设置组件上下间距

2.Row 水平布局

水平布局 = Row
组件从左到右横向排列。
justifyContent:控制水平方向对齐(左 / 中 / 右 / 均分)
alignItems:控制垂直方向对齐(上 / 中 / 下)
spacing:设置组件左右间距

3.Stack层叠布局

Stack = 组件叠在一起
后面的组件覆盖在前面的组件之上。
作用:实现图片 + 文字、按钮叠加、多层重叠效果
对齐:默认居中,可设置左上 / 右下 / 居中
特点:所有子组件共享同一个显示区域

4.Flex弹性布局

Flex = 自适应弹性排列
可水平 / 垂直自由切换,自动适配屏幕,最常用。
方向:flexDirection 控制水平 / 垂直
主轴对齐:justifyContent 控制主方向间距
侧轴对齐:alignItems 控制交叉方向对齐
自适应:子组件用 flex:1 自动占满剩余空间

5.相对布局

容器:RelativeContainer
逻辑:子组件依靠id 锚点,参照容器或其他组件定位,而非固定行列顺序
关键配置:.id('标识名')给组件起名,.alignRules()写锚定规则
对齐参数:top/bottom/left/right/middle,分别绑定锚点与对齐方式
特点:位置自由灵活,适合复杂错位排版;代码层级比 Column/Row 繁琐

6.轮播图

容器:Swiper
作用:实现图片 / 组件自动轮播、左右滑动切换
核心属性:
autoPlay(true):自动播放
interval(2000):切换间隔(毫秒)
loop(true):循环播放
width/height:设置轮播框大小
内部:放Image实现图片轮播

7.tabs

容器:Tabs
内部:TabContent 存放每个页面
标签:.tabBar("名称") 设置顶部 / 底部按钮
效果:点击标签 / 左右滑动切换页面
常用:.barPosition() 设置标签位置

Logo

讨论HarmonyOS开发技术,专注于API与组件、DevEco Studio、测试、元服务和应用上架分发等。

更多推荐