【入门到实战】OpenHarmony南向子系统开发:窗口标题栏定制开发指导(ArkTS)

鸿蒙开发(OpenHarmony)窗口标题栏定制开发(ArkTs) 窗口标题栏是图形用户界面中的一个重要元素,它位于窗口的顶部,通常包含了窗口的标题以及一些控制按钮。标题栏的主要作用是提供关于窗口的基本信息,同时也为用户提供了一些控制选项。OpenHarmony有默认的窗口标题栏样式,本文基于ArkTs语言,提供窗口标题栏自定义方法。 阅读详情

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


窗口标题栏定制开发指导(ArkTS)

概述

功能简介

窗口标题栏是图形用户界面中的一个重要元素,它位于窗口的顶部,通常包含了窗口的标题以及一些控制按钮。标题栏的主要作用是提供关于窗口的基本信息,同时也为用户提供了一些控制选项。OpenHarmony有默认的窗口标题栏样式,本文基于ArkTS语言,提供窗口标题栏自定义方法。

约束与限制

需要在foundation/arkui/ace_engine/frameworks/core/components_ng/pattern/container_modal/interfaces路径下加入有自定义标题栏代码的js文件。并且在foundation/arkui/ace_engine/frameworks/core/components_ng/pattern/container_modal/interfaces/BUILD.gn中配置js文件编译成abc文件,最后在foundation/arkui/ace_engine/frameworks/core/components_ng/pattern/BUILD.gn完成编译配置。

开发步骤

