鸿蒙5.0开发进阶:UI框架-ArkTS组件(EditableTitleBar)

【鸿蒙】基于ArkTS基础组件封装的标题栏(TitleBar)组件 TitleBar 是基于 ArkTS 封装的通用、功能全面的自定义标题栏框架。 阅读详情

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


EditableTitleBar

编辑型标题栏,适用于多选界面或者内容的编辑界面,一般采取左叉右勾的形式。

说明

该组件从API Version 10开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。

导入模块

import { EditableTitleBar } from '@kit.ArkUI'

子组件

无

属性

不支持通用属性

EditableTitleBar

EditableTitleBar({leftIconStyle: EditableLeftIconType, imageItem?: EditableTitleBarItem, title: ResourceStr, subtitle?: ResourceStr, menuItems?: Array<EditableTitleBarMenuItem>, isSaveIconRequired: boolean, onSave?: () => void, onCancel?: () =>void, options: EditableTitleBarOptions, contentMargin?: LocalizedMargin})

装饰器类型:@Component

系统能力: SystemCapability.ArkUI.ArkUI.Full

参数:

名称参数类型必填装饰器类型说明
leftIconStyleEditableLeftIconType是-

左侧按钮类型。

默认值:EditableLeftIconType.Back,表示返回。

元服务API: 从API version 11开始,该接口支持在元服务中使用。

imageItem12+EditableTitleBarItem否-

用于左侧头像的单个菜单项目。

默认值:undefined。

元服务API: 从API version 12开始,该接口支持在元服务中使用。

titleResourceStr是-

标题。

默认值:'',表示标题内容为空。

元服务API: 从API version 11开始,该接口支持在元服务中使用。

subtitle12+ResourceStr否-

副标题。

默认值:'',表示副标题内容为空。

元服务API: 从API version 12开始,该接口支持在元服务中使用。

menuItemsArray<EditableTitleBarMenuItem>否-

右侧菜单项目列表。

默认值:undefined。

元服务API: 从API version 11开始,该接口支持在元服务中使用。

isSaveIconRequired12+boolean是-

是否需要右侧的保存按钮。

默认值:true,表示需要右侧的保存按钮。

说明: 未使用@Require装饰,构造时不强制校验参数。

元服务API: 从API version 12开始,该接口支持在元服务中使用。

onSave() => void否-

保存时的动作闭包。

默认值:() => void。

元服务API: 从API version 11开始,该接口支持在元服务中使用。

onCancel() => void否-

当左侧按钮类型为 Cancel,触发取消时的动作闭包。

默认值:() => void。

从API version 12开始,当左侧按钮类型为 Back,触发返回时的动作闭包。

元服务API: 从API version 11开始,该接口支持在元服务中使用。

options12+EditableTitleBarOptions是-

标题样式。

默认值:

{

safeAreaTypes: [SafeAreaType.SYSTEM],

safeAreaEdges: [SafeAreaEdge.TOP],

backgroundColor: '#00000000'

}。

说明: 未使用@Require装饰,构造时不强制校验参数。

元服务API: 从API version 12开始,该接口支持在元服务中使用。

contentMargin12+LocalizedMargin否@Prop

标题栏外边距,不支持设置负数。

默认值:

{start: LengthMetrics.resource($r('sys.float.margin_left')), end: LengthMetrics.resource($r('sys.float.margin_right'))}。

元服务API: 从API version 12开始,该接口支持在元服务中使用。

说明

入参对象不可为undefined,即EditableTitleBar(undefined)。

EditableLeftIconType

元服务API: 从API version 11开始,该接口支持在元服务中使用。

名称值说明
Back0返回按钮。
Cancel1取消按钮。

EditableTitleBarMenuItem

元服务API: 从API version 11开始,该接口支持在元服务中使用。

名称类型必填说明
valueResourceStr是图标资源。
label12+ResourceStr否图标标签描述。
isEnabledboolean否

是否启用,默认启用。

isEnabled为true时,表示为启用。

isEnabled为false时,表示为禁用。

action() => void否触发时的动作闭包。

