鸿蒙5.0开发进阶:JS服务卡片UI组件-HML语法

鸿蒙之HML语法参考 HML(HarmonyOS Markup Language)是一套类HTML的标记语言,通过组件,事件构建出页面的内容。页面具备数据绑定、事件绑定、条件渲染和逻辑控制等高级能力。 阅读详情

往期鸿蒙5.0全套实战文章必看:(文中附带全栈鸿蒙5.0学习资料)


HML语法

HML是一套类HTML的标记语言,通过组件,事件构建出页面的内容。页面具备数据绑定、事件绑定、条件渲染和逻辑控制等高级能力。

页面结构

<!-- xxx.hml -->
<div class="item-container">
  <text class="item-title">Image Show</text>
  <div class="item-content">
    <image src="/common/xxx.png" class="image"></image>
  </div>
</div>

数据绑定

<!-- xxx.hml -->
<div class="item-container">
  <text>{{content}}</text>            <!-- 输出:Hello World!-->
  <text>{{key1}} {{key2}}</text>       <!-- 输出:Hello World-->
  <text>key1 {{key1}}</text>           <!-- 输出:key1 Hello-->
  <text>{{flag1 && flag2}}</text>      <!-- 输出:false-->
  <text>{{flag1 || flag2}}</text>      <!-- 输出:true-->
  <text>{{!flag1}}</text>              <!-- 输出:false-->
</div>

卡片hml文件中的变量需要在json文件的data字段下进行声明:

{
  "data": {
    "content": "Hello World!",
    "key1": "Hello",
    "key2": "World",
    "flag1": true,
    "flag2": false
  }
}

说明

  • key值支持对象操作符和数组操作符,如{{key.value}}、{{key[0]}}。

  • 支持字符串拼接、逻辑运算和三元表达式。

  • 字符串拼接:

    • 支持变量跟变量:{{key1}}{{key2}}等
    • 支持常量跟变量: "my name is {{name}}, i am from {{city}}." "key1 {{key1}}"
  • 逻辑运算:

    • 与:{{flag1 && flag2}}(仅支持两个boolean变量间的与逻辑运算)
    • 或:{{flag1 || flag2}} (仅支持两个boolean变量间的或逻辑运算)
    • 非:{{!flag1}} (仅支持boolean变量的非逻辑运算)
  • 三元表达式

    • {{flag? key1:key2}}(flag为boolean变量,key1和key2可以是变量,也可以是常量)
  • 注意事项

    • 非boolean类型值进行bool运算默认为false
    • 以上所有变量解析跟运算解析均不支持嵌套

事件绑定

卡片的事件需要在json文件的actions字段下进行声明。卡片仅支持click通用事件,事件的定义只能是直接命令式,事件定义必须包含action字段,用以说明事件类型。卡片支持两种事件类型:跳转事件(router)和消息事件(message)。跳转事件可以跳转到卡片提供方的应用,消息事件可以将开发者自定义信息传递给卡片提供方。事件参数支持变量,变量以"{{}}"修饰。跳转事件中若定义了params字段,则在被拉起应用的onStart的intent中,可用"params"作为key将跳转事件定义的params字段的值取到。

  • 跳转事件格式

    通过定义ability名称和携带的参数字段params直接跳转,可用"params"作为key提取到跳转事件定义的params字段值。

    选择器样例默认值样例描述
    actionstring"router"

    事件类型。

    - "router":用于应用跳转。

    - "message":自定义点击事件。

    abilityNamestring-跳转ability名。
    paramsObject-跳转应用携带的额外参数。
    {
      "data": {
        "mainAbility": "xxx.xxx.xxx"
      },
      "actions": {
        "routerEvent": { 
          "action": "router",
          "abilityName": "{{mainAbility}}",
          "params":{}
        } 
      }
    }
  • 消息事件格式

    选择器样例默认值样例描述
    actionstringmessage表示事件类型。
    paramsObject-跳转应用携带的额外参数。
    {
      "actions": {
        "activeEvent": { 
          "action": "message",
          "params": {}           
        } 
      }
    }
  • 绑定路由事件和消息事件

    <!-- xxx.hml --> 
    <div> 
      <!-- 正常格式 --> 
      <div onclick="activeEvent"></div> 
      <!-- 缩写 --> 
      <div @click="activeEvent"></div> 
    </div>

列表渲染

