鸿蒙5.0开发进阶:API ArkUI框架-ArkTS组件(形状裁剪)

鸿蒙HarmonyOS NEXT开发:形状裁剪(ArkTS通用属性) 用于对组件进行裁剪、遮罩处理。 阅读详情

往期鸿蒙全套实战文章必看:(文中附带全栈鸿蒙学习资料)


形状裁剪

用于对组件进行裁剪、遮罩处理。

说明

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

clip12+

clip(value: boolean)

是否对当前组件的子组件进行裁剪。

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

卡片能力: 从API version 12开始,该接口支持在ArkTS卡片中使用。

元服务API: 从API version 12开始,该接口支持在元服务中使用。

参数:

参数名类型必填说明
valueboolean是

参数为boolean类型,设置是否按照父容器边缘轮廓进行裁剪。

默认值:false

说明: 设置为true后,子组件超出当前组件范围外的区域将不响应绑定的手势事件。

clip(deprecated)

clip(value: boolean | CircleAttribute | EllipseAttribute | PathAttribute | RectAttribute)

按指定的形状对当前组件进行裁剪。

说明

从API version 7开始支持,从API version 12开始废弃。建议使用clip和clipShape替代。

卡片能力: 从API version 9开始,该接口支持在ArkTS卡片中使用。

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

参数:

参数名类型必填说明
valueboolean | CircleAttribute | EllipseAttribute | PathAttribute | RectAttribute是

参数为相应类型的组件,按指定的形状对当前组件进行裁剪;参数为boolean类型时,设置是否按照父容器边缘轮廓进行裁剪。

默认值:false

说明: 参数为对应类型的组件时,裁剪不会导致被裁剪区域无法响应绑定的手势事件。参数为boolean类型时,裁剪会导致被裁剪区域无法响应绑定的手势事件。

clipShape12+

clipShape(value: CircleShape | EllipseShape | PathShape | RectShape)

按指定的形状对当前组件进行裁剪。

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

卡片能力: 从API version 12开始,该接口支持在ArkTS卡片中使用。

元服务API: 从API version 12开始,该接口支持在元服务中使用。

参数:

参数名类型必填说明
valueCircleShape | EllipseShape | PathShape | RectShape是

参数为相应类型的组件,按指定的形状对当前组件进行裁剪。

说明: 裁剪不会导致被裁剪区域无法响应绑定的手势事件。

mask12+

mask(value: ProgressMask)

为组件上添加可调节进度的遮罩。

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

元服务API: 从API version 12开始,该接口支持在元服务中使用。

参数:

参数名类型必填说明
valueProgressMask是在当前组件上加上可动态设置进度、最大值和颜色的遮罩。

mask(deprecated)

mask(value: CircleAttribute | EllipseAttribute | PathAttribute | RectAttribute | ProgressMask)

为组件上添加指定形状的遮罩。

说明

从API version 7开始支持,从API version 12开始废弃。建议使用mask和maskShape替代。

卡片能力: 从API version 9开始,该接口支持在ArkTS卡片中使用。

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

参数:

参数名类型必填说明
valueCircleAttribute | EllipseAttribute | PathAttribute | RectAttribute | ProgressMask10+是在当前组件上加上指定形状的遮罩。

maskShape12+

maskShape(value: CircleShape | EllipseShape | PathShape | RectShape)

为组件上添加指定形状的遮罩。

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

卡片能力: 从API version 12开始,该接口支持在ArkTS卡片中使用。

元服务API: 从API version 12开始,该接口支持在元服务中使用。

参数:

参数名类型必填说明
valueCircleShape | EllipseShape | PathShape | RectShape是在当前组件上加上指定形状的遮罩。

ProgressMask10+

ProgressMask设置遮罩的进度、最大值和遮罩颜色。

元服务API: 从API version 11开始,该接口支持在元服务中使用。

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

constructor10+

constructor(value: number, total: number, color: ResourceColor)