以默认的系统标题栏为例,定制窗口标题栏的开发步骤如下:

  1. 使用ArkTS语言编写定制的窗口标题栏。

    import image from '@ohos.multimedia.image';
    
    const TITLE_ICON_SIZE: string = '20vp'
    const TITLE_PADDING_START: string = '20vp'
    const TITLE_ELEMENT_MARGIN_HORIZONTAL: string = '12vp'
    const TITLE_TEXT_FONT_SIZE: string = '16fp'
    const TITLE_TEXT_FONT_WEIGHT: string = '500px'
    const TITLE_ROW_HEIGHT: string = '37vp'
    
    @Entry
    @Component
    struct Index {
      @State appLabel: string = '';
      @State appLabelColor: Color = 0xff000000;
      @State appIcon: PixelMap | undefined = undefined;
    
      // 1、重写失焦和获焦函数,用于改变字体颜色
      onWindowFocused() {
        this.appLabelColor = 0xff000000;
      }
    
      onWindowUnfocused() {
        this.appLabelColor = 0x66000000;
      }
    
      // 2、重写标题栏设置应用图标和名称的方法
      setAppTitle(content: string ) {
        this.appLabel = content;
      }
    
      setAppIcon(pixelMap: image.PixelMap) {
        this.appIcon = pixelMap;
      }
    
      build() {
        Row() {
          // 3、Image组件用于显示应用图标
          Image(this.appIcon)
            .id("enhanceAppIcon")
            .height(TITLE_ICON_SIZE)
            .width(TITLE_ICON_SIZE)
            .interpolation(ImageInterpolation.Medium)
            .focusable(false)
            .margin({ left: TITLE_PADDING_START, right: TITLE_ELEMENT_MARGIN_HORIZONTAL })
          // 4、Text组件用于显示应用名称
          Text(this.appLabel)
            .id("enhanceAppLabel")
            .fontSize(TITLE_TEXT_FONT_SIZE)
            .fontColor(this.appLabelColor)
            .fontWeight(TITLE_TEXT_FONT_WEIGHT)
            .maxLines(1)
            .textOverflow({ overflow: TextOverflow.Ellipsis })
            .textAlign(TextAlign.Start)
            .layoutWeight(1.0)
          }
          .width('100%')
          .height(TITLE_ROW_HEIGHT)
          .justifyContent(FlexAlign.Start)
          .alignItems(VerticalAlign.Center)
          .padding({ top: 6, bottom: 6 })
      }
    }
    
  2. 将ets文件编译成js文件。

    const TITLE_ICON_SIZE = '20vp';
    const TITLE_PADDING_START = '20vp';
    const TITLE_ELEMENT_MARGIN_HORIZONTAL = '12vp';
    const TITLE_TEXT_FONT_SIZE = '16fp';
    const TITLE_TEXT_FONT_WEIGHT = '500px';
    const TITLE_ROW_HEIGHT = '37vp'
    export class Index extends ViewPU {
        constructor(parent, params, __localStorage, elmtId = -1) {
            super(parent, __localStorage, elmtId);
            this.__appLabel = new ObservedPropertySimplePU('', this, "appLabel");
            this.__textColor = new ObservedPropertySimplePU(0xff000000, this, "textColor");
            this.__pixelMap = new ObservedPropertyObjectPU(undefined, this, "appIcon");
            this.setInitiallyProvidedValue(params);
        }
        setInitiallyProvidedValue(params) {
            if (params.textColor !== undefined) {
                this.textColor = params.textColor;
            }
            if (params.appLabel !== undefined) {
                this.appLabel = params.appLabel;
            }
            if (params.appIcon !== undefined) {
                this.appIcon = params.appIcon;
            }
        }
        updateStateVars(params) {
        }
        purgeVariableDependenciesOnElmtId(rmElmtId) {
            this.__textColor.purgeDependencyOnElmtId(rmElmtId);
            this.__appLabel.purgeDependencyOnElmtId(rmElmtId);
            this.__appIcon.purgeDependencyOnElmtId(rmElmtId);
        }
        aboutToBeDeleted() {
            this.__textColor.aboutToBeDeleted();
            this.__appLabel.aboutToBeDeleted();
            this.__appIcon.aboutToBeDeleted();
            SubscriberManager.Get().delete(this.id__());
            this.aboutToBeDeletedInternal();
        }
        get textColor() {
            return this.__textColor.get();
        }
        set textColor(newValue) {
            this.__textColor.set(newValue);
        }
        get appLabel() {
            return this.__appLabel.get();
        }
        set appLabel(newValue) {
            this.__appLabel.set(newValue);
        }
        get appIcon() {
            return this.__appIcon.get();
        }
        set appIcon(newValue) {
            this.__appIcon.set(newValue);
        }
        onWindowFocused() {
            this.textColor = 0xff000000;
        }
        onWindowUnfocused() {
            this.textColor = 0x66000000;
        }
        setAppTitle(content) {
            this.appLabel = content;
        }
        setAppIcon(pixelMap) {
            this.appIcon = pixelMap;
        }
        initialRender() {
            this.observeComponentCreation((elmtId, isInitialRender) => {
                ViewStackProcessor.StartGetAccessRecordingFor(elmtId);
                Row.create();
                Row.width('100%');
                Row.height(TITLE_ROW_HEIGHT);
                Row.justifyContent(FlexAlign.Start);
                Row.alignItems(VerticalAlign.Center);
                Row.padding({ top: 6, bottom: 6 });
                if (!isInitialRender) {
                    Row.pop();
                }
                ViewStackProcessor.StopGetAccessRecording();
            });
            this.observeComponentCreation((elmtId, isInitialRender) => {
                ViewStackProcessor.StartGetAccessRecordingFor(elmtId);
                Image.create(this.appIcon);
                Image.id("enhanceAppIcon");
                Image.height(TITLE_ICON_SIZE);
                Image.width(TITLE_ICON_SIZE);
                Image.interpolation(ImageInterpolation.Medium);
                Image.focusable(false);
                Image.margin({ left: TITLE_PADDING_START, right: TITLE_ELEMENT_MARGIN_HORIZONTAL });
                if (!isInitialRender) {
                    Image.pop();
                }
                ViewStackProcessor.StopGetAccessRecording();
            });
            this.observeComponentCreation((elmtId, isInitialRender) => {
                ViewStackProcessor.StartGetAccessRecordingFor(elmtId);
                Text.create(this.appLabel);
                Image.id("enhanceAppLabel");
                Text.maxLines(1);
                Text.fontSize(TITLE_TEXT_FONT_SIZE);
                Text.fontColor(this.textColor);
                Text.fontWeight(TITLE_TEXT_FONT_WEIGHT);
                Text.textOverflow({ overflow: TextOverflow.Ellipsis });
                Text.textAlign(TextAlign.Start);
                Text.layoutWeight(1.0);
                if (!isInitialRender) {
                    Text.pop();
                }
                ViewStackProcessor.StopGetAccessRecording();
            });
            Text.pop();
            Row.pop();
        }
        rerender() {
            this.updateDirtyElements();
        }
    }
    ViewStackProcessor.StartGetAccessRecordingFor(ViewStackProcessor.AllocateNewElmetIdForNextComponent());
    // loadDocument方法需要更改为loadCustomTitleBar
    loadCustomTitleBar(new Index(undefined, {}));
    ViewStackProcessor.StopGetAccessRecording();
    
    • DevEco Studio编译生成的js文件或ts文件一般在工程的如下目录下:build/default/cache/default/default@CompileArkTS/esmodule/debug/entry/src/main/ets/pages/。
    • 处理ts文件,使其符合js语法规范。
    • js文件中的loadDocument或registerNameRouter方法需要更改使用loadCustomTitleBar方法。
      loadCustomTitleBar(new Index(undefined, {}));
      
  3. 通过BUILD.gn文件将处理后的js文件加入系统编译依赖,进一步生成.abc文件。

    import("//arkcompiler/ets_frontend/es2panda/es2abc_config.gni")
    
    es2abc_gen_abc("gen_customtitle_abc") {
    src_js = rebase_path("customtitle.js")
    dst_file = rebase_path(target_out_dir + "/customtitle.abc")
    in_puts = [ "customtitle.js" ]
    out_puts = [ target_out_dir + "/customtitle.abc" ]
    extra_args = [ "--module" ]
    }
    

    将上述gen_customtitle_abc加入到foundation/arkui/ace_engine/frameworks/core/components_ng/pattern/BUILD.gn文件的编译依赖中。编译后生成的.abc文件在obj/foundation/arkui/ace_engine/frameworks/core/components_ng/pattern/container_modal/interfaces目录下。

    具体可参考如下路径下的实现:foundation/arkui/ace_engine/frameworks/core/components_ng/pattern/container_modal/interfaces。

  4. 将.abc文件配置到系统中的指定目录,如/system/lib64/,然后命令行设置配置参数"persist.sys.arkui.customtitle"的值为.abc文件的路径,就可以读取并显示自定义的标题栏。

    hdc shell param set persist.sys.arkui.customtitle /system/lib64/customtitle.abc