EditableTitleBarItem12+

元服务API: 从API version 12开始,该接口支持在元服务中使用。

类型说明
EditableTitleBarMenuItem左侧头像的单个菜单类型。

EditableTitleBarOptions12+

元服务API: 从API version 12开始,该接口支持在元服务中使用。

名称类型必填说明
backgroundColorResourceColor否

标题栏背景色。

默认值: '#00000000'

backgroundBlurStyleBlurStyle否

标题栏背景模糊样式。

默认值: [BlurStyle.NONE]

safeAreaTypesArray <SafeAreaType>否

非必填,配置扩展安全区域的类型。

默认值: [SafeAreaType.SYSTEM]

safeAreaEdgesArray <SafeAreaEdge>否

非必填,配置扩展安全区域的方向。

默认值: [SafeAreaEdge.TOP]

事件

不支持通用事件

示例

示例1(右侧图标自定义标题栏)

该示例主要演示EditableTitleBar设置左侧图标、主标题及自定义右侧图标区的效果。

import { EditableLeftIconType, EditableTitleBar, promptAction } from '@kit.ArkUI';

@Entry
@Component
struct Index {
  build() {
    Row() {
      Column() {
        Divider().height(2).color(0xCCCCCC)
        // 左侧取消按钮,右侧保存按钮。
        EditableTitleBar({
          leftIconStyle: EditableLeftIconType.Cancel,
          title: '编辑页面',
          menuItems: [],
          onCancel: () => {
            promptAction.showToast({ message: 'on cancel' });
          },
          onSave: () => {
            promptAction.showToast({ message: 'on save' });
          }
        })
        Divider().height(2).color(0xCCCCCC)
        // 左侧返回按钮,右侧自定义取消按钮(disabled)、保存按钮。
        EditableTitleBar({
          leftIconStyle: EditableLeftIconType.Back,
          title: '编辑页面',
          menuItems: [
            {
              value: $r('sys.media.ohos_ic_public_cancel'),
              isEnabled: false,
              action: () => {
                promptAction.showToast({ message: 'show toast index 2' });
              }
            }
          ],
          onSave: () => {
            promptAction.showToast({ message: 'on save' })
          }
        })
        Divider().height(2).color(0xCCCCCC)
      }.width('100%')
    }.height('100%')
  }
}

示例2(头像与背景模糊标题栏)

该示例主要演示EditableTitleBar设置背景模糊、头像;取消右侧保存图标及自定义标题栏外边距的效果。

import { EditableLeftIconType, EditableTitleBar, LengthMetrics, promptAction, router } from '@kit.ArkUI';

@Entry
@Component
struct Index {
  @State titleBarMargin: LocalizedMargin = {
    start: LengthMetrics.vp(35),
    end: LengthMetrics.vp(35),
  };

  build() {
    Row() {
      Column() {
        EditableTitleBar({
          leftIconStyle: EditableLeftIconType.Cancel,
          title: '主标题',
          subtitle: '副标题',
          // 设置背景模糊效果
          options: {
            backgroundBlurStyle: BlurStyle.COMPONENT_THICK,
          },
          onSave: () => {
            promptAction.showToast({ message: "on save" });
          },
        })
        Divider().height(2).color(0xCCCCCC);
        EditableTitleBar({
          leftIconStyle: EditableLeftIconType.Cancel,
          title: '主标题',
          subtitle: '副标题',
          // 取消右侧保存按钮
          isSaveIconRequired: false,
        })
        Divider().height(2).color(0xCCCCCC);
        EditableTitleBar({
          leftIconStyle: EditableLeftIconType.Back,
          title: '主标题',
          subtitle: '副标题',
          isSaveIconRequired: false,
          onCancel: () => {
            router.back();
          },
        })
        Divider().height(2).color(0xCCCCCC);
        EditableTitleBar({
          leftIconStyle: EditableLeftIconType.Back,
          title: '主标题',
          subtitle: '副标题',
          menuItems: [
            {
              value: $r('sys.media.ohos_ic_public_remove'),
              isEnabled: true,
              action: () => {
                promptAction.showToast({ message: "show toast index 1" });
              }
            }
          ],
          isSaveIconRequired: false,
          // 点击左侧Back图标,触发的动作。
          onCancel: () => {
            router.back();
          },
        })
        Divider().height(2).color(0xCCCCCC);
        EditableTitleBar({
          leftIconStyle: EditableLeftIconType.Back,
          title: '主标题',
          subtitle: '副标题',
          // 设置可点击头像
          imageItem: {
            value: $r('sys.media.ohos_ic_normal_white_grid_image'),
            isEnabled: true,
            action: () => {
              promptAction.showToast({ message: "show toast index 2" });
            }
          },
          // 设置标题栏外边距
          contentMargin: this.titleBarMargin,
          // 右侧图标配置
          menuItems: [
            {
              value: $r('sys.media.ohos_ic_public_remove'),
              isEnabled: true,
              action: () => {
                promptAction.showToast({ message: "show toast index 3" });
              }
            }
          ],
          onCancel: () => {
            router.back();
          },
        })
      }
    }
  }
}

