文章目录前言页面骨架其实比参数更重要看懂状态比看懂样式更重要真正决定页面行为的是这些函数第一段关键代码页面是怎么被带起来的第二段关键代码真正决定交互手感的地方这一页我建议这样上手从示例到项目中间这几步别省这类实现为什么比文档片段更有用完整代码收个尾前言默认标题栏能用但很多项目最后都会改。因为真实业务的标题区经常不仅有标题还会有副标题、搜索入口、操作按钮。这个案例适合用来理解导航头部的二次设计。 如果你手上正好有类似页面要做那这篇文章最好不要只当教程看。我更建议你边看边想这一段如果换成我自己的业务数据需不需要改状态需不需要拆组件。别看这个案例篇幅不算长但它很适合拿来练“页面目标和代码结构怎么对齐”这件事。你后面不管是复刻还是准备拆成自己的业务组件都会更顺。这类写法尤其适合落在 详情页、活动页、带头部操作的功能页 这些场景里所以我下面不会只讲“组件怎么写”而是更关心“放进页面之后为什么这样组织”。页面骨架其实比参数更重要我建议先不要着急顺着源码往下滚。先回答一个更实际的问题自定义标题导航页 这个页面用户一进来第一眼会看到什么接着又会去操作哪里。结构感一旦建立起来后面的代码就不容易看散。页面区域主要职责在代码里的典型表现头部说明区交代当前案例在演示什么Text标题、补充说明、标签文案核心展示区承载组件能力的主要效果Column、Row、业务组件本体辅助信息区补充状态、标签、分组或统计信息次级文本、角标、分组标题、描述块交互入口区负责切换、返回、定位、选择等动作点击事件、按钮、索引条、导航入口这一页没有额外拆出接口页面更多是直接围绕基础数据和组件参数展开。单个组件 API 不难难的是和其他布局、容器、交互拼在一起之后还不乱这篇会重点讲这个。看懂状态比看懂样式更重要我在看这类页面时通常会先找状态字段。因为 NavDestination 标题区改造与头部布局 这件事最终都要落到“是谁控制、什么时候变、变了之后哪里刷新”上。isShow建议优先确认它控制的是显示、选择、切换还是数据同步。showDetail建议优先确认它控制的是显示、选择、切换还是数据同步。真要自己上手改我建议别一开始就扑到样式上先把状态分层这件事处理好长期数据列表内容、卡片信息、导航目标、角标基数这类不该跟着一次点击乱跳的内容。交互状态当前选中项、弹层开关、吸附开关、回显结果这类会频繁变化的值。计算结果过滤结果、统计文案、高亮判断这类更适合派生出来的内容。真正决定页面行为的是这些函数读函数别贪多。对 自定义标题导航页 这种页面来说真正有阅读价值的往往是那几段会改状态、触发交互或者推动页面切换的逻辑。这个案例没有太多额外方法核心价值主要集中在页面结构和组件组合方式。我自己读这类方法时通常只抓一条线谁触发、谁被改、页面哪里立刻有反馈。把这三件事连起来很多交互代码一下就顺了。第一段关键代码页面是怎么被带起来的这一段建议慢一点看。它通常决定了页面初始状态也决定了后续哪些区域会跟着刷新。StateisShow:booleantrueStateshowDetail:booleanfalsebuild(){Column(){if(this.isShow){Column({space:16}){Text(NavDestination 标题).fontSize(20).fontWeight(FontWeight.Bold).fontColor(DEMO_THEME_COLOR)Text(NavDestination 支持自定义标题和副标题).fontSize(13).fontColor(DEMO_SUBTEXT_COLOR).width(100%)if(!this.showDetail){Column({space:10}){ForEach([用户详情,订单信息,系统设置],(title:string,index:number){Row({space:12}){Text([,,⚙][index]).fontSize(24)Column({space:4}){这一段我通常不会一下翻过去而是先确认下面这几个判断点State字段到底在控制显示、选择、跳转结果还是模式切换。默认值是不是合理页面一打开会不会就落在一个可理解的状态上。字段命名能不能让后来的人一眼看懂用途而不是还要翻半天 UI。第二段关键代码真正决定交互手感的地方这一段代码把入口列表和详情区域拆得很清楚点击任意项后把showDetail置为true页面随即切到自定义标题布局。这里可以重点看标题、副标题、返回入口和内容区是否形成了同一套页面语义。.onClick((){this.showDetailtrue})})}.width(100%)}else{Column({space:14}){// 自定义标题栏样式1Text(标题样式 1居中大标题).fontSize(12).fontColor(DEMO_SUBTEXT_COLOR).width(100%)Column(){Row(){Text(← 返回).fontSize(14).fontColor(DEMO_THEME_COLOR)Blank()Text(···).fontSize(18).fontColor(#666666)}.width(100%)代码读到这里我通常会顺手补三件事不然后面很容易只看热闹这个交互入口接收的到底是什么输入。输入进来之后代码改了哪个状态或者触发了哪次导航。变化发生后用户最先感知到的反馈会落在哪个区域。这三个问题串起来之后这一页基本就不只是“看过”而是真的读懂了。这一页我建议这样上手文章讲再多都不如自己把页面点一遍。尤其是 自定义标题导航页 这种带明显交互结果的页面只看代码很难建立手感。先进入页面确认首屏是不是把自定义标题导航页的主题交代清楚。盯住核心展示区观察默认状态下最醒目的内容是什么。主动触发一次关键交互比如点击、滑动、跳转、返回、切换或者选择。回头检查状态区、提示区、标题区或者附属信息有没有跟着变化。最后再打开源码对照刚才那次交互把状态变化链路串起来。如果这五步你能边操作边说清楚页面发生了什么后面再换成自己的数据和交互心里会稳很多。从示例到项目中间这几步别省示例页最大的风险就是你觉得“这不难”结果真要迁进项目里发现数据、样式、交互边界全要补。这里提前把这些坑说开。导航类页面迁到业务里时最先要补的是参数类型和返回结果约定而不是视觉样式。如果页面层级开始变多建议尽早把跳转入口、回退逻辑和标题栏动作拆成清晰边界。只要页面里有重复块就别硬撑着手写到底早点抽成小组件后面改样式和改交互都会轻松很多。示例数据最好和布局代码分开放不然后面一接接口页面文件很容易立刻变臃肿。这类实现为什么比文档片段更有用它真正值得保留的地方不只是效果能跑出来而是写法相对克制。你以后回来翻会发现它很适合当中间层模板。页面结构比较稳后续不管是换数据还是换皮肤成本都不会特别高。状态数量总体可控适合拿来练“一个页面里如何分配职责”这件事。组件参数和页面目标之间关系比较直观不太会出现“能跑但看不懂为什么这么配”的情况。完整代码下面保留整理过命名的完整 ArkTS 代码方便你直接对照学习。这里已经去掉原始的 Demo 命名改成了更贴近当前案例语义的名称。/** * 自定义标题导航页 */import{PRESET_COLORS,generateListItems,DEMO_BG_COLOR,DEMO_CARD_COLOR,DEMO_THEME_COLOR,DEMO_SUBTEXT_COLOR}from./typesEntryComponentstruct CustomNavdestinationTitle{StateisShow:booleantrueStateshowDetail:booleanfalsebuild(){Column(){if(this.isShow){Column({space:16}){Text(NavDestination 标题).fontSize(20).fontWeight(FontWeight.Bold).fontColor(DEMO_THEME_COLOR)Text(NavDestination 支持自定义标题和副标题).fontSize(13).fontColor(DEMO_SUBTEXT_COLOR).width(100%)if(!this.showDetail){Column({space:10}){ForEach([用户详情,订单信息,系统设置],(title:string,index:number){Row({space:12}){Text([,,⚙][index]).fontSize(24)Column({space:4}){Text(title).fontSize(15).fontWeight(FontWeight.Medium).fontColor(#333333)Text(点击查看自定义标题效果).fontSize(12).fontColor(DEMO_SUBTEXT_COLOR)}.alignItems(HorizontalAlign.Start).layoutWeight(1)Text().fontSize(14).fontColor(#CCCCCC)}.width(100%).padding(14).backgroundColor(DEMO_CARD_COLOR).borderRadius(10).onClick((){this.showDetailtrue})})}.width(100%)}else{Column({space:14}){// 自定义标题栏样式1Text(标题样式 1居中大标题).fontSize(12).fontColor(DEMO_SUBTEXT_COLOR).width(100%)Column(){Row(){Text(← 返回).fontSize(14).fontColor(DEMO_THEME_COLOR)Blank()Text(···).fontSize(18).fontColor(#666666)}.width(100%)Text(用户详情).fontSize(20).fontWeight(FontWeight.Bold).fontColor(#333333).width(100%)Text(查看和管理个人信息).fontSize(12).fontColor(DEMO_SUBTEXT_COLOR)}.width(100%).padding(12).backgroundColor(DEMO_CARD_COLOR).borderRadius(10)// 自定义标题栏样式2Text(标题样式 2双行标题副标题).fontSize(12).fontColor(DEMO_SUBTEXT_COLOR).width(100%)Column(){Row(){Text(← 返回).fontSize(14).fontColor(PRESET_COLORS[0].value)Blank()Text(编辑).fontSize(14).fontColor(PRESET_COLORS[0].value)}.width(100%)Row(){Column({space:2}){Text(订单信息).fontSize(18).fontWeight(FontWeight.Bold).fontColor(#333333)Text(2024年度订单汇总).fontSize(12).fontColor(DEMO_SUBTEXT_COLOR)}.alignItems(HorizontalAlign.Start)Blank()}.width(100%)}.width(100%).padding(12).backgroundColor(DEMO_CARD_COLOR).borderRadius(10)// 自定义标题栏样式3Text(标题样式 3带徽章标题).fontSize(12).fontColor(DEMO_SUBTEXT_COLOR).width(100%)Column(){Row(){Text(← 返回).fontSize(14).fontColor(PRESET_COLORS[1].value)Blank()Text(完成).fontSize(14).fontColor(PRESET_COLORS[1].value)}.width(100%)Row({space:8}){Text(系统设置).fontSize(18).fontWeight(FontWeight.Bold).fontColor(#333333)Text(Pro).fontSize(10).fontColor(#FFFFFF).backgroundColor(PRESET_COLORS[1].value).padding({left:6,right:6,top:2,bottom:2}).borderRadius(4)}}.width(100%).padding(12).backgroundColor(DEMO_CARD_COLOR).borderRadius(10)Button(返回列表).fontSize(14).height(40).backgroundColor(DEMO_THEME_COLOR).fontColor(#FFFFFF).borderRadius(20).onClick((){this.showDetailfalse})}.width(100%).padding(16).backgroundColor(DEMO_CARD_COLOR).borderRadius(12)}}.alignItems(HorizontalAlign.Start)}Text(自定义标题导航页 - NavDestination 标题).fontSize(12).fontColor(#999999).margin({top:12})}.width(100%).height(100%).backgroundColor(DEMO_BG_COLOR).padding(16)}}收个尾我会把 自定义标题导航页 归到“代码不长但值得留档”的那类示例里。以后遇到同类页面回来翻它比重新猜一遍状态和结构靠谱得多。
