news 2026/5/26 19:10:44

HarmonyOS 6 Chip 组件:设置默认后缀图标使用文档

作者头像

张小明

前端开发工程师

1.2k 24
文章封面图
HarmonyOS 6 Chip 组件:设置默认后缀图标使用文档

文章目录

    • 代码
    • 默认后缀图标核心配置
      • 1. 启用默认关闭图标
      • 2. 显示优先级规则
      • 3. 关联配置项
    • 代码解析
      • 1. 启用默认后缀图标
      • 2. 不冲突条件
      • 3. 整体结构
    • 总结

默认后缀图标即Chip 内置关闭图标,由系统提供样式、尺寸、交互逻辑,无需配置图片资源,只需开启allowClose: true即可显示。

代码

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.NORMAL, allowClose: true, enabled: true, backgroundColor: $r('sys.color.ohos_id_color_button_normal'), borderRadius: $r('sys.float.ohos_id_corner_radius_button'), }) } } }

运行效果如图:


默认后缀图标核心配置

1. 启用默认关闭图标

allowClose: true
  • 作用:显示系统默认关闭图标
  • 默认值:true
  • allowClose: false时,默认图标隐藏

2. 显示优先级规则

  • 未设置suffixIcon、未设置suffixSymbol→ 由allowClose控制是否显示默认关闭图标
  • 设置了suffixIconsuffixSymbol优先显示自定义图标,默认图标不显示

3. 关联配置项

  • onClose:默认图标点击回调(删除逻辑)
  • closeOptions:设置默认图标字体大小、无障碍属性

代码解析

1. 启用默认后缀图标

allowClose: true

这是显示默认关闭图标唯一必要开关

2. 不冲突条件

代码中未配置 suffixIcon / suffixSymbol,因此默认图标可以正常展示。

3. 整体结构

  • 左侧:自定义前缀图标 startIcon
  • 中间:文本“操作块”
  • 右侧:系统默认关闭图标
  • 形成“前缀图标 + 文本 + 默认删除按钮”的标准操作块布局

总结

  1. 默认图标仅在无自定义后缀图标时显示
    只要配置了suffixIconsuffixSymbol,默认图标自动隐藏。

  2. enabled 必须为 true
    enabled: false,Chip 不可点击,默认图标也不会显示。

  3. size 影响默认图标大小

  • ChipSize.NORMAL:默认图标尺寸更大
  • ChipSize.SMALL:默认图标尺寸更小
  1. 样式跟随系统
    背景、圆角、图标颜色全部取自系统资源:
  • 背景:ohos_id_color_button_normal
  • 圆角:ohos_id_corner_radius_button

如果这篇文章对你有帮助,欢迎点赞、收藏、关注,你的支持是持续创作的动力

版权声明: 本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若内容造成侵权/违法违规/事实不符,请联系邮箱:809451989@qq.com进行投诉反馈,一经查实,立即删除!
网站建设 2026/5/22 9:39:20

高效游戏模组开发实战指南:从零构建《鸣潮》增强模组

高效游戏模组开发实战指南:从零构建《鸣潮》增强模组 【免费下载链接】wuwa-mod Wuthering Waves pak mods 项目地址: https://gitcode.com/GitHub_Trending/wu/wuwa-mod 在游戏模组开发领域,WuWa-Mod项目为《鸣潮》玩家提供了15项强大的游戏增强…

作者头像 李华
网站建设 2026/5/22 9:37:38

智能编排:重新定义碧蓝航线自动化管理的开源方案

智能编排:重新定义碧蓝航线自动化管理的开源方案 【免费下载链接】AzurLaneAutoScript Azur Lane bot (CN/EN/JP/TW) 碧蓝航线脚本 | 无缝委托科研,全自动大世界 项目地址: https://gitcode.com/gh_mirrors/az/AzurLaneAutoScript 深夜三点&#…

作者头像 李华