鸿蒙5.0开发进阶:ArkTS组件-像素单位

【快应用】px和vp单位换算 【问题背景】在快应用页面布局设计时,需要知道每个组件的样式及位置,这时就需要了解下长度单位及相互转换方法。【解决方案】px是长度单位像素,是显示屏中的一个个小方格。vp(虚拟像素)vp=(px*160)/PPI屏幕像素点密度(Pixels Per Inch-PPI):对角线像素点个数/屏幕尺寸。即每英寸中有多少个像素点。代表的分辨率屏幕密度换算(px/vp)240*3201201vp=0.75px320*4801601vp=1px480*8002401vp=1.5px720*12803201vp=2px19 阅读详情

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


像素单位

ArkUI为开发者提供4种像素单位,采用vp为基准数据单位。

说明

本模块首批接口从API version 7开始支持,后续版本的新增接口,采用上角标单独标记接口的起始版本。

名称描述
px屏幕物理像素单位。
vp

屏幕密度相关像素,根据屏幕像素密度转换为屏幕物理像素,当数值不带单位时,默认单位vp。

说明:

vp与px的比例与屏幕像素密度有关。

fp字体像素,与vp类似适用屏幕密度变化,随系统字体大小设置变化。
lpx视窗逻辑像素单位,lpx单位为实际屏幕宽度与逻辑宽度(通过designWidth配置)的比值,designWidth默认值为720。当designWidth为720时,在实际宽度为1440物理像素的屏幕上,1lpx为2px大小。

像素单位转换

提供其他单位与px单位互相转换的方法。

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

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

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

接口描述
vp2px(value : number) : number

将vp单位的数值转换为以px为单位的数值。

说明:

默认使用当前UI实例所在屏幕的虚拟像素比进行转换,UI实例未创建时,使用默认屏幕的虚拟像素比进行转换。

px2vp(value : number) : number

将px单位的数值转换为以vp为单位的数值。

说明:

默认使用当前UI实例所在屏幕的虚拟像素比进行转换,UI实例未创建时,使用默认屏幕的虚拟像素比进行转换。

fp2px(value : number) : number将fp单位的数值转换为以px为单位的数值。
px2fp(value : number) : number将px单位的数值转换为以fp为单位的数值。
lpx2px(value : number) : number将lpx单位的数值转换为以px为单位的数值。
px2lpx(value : number) : number将px单位的数值转换为以lpx为单位的数值。

示例

说明

直接使用vp2px/px2vp/fp2px/px2fp/lpx2px/px2lpx可能存在UI上下文不明确的问题,建议使用getUIContext获取UIContext实例,再使用UIContext下的vp2px/px2vp/fp2px/px2fp/lpx2px/px2lpx调用绑定实例的接口。

// xxx.ets
@Entry
@Component
struct Example {
  build() {
    Column() {
      Flex({ wrap: FlexWrap.Wrap }) {
        Column() {
          Text("width(220)")
            .width(220)
            .height(40)
            .backgroundColor(0xF9CF93)
            .textAlign(TextAlign.Center)
            .fontColor(Color.White)
            .fontSize('12vp')
        }.margin(5)

        Column() {
          Text("width('220px')")
            .width('220px')
            .height(40)
            .backgroundColor(0xF9CF93)
            .textAlign(TextAlign.Center)
            .fontColor(Color.White)
        }.margin(5)

        Column() {
          Text("width('220vp')")
            .width('220vp')
            .height(40)
            .backgroundColor(0xF9CF93)
            .textAlign(TextAlign.Center)
            .fontColor(Color.White)
            .fontSize('12vp')
        }.margin(5)

        Column() {
          Text("width('220lpx') designWidth:720")
            .width('220lpx')
            .height(40)
            .backgroundColor(0xF9CF93)
            .textAlign(TextAlign.Center)
            .fontColor(Color.White)
            .fontSize('12vp')
        }.margin(5)

        Column() {
          Text("width(vp2px(220) + 'px')")
            // 建议使用this.getUIContext().vp2px()
            .width(vp2px(220) + 'px')
            .height(40)
            .backgroundColor(0xF9CF93)
            .textAlign(TextAlign.Center)
            .fontColor(Color.White)
            .fontSize('12vp')
        }.margin(5)

        Column() {
          Text("fontSize('12fp')")
            .width(220)
            .height(40)
            .backgroundColor(0xF9CF93)
            .textAlign(TextAlign.Center)
            .fontColor(Color.White)
            .fontSize('12fp')
        }.margin(5)

        Column() {
          Text("width(px2vp(220))")
            // 建议使用this.getUIContext().px2vp()
            .width(px2vp(220))
            .height(40)
            .backgroundColor(0xF9CF93)
            .textAlign(TextAlign.Center)
            .fontColor(Color.White)
            .fontSize('12fp')
        }.margin(5)
      }.width('100%')
    }
  }
}