构造ProgressMask对象。

元服务API: 从API version 11开始,该接口支持在元服务中使用。

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

参数:

参数名参数类型必填参数描述
valuenumber是进度遮罩的当前值。
totalnumber是进度遮罩的最大值。
colorResourceColor是进度遮罩的颜色。

updateProgress10+

updateProgress(value: number): void

更新进度遮罩的进度值。

元服务API: 从API version 11开始,该接口支持在元服务中使用。

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

参数:

参数名参数类型必填参数描述
valuenumber是进度遮罩的当前值。

updateColor10+

updateColor(value: ResourceColor): void

更新进度遮罩的颜色。

元服务API: 从API version 11开始,该接口支持在元服务中使用。

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

参数:

参数名参数类型必填参数描述
valueResourceColor是进度遮罩的颜色。

enableBreathingAnimation12+

enableBreathingAnimation(value: boolean): void

进度满时的呼吸光晕动画开关。默认关闭呼吸光晕动画。

元服务API: 从API version 12开始,该接口支持在元服务中使用。

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

参数:

参数名参数类型必填参数描述
valueboolean是设置为true则开启呼吸光晕动画。默认值:false

示例

示例1(使用不同裁剪属性)

// xxx.ets
@Entry
@Component
struct ClipAndMaskExample {
  build() {
    Column({ space: 15 }) {
      Text('clip').fontSize(12).width('75%').fontColor('#DCDCDC')
      Row() {
        Image($r('app.media.testImg')).width('500px').height('280px')
      }
      .clip(true) // 如这里不设置clip为true,则Row组件的圆角不会限制其中的Image组件,Image组件的四个角会超出Row
      .borderRadius(20)
      // 用一个280px直径的圆对图片进行裁剪
      Image($r('app.media.testImg'))
        .clipShape(new Circle({ width: '280px', height: '280px' }))
        .width('500px').height('280px')

      Text('mask').fontSize(12).width('75%').fontColor('#DCDCDC')
      // 给图片添加了一个500px*280px的方形遮罩
      Image($r('app.media.testImg'))
        .maskShape(new Rect({ width: '500px', height: '280px' }).fill(Color.Gray))
        .width('500px').height('280px')

      // 给图片添加了一个280px*280px的圆形遮罩
      Image($r('app.media.testImg'))
        .maskShape(new Circle({ width: '280px', height: '280px' }).fill(Color.Gray))
        .width('500px').height('280px')
    }
    .width('100%')
    .margin({ top: 15 })
  }
}

示例2(裁剪属性动画)

@Entry
@Component
struct ProgressMaskExample {
  @State progressflag1: boolean = true;
  @State color: Color = 0x01006CDE;
  @State value: number = 10.0;
  @State enableBreathingAnimation: boolean = false;
  @State progress: ProgressMask = new ProgressMask(10.0, 100.0, Color.Gray);
  build() {
    Column({ space: 15 }) {
      Text('progress mask').fontSize(12).width('75%').fontColor('#DCDCDC')
      // 给图片添加了一个280px*280px的进度遮罩
      Image($r('app.media.testImg'))
        .width('500px').height('280px')
        .mask(this.progress)
        .animation({
          duration: 2000, // 动画时长
          curve: Curve.Linear, // 动画曲线
          delay: 0, // 动画延迟
          iterations: 1, // 播放次数
          playMode: PlayMode.Normal // 动画模式
        }) // 对Button组件的宽高属性进行动画配置

      // 更新进度遮罩的进度值
      Button('updateProgress')
        .onClick((event?: ClickEvent) => {
          this.value += 10;
          this.progress.updateProgress(this.value);
        }).width(200).height(50).margin(20)

      // 更新进度遮罩的颜色
      Button('updateColor')
        .onClick((event?: ClickEvent) => {
          if (this.progressflag1) {
            this.progress.updateColor(0x9fff0000);
          } else {
            this.progress.updateColor(0x9f0000ff);
          }
          this.progressflag1 = !this.progressflag1
        }).width(200).height(50).margin(20)
      
      // 开关呼吸光晕动画
      Button('enableBreathingAnimation:' + this.enableBreathingAnimation)
        .onClick((event?: ClickEvent) => {
          this.enableBreathingAnimation = !this.enableBreathingAnimation
          this.progress.enableBreathingAnimation(this.enableBreathingAnimation);
        }).width(200).height(50).margin(20)

      // 恢复进度遮罩
      Button('click reset!')
        .onClick((event?: ClickEvent) => {
          this.value = 0;
          this.progress.updateProgress(this.value);
        }).width(200).height(50).margin(20)
    }
    .width('100%')
    .margin({ top: 15 })
  }
}

