鸿蒙Harmony应用开发—ArkTS-高级组件：@ohos.arkui.advanced.Chip（操作块组件）

news2024/9/17 21:05:43

操作块，用于搜索框历史记录或者邮件发送列表等场景。

说明：

该组件从API Version 11开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。

子组件

无

Chip

Chip({options:ChipOptions})

装饰器类型：@Builder

系统能力： SystemCapability.ArkUI.ArkUI.Full

参数：

名称	类型	必填	装饰器类型	说明
options	ChipOptions	是	@Builder	定义chip组件的参数。

ChipOptions

ChipOptions定义chip的样式及具体式样参数。

系统能力： SystemCapability.ArkUI.ArkUI.Full

名称	类型	必填	说明
size	ChipSize \| SizeOptions	否	操作块尺寸。默认值：ChipSize：ChipSize.NORMAL， SizeOptions类型参数不支持百分比设置。
enabled	boolean	否	操作块是否可选中。默认值：true。
prefixIcon	PrefixIconOptions	否	前缀图标属性。
label	LabelOptions	是	文本属性。
suffixIcon	SuffixIconOptions	否	后缀图标属性。
backgroundColor	ResourceColor	否	操作块背景颜色。默认值：$r('sys.float.ohos_id_color_button_normal')。
borderRadius	Dimension	否	操作块背景圆角半径大小，不支持百分比。默认值：$r('sys.float.ohos_id_corner_radius_button')。
allowClose	boolean	否	删除图标是否显示。默认值：true。
onClose	()=>void	否	默认删除图标点击事件。

说明：

1.操作块有最小宽度限制，当用户设置宽度小于最小宽度时，按最小宽度显示。

2.suffixIcon有传入参数时，allowClose不生效，suffixIcon没有传入参数时，allowClose决定是否显示删除图标。

3.backgroundColor赋值undefined时，显示默认背景颜色，赋值非法值时，背景色透明。

4.prefixIcon的fillColor默认值：$r('sys.color.ohos_id_color_secondary')，suffixIcon的fillColor默认值：$r('sys.color.ohos_id_color_primary')。fillColor对颜色的解析与Image组件保持一致。

ChipSize

ChipSize是chip可指定的尺寸类型，如普通型Chip。

名称	值	描述
NORMAL	"NORMAL"	normal尺寸操作块。
SMALL	"SMALL"	small尺寸操作块。

IconCommonOptions

IconCommonOptions定义图标的共通属性。

名称	类型	必填	说明
src	ResourceStr	是	图标图片或图片地址引用。
size	SizeOptions	否	图标大小，不支持百分比。默认值：{width: 16,height: 16}。
fillColor	ResourceColor	否	图标填充颜色。

说明：

仅在图片格式为svg时，fillColor生效。

PrefixIconOptions

PrefixIconOptions定义前缀图标的属性。

继承于IconCommonOptions

SuffixIconOptions

SuffixIconOptions定义后缀图标的属性。

继承于IconCommonOptions

名称	类型	必填	说明
action	() => void	否	后缀图标设定事件。

LabelOptions

LabelOptions定义文本的属性。

名称	类型	必填	说明
text	string	是	文本文字内容。
fontSize	Dimension	否	文字字号，不支持百分比。默认值：$r('sys.float.ohos_id_text_size_button3')。
fontColor	ResourceColor	否	文字颜色。默认值：$r('sys.color.ohos_id_color_text_primary')。
fontFamily	string	否	文字字体。默认值："HarmonyOS Sans"。
labelMargin	LabelMarginOptions	否	文本与左右侧图标之间间距。

LabelMarginOptions

LabelMarginOptions定义文本与左右侧图标之间间距。

名称	类型	必填	说明
left	Dimension	否	文本与左侧图标之间间距，不支持百分比。默认值：6vp。
right	Dimension	否	文本与右侧图标之间间距，不支持百分比。默认值：6vp。

示例

示例1

import { Chip, ChipSize } from '@ohos.arkui.advanced.Chip';

@Entry
@Component
struct Index {
  build() {
    Column({ space: 10 }) {
      Chip({
        prefixIcon: {
          src: $r('app.media.chips'),
          size: { width: 16, height: 16 },
          fillColor: Color.Red,
        },
        label: {
          text: "操作块",
          fontSize: 12,
          fontColor: Color.Blue,
          fontFamily: "HarmonyOS Sans",
          labelMargin: { left: 20, right: 30 },
        },
        suffixIcon: {
          src: $r('app.media.close'),
          size: { width: 16, height: 16 },
          fillColor: Color.Red,
        },
        size: ChipSize.NORMAL,
        allowClose: false,
        enabled: true,
        backgroundColor: $r('sys.color.ohos_id_color_button_normal'),
        borderRadius: $r('sys.float.ohos_id_corner_radius_button')
      })
    }
  }
}

示例2

import { Chip, ChipSize } from '@ohos.arkui.advanced.Chip';

@Entry
@Component
struct Index {
  build() {
    Column({ space: 10 }) {
      Chip({
        prefixIcon: {
          src: $r('app.media.chips'),
          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')
      })
    }
  }
}

示例3

import { Chip, ChipSize } from '@ohos.arkui.advanced.Chip';

@Entry
@Component
struct Index {
  build() {
    Column({ space: 10 }) {
      Chip({
        prefixIcon: {
          src: $r('app.media.chips'),
          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.log("chip on close")
      }
      })
    }
  }
}

最后

有很多小伙伴不知道学习哪些鸿蒙开发技术？不知道需要重点掌握哪些鸿蒙应用开发知识点？而且学习时频繁踩坑，最终浪费大量时间。所以有一份实用的鸿蒙（HarmonyOS NEXT）资料用来跟着学习是非常有必要的。

这份鸿蒙（HarmonyOS NEXT）资料包含了鸿蒙开发必掌握的核心知识要点，内容包含了（ArkTS、ArkUI开发组件、Stage模型、多端部署、分布式应用开发、音频、视频、WebGL、OpenHarmony多媒体技术、Napi组件、OpenHarmony内核、Harmony南向开发、鸿蒙项目实战等等）鸿蒙（HarmonyOS NEXT）技术知识点。

希望这一份鸿蒙学习资料能够给大家带来帮助，有需要的小伙伴自行领取，限时开源，先到先得~无套路领取！！

获取这份完整版高清学习路线，请点击→纯血版全套鸿蒙HarmonyOS学习资料

鸿蒙（HarmonyOS NEXT）最新学习路线

HarmonOS基础技能

HarmonOS就业必备技能
HarmonOS多媒体技术

鸿蒙NaPi组件进阶

HarmonOS高级技能

初识HarmonOS内核
实战就业级设备开发

有了路线图，怎么能没有学习资料呢，小编也准备了一份联合鸿蒙官方发布笔记整理收纳的一套系统性的鸿蒙（OpenHarmony ）学习手册（共计1236页）与鸿蒙（OpenHarmony ）开发入门教学视频，内容包含：ArkTS、ArkUI、Web开发、应用模型、资源分类…等知识点。

获取以上完整版高清学习路线，请点击→纯血版全套鸿蒙HarmonyOS学习资料