鸿蒙5.0开发进阶:ArkTS组件-安全控件通用属性

鸿蒙OpenHarmony【安全控件通用属性】安全 安全控件的基础属性,用于设置安全控件通用的属性。 阅读详情

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


安全控件通用属性

安全控件的基础属性,用于设置安全控件通用的属性。

说明

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

iconSize

iconSize(value: Dimension): T

设置安全控件上图标的尺寸。

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

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

参数:

参数名类型必填说明
valueDimension是

安全控件上图标的尺寸。

默认值:16vp

返回值:

类型说明
T返回安全控件的属性。

layoutDirection

layoutDirection(value: SecurityComponentLayoutDirection): T

设置安全控件上图标和文字分布的方向。

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

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

参数:

参数名类型必填说明
valueSecurityComponentLayoutDirection是

安全控件上图标和文字分布的方向。

默认值:SecurityComponentLayoutDirection.HORIZONTAL

返回值:

类型说明
T返回安全控件的属性。

position

position(value: Position): T

设置绝对定位,设置安全控件的左上角相对于父容器左上角的偏移位置。

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

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

参数:

参数名类型必填说明
valuePosition是

安全控件的左上角相对于父容器左上角的偏移位置。

默认值:

{

x: 0,

y: 0

}

返回值:

类型说明
T返回安全控件的属性。

markAnchor

markAnchor(value: Position): T

设置安全控件在位置定位时的锚点,以控件左上角作为基准点进行偏移。

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

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

参数:

参数名类型必填说明
valuePosition是

安全控件在位置定位时的锚点,以控件左上角作为基准点进行偏移。通常配合position和offset属性使用,单独使用时,效果类似offset。

默认值:

{

x: 0,

y: 0

}

返回值:

类型说明
T返回安全控件的属性。

offset

offset(value: Position | Edges | LocalizedEdges): T

设置安全控件相对于自身布局位置的坐标偏移。

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

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

参数:

参数名类型必填说明
valuePosition | Edges12+ | LocalizedEdges12+是

安全控件相对于自身布局位置的坐标偏移。设置此属性不会影响父容器的布局,仅在绘制过程中调整位置。

默认值:

{

x: 0,

y: 0

}

返回值:

类型说明
T返回安全控件的属性。

fontSize

fontSize(value: Dimension): T

设置安全控件上文字的尺寸。

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

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

参数:

参数名类型必填说明
valueDimension是

安全控件上文字的尺寸。

默认值:16fp

返回值:

类型说明
T返回安全控件的属性。

fontStyle

fontStyle(value: FontStyle): T

设置安全控件上文字的样式。

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

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

参数:

参数名类型必填说明
valueFontStyle是

安全控件上文字的样式。

默认值:FontStyle.Normal

返回值:

类型说明
T返回安全控件的属性。

fontWeight

fontWeight(value: number | FontWeight | string): T

设置安全控件上文字粗细。

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

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

参数:

参数名类型必填说明
valuenumber | FontWeight | string是

安全控件上文字粗细。

默认值:FontWeight.Medium

返回值:

类型说明
T返回安全控件的属性。

fontFamily

fontFamily(value: string | Resource): T

设置安全控件上文字的字体。

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

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

参数:

参数名类型必填说明
valuestring | Resource是

安全控件上文字的字体。

默认字体:'HarmonyOS Sans'

返回值:

类型说明
T返回安全控件的属性。

fontColor

fontColor(value: ResourceColor): T

设置安全控件上文字的颜色。

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

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

参数:

参数名类型必填说明
valueResourceColor是

安全控件上文字的颜色。

默认值:$r('sys.color.font_on_primary')

返回值:

类型说明
T返回安全控件的属性。

iconColor

iconColor(value: ResourceColor): T

设置安全控件上图标的颜色。

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

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

参数:

参数名类型必填说明
valueResourceColor是

安全控件上图标的颜色。

默认值:$r('sys.color.icon_on_primary')

返回值:

类型说明
T返回安全控件的属性。

backgroundColor

backgroundColor(value: ResourceColor): T

设置安全控件的背景颜色。

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

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

参数:

参数名类型必填说明
valueResourceColor是

安全控件的背景颜色。

默认值:$r('sys.color.icon_emphasize')

安全控件按钮背景色高八位的α值低于0x1a(例如0x1800ff00)时,安全控件按钮背景色高八位的α值会被系统强制调整为0xff。

返回值:

类型说明
T返回安全控件的属性。

borderStyle

borderStyle(value: BorderStyle): T

设置安全控件的边框的样式。

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

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

参数:

参数名类型必填说明
valueBorderStyle是

安全控件的边框的样式。

默认不设置边框样式

返回值:

类型说明
T返回安全控件的属性。

borderWidth

borderWidth(value: Dimension): T

设置安全控件的边框的宽度。

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

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

参数:

参数名类型必填说明
valueDimension是

安全控件的边框的宽度。

默认不设置边框宽度

返回值:

类型说明
T返回安全控件的属性。

borderColor

borderColor(value: ResourceColor): T

设置安全控件的边框的颜色。

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

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

参数:

参数名类型必填说明
valueResourceColor是

安全控件的边框的颜色。

默认不设置边框颜色

返回值:

类型说明
T返回安全控件的属性。

borderRadius

borderRadius(value: Dimension): T

设置安全控件的边框圆角半径。

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

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

参数:

参数名类型必填说明
valueDimension是安全控件的边框圆角半径。

返回值:

类型说明
T返回安全控件的属性。

padding

padding(value: Padding | Dimension): T

设置安全控件的内边距。

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

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

参数:

参数名类型必填说明
valuePadding | Dimension是

安全控件的内边距。

默认值:上下8vp, 左右16vp

返回值:

类型说明
T返回安全控件的属性。

textIconSpace

textIconSpace(value: Dimension): T

设置安全控件中图标和文字的间距。

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

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

参数:

参数名类型必填说明
valueDimension是

安全控件中图标和文字的间距。

默认值:4vp

返回值:

类型说明
T返回安全控件的属性。

width11+

width(value: Length): T

设置安全控件自身的宽度,缺省时将根据元素内容自适配宽度。

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

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

参数:

参数名类型必填说明
valueLength是安全控件自身的宽度,缺省时将根据元素内容自适配宽度。若设置宽度小于当前属性组合下允许的最小宽度时,宽度会调整为设置值,此时按钮文本信息会自动换行,以保证安全控件显示的完整性。

返回值:

类型说明
T返回安全控件的属性。

height11+

height(value: Length): T

设置安全控件自身的高度,缺省时将根据元素内容自适配高度。

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

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

参数:

参数名类型必填说明
valueLength是安全控件自身的高度,缺省时将根据元素内容自适配高度。若设置高度小于当前属性组合下允许的最小高度时,高度不会缩减到设置值,此时高度会大于设置高度,以保证安全控件显示的完整性。

返回值:

类型说明
T返回安全控件的属性。

size11+

size(value: SizeOptions): T

设置高宽尺寸,缺省时将根据元素内容自适配高宽尺寸。

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

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

参数:

参数名类型必填说明
valueSizeOptions是高宽尺寸,缺省时将根据元素内容自适配高宽尺寸。若设置尺寸小于当前属性组合下允许的最小尺寸时,高度不会缩减到设置值,宽度会调整到设置值,此时按钮文本信息会自动换行,以保证安全控件显示的完整性。

返回值:

类型说明
T返回安全控件的属性。

constraintSize11+

constraintSize(value: ConstraintSizeOptions): T

设置约束尺寸,组件布局时,进行尺寸范围限制。

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

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

参数:

参数名类型必填说明
valueConstraintSizeOptions是

约束尺寸,组件布局时,进行尺寸范围限制。constraintSize的优先级高于Width和Height。

同width/height一样,若设置尺寸小于当前属性组合下允许的最小尺寸时, 高度不会缩减到设置值,宽度会调整到设置值,此时按钮文本信息会自动换行,以保证安全控件显示的完整性。

默认值:

{

minWidth: 0,

maxWidth: Infinity,

minHeight: 0,

maxHeight: Infinity

}

返回值:

类型说明
T返回安全控件的属性。

SecurityComponentLayoutDirection枚举说明

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

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

名称值说明
HORIZONTAL0安全控件上图标和文字分布的方向为水平排列。
VERTICAL1安全控件上图标和文字分布的方向为垂直排列。

示例

说明

为避免控件样式不合法导致授权失败,请开发者先了解安全控件样式的约束与限制。

// xxx.ets
@Entry
@Component
struct Index {
  build() {
    Row() {
      Column({space:5}) {
        // 生成一个保存按钮,并设置它的SecurityComponent属性
        SaveButton()
          .fontSize(35)
          .fontColor(Color.White)
          .iconSize(30)
          .layoutDirection(SecurityComponentLayoutDirection.HORIZONTAL)
          .borderWidth(1)
          .borderStyle(BorderStyle.Dashed)
          .borderColor(Color.Blue)
          .borderRadius(20)
          .fontWeight(100)
          .iconColor(Color.White)
          .padding({left:50, top:50, bottom:50, right:50})
          .textIconSpace(20)
          .backgroundColor(0x3282f6)
        SaveButton().size({width:200, height:100})
        SaveButton().constraintSize({maxWidth:60})
      }.width('100%')
    }.height('100%')
  }
}

鸿蒙5.0版开发:ArkTS组件-卡片(FormComponent) 提供卡片组件,实现卡片的显示功能。 阅读详情

相关推荐

鸿蒙5.0版开发:ArkTS组件-安全控件通用属性