OpenHarmony南向设备开发:子系统窗口标题栏定制开发(ArkTs) 窗口标题栏是图形用户界面中的一个重要元素,它位于窗口的顶部,通常包含了窗口的标题以及一些控制按钮。 阅读详情

相关推荐

OpenHarmony实战开发-如何实现应用市场首页

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

2401_82546228的博客 991

鸿蒙应用开发-去掉页面顶部标题

隐藏页面顶部的应用名称,在config.json - module 中加入下列配置 "metaData": { "customizeData": [ { "name": "hwc-theme", "value": "androidhwext:style/Theme.Emui.Light.NoTitleBar" } ] }, ...

万能的僵小鱼 2156

【鸿蒙】基于ArkTS基础组件封装的标题栏(TitleBar)组件

TitleBar 是基于 ArkTS 封装的通用、功能全面的自定义标题栏框架。

2401_82772199的博客 1635

鸿蒙Harmony应用开发—ArkTS声明式开发(基础手势:Text)

ArkTS声明式开发(基础手势:Text)

m0_64420071的博客 3348

OpenHarmony实战开发-如何使用自适应布局能力和响应式布局能力适配不同尺寸窗口。

页面设计 音乐专辑页的页面设计如下。

m0_70749039的博客 923

OpenHarmony实战开发-使用一次开发多端部署实现一多音乐专辑主页

本示例展示了音乐专辑主页。

2401_82546228的博客 768

华为 鸿蒙开发 ArkTS 怎么实现一行或者多行展示之后超出省略号(超出...)

【代码】华为 鸿蒙开发 ArkTS 怎么实现一行或者多行展示之后超出省略号(超出...)

小得盈满! 3519

鸿蒙OpenHarmony【安全区域】ArkTS组件通用属性