鸿蒙OpenHarmony【EditableTitleBar】标题栏与工具栏 编辑型标题栏,适用于多选界面或者内容的编辑界面,一般采取左叉右勾的形式。 阅读详情

相关推荐

HarmonyOS 5.0.0 或以上:实现顶部导航栏与页面标题栏实战

本篇讲解如何在 HarmonyOS ArkTS 中实现顶部导航栏(常用于页面标题、返回按钮、操作项),适用于详情页、设置页等具有导航逻辑的页面。

2501_92049284的博客 691

华为鸿蒙应用--封装通用标题栏:CommonTitleBar(鸿蒙工具)-ArkTs

鸿蒙通用标题栏,支持左、中、右常规标题栏设置;

qq_41374940的博客 1765

鸿蒙5.0版开发:ArkTS组件-EditableTitleBar

编辑型标题栏,适用于多选界面或者内容的编辑界面,一般采取左叉右勾的形式。

m0_69424697的博客 867

探索HarmonyOS的EditableTitleBar组件:一个灵活易用的编辑型标题栏

文章摘要:EditableTitleBar是一款适用于编辑场景的标题栏组件,支持API≥10。核心功能包括:1)按钮类型控制(Cancel/Back);2)主副标题配置;3)右侧功能区自定义(菜单项/保存按钮);4)样式定制(背景/边距);5)焦点管理。提供无障碍支持,需注意API版本兼容性限制(如副标题需API≥12)。典型应用场景包括取消/保存功能、模糊背景效果及语音播报优化。使用时需处理好回调逻辑,图标资源需通过$r()引用系统资源,且不支持通用装饰器属性扩展。

2401_86731168的博客 727

【HarmonyOS】自定义组件之JavaUI实现通用标题栏组件

平时我们在开发一个应用时,我们都知道一个完整的项目中会有很多个页面,而这些页面中会有许多通用的部分,比如通用标题栏、通用Dialog、通用下拉菜单等等,在Android开发中我们可以通过LayoutInflater.from(Context).inflate(layout,root,false)解析XML布局,从而将多个Android中内置的控件实现一个组合式的自定义View,以达到组件通用化,提高代码的复用性的效果。

华为开发者联盟 902

HarmonyOS鸿蒙开发指南:基础组件 toolbar开发指导

Toolbar组件仅支持toolbar-item为子组件,页面最多可以展示5个toolbar-item子组件,如果存在6个及以上toolbar-item,则保留前面4个,后续的将收纳到工具栏上的更多项中,通过点击更多项弹窗进行展示。设置position样式控制Toolbar组件的位置,并设置子组件toolbar-item的字体颜色、大小及背景色。Toolbar组件不支持添加事件和方法,但其子组件toolbar-item支持。在pages/index目录下的hml文件中创建一个Toolbar组件。

斌擎科技 1028

【鸿蒙开发基础学习】组件导航 (Navigation)