<!-- xxx.hml -->
<div class="array-container">
  <!-- div列表渲染 -->
  <!-- 默认$item代表数组中的元素, $idx代表数组中的元素索引 -->
  <div for="{{array}}" tid="id">
    <text>{{$item.name}}</text>
  </div>
  <!-- 自定义元素变量名称 -->
  <div for="{{value in array}}" tid="id">    
    <text>{{value.name}}</text>
  </div>
  <!-- 自定义元素变量、索引名称 -->
  <div for="{{(index, value) in array}}" tid="id">    
    <text>{{value.name}}</text>
  </div>
</div>
{
  "data": {
    "array": [
      {"id": 1, "name": "jack", "age": 18},
      {"id": 2, "name": "tony", "age": 18}
    ]
  }
}

tid属性主要用来加速for循环的重渲染,旨在列表中的数据有变更时,提高重新渲染的效率。tid属性是用来指定数组中每个元素的唯一标识,如果未指定,数组中每个元素的索引为该元素的唯一id。例如上述tid="id"表示数组中的每个元素的id属性为该元素的唯一标识。for循环支持的写法如下:

  • for="array":其中array为数组对象,array的元素变量默认为$item。

  • for="v in array":其中v为自定义的元素变量,元素索引默认为$idx。

  • for="(i, v) in array":其中元素索引为i,元素变量为v,遍历数组对象array。

说明

  • 数组中的每个元素必须存在tid指定的数据属性,否则运行时可能会导致异常。

  • 数组中被tid指定的属性要保证唯一性,如果不是则会造成性能损耗。比如,示例中只有id和name可以作为tid字段,因为它们属于唯一字段。

  • tid不支持表达式。

  • 不支持for嵌套使用。

  • for对应的变量数组,当前要求数组中的object是相同类型,不支持多种object类型混合写在一个数组中。

条件渲染

条件渲染分为2种:if/elif/else和show。

当使用if/elif/else写法时,节点必须是兄弟节点,否则编译无法通过。实例如下:

<!-- xxx.hml -->
<div>
  <text if="{{show}}"> Hello-TV </text>
  <text elif="{{display}}"> Hello-Wearable </text>
  <text else> Hello-World </text>
</div>
{
  "data": {
    "show": false,
    "display": true
  }
}

当show为真时,节点正常渲染;当show为假时,节点不渲染,效果等同display样式为none。

<!-- xxx.hml -->
<text show="{{visible}}"> Hello World </text>
{
  "data": {
    "visible": false
  }
}

逻辑控制块

<block>控制块使得循环渲染和条件渲染变得更加灵活;block在构建时不会被当作真实的节点编译。block标签只支持if属性。

<!-- xxx.hml --> 
<div> 
  <block if="{{show}}"> 
    <text>Hello</text> 
    <text>World</text> 
  </block>
</div>
{ 
  "data": { 
    "show": true
  } 
}

【鸿蒙开发 day13】 本章主要学习了字符串的拼接方法,数据类型的转换,交互点击事件,状态管理的概念以及业务场景,运算符,数组增删改查的方法及如何计算数组长度. 阅读详情

相关推荐

【鸿蒙开发】—— UI开发框架 (HML语法)

HML是一套类HTML的标记语言,通过组件,事件构建出页面的内容。页面具备数据绑定、事件绑定、列表渲染、条件渲染和逻辑控制等高级能力。

2401_88547687的博客 1318

HarmonyOS学习笔记——ArkUI框架体系、HML基础组件、HML高级组件

ArkUI框架体系、HML基础组件、HML高级组件

2401_85302533的博客 2145

Python量化投资入门教程:从零构建你的第一个交易策略

量化投资教程以数学模型和计算机程序实现超额收益,选用Python工具链完成数据获取、策略构建及回测。通过移动平均线交叉策略示例,展示数据预处理、信号生成、收益计算及可视化全流程,结合收益率、最大回撤和夏普比率评估策略,并建议参数优化与策略融合提升稳健性。

ylmx5201314的博客 2460

html基础知识点

1. 前端开发的核心语言 HTML——结构 CSS——样式 JS——行为 2.HTML(Hypertext Markup Language)翻译过来就是 超文本标记语言。 超文本即超越文本,可以显示 文字 图片 视频 音频,最重要的是可以包含超链接。 标记语言:当我们把特定的英文单词放入到我们的标记(单标记:</>、双标记<></>)当中,我们的标记具有了新的语义,而由具有特定语义的标记的规范,我们可以称之为标记语言。 当我们将英语单词放入到标记当中,这时候我们可以称之为