安全区域是指页面的显示区域,默认不与系统设置的非安全区域比如状态栏、导航栏区域重叠,默认情况下开发者开发的界面都被布局在安全区域内。提供属性方法允许开发者设置组件绘制内容突破安全区域的限制,通过[expandSafeArea]属性支持组件不改变布局情况下扩展其绘制区域至安全区外,通过设置[setKeyboardAvoidMode]来配置虚拟键盘弹出时页面的避让模式。页面中有标题栏等文字不希望和非安全区重叠时,建议对组件设置expandSafeArea属性达到沉浸式效果,也可以直接通过窗口接口[setWind

CS9527DND的博客 1373

OpenHarmony窗口标题栏定制开发指导(ArkTs)

窗口标题栏是图形用户界面中的一个重要元素,它位于窗口的顶部,通常包含了窗口的标题以及一些控制按钮。标题栏的主要作用是提供关于窗口的基本信息,同时也为用户提供了一些控制选项。OpenHarmony有默认的窗口标题栏样式,本文基于ArkTs语言,提供窗口标题栏自定义方法。

__Benco的博客 884

鸿蒙Harmony应用开发—ArkTS声明式开发(基础手势:NavDestination)

ArkTS声明式开发(基础手势:NavDestination)

m0_64420071的博客 1506

OpenHarmony相机和媒体库-如何在ArkTS中调用相机拍照和录像。

此Demo展示如何在ArkTS中调用相机拍照和录像,以及如何使用媒体库接口进行媒体文件的增、删、改、查操作。

m0_70749039的博客 2769

OpenHarmony子系统开发 - ArkUI

OpenHarmony有一套默认的窗口标题UX样式,但是不同的厂商的不同设备对于窗口有不同的UX样式的诉求,所以为了满足厂商自定义的需求,提供窗口标题栏自定义机制。

__Benco的博客 977

OpenHarmony Stage模型下的窗口开发

窗口模块用于在同一块物理屏幕上,提供多个应用界面显示、交互的机制。对应用开发者而言,窗口模块提供了界面显示和交互能力。对终端用户而言,窗口模块提供了控制应用界面的方式。对整个操作系统而言,窗口模块提供了不同应用界面的组织管理逻辑。设置应用主窗口属性及目标页面设置应用子窗口属性及目标页面体验窗口沉浸式能力设置悬浮窗在Stage模型下, 允许系统应用创建和管理系统窗口,包括音量条、壁纸、通知栏、状态栏、导航栏等。具体支持的系统窗口类型见API参考-WindowType。

坚果的博客 1万+

【入门到实战】OpenHarmony开发:分类组件(UICategory)

UICategory是基于open harmony基础组件开发的分类组件,支持单级分类、多级分类。

Androidbye的博客 644

车载以太网抓包实战:100BASE-T1/1000BASE-T1高效监控方案解析

本文深入解析了车载以太网100BASE-T1/1000BASE-T1的高效抓包监控方案。针对智能汽车开发中的故障排查与性能测试需求,详细对比了交换机镜像、TAP分流和捕获模块三大主流方案的原理、核心优势与适用场景,并提供了基于实战经验的选型指南与操作避坑要点,帮助工程师精准定位网络问题。

desk3的博客 430

P1003 [NOIP2011 提高组] 铺地毯 python题解

解题思路: 1、根据题意,所有地毯都是挨着铺的,所以最上面的一条符合题意的一定是从后往前数的第一条符合题意的。 2、符合题意要求x和y同时满足大于等于地毯左边坐标并且小于等于地毯右边坐标。 代码如下: n = int(input()) a = [] for i in range(n): a.append(list(map(int,input().split()))) x,y = list(map(int,input().split())) l = len(a) while l > 0: ..

繁华三千东流水不舍昼夜的博客 1622

【入门到实战】OpenHarmony开发:ImageUploader 图片上传

用于本地的图片上传至服务器.....

Androidbye的博客 395

rk3399 hdmi HDCP key烧录

1.key转换 使用 hdcp\ProvisioningTool_20170526\KeyConverterV2.02 目录下的KeyConvertor.exe工具将1.4key进行转换 转换后得到 TX00000001.skf 文件,将 TX00000001.skf 文件烧录到开发板上,烧录方式: 打开文件 hdcp\ProvisioningTool_20170526\ProvisioningTool20170526\ProvisioningTool.exe 选择烧录方式与烧录路...

qq_32645109的博客 3861

Flutter for OpenHarmony 实战:HarmonyOS ArkTS API 24 图片取色器

图片取色器组件继承自 StatefulWidget,这是因为它需要维护多个可变状态:图片是否加载完成、选中的颜色、HEX 代码、RGB 代码、点击位置等。组件的构造函数接收两个可选参数:宽度和高度。宽度默认值为 double.infinity,表示占满父容器的可用宽度;高度默认值为 400.0 像素。这种设计使得组件具有良好的灵活性,可以根据不同的使用场景调整尺寸。组件化设计:图片取色器被封装为独立的 StatefulWidget,具有良好的可复用性和可维护性。

2301_79516858的博客 367

CTP-API开发系列之三:柜台系统简介

综合交易平台(Comprehensive Transaction Platform,CTP)是专门为期货公司开发的一套期货经纪业务管理系统,由交易、风险控制和结算三大系统组成。接下来分享的内容,对于期货公司的负责交易、运维同事会比较熟悉,针对CTP-API接口对接的朋友可以了解一下,在接口之上的系统是怎样的。

码上助君的专栏 6206

路由三大分类:直连路由、静态路由、动态路由

直连路由、静态路由和动态路由各有其独特的特点和适用场景。直连路由适用于简单的直接连接网络,静态路由提供了精确的路径控制,而动态路由则在大型复杂网络中展现出强大的适应性和自动化能力。了解和掌握这三种路由类型的配置和管理,对于网络管理员来说,是确保网络高效、安全运行的重要技能。

网络技术联盟站 4702

Flutter for OpenHarmony 实战:HarmonyOS ArkTS API 24 盲盒”图片展示

精致的模糊揭示动画:使用和双动画协同实现了专业级的盲盒揭开效果,模糊度和透明度同步变化,视觉过渡流畅自然。多状态反馈设计:为不同的状态提供了相应的视觉反馈——未揭开时显示点击提示,揭开过程中显示加载指示器,揭开完成后显示清晰图片,用户体验完整连贯。网格布局集成:以网格形式展示多个盲盒,每个盲盒状态独立,用户可以逐个探索,营造出收集和探索的乐趣。可复用组件设计:盲盒图片封装为独立组件,提供丰富的配置参数,可以方便地集成到各种应用场景中。视觉细节完善。

2301_79516858的博客 507

32、运算放大器的工作原理与应用

本文详细介绍了运算放大器的工作原理与多种应用场景,涵盖开环与闭环放大器的基本概念、理想运算放大器的特性及其‘黄金规则’。文章深入解析了反相放大器、同相放大器、单位增益跟随器与反相器的配置和增益计算,并探讨了电压比较器及窗口比较器的工作机制。同时提供了运算放大器在实际应用中的选型流程、使用注意事项以及常见故障排查方法,帮助读者全面掌握运算放大器的设计与应用要点。

u5v6w7的博客 167

在鸿蒙 PC 上用 Rust 写一个 2048:ArkTS 负责界面,Rust 负责灵魂

鸿蒙应用的主力语言是 ArkTS(声明式 UI,类 TypeScript)。但很多场景下,我们希望把核心逻辑游戏规则、状态机这类纯逻辑,用 Rust 写既安全又好测,还能脱离 UI 单独跑单元测试;同一份 Rust 逻辑未来可复用到其它平台;鸿蒙提供 N-API(Node-API)桥接,ohos.rs把 napi-rs 适配到了鸿蒙,让 Rust 函数可以像 C++ native 模块一样被 ArkTSimport。逻辑层:纯 Rust,编译为cdylib,导出一个Game类。桥接。

DecorateCC的博客 5585

基于STM32单片机的环境监测系统设计与实现

综上所述,基于STM32单片机的环境监测系统具有良好的实时性、准确性和稳定性,能够满足环境监测的需求。本系统的研究意义在于,首先,它能够为用户提供准确的室内空气质量信息,帮助用户了解室内环境的质量状况,从而采取相应的措施来改善室内环境。本文设计并实现了一种基于STM32单片机的环境监测系统,该系统能够实时监测并显示室内环境的温湿度、甲醛浓度以及二氧化碳浓度,为用户提供准确的空气质量信息。实验过程中,我们模拟了不同的环境条件,包括温湿度变化、甲醛和二氧化碳浓度的波动等,以测试系统的实时性、准确性和稳定性。

3254968421的博客 2万+

华为OD机考双机位C卷 - 文件存储系统的排序(Java & Python & JS & GO & C++ & C)

华为OD机考双机位C卷 - 文件存储系统的排序, 提供Java、C++、Python、Go、JavaScript源码实现,并提供完整思路讲解,以及在线OJ模拟做题。

算法大师! 781
上一篇: 【入门到实战】OpenHarmony南向开发:Rust编译构建指南-Cargo2gn工具操作
下一篇: 【入门到实战】OpenHarmony南向子系统开发:窗口标题栏定制开发指导(C++)
懂你的大海
博客等级 码龄6年 9049粉丝 1381原创
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

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

抵扣说明:

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

余额充值