HarmonyOS怎么使用条件渲染动态显示UI

大明姑娘_2377

大明姑娘_2377

2026-08-07

313人浏览

原创

HarmonyOS ArkTS中条件渲染需用@State装饰状态变量,支持if/else、else if嵌套及ForEach内单条过滤,子组件状态须通过@Link传递避免丢失。

harmonyos怎么使用条件渲染动态显示ui - php中文网

在HarmonyOS ArkTS开发中,需要根据用户操作、网络状态或数据变化实时切换界面元素——比如登录后显示个人中心按钮、加载中隐藏列表、错误时展示重试提示,这些都依赖条件渲染实现。

基础if/else结构写法

在组件的build()函数内直接使用if语句包裹要条件显示的UI组件。

if语句后必须紧跟一个构建函数(即花括号{}内含至少一个可渲染组件),否则编译报错。

写法与标准TypeScript一致:if (this.status) { Text('已启用') } else { Text('已禁用') }。

【this.status必须用@State装饰】,否则状态变更不会触发界面更新。

嵌套条件与多分支控制

支持else if和深层嵌套,但需注意父容器对子组件类型的约束。

例如Grid容器内所有条件分支都只能返回GridItem组件,否则运行时报错。

第一步:定义多级状态变量
  @State showHeader: boolean = true
  @State userType: string = 'guest'

第二步:在build中组合判断
  if (this.showHeader) {
    Text('欢迎页').fontSize(20)
    if (this.userType === 'admin') {
      Button('管理后台').onClick(() => this.goToAdmin())
    } else if (this.userType === 'user') {
      Button('我的订单').onClick(() => this.goToOrder())
    } else {
      Button('立即登录').onClick(() => this.login())
    }
  }

Rustic AI
Rustic AI

一款AI图像与设计工具,主要用于AI驱动的创意设计平台,适合需要提升相关任务效率的用户。

下载

条件渲染配合ForEach动态列表

方法一:在外层控制整个列表显隐
  if (this.data.length > 0) {
    List() {
      ForEach(this.data, item => ListItem() { Text(item.name) }, item => item.id)
    }
  } else {
    Text('暂无数据').fontSize(16).fontColor(Color.Grey)
  }

方法二:在ForEach内部做单条过滤
  ForEach(this.allItems, item => {
    if (item.visible) {
      ListItem() { Text(item.title) }
    }
  }, item => item.id)

注意:ForEach内部的if只影响当前item的渲染,不会破坏列表结构完整性。

避免状态丢失的关键处理

@State变量归属父组件,子组件不能直接持有条件渲染中可能被销毁的@State。

当条件分支内包含自定义子组件且该子组件需维护自身状态时,必须用@Link从父组件传递状态引用。

错误写法:
  if (this.showPanel) {
    CustomPanel() // 若CustomPanel内有@State,切换时状态会重置
  }

正确写法:
  if (this.showPanel) {
    CustomPanel({ isVisible: $showPanel }) // 用$前缀传@Link绑定
  }

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

harmonyos教程 harmonyos

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
harmonyos是什么意思
harmonyos是什么意思

harmonyos是一个多设备、可扩展的全场景操作系统,它的设计目标是实现智能终端之间的无缝连接,提供统一的操作体验。本专题提供harmonyos相关的文章,大家可以免费体验。

2023.06.28

5325

5

GoFrame框架Web开发与路由中间件
GoFrame框架Web开发与路由中间件

本专题聚焦GoFrame框架的Web开发,拆解路由注册与匹配规则、请求参数获取、参数校验与中间件执行顺序,说明统一响应、JWT鉴权、文件上传与接口文档生成的落地方式,并补充优雅重启与测试实践。

2026.11.17

0

15

GoFrame框架安装与gf命令行工具
GoFrame框架安装与gf命令行工具

本专题围绕GoFrame框架的安装与工具链配置展开,讲清Go版本要求、gf命令行的安装方式、代理镜像与依赖准备,说明项目初始化、热编译、交叉编译打包的做法,并整理安装阶段的常见报错与验证步骤。

2026.11.17

20

15

GoFrame框架零基础入门
GoFrame框架零基础入门

本专题整理GoFrame框架的入门知识,从模块化设计理念、环境准备到跑通第一个Web服务,讲清目录分层、配置加载、日志与中间件的用法,并对比Gin、Go-Zero的差异,帮助Go开发者建立整体认知。

2026.11.17

0

15

SQLAlchemy 一对多关系怎么建立
SQLAlchemy 一对多关系怎么建立

SQLAlchemy 一对多关系怎么建立?本专题整理父子表外键、relationship 双向映射、关联查询、级联删除和加载优化等相关文章,帮助你理解并实现常见的 ORM 关系建模。

2026.11.17

0

10

SQLAlchemy 如何增删改查
SQLAlchemy 如何增删改查

SQLAlchemy 如何增删改查?本专题整理 ORM 新增记录、条件查询、更新和删除、Session 事务提交与批量处理等实用文章,帮助你掌握 Python 数据库操作流程。

2026.11.17

0

11

SQLAlchemy ORM 模型怎么写
SQLAlchemy ORM 模型怎么写

SQLAlchemy ORM 模型怎么写?本专题整理模型类定义、Mapped 字段映射、主键与约束、表结构创建和常见报错的相关文章,帮助你从基础配置到实际建模逐步掌握 SQLAlchemy。

2026.11.17

0

16

Go-Zero API开发使用教程
Go-Zero API开发使用教程

本专题聚焦Go-Zero的API开发,拆解.api描述文件的语法结构、路由与分组定义、参数绑定与校验规则,说明统一响应体、JWT鉴权、跨域与接口文档生成的落地方式,并给出网关聚合与接口测试的实践建议。

2026.11.12

180

15

Go-Zero安装与goctl环境配置教程
Go-Zero安装与goctl环境配置教程

本专题围绕Go-Zero的安装与工具链配置展开,讲清Go版本要求、goctl安装方式、代理镜像、protoc依赖与环境变量设置,说明多版本共存、升级回退与CI流水线安装的做法,并整理安装阶段的常见报错与验证步骤。

2026.11.12

120

15

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程