鸿蒙Harmony应用开发—ArkTS声明式开发(通用属性:形状裁剪) ArkTS声明式开发(通用属性:形状裁剪) 阅读详情

相关推荐

使用HarmonyOS实现图片编辑,裁剪、旋转、亮度、透明度

本篇Codelab是基于ArkTS的声明式开发范式的样例,主要介绍了图片编辑实现过程。样例主要包含以下功能:

2401_82546228的博客 3931

HarmonyOS 鸿蒙Next实现图片编辑裁剪

最近开发一款鸿蒙应用,需要用到图片裁剪,系统的图片编辑功能目前没有对外开发API调用,所以需要自己整一套裁剪的功能。由于刚接触这个ArkTS语言,探索的过程还是挺费劲。这一效果大致可以满足我的需求,但我在测试的时候发现裁剪框滑动的时候有问题,裁剪框和图片位置没做处理,有大神可以处理的可以使用这个去修改。这种方式功能比较简单,裁剪是手动点击的,大小是固定的,并不能满足我的需求。但项目部分使用的TS语言,NEXT版需要改造才能用。以我的性格就是继续探索新的方案。支持自由裁剪和固定比例裁剪。

doubletan1990的博客 4249

鸿蒙5.0版开发:ArkTS组件通用属性-形状裁剪

用于对组件进行裁剪、遮罩处理。

m0_69424697的博客 1348

鸿蒙NEXT开发:ArkTS组件-通用属性(形状裁剪)

用于对组件进行裁剪、遮罩处理。

ZPYQAQ的博客 1382

MIKE11实战:平原河网水动力建模从入门到精通(附GIS数据处理技巧)

本文系统介绍了MIKE11软件在平原河网水动力建模中的完整实战流程。从GIS数据预处理、河网构建、参数率定到结果分析,详细阐述了构建可靠数字孪生模型的关键步骤与技巧,旨在帮助水利工程师高效解决平原地区复杂水流模拟的挑战,为防洪决策提供科学依据。

weixin_28419039的博客 690

各种逻辑漏洞

注册:短信轰炸验证码安全问题密码爆破邮箱轰炸用户任意注册、批量注册用户名枚举XSS(有框的地方就可以尝试插XSS)登录:短信轰炸、验证码安全问题、密码爆破、邮箱轰炸SQL注入撞库抓包把password字段修改为空值发送认证凭证替换、比如返回的数据包中包含账号,修改账号就能登录到其他账号Cookie仿冒修改返回包的相关数据,可能会登陆到其他的用户找回密码:短信邮箱轰炸、短信邮箱劫持重置任意用户账户密码、验证码手机用户未统一验证直接跳过验证步骤。

shirlly_的博客 2095

【鸿蒙next开发】ArkUI框架:ArkTS组件-形状裁剪

本文详细讲解了clip、clipShape、mask和maskShape等接口的使用方法及其参数说明,并提供了从API版本7到12的更新和废弃信息。

m0_73088370的博客 1166

CentOS7全隔离环境部署Nvidia Tesla A100 40G驱动与CUDA工具包实战