qq_52006958的博客 2854

Prompt Airlines CTF通关实战:从提示词注入到多模态攻击的AI安全攻防演练

提示词注入(Prompt Injection)是当前大语言模型(LLM)应用面临的核心安全威胁之一,其原理在于攻击者通过精心构造的用户输入,覆盖或绕过系统预设的指令,从而操控模型行为。这种攻击手法的技术价值在于揭示了AI系统在理解与执行指令时存在的逻辑边界模糊性,可能导致数据泄露、越权访问等严重风险。在应用场景上,从基础的客服对话到结合视觉识别的多模态系统,都可能成为攻击面。本文以一场名为“Prompt Airlines CTF”的实战挑战为例,深入剖析了包括指令遗忘、上下文注入、工具调用滥用及多模态提示注

aodan5477的博客 525

西门子200SMART PID温控实战:从配置到避坑(附加热棒控制案例)

本文详细介绍了西门子200SMART PLC在PID温控系统中的实战应用,涵盖硬件配置、PID参数整定及工程避坑技巧。通过加热棒控制案例,重点解析了信号处理、固态继电器选型、断电保持和无扰切换等关键问题,为工业自动化领域的温度控制提供可靠解决方案。

weixin_28727975的博客 357

【鸿蒙next开发】JS服务卡片UI组件:框架说明(HML语法)

本文介绍了鸿蒙HarmonyOS 5.0开发中的HML语法核心知识点,包括页面结构、数据绑定、事件绑定、列表渲染和条件渲染等功能。

m0_73088370的博客 704

从FedAvg到实战:手把手教你用PyTorch复现联邦学习经典论文实验(MNIST/CIFAR-10)

本文详细介绍了如何使用PyTorch复现联邦学习经典算法FedAvg在MNIST和CIFAR-10数据集上的实验。从环境搭建、数据非IID划分到模型实现和参数聚合,手把手教你掌握联邦学习的核心技术与实战技巧,帮助开发者和研究人员快速实现隐私保护的分布式机器学习方案。

weixin_29053695的博客 256

鸿蒙5.0开发进阶:JS服务卡片UI组件-CSS语法

CSS是描述HML页面结构的样式语言。

Androidbye的博客 1015

CMU动作捕捉数据集实战:从AMC文件到Python可视化的完整流程

本文提供了CMU动作捕捉数据集的完整实战指南,详细解析了AMC文件格式,并对比了MATLAB转换、Python原生解析及转换为BVH格式三种数据解析策略。重点介绍了如何构建Python数据处理与可视化管道,包括将数据转换为Pandas DataFrame、绘制时间序列与相关性热力图,以及实现3D骨架动画,帮助开发者高效利用这一经典动作捕获数据集进行运动分析与模型训练。

android的专栏 716

Backtrader官方中文文档:第四章Concepts基本概念

官方Concepts章节:https://backtrader.com/docu/concepts/

汇渊科技 2603

【鸿蒙next开发】JS服务卡片UI组件:框架说明(CSS语法)

本文介绍了鸿蒙5.0开发中的CSS样式语言应用。

m0_73088370的博客 556

QGIS安装与使用教程

QGIS安装与使用教程

weixin_46713695的博客 2万+

【鸿蒙next开发】JS服务卡片UI组件:框架说明(文件组织)

本文介绍了鸿蒙5.0开发中服务卡片的文件组织目录结构及访问规则。

m0_73088370的博客 697

ARM Linux工控板+C# .NET Core:倍福ADS协议轻量化工业控制(附跨平台部署代码)

某自动化设备厂的倍福PLC控制系统曾依赖传统x86工控机:单台设备需配备1台Intel i5工控机(成本约8000元),功耗30W+,且Windows系统稳定性受工业环境干扰(如电磁辐射导致蓝屏)。更棘手的是,设备需部署在产线边缘(空间狭小),x86工控机的体积(4U机架)和散热需求(风扇噪音)难以适配;而多设备部署时,高硬件成本和高功耗导致年运维成本超20万元。

这里只有干货:从 Modbus 通信到 MES 对接,从 YOLO 训练到工控机部署,带你搞定工业软件开发全流程。 954

visio安装包