Navigation 通过 customNavContentTransition 事件提供自定义转场动画的能力,通过如下三步可以定义一个自定义的转场动画。

专注移动开发 2433

手把手教你用西门子博图V18配置阿特拉斯PF6000拧紧枪PN通讯(附完整GSD文件与ToolsTalk配置文件)

本文详细介绍了如何使用西门子博图V18配置阿特拉斯PF6000拧紧枪的PN通讯,包括硬件连接、网络参数规划、ToolsTalk软件配置及博图工程设置。通过完整的GSD文件和配置文件,帮助工程师快速实现高精度拧紧设备与PLC的高效通讯,适用于汽车装配和电子制造等工业自动化场景。

weixin_42662293的博客 606

鸿蒙5.0版开发:ArkTS高级组件-@ohos.arkui.advanced.EditableTitleBar (编辑页面标题栏)

编辑型标题栏,适用于多选界面或者内容的编辑界面,一般采取左叉右勾的形式。

m0_69424697的博客 818

手把手教你用DevExpress Patch工具解决VS项目中的试用弹窗问题

本文详细指导开发者使用DevExpress Patch工具解决Visual Studio项目中恼人的试用弹窗问题。核心在于理解并分步处理:首先正确应用补丁工具以绕过运行时验证,然后重点清理或重置项目中的licenses.licx文件以消除编译时验证,从而彻底根治弹窗。

weixin_29234423的博客 590

TMS320C6678开发笔记1-6---C6678单核烧写程序

第6节 单核烧写加载程序 6.1节 TI参考文档 参考文档:《KeystoneI Bootloader Resources and FAQ》讲的非常好,建议一定要看 https://processors.wiki.ti.com/index.php/KeystoneI_Bootloader_Resources_and_FAQ#Direct_Boot_Examples_.28without_IBL.29 里面有三个工程: C6678 EVM SPI boot example C6657 EVM ..

kunkliu的博客 5699

基础ArkTS组件:导航栏组件(HarmonyOS学习第三课【3.8】)

Navigationtitle:当titleMode为时,随着可滚动组件的滑动标题栏模式发生变化时触发此回调。

qq_58213084的博客 4966

RexUniNLU零样本通用自然语言理解:nlp_deberta_rex-uninlu_chinese-base模型实战解析

本文深入解析了RexUniNLU零样本通用自然语言理解模型(nlp_deberta_rex-uninlu_chinese-base)的实战应用。通过详细的环境配置、模型加载及实战案例,展示了该模型在零样本场景下的强大能力,如实体识别和复杂关系抽取,显著提升NLP任务效率。

weixin_29088655的博客 251

鸿蒙OpenHarmony【TabTitleBar】标题栏与工具栏

页签型标题栏,用于页面之间的切换。仅一级页面适用。

asfn123123的博客 447

解决:Solving environment: failed CondaValueError: Malformed version string ‘~‘: invalid character(s).

解决:Solving environment: failed CondaValueError: Malformed version string '~': invalid character(s).

晚风微凉的博客 1万+

基于V7-690T FPGA纯逻辑实现NVMe SSD盘的读写(不使用软核)

a.NVMe的Admin CQ与Admin SQ命令放在Host内存中;因此SQ的64B要用FPGA的DDR或开一个bram空间存放,同理NVME写到HOST的CQ命令也需要存放在FPGA的DDR或一个bram空间,host收到NVME传来的MSI/MSI-X中断后,去CQ存放空间取CQ指令;b. 发送identify命令后,需要发送tial doorbell通知NVME;(发送CNS01h获取4096字节的固件信息等;发送CNS02h获取1024字节的namaspace list)

宝沐熙的博客 837

鸿蒙开发系列教程(十三)--组件导航:Navigation 导航

Navigation组件的页面包含主页和内容页。主页由标题栏、内容区和工具栏组成,

huazi99于老师的博客 1029

上位机图像处理和嵌入式模块部署(qmacvisual获取边界点)