安全控件的基础属性,用于设置安全控件通用的属性。

m0_69424697的博客 899

HarmonyOS之深入解析NFC的功能和使用

一、简介 NFC(Near Field Communication,近距离无线通信技术) 是一种非接触式识别和互联技术,让移动设备、消费类电子产品、PC 和智能设备之间可以进行近距离无线通信。 HarmonyOS 的 NFC 提供的功能有: NFC 基础查询:在进行 NFC 功能开发之前,开发者应该先确认设备是否支持 NFC 功能、NFC 是否打开等基本信息。 访问安全单元(Secure Element,简称为 SE):SE 可用于保存重要信息,应用可以访问指定 SE,并发送数据到 SE 上。

╰つ栺尖篴夢ゞ 1万+

鸿蒙5.0版开发:ArkTS组件通用属性-文本通用

文本通用属性目前只针对包含文本元素的组件,设置文本样式。

m0_69424697的博客 1312

鸿蒙5.0开发进阶:API ArkUI框架-ArkTS组件(位置设置)

设置组件的对齐方式、布局方向和显示位置。

Androidbye的博客 950

鸿蒙5.0版开发:ArkTS组件通用属性-尺寸设置

用于设置组件的宽高、边距。

m0_69424697的博客 1717

鸿蒙5.0版开发:ArkTS组件通用属性-拖拽控制

设置组件是否可以响应拖拽事件。

m0_69424697的博客 1233

【鸿蒙软件开发】ArkTS常用组件之Button

Button是按钮组件,通常用于响应用户的点击操作,其类型包括胶囊按钮、圆形按钮、普通按钮。Button当做为容器使用时可以通过添加子组件实现包含文字、图片等元素的按钮。具体用法请参考Button。Button通过调用接口来创建,接口调用有以下两种形式:创建不包含子组件的按钮。: { type?该接口用于创建不包含子组件的按钮,其中label用来设置按钮文字,type用于设置Button类型,stateEffect属性设置Button是否开启点击效果。

m0_62599305的博客 9366

鸿蒙5.0版开发:ArkTS组件通用属性-组件标识

id为组件的唯一标识,在整个应用内唯一。

m0_69424697的博客 1166

鸿蒙5.0版开发:ArkTS组件通用属性-位置设置

设置组件的对齐方式、布局方向和显示位置。

m0_69424697的博客 1508

鸿蒙5.0版开发:ArkTS组件通用属性-动态属性设置

动态设置组件的属性,支持开发者在属性设置时使用if/else语法

m0_69424697的博客 1582

鸿蒙5.0版开发:ArkTS组件-PasteButton

安全控件的粘贴按钮,用户通过点击该粘贴按钮,可以临时获取读取剪贴板权限。

m0_69424697的博客 820

鸿蒙5.0版开发:ArkTS组件通用属性-外描边设置

设置组件外描边样式。

m0_69424697的博客 881

鸿蒙5.0版开发:ArkTS组件通用属性-布局约束

通过组件的宽高比和显示优先级约束组件显示效果。

m0_69424697的博客 921

鸿蒙5.0版开发:ArkTS组件-LocationButton

安全控件的位置控件,用户通过点击该位置按钮,可以临时获取精准定位权限,而不需要权限弹框授权确认。

m0_69424697的博客 1095

鸿蒙5.0版开发:ArkTS组件-SaveButton

安全控件的保存控件,用户通过点击该保存按钮,可以临时获取存储权限,而不需要权限弹框授权确认。

m0_69424697的博客 1167

鸿蒙5.0版开发:ArkTS组件通用属性-图片边框设置

设置容器组件的图片边框样式。

m0_69424697的博客 1140

鸿蒙5.0版开发:ArkTS组件通用属性-背景设置

设置组件的背景样式。

m0_69424697的博客 1608

鸿蒙HarmonyOS 【ArkTS组件】通用属性-安全区域

摘要:本文介绍了ArkUI框架中的安全区域概念及其实现方式。安全区域默认不与系统非安全区(如状态栏、导航栏)重叠,开发者可通过expandSafeArea属性扩展组件绘制区域至安全区外,支持配置安全区类型和方向。同时提供了setKeyboardAvoidMode方法设置键盘弹出时的页面避让模式(默认上抬),并说明了两者的交互效果。文章通过6个代码示例,分别演示了沉浸式效果、固定宽高限制、键盘避让场景、滚动容器适配等典型应用。其中强调:设置expandSafeArea需注意组件边界条件,避免与滚动容器冲突;键

zhangQ2013的博客 1210
上一篇: 鸿蒙5.0开发进阶:ArkTS组件-卡片(FormMenu)
下一篇: 鸿蒙5.0开发进阶:ArkTS组件-LocationButton
懂你的大海
博客等级 码龄6年 9049粉丝 1381原创
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

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

抵扣说明:

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

余额充值