Microsoft Office Visio 是一款专业的制图软件。利用经过更新的形状、协作工具和数据链接图表,创建专业级图表以简化复杂的信息。

【鸿蒙next开发】JS服务卡片UI组件:框架说明(多语言支持)

本文介绍了鸿蒙5.0开发中的多语言支持实现方法。

m0_73088370的博客 852

Probability and Statistics - 4th edition

Probability and Statistics - 4th edition

鸿蒙 Harmony arkTS开发资源Resource string 字符串类型和数字number 变量连接方法,API9的string资源占位符功能

这里关键的一个地方是$r('app.string.hostLab',item.toString())需求,多个相似的组件,传入不同的数字,或者字符串,然后根据传入值,把内容显示出来。需要用到国际化的字符串和传入值一起连接起来,部分代码如下,资源部分不贴出来了。对应resources.base.element.string文件里。

yakie的专栏 8190

win10 跳过U8环境检测的IE WebControls.rar

win10 安装u8的时候 提示IE WebControls 不通过,这个工具可以欺骗u8的检查。 跳过U8环境检测的IE WebControls。提示导入失败后,重新检测通过。

jre9下载 jdk9

(Java SE Runtime Environment 9.0) 9.0u175 官方最新版 【x86|x64】

鸿蒙开发-第9天

name:'小李',age:18,gender:'男',bobby:['滑雪','吃火锅'],eat:(food:string)=>{ console.log('我要吃'),food}}let xx1 = (num1:number,num2:number) => { return num1+num2 } console.log('和是',xx1(1,2))console.log('简介','名字是'+name,'年龄是'+age)console.log('结果是:',parseFloat(str2))

shr007_的博客 2607

鸿蒙教程 Day01(鸿蒙介绍与开发环境) 7.HML组件

HML(HarmonyOS Markup Language)是一套类HTML的标记语言,是兼容类Web开发范式中三段式开发范式的一部分,通过HML组件页面具备数据绑定、事件绑定、条件渲染和逻辑控制等高级能力。说起来这个HML缩写和HTML差不多,但是这个H居然是HarmonyOS的意思…不过就算它换了个名字,其实大体用法上还是和HTML差不多,还是相当好学的。

qq_42230454的博客 691

【鸿蒙】HarmonyOS NEXT星河入门到实战5-基础语法

学习数据类型、控制语句等。

春天的波菜 2752

鸿蒙开发(1)

鸿蒙开发(1) 1.开发环境搭建 2.目录结构和文件使用规则 3.chart组件的使用 4.使用image-animator组件构建多图帧动画 5.TODOList应用构建

weixin_54230482的博客 381

鸿蒙开发系统的初步学习

鸿蒙的简单入门学习

m0_61673669的博客 1126

【小白学鸿蒙-学习笔记】关于鸿蒙的一点吐槽与近期学习的体会

对于这块内容,我是站在一个新手的角度得出的内容,如有不对的内容,请指正。

csdndevpress0028的博客 2664

Kotlin开发中的一些Tips,Android知识总结

然后点击Tools - > Kotlin - > Show Kotlin Bytecode -> Decompile就可以对kotlin编译后的字节码进行反编译,从而看到java版本的代码。 示例代码区别只是末尾多拼接了一个!,结果转换代码略有不同,但+号拼接方式在java中最终也是用 StringBuilder 来进行字符串拼接,所以其实是等价的。这里只是展示不同。 但问题是使用plus的代码,可以看到图中倒数第二行,append中直接是a + " "。感觉有点不对劲,那我们直接看一下

m0_64319298的博客 570

鸿蒙0基础学习【HML语法参考】ArkUI

HML是一套类HTML的标记语言,通过组件,事件构建出页面的内容。页面具备数据绑定、事件绑定、列表渲染、条件渲染和逻辑控制等高级能力。

zhenggaoxiao232的博客 849

HarmonyOS Next星河版笔记--界面开发(5)

作用:把两个或多个字符串,拼成一个字符串。(通常是用来拼接字符串和变量)加好作用:拼接日志页面效果。

2301_81982769的博客 1013
上一篇: 鸿蒙5.0开发进阶:JS组件-画布组件(CanvasRenderingContext2D对象)
下一篇: 鸿蒙5.0开发进阶:JS服务卡片UI组件-CSS语法
懂你的大海
博客等级 码龄6年 9049粉丝 1381原创
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付:10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值