HarmonyOS 6 SubHeader 自定义标题内容使用文档

文章目录依赖导入核心属性与规则1. 关键属性2. 优先级规则示例代码代码解析运行效果总结依赖导入import { Prompt, OperationType, SubHeader, Color, FontWeight } from kit.ArkUI;核心属性与规则1. 关键属性属性说明titleBuilderBuilderParam 类型自定义标题插槽用于绑定外部自定义 BuilderprimaryTitle原生一级标题存在 titleBuilder 时不生效secondaryTitle原生二级标题存在 titleBuilder 时不生效icon左侧原生图标存在 titleBuilder 时不生效operationType右侧操作区类型TEXT_ARROW表示文字右箭头样式operationItem右侧操作项配置展示文本与点击回调2. 优先级规则titleBuilder自定义标题 原生icon/primaryTitle/secondaryTitle启用自定义标题后左侧原生图标、双行标题全部被覆盖仅渲染 Builder 内内容。示例代码import { Prompt, OperationType, SubHeader, Color, FontWeight } from kit.ArkUI; Entry Component struct SubHeaderExample { // 自定义标题 Builder 函数 Builder TitleBuilder(): void { Text(自定义标题) .fontSize(24) .fontColor(Color.Blue) .fontWeight(FontWeight.Bold) } build() { Column() { SubHeader({ // 绑定自定义标题 titleBuilder: () { this.TitleBuilder(); }, // 原生标题、图标被自定义标题覆盖不会展示 primaryTitle: 一级标题, secondaryTitle: 二级标题, icon: $r(sys.symbol.ohos_star), // 右侧文字 右箭头按钮 operationType: OperationType.TEXT_ARROW, operationItem: [{ value: 更多信息, action: () { Prompt.showToast({ message: demo }); } }] }) } } }运行效果如图代码解析定义自定义 Builder使用Builder声明TitleBuilder内部通过Text组件自定义文字大小、颜色、字重实现个性化标题样式。绑定自定义插槽通过titleBuilder将自定义 Builder 传入SubHeader接管左侧标题区域渲染。原生配置失效代码中声明的primaryTitle、secondaryTitle、icon因优先级低于自定义标题页面上不会显示。右侧操作区域operationType设置为TEXT_ARROW展示「更多信息 右箭头」组合按钮点击后弹出 Toast原有交互逻辑不受自定义标题影响。运行效果左侧展示蓝色、加粗、大号字体的自定义标题原生一级标题、二级标题、星星图标均隐藏右侧显示「更多信息」文字与向右箭头点击右侧按钮正常弹出提示交互功能完好。总结titleBuilder优先级最高启用后左侧原生图标、标题全部失效Builder 内部支持任意 ArkUI 基础组件Text、Image、Row、Column 等可实现复杂布局仅 Stage 模型可用FA 模型、穿戴设备不支持SubHeader右侧操作区所有配置不受自定义标题影响可正常搭配各类operationTypeBuilder 函数可抽离复用实现多处标题样式统一。如果这篇文章对你有帮助欢迎点赞、收藏、关注你的支持是持续创作的动力