【声明:版权所有,欢迎转载,请勿用于商业用途。 联系信箱:feixiaoxing @163.com】 在图像处理中,解决了分割的问题之后,下面就是属性信息的提取。在这其中,有一种属性是非常重要的 ,那就是外界轮廓的边界点获取。这个边界点,可以用来计算长度,也可以用来进行直线、圆的拟合,具体的用途取决于现场的实际使用场景。目前qmacvisual支持对边界点的提取,相关控件可以直接用来提取边界点。

嵌入式-老费,一个分享专业嵌入式知识的blog 885

鸿蒙应用开发取消标题栏

鸿蒙应用开发取消标题栏

juer2017的博客 298

【推荐100个unity插件】将UE的资源导出到unity使用—— Exporter for Unreal to/for Unity插件

Unreal to Unity导出器是一款帮助开发者将Unreal Engine项目转换为Unity的工具。文章详细介绍了使用步骤:1)安装虚幻引擎并创建项目;2)在Plugins文件夹中安装导出插件;3)导入UE资产到Content文件夹;4)配置导出参数并完成转换。文末推荐了多个Unity开发专栏,涵盖C#编程、2D/3D开发、特效制作等内容。作者向宇提供了博客地址,欢迎读者交流学习。该工具能有效提升项目迁移效率,适合需要跨引擎开发的用户使用。

向宇的博客,专注php/web全栈 unity游戏开发,欢迎大家评论纠错 857

锂电池充电器电路设计 里面有电路

锂电池充电器电路设计 里面有电路 3.7V升压到5V电路设计。

HarmonyOS应用开发实战-公共TitleBar的开发

【代码】HarmonyOS应用开发实战-公共TitleBar的开发。

莫言情怼的博客 1128

计算机控制技术及应用

《计算机控制技术及应用》通过总结作者的科研成果和吸收国内外的先进理论、方法和技术,以计算机控制系统的网络化、开放化、智能化和集成化发展趋势为主线索,主要介绍计算机控制系统的基本概念和计算机控制系统的典型形式,计算机控制系统的数学描述与基本分析方法,以及数字PID控制器、最少拍控制系统、达林算法、状态变量设计法等设计方法及其各种改进算法。重点突出计算机控制系统输入输出通道接口的设计方法和典型控制系统的设计案例与实现方法等。

鸿蒙5.0版开发:ArkTS高级组件-@ohos.arkui.advanced.ComposeTitleBar (头像和单双行文本标题栏)

一种普通标题栏,支持设置标题、头像(可选)和副标题(可选),可用于一级页面、二级及其以上界面配置返回键。

m0_69424697的博客 902

RU DOS版、EFI版32bit/64bit BIOS常用工具

DOS版、EFI版的RU工具,可用来查看IO、MEM、PCI、SMBIOS等资源。亲测在EFI SHELL下可用。

假人有限元模型

假人模型,车辆碰撞假人有限元模型,适合做乘员安全的研究者利用

鸿蒙一次开发,多端部署(九)应用市场首页

本小节将以应用市场首页为例,介绍如何使用自适应布局能力和响应式布局能力适配不同尺寸窗口。

1 1401

鸿蒙ArkTS实现返回顶部按钮

在日常各种应用中,可以发现在往下滚动一定距离的时候,右下角会自动弹出一个按钮,点击以后可以返回到页面顶部,那么在ArkTS中,这个功能如何实现呢?主要以使用Scroll组件为主,当然List也同理。

lcyuanyuan的博客 1694

HarmonyOS--路由管理--组件导航 (Navigation)

HarmonyOS--路由管理--组件导航 (Navigation)

weixin_47808575的博客 3335

鸿蒙开发:自定义一个简单的标题栏

你可以使用相对布局RelativeContainer或者线性布局Row,都可以进行实现,根据项目中的需求或者UI设计进行组件摆放

知足常乐 1248
上一篇: 鸿蒙5.0开发进阶:UI框架-ArkTS组件(ComposeTitleBar)
下一篇: 鸿蒙5.0开发进阶:UI框架-ArkTS组件(SelectTitleBar)
懂你的大海
博客等级 码龄6年 9049粉丝 1381原创
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

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

抵扣说明:

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

余额充值