【HarmonyOS NEXT】在Component中通过px2vp转换的数据前后不一致 px2vp是ArkUI的接口。通过getWindowAvoidArea.topRect.heigth获取到状态栏的高度为126,这个高度设置为组件的margintop,在工具类里面通过px2vp 126 = 126, 而在component中转换后得到的值却不一样,是什么原因?px2vp像素单位转换 / @ohos.app.ability.UIAbility组件 / @ohos.window (窗口)模块 / windowStage.loadContent。 阅读详情

相关推荐

鸿蒙Harmony应用开发—ArkTS-像素单位

ArkUI为开发者提供4种像素单位,框架采用vp为基准数据单位。

m0_64420071的博客 1894

OpenHarmony/Harmony像素单位

大家好,我是坚果,今天给大家介绍一下像素单位的基础知识。ArkUI为开发者提供4种像素单位,框架采用vp为基准数据单位。

坚果的博客 1万+

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

Image为图片组件,常用于在应用中显示图片。

m0_69424697的博客 1688

【Harmony OS 4.0】像素单位

像素单位:px、vp、fp

票票的博客 812

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

提供分隔器组件,分隔不同内容块/内容元素。

m0_69424697的博客 735

鸿蒙Harmony应用开发—ArkTS声明式开发(画布组件:ImageBitmap)

ArkTS声明式开发(画布组件:ImageBitmap)

m0_64420071的博客 1829

鸿蒙系统中的像素单位与API使用详解

px:屏幕物理像素单位,与设备硬件直接相关。vp(Viewport 像素):屏幕密度相关像素,根据屏幕像素密度转换为屏幕物理像素。fp(字体像素):类似于vp,适用于屏幕密度变化,并会随系统字体大小设置变化。lpx(视窗逻辑像素单位):其大小取决于实际屏幕宽度与逻辑宽度(通过designWidth配置)的比值。

qq_14863717的博客 2337

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

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

m0_69424697的博客 921

【鸿蒙next开发】ArkUI框架:ArkTS组件-像素单位

ArkUI为开发者提供4种像素单位,采用vp为基准数据单位。

m0_73088370的博客 1077

HarmonyOS:像素单位

ArkUI为开发者提供4种像素单位,采用vp为基准数据单位。 px、vp、fp、lpx

ChinaDragon10的博客 1574

鸿蒙开发:ArkTS ScrollBar 组件

在 ArkTS 中,ScrollBar 是用于在可滚动容器(如具有滚动功能的视图、列表或文本区域)中提供可视化滚动指示和交互功能的组件。它帮助用户了解内容的滚动位置以及可滚动的范围,并允许用户通过拖动或点击滚动条来实现内容的滚动。

1673

鸿蒙5.0开发进阶:API ArkUI框架-ArkTS组件(组件级像素取整)

组件级像素取整的目标是将像素取整功能作为组件的属性.........

Androidbye的博客 757

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

ImageBitmap对象可以存储canvas渲染的像素数据。

m0_69424697的博客 910

鸿蒙5.0开发进阶:UI框架-ArkTS组件(Divider)

提供分隔器组件,分隔不同内容块/内容元素。

Androidbye的博客 1123

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

ImageData对象可以存储canvas渲染的像素数据。

m0_69424697的博客 1051

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

用于显示单个二维码的组件。

m0_69424697的博客 1090

鸿蒙5.0开发进阶:ArkTS组件-基础类型定义

资源引用类型,用于设置组件属性的值。

Androidbye的博客 906

鸿蒙Harmony应用开发—ArkTS声明式开发(画布组件:ImageData)

ArkTS声明式开发(画布组件:ImageData)

m0_64420071的博客 845
上一篇: 鸿蒙5.0开发进阶:ArkTS组件-基础类型定义
下一篇: 鸿蒙5.0开发进阶:ArkTS组件-设置事件回调
懂你的大海
博客等级 码龄6年 9049粉丝 1381原创
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

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

抵扣说明:

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

余额充值