本文详细介绍了在CentOS7全隔离环境下部署Nvidia Tesla A100 40G显卡驱动与CUDA工具包的实战经验。通过构建本地YUM仓库、解决驱动依赖问题以及三重验证法,确保Tesla A100与CUDA 11.7的完美兼容。同时分享了Anaconda3离线部署技巧,帮助用户在隔离环境中高效搭建Python GPU开发环境。

weixin_27215337的博客 404

【鸿蒙next开发】ArkUI框架:ArkTS组件-Shape

本文介绍了鸿蒙HarmonyOS 5.0中Shape组件的使用方法和属性设置。

m0_73088370的博客 729

基于单片机直流电机调速控制系统设计

*单片机设计介绍,基于单片机直流电机调速控制系统设计。

2201_75940997的博客 2783

sid图像数据_遥感影像数据

影像数据基本概念影像数据是由卫星或飞机上的成像系统获得的影像,多为遥感影像数据。影像数据的每个像元都有一个值,表示传感器探测到像素对应地面面积上目标物的电磁辐射强度,也叫亮度值、灰度值。SuperMap支持的影像数据格式有:*.img、*.tif、*.tiff、*.bmp、*.jpg、*.png、*.gif、*.raw、*.sid等。计算机以二进制记录数据,所以其量化的等级以二进制来划分,即2n。...

weixin_39534395的博客 1628

【鸿蒙next开发】ArkUI框架:ArkTS组件-Path2D

本文介绍了鸿蒙HarmonyOS中Path2D路径对象的使用方法。

m0_73088370的博客 1055

Python爬虫实战:使用最新技术爬取GitHub Trending项目

本文将详细介绍如何使用Python最新技术栈构建一个高效的GitHub Trending爬虫。我们将使用异步请求库httpx、HTML解析库parsel、数据存储方案以及反反爬技术,完整实现一个能够稳定获取GitHub Trending数据的爬虫系统。文章包含5000余字详细教程,从环境搭建到代码实现,再到数据处理和存储,最后部署运行,提供全方位指导。GitHub Trending页面展示了GitHub上当前最受欢迎的项目,对于开发者了解技术趋势、发现优秀项目非常有价值。

2201_76125261的博客 739

HarmonyOS NEXT 了解 ArkUI:鸿蒙应用开发的得力框架

作为一名鸿蒙开发者,在日常开发过程中,ArkUI 无疑是我们构建精美、高效应用界面的得力助手。

weixin_45109483的博客 885

使用podspec创建iOS插件

概述 在WWDC 2014全球开发者大会上,苹果开放了动态库、App Extension等全新的功能,这为iOS插件化开发带来了可能。在iOS开发中,动态库是iOS提供的一种资源打包方式,可以将代码文件、头文件、资源文件和说明文档等集中在一起,并且可以在运行时进行动态加载。 目前,很多应用越做越复杂,应用程序也显得越来越臃肿。试想一下,如果将一些不常用的功能做成一个插件,然后根据用户的需求从网络中...

xiangzhihong8的专栏 993

如何在非序列模式下使用类似图像模功能

如何在非序列模式下使用类似图像模功能

weixin_72050316的博客 553

# HarmonyOS NEXT 原生 ArkTS 布局实战:Clip + RoundRect 圆角裁剪深度解析

本文深入解析了HarmonyOS NEXT中ArkTS布局的圆角裁剪技术,重点介绍了三种实现方案:borderRadius+clip(true)、clipShape+Rect和Path自定义路径。通过底层渲染原理分析和技术对比,文章指出borderRadius+clip(true)是最灵活推荐的方案,支持四角独立半径和子元素溢出裁剪。实战部分包含完整项目架构、路由配置和核心代码解析,并提供了入口页面的实现示例,帮助开发者掌握鸿蒙原生UI的圆角裁剪技术要点。

woshi_xiaoa的博客 481

STM32F407中文手册

