鸿蒙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

Fluent Meshing边界层设置保姆级教程:从y+理论到实战避坑,看完就会

本文详细解析了Fluent Meshing边界层设置的全过程,从y+理论基础到实战避坑技巧,帮助用户精准计算第一层高度并优化参数配置。通过案例演示和常见问题诊断,指导读者掌握边界层网格生成的核心技术,提升CFD模拟精度。特别针对不同湍流模型的y+要求提供具体参数建议。

weixin_30576827的博客 799

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

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

m0_69424697的博客 818

ABAQUS单元刚度矩阵输出全攻略:从理论到实践(含MTX/DAT文件对比)

本文详细解析了ABAQUS中单元刚度矩阵的输出方法,涵盖理论原理、MTX与DAT文件格式对比及二次开发应用。通过具体操作步骤和性能优化建议,帮助用户高效获取并利用刚度矩阵数据,特别适合需要进行有限元分析验证和二次开发的工程师。

lg888的博客 1008

长上下文技术的底层逻辑:Attention、压缩、缓存与跨页推理

如果把模型的参数视为“固化智能”,动态智能(Dynamic Intelligence)——模型不必依赖训练时的记忆,而是可以随时调用外部信息。这一点正在改变大模型的范式:Prompt 不再是输入,而是“操作系统事件”文档不再是知识,而是“模型的临时记忆”模型不再是一段神经网络,而是一个“具备阅读循环的推理引擎”当我们把上下文从 128K 拉到百万级,我们做的不是扩容,而是让模型第一次拥有阅读、回溯、定位、跨页分析的能力。这是一种新的智能。

aifs2025的博客 998

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

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

qq_58213084的博客 4966

从零构建:用Arduino和MCP2515模块搭建你的第一个CAN Bus网络

本文详细介绍了如何使用Arduino和MCP2515模块从零搭建CAN Bus网络,实现温湿度数据的传输与显示。涵盖硬件连接、软件配置、发送端与接收端代码实现,以及系统调试和进阶应用,帮助初学者快速掌握CAN总线通信技术。

d6e7f8的博客 834

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

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

asfn123123的博客 447

CDD数据库文件制作(十一)——服务配置(0x19_DTC Code)

虽然选择Copy和Reference都可以加载DTC,但是如果我们在DTC库中有修改DTC,通过Copy的方式加载的DTC在DTC Table中不会跟着DTC库的修改而自动更新。通过Reference的方式加载的DTC可以自动更新。找到Fault Memory的DTC Table,鼠标放在DTC Table区域,右键点击选择Copy …根据需要(客户协议)勾选响应的19服务子功能。如何创建一个新的DTC code?按照字母与下方要素可做一一对应。首先在DTC库中新建DTC。支持10 01/10 03。

LOVE135149的博客 1921

手把手教你学SOC芯片架构--NoC(片上网络,Network on Chip)全方位解析

​、​。

MHD0815的博客 874

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

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

huazi99于老师的博客 1029

idea出现 EXCEPTION_ACCESS_VIOLATION (0xc0000005) 的解决方法

idea启动的时候出现如下问题,以为没啥事,就索性关闭 后面再打开idea的时候发现直接闪退,之后打开其他软件,直接蓝屏

码农研究僧的博客 4817

鸿蒙应用开发取消标题栏

鸿蒙应用开发取消标题栏

juer2017的博客 298

uniapp - 实现扫码功能自定义扫描二维码/条码界面+手电筒轻触照亮+扫码屏幕添加手动输入框,手机扫描二维码并跳转过程,调用手机原生摄像头进行扫码且自动识别执行事件(uniApp安卓苹果App端)

uniapp,app端,安卓app,苹果ios,uniapp扫码识别,二维码展示和扫码,uniapp如何实现扫码功能,uni-app实现扫码功能,二维码和一维码/条码扫描,UniApp实现扫描二维码,uniapp开发原生app页面的扫码功能,自定义扫码界面,uniapp怎么调用扫一扫功能,app自定义扫码界面,uniapp 自定义扫一扫页面,扫码手电筒功能,自定义扫描框,扫码报错怎么办,扫码黑屏,扫一扫摄像头黑屏,uniapp扫码原生插件,最新扫码组件,连续扫码,uniapp APP扫码,扫码后如何处理跳转

✅ 精选推荐文章 1万+

Statistics and Machine Learning Toolbox

Statistics and Machine Learning Toolbox(带书签),MATLAB统计学习工具

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

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

莫言情怼的博客 1128

TMS_WebGMaps_1.9.8.0_Full_Source

TMS_WebGMaps_1.9.8.0_Full_Source 全源码 delphi cbuilder

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

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

m0_69424697的博客 902

IMSL CNL 7.0.0 (x86-64)Crack

IMSL CNL 7.0.0 (x86-64)Crack intel的算法库破解文件,这是C++版本的破解文件

霍尼韦尔SoftMaster使用说明

霍尼韦尔SoftMaster使用说明

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

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

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、付费专栏及课程。

余额充值