文章目录概述源码隐藏后缀图标核心实现原理1. 核心控制字段2. 双重隐藏条件3. 冗余回调说明组件配置解析总结概述Chip组件后缀图标包含两类系统默认关闭图标、自定义suffixIcon后缀图标。通过组件配置项可统一关闭后缀图标展示实现仅前缀图标文字的极简布局样式适用于纯展示类标签、状态提示标签、静态操作文字块等无需删除、无需右侧功能图标的业务场景。源码import { Chip, ChipSize, LengthMetrics } from kit.ArkUI; Entry Component struct Index { build() { Column({ space: 10 }) { Chip({ // 设置前缀图标属性。 prefixIcon: { // app.media.chips仅作示例请替换为实际使用图片。 src: $r(app.media.startIcon), size: { width: 16, height: 16 }, fillColor: Color.Blue }, // 设置文本属性。 label: { text: 操作块, fontSize: 12, fontColor: Color.Blue, fontFamily: HarmonyOS Sans, labelMargin: { left: 20, right: 30 } }, size: ChipSize.SMALL, allowClose: false, enabled: true, backgroundColor: $r(sys.color.ohos_id_color_button_normal), borderRadius: $r(sys.float.ohos_id_corner_radius_button), onClose: () { console.info(chip on close); }, }) } } }运行效果如图隐藏后缀图标核心实现原理1. 核心控制字段allowClose: false该配置为隐藏系统默认关闭后缀图标的核心开关设置为false后Chip自带的关闭按钮后缀图标直接隐藏。2. 双重隐藏条件代码中未声明suffixIcon自定义后缀图标无自定义右侧图标渲染allowClose设置为false关闭系统默认关闭后缀图标两者同时满足即可实现完全不显示任何后缀图标3. 冗余回调说明代码中保留了onClose关闭点击回调函数因allowClose:false后缀关闭图标已隐藏该回调函数永远不会触发执行仅作代码预留兼容不影响布局与展示效果。组件配置解析前缀图标正常配置生效左侧展示自定义蓝色16*16尺寸图标不受后缀图标隐藏影响文字标签自定义文字大小、颜色、字体、左右边距布局样式正常生效组件尺寸ChipSize.SMALL设置为小型Chip标签整体尺寸更紧凑启用状态enabled:true组件可正常点击交互仅隐藏右侧图标系统样式沿用系统默认按钮背景色、圆角风格统一原生UI视觉关闭回调预留关闭事件无图标触发仅做业务预留总结隐藏后缀图标优先级关闭默认关闭图标 移除自定义suffixIcon图标仅隐藏后缀图标不会影响前缀图标、文字内容的正常展示与样式设置当allowClose为false时无论是否编写onClose回调都无法触发关闭事件小型尺寸ChipSize.SMALL搭配无后缀图标布局视觉更加简洁紧凑隐藏后缀图标后文字区域右侧无图标占位布局空间利用率更高如果这篇文章对你有帮助欢迎点赞、收藏、关注你的支持是持续创作的动力
HarmonyOS 6 Chip 组件:不显示后缀图标使用文档
发布时间:2026/5/22 9:43:13
文章目录概述源码隐藏后缀图标核心实现原理1. 核心控制字段2. 双重隐藏条件3. 冗余回调说明组件配置解析总结概述Chip组件后缀图标包含两类系统默认关闭图标、自定义suffixIcon后缀图标。通过组件配置项可统一关闭后缀图标展示实现仅前缀图标文字的极简布局样式适用于纯展示类标签、状态提示标签、静态操作文字块等无需删除、无需右侧功能图标的业务场景。源码import { Chip, ChipSize, LengthMetrics } from kit.ArkUI; Entry Component struct Index { build() { Column({ space: 10 }) { Chip({ // 设置前缀图标属性。 prefixIcon: { // app.media.chips仅作示例请替换为实际使用图片。 src: $r(app.media.startIcon), size: { width: 16, height: 16 }, fillColor: Color.Blue }, // 设置文本属性。 label: { text: 操作块, fontSize: 12, fontColor: Color.Blue, fontFamily: HarmonyOS Sans, labelMargin: { left: 20, right: 30 } }, size: ChipSize.SMALL, allowClose: false, enabled: true, backgroundColor: $r(sys.color.ohos_id_color_button_normal), borderRadius: $r(sys.float.ohos_id_corner_radius_button), onClose: () { console.info(chip on close); }, }) } } }运行效果如图隐藏后缀图标核心实现原理1. 核心控制字段allowClose: false该配置为隐藏系统默认关闭后缀图标的核心开关设置为false后Chip自带的关闭按钮后缀图标直接隐藏。2. 双重隐藏条件代码中未声明suffixIcon自定义后缀图标无自定义右侧图标渲染allowClose设置为false关闭系统默认关闭后缀图标两者同时满足即可实现完全不显示任何后缀图标3. 冗余回调说明代码中保留了onClose关闭点击回调函数因allowClose:false后缀关闭图标已隐藏该回调函数永远不会触发执行仅作代码预留兼容不影响布局与展示效果。组件配置解析前缀图标正常配置生效左侧展示自定义蓝色16*16尺寸图标不受后缀图标隐藏影响文字标签自定义文字大小、颜色、字体、左右边距布局样式正常生效组件尺寸ChipSize.SMALL设置为小型Chip标签整体尺寸更紧凑启用状态enabled:true组件可正常点击交互仅隐藏右侧图标系统样式沿用系统默认按钮背景色、圆角风格统一原生UI视觉关闭回调预留关闭事件无图标触发仅做业务预留总结隐藏后缀图标优先级关闭默认关闭图标 移除自定义suffixIcon图标仅隐藏后缀图标不会影响前缀图标、文字内容的正常展示与样式设置当allowClose为false时无论是否编写onClose回调都无法触发关闭事件小型尺寸ChipSize.SMALL搭配无后缀图标布局视觉更加简洁紧凑隐藏后缀图标后文字区域右侧无图标占位布局空间利用率更高如果这篇文章对你有帮助欢迎点赞、收藏、关注你的支持是持续创作的动力