STM32f407中文手册 本参考手册面向应用开发人员,提供有关使用 STM32F405xx/07xx、STM32F415xx/17xx、 STM32F42xxx 和 STM32F43xxx 微控制器存储器与外设的完整信息。STM32F405xx/07xx、STM32F415xx/17xx、STM32F42xxx 和 STM32F43xxx 构成一个微 控制器系列,各产品具有不同的存储器大小、封装和外设。有关订购信息以及器件的机械与电气特性,请参见数据手册。有关 ARM Cortex™-M4F 内核的信息,请参见《Cortex™-M4F 技术参考手册》。

HarmonyOS应用开发实战:小事记 - 形状裁剪与遮罩:clip/globalCompositeOperation 的图形混合模式

Canvas高级绘图技术解析:裁剪与混合模式应用 本文深入探讨HarmonyOS中Canvas绘图的两大核心技术:形状裁剪(clip)和图形混合(globalCompositeOperation)。以头像裁剪/特效场景为例,详细介绍了圆形裁剪实现方法、混合模式的多种类型及效果对比,并提供了完整的代码实现方案。文章还包含常见问题解答、最佳实践建议和性能优化策略,特别强调了使用save/restore管理裁剪状态的重要性。通过封装Canvas绘图工具类,展示了如何将复杂图形操作转化为可复用组件,为开发者提供了一

2501_94022858的博客 646

pscad IEEE标准系统搭建说明

pscad IEEE标准系统搭建说明,包含典型的IEEE 9节点、14节点、30节点、39节点和118节点系统。内含标准测试系统的原始数据和潮流结果。

迈瑞BS系列全自动生化分析仪LIS协议接口手册(内含HL7和ASTM)

迈瑞BS系列全自动生化分析仪LIS协议接口手册,内含HL7和ASTM)

初识ArkUI

组件内容和组件内容区不一定匹配,比如设置了固定的width和height,此时组件内容的大小就是设置的width和height减去padding和border值,但文本内容则是通过文本布局引擎测算后得到的大小,可能出现文本真实大小小于设置的组件内容区大小。组件 组件是UI的必要元素,形成了在界面中的样子,由框架直接提供的称为系统组件,由开发者定义的称为自定义组件。ArkUI框架提供了多种布局方式,除了基础的线性布局、层叠布局、弹性布局、相对布局、栅格布局外,也提供了相对复杂的列表、宫格、轮播。

2301_80839686的博客 844

霍尼韦尔SoftMaster使用说明

霍尼韦尔SoftMaster使用说明

一文彻底搞清楚Harmony NEXT的ArkUI

在移动开发领域,长期以来存在着两大阵营:iOS和Android。为了满足不同平台的需求,开发者往往需要分别编写两套代码,这无疑增加了开发成本和维护难度。在这种背景下,跨平台UI框架应运而生,旨在实现“一套代码,多平台运行”。目前主流的跨端开发框架:React Native由Facebook开发Flutter是由Google公司开发的uni-app 是国内的DCloud开发的ArkUI 是华为推出一款跨平台Weex是由阿里巴巴开发的跨平台。

程序员Feri 1197

旅行行程规划应用HarmonyOS ArkTS API 24自定义组件使用@Component进行装饰,框架会为被装饰的 struct 生成组件注册表项,使其能够在声明式 UI 的嵌套体系中被实例化

在移动互联网与智能穿戴设备高度普及的今天,"习惯养成"已经从一个模糊的自我管理理念,演变为一个可量化、可追踪、可视化的数字化产品赛道。越来越多的人希望借助手中的智能终端,把"早起、冥想、阅读、运动"这些抽象的自律行为,转化为一条条清晰的数据曲线和一张张可触摸的打卡卡片。而鸿蒙生态(HarmonyOS)凭借其跨设备协同、分布式软总线以及声明式 UI 开发框架 ArkUI,为这类注重"轻量化交互 + 即时反馈"的生活方式类应用提供了极为理想的生长土壤。本应用正是一款面向"晨间场景"深度打磨的习惯追踪工具。它聚焦

2301_79516720的博客 164

HarmonyOS ArkTS API 24任务看板应用使用了 Array<StatusColumnConfig> 而非普通对象,看板列的展示顺序必须与数组下标一致

在 HarmonyOS NEXT 正式商用的背景下,ArkTS 作为鸿蒙生态的官方应用开发语言,正在从传统的命令式 UI 开发范式向声明式 UI 范式全面迁移。ArkUI 框架以组件化、声明式、状态驱动为核心特征,要求开发者以"描述 UI 应该是什么样"而非"一步步操作 UI 怎么变"的思维方式构建界面。本文以一个名为"智能账单"的三标签页记账应用为切入点,逐层拆解其数据模型设计、@Builder 组件复用策略、@State 状态管理机制、条件渲染导航模式,以及静态写死渲染与动态循环渲染之间的性能权衡,为

2401_86031952的博客 74

鸿蒙原生ArkTS-鸿蒙6.0新特性-粒子特效壁纸动态桌面

鸿蒙原生ArkTS-鸿蒙6.0新特性-粒子特效壁纸动态桌面 本文详细介绍了基于鸿蒙6.0 ArkUI框架构建的粒子特效壁纸动态桌面应用。项目利用 Canvas 2D 渲染引擎实现了包含 120颗闪烁星星、30只飘浮萤火虫、3层梦幻星云和动态流星 的完整粒子系统,所有粒子均拥有独立的运动规律和渲染策略,共同营造出沉浸式的动态桌面背景。

s1316339343的博客 628

《宝宝成长记录时间轴》四、ArkTS开发避坑与修复指南

ArkTS严格模式虽然增加了开发约束,但也帮助我们在编译阶段发现潜在问题。类型显式化:对象字面量、枚举值、变量类型都要显式声明API先查后用:不要凭直觉假设组件属性,先查官方文档数据简单化:跨页面传递数据优先使用基本类型状态规范化:正确使用装饰器,筛选逻辑放在数据层而非UI层掌握这些原则,你的HarmonyOS开发效率将大幅提升!关键词。

army16的专栏 310

HarmonyOS NEXT Developer Beta3版本发布啦

C API通用属性支持设置、重置和获取Refresh/Swiper/List相关接口,包括List分割线样式(NODE_LIST_DIVIDER)、Swiper组件前边距(NODE_SWIPER_PREV_MARGIN)/后边距(NODE_SWIPER_NEXT_MARGIN)、Refresh组件下拉偏移量等(NODE_REFRESH_OFFSET)。这次更新增加了许多新能力。支持通过PdfView组件实现:打开PDF文档、PDF文档与图片格式互转、添加页眉页脚、添加水印、添加背景、添加批注、添加书签。

坚果的博客 771

专注计时与时间记录应用HarmonyOS ArkTS API 24引入了 AppStorage 作为全局状态容器,将时间记录列表、项目列表等跨页面共享的数据统一托管

在 HarmonyOS NEXT 正式商用的背景下,ArkTS 作为鸿蒙生态的官方应用开发语言,正在从传统的命令式 UI 开发范式向声明式 UI 范式全面迁移。ArkUI 框架以组件化、声明式、状态驱动为核心特征,要求开发者以"描述 UI 应该是什么样"而非"一步步操作 UI 怎么变"的思维方式构建界面。本文以一个名为"智能账单"的三标签页记账应用为切入点,逐层拆解其数据模型设计、@Builder 组件复用策略、@State 状态管理机制、条件渲染导航模式,以及静态写死渲染与动态循环渲染之间的性能权衡,为

2401_86031952的博客 254
上一篇: 鸿蒙5.0开发进阶:API ArkUI框架-ArkTS组件(图像效果)
下一篇: 鸿蒙5.0开发进阶:API ArkUI框架-ArkTS组件(栅格设置)
懂你的大海
博客等级 码龄6年 9049粉丝 1381原创
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付:10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值