harmony 鸿蒙像素单位转换

2023-10-30
浏览 (1504)

像素单位转换

在日常应用页面布局设计时，开发者需要知道每个组件的样式及位置，这时就需要了解像素单位及相互转换方法，ArkUI 开发框架提供了4种像素单位供开发者使用，分别是： px 、 vp 、 fp 和 lpx ，框架采用 vp 为基准数据单位，本篇就简单为大家介绍下像素单位的基本知识与像素单位转换API的使用。通过像素转换案例，向开发者讲解了如何使用像素单位设置组件的尺寸、字体的大小以及不同像素单位之间的转换方法。

效果呈现

本例最终效果如下：

Pixel-Convertion

运行环境

本例基于以下环境开发，开发者也可以基于其他适配的版本进行开发： - IDE: DevEco Studio 3.1 Release - SDK: Ohos_sdk_public 3.2.12.5(API Version 9 Release)

实现思路

本篇案例主要功能包括：①像素单位基本知识介绍；②像素单位转换相关API的使用。 * 构建入口页面：该页面包含两个button组件，通过点击按钮事件，实现到详细页面的跳转

像素单位介绍页面：
- 构建IntroducitonViewModel.ets
创建自定义接口IntroductionItem，根据IntroductionItem接口参数，创建对象数组INTRODUCE_LIST，向对象数组INTRODUCE_LIST中填充像素单位介绍页面所需参数内容。
- 构建IntroducitonPage.ets
通过ForEach循环渲染上一步骤中对象数组中的每个Item；通过if判断组件的显隐，同时添加样式，完成像素介绍页面。
像素转换页面：
- 构建ConvertionViewModel.ets
创建自定义接口ConversionItem，根据ConversionItem接口参数，创建对象数组ConversionViewModel，向对象数组ConversionViewModel中填充像素转换页面所需参数内容。
- 构建ConvertionPage.ets
通过ForEach循环渲染上一步构建的ConversionViewModel的每个子菜单Item，同时添加样式，构建像素介绍页面。

开发步骤

构建入口页面：该页面包含两个button按钮，通过点击按钮事件，实现到详细页的跳转。具体代码如下：

// entry/src/main/ets/pages/IndexPage.ets


import router from '@ohos.router';
@Entry
@Component
struct IndexPage {
    // 定义jumpPage方法，实现路由跳转
    jumpPage(url: string) {
        router.pushUrl({ url })
    }


    build() {
        Column({ space: 24 }) {
            Button('像素介绍')
                .height('40vp')
                .width('100%')
                .backgroundColor($r('app.color.blue_background'))
                // 点击时回调jumpPage方法，跳转到pages/IntroductionPage页面
            .onClick(() => this.jumpPage('pages/IntroductionPage'))


            Button('像素转换')
                .height('40vp')
                .width('100%')
                .backgroundColor($r('app.color.blue_background'))
                // 点击时回调jumpPage方法，跳转到pages/ConversionPage页面
                .onClick(() => this.jumpPage('pages/ConversionPage'))
        }
        .backgroundColor($r('app.color.page_background'))
        .justifyContent(FlexAlign.Center)
        .padding(24)
        .width('100%')
        .height('100%')
    }
}

像素单位介绍页面创建。此页面主要系统介绍像素单位的概念，包含px、vp、lpx以及fp，并在页面中为Text组件的宽度属性设置不同的像素单位（如px、vp、lpx），fp像素单位则设置为Text组件的字体大小。

从效果图看，此页面由4个功能相同的菜单组成，我们先构建功能菜单。创建IntroducitonViewModel.ets定义每个子功能菜单Item。具体代码如下:

// entry/src/main/ets/viewmodel/IntroducitonViewModel.ets


// 创建自定义接口，定义每个Item中的内容
interface IntroductionItem {
    name: string;
    title: string;
    subTitle: string;
    value: string;
    smallFontSize: number;
    largeFontSize: number;
}


// 根据自定义接口IntroductionItem，填充内容
const INTRODUCE_LIST: IntroductionItem[] = [
{
    name: 'px',
    title: '屏幕物理像素单位。',
    subTitle: null,
    value: '200px',
    smallFontSize: 0,
    largeFontSize: 0
},
{
    name: 'vp',
    title:'屏幕密度相关像素，根据屏幕像素密度转换为屏幕物理像素。',
    value:'200vp',
    subTitle:'像素密度为160dpi的设备上1vp=1px,1vp对应的物理屏幕像素=（屏幕像素密度/160）px',
    smallFontSize: 0,
    largeFontSize: 0
},
{
    name: 'lpx',
    title:'视窗逻辑像素单位，lpx单位为实际屏幕宽度与逻辑宽度（通过designWidth配置）的比值。',
    subTitle: null,
    value: '200lpx',
    smallFontSize: 0,
    largeFontSize: 0
},
{
    name: 'fp',
    title:'字体像素，与vp类似，随系统字体大小设置变化。',
    subTitle:'默认情况下与vp相同，即1vp=1fp,如果用户手动调整了系统字体，scale为缩放比例，设置后的字体大小（单位fp） = 设置前的字体大小 * scale',
    value: '',
    smallFontSize: 14,
    largeFontSize: 24
}
];


// 定义类IntroductionViewModel，获取像素介绍页面的数据
class IntroductionViewModel {
    getIntroductionList() {
        let introductionItems = INTRODUCE_LIST;
        return introductionItems;
	}
}


let introductionViewModel = new IntroductionViewModel();
export default introductionViewModel as IntroductionViewModel;

渲染像素单位介绍页面,通过ForEach循环渲染上一步构建的IntroductionViewModel的每个子菜单Item；通过if判断组件的显隐，为显示的组件，添加样式，构建像素介绍页面。具体代码如下：

// entry/src/main/ets/pages/IntroducitonPages.ets
import IntroductionViewModel from '../viewmodel/IntroductionViewModel';


    interface IntroductionItem {
        name: string;
        title: Resource;
        subTitle: Resource;
        value: string;
        smallFontSize: number;
        largeFontSize: number;
	}


    @Extend(Text) function titleTextStyle() {
        .fontColor($r('app.color.title_font'))
        .fontFamily('HarmonyHeiTi_Medium')
        .fontWeight(500)
	}


    @Entry
    @Component
    struct IntroductionPage {
        build() {
            Column() {
                Navigation() {
                    List({ space: 12 }) {
                    //通过ForEach循环渲染Item，构建像素介绍页面
                        ForEach(IntroductionViewModel.getIntroductionList(), (item: IntroductionItem) => {
                            //渲染每个Item
                            ListItem() {
                                Column() {
                                    Text(item.name)
                                        .titleTextStyle()
                                        .fontSize('16fp')
                                    Text(item.title)
                                        .titleTextStyle()
                                        .fontSize('14fp')
                                        .fontFamily('HarmonyHeiTi')
                                        .lineHeight('20fp')
                                        .margin({ top: '8vp'})
                                        .fontWeight(400)
                                    // subTitle非空，添加Text组件，显示subTitle内容，同时添加样式；不存在则不显示
                                    if (item.subTitle) {
                                        Text(item.subTitle)
                                            .titleTextStyle()
                                            .opacity(0.6)
                                            .lineHeight('16fp')
                                            .fontSize('12fp')
                                            .fontFamily($r('app.string.HarmonyHeiTi'))
                                            .margin({ top: '20vp' })
                                            .fontWeight(400)
                                }


                                    // value非空，添加Text组件且通过宽度属性设置不同的像素单位
                                    if (item.value.length > 0) {
                                        Text(item.value)
                                            .titleTextStyle()
                                            .fontColor($r('app.color.item_background'))
                                            .fontSize('16fp')
                                            .textAlign(TextAlign.Center)
                                            .backgroundColor($r('app.color.blue_background'))
                                            .height('28vp')
                                            .width(item.value)
                                            .borderRadius('4vp')
                                            .margin({ top: '12vp' })
                                    // value为空，添加两个text组件，使用fp像素单位设置为Text组件的字体大小
                                    } else {
                                        Column() {
                                            Text($r('app.string.font_desc', item.smallFontSize))
                                                .titleTextStyle()
                                                .fontSize(item.smallFontSize)
                                            Text($r('app.string.font_desc', item.largeFontSize))
                                                .titleTextStyle()
                                                .fontSize(item.largeFontSize)
                                                .margin({ top: '6vp' })
                                        }
                                            .alignItems(HorizontalAlign.Start)
                                            .backgroundColor($r('app.color.font_background'))
                                            .width('100%')
                                            .borderRadius('12vp')
                                            .padding('12vp')
                                            .margin({ top: '12vp' })
                                    }
                                }
                                .alignItems(HorizontalAlign.Start)
                                .width('100%')
                                .padding('12vp')
                                .borderRadius('24vp')
                                .backgroundColor('#FFFFFF')
                            }
                            .padding({
                            left: '12vp',
                            right: '12vp'
                            })
                        })
                    }
                    .width('100%')
                    .height('100%')
                }
                .titleMode(NavigationTitleMode.Mini)
                .title('像素介绍')
            }
            .backgroundColor($r('app.color.page_background'))
            .width('100%')
            .height('100%')
        }
    }

像素转换页面创建。此页面主要是通过使用像素转换API，实现不同像素单位之间的相互转换功能。

从效果图看，此页面由3个功能相同的菜单组成，我们先构建功能菜单。创建ConversionViewModel.ets定义每个子功能菜单Item。具体代码如下:

// entry/src/main/ets/viewmodel/ConversionViewModel.ets


// 创建自定义接口，定义每个Item中的内容
interface ConversionItem {
    title: string;
    subTitle: string;
    value: number;
    conversionTitle: string;
    conversionSubTitle: string;
    conversionValue: number;
    notice: string;
}


// 定义类ConversionViewModel，获取像素转换页面的数据
class ConversionViewModel {
    getConversionList() {
        let conversionItems = CONVERSION_LIST;
        return conversionItems;
    }
}


// 根据自定义接口ConversionItem，填充内容
export const CONVERSION_LIST: ConversionItem[] = [
{
    title: 'vp > px',
    subTitle: `vp2px(60)`,
    value: vp2px(60),
    conversionTitle: 'px > vp',
    conversionSubTitle: `px2vp(60)`,
    conversionValue: px2vp(60),
    notice: null
},
{
    title: 'fp > px',
    subTitle: `fp2px(60)`,
    value: fp2px(60),
    conversionTitle: 'px > fp',
    conversionSubTitle: `px2fp(60})`,
    conversionValue: px2fp(60),
    notice: null
},
{
    title: 'lpx > px',
    subTitle: `lpx2px(60)`,
    value: lpx2px(60),
    conversionTitle: 'px > lpx',
    conversionSubTitle: `px2lpx(60)`,
    conversionValue: px2lpx(60),
    notice: 'lpx与px之间的转换，需要根据实际情况设置designWidth'
}
];


let conversionViewModel = new ConversionViewModel();
export default conversionViewModel as ConversionViewModel;

渲染像素单位介绍页面,通过ForEach循环渲染上一步构建的ConversionViewModel的每个子菜单Item，同时添加样式，构建像素介绍页面。具体代码如下：

// entry/src/main/ets/pages/ConversionPage.ets


import ConversionViewModel from '../viewmodel/ConversionViewModel';


interface ConversionItem {
    title: string;
    subTitle: string;
    value: number;
    conversionTitle: string;
    conversionSubTitle: string;
    conversionValue: number;
    notice: string;
}


@Extend(Text) function descTextStyle() {
    .fontColor($r('app.color.title_font'))
    .fontSize('14fp')
    .fontFamily($r('app.string.HarmonyHeiTi'))
    .lineHeight('20fp')
    .fontWeight(400)
    .margin({ top: '8vp' })
}


@Extend(Text) function titleTextStyle() {
    .fontColor($r('app.color.title_font'))
    .fontSize('16fp')
    .fontFamily($r('app.string.HarmonyHeiTi_Medium'))
    .fontWeight(500)
}


@Styles function blueStyle() {
    .backgroundColor($r('app.color.blue_background'))
    .height('28vp')
    .borderRadius('4vp')
    .margin({ top: '4vp' })
}


@Entry
@Component
struct ConversionPage {
    build() {
        Column() {
            Navigation() {
                List({ space: 12 }) {
                //通过ForEach循环渲染Item，构建像素转换页面
                    ForEach(ConversionViewModel.getConversionList(), (item: ConversionItem) => {
                        //渲染每个Item
                        ListItem() {
                            Column() {
                                Text(item.title)
                                    .titleTextStyle()
                                    .margin({ top: '6vp' })
                                    Text(item.subTitle)
                                    .descTextStyle()
                                    .opacity(0.6)
                                Row()
                                .blueStyle()
                                    // 为宽度属性设置不同的像素单位
                                    .width(item.value)
                                Text(item.conversionTitle)
                                    .titleTextStyle()
                                    .margin({ top: '18vp' })
                                Text(item.conversionSubTitle)
                                    .descTextStyle()
                                    .opacity(0.6)
                                Row()
                                    .blueStyle()
                                    // 为宽度属性设置不同的像素单位
                                    .width(item.conversionValue)
                                if (item.notice) {
                                    Text(item.notice)
                                        .descTextStyle()
                                        .fontColor($r('app.color.notice_font'))
                                }
                            }
                            .alignItems(HorizontalAlign.Start)
                            .width('100%')
                            .padding('12vp')
                            .borderRadius('24vp')
                            .backgroundColor('#FFFFFF')
                        }
                        .padding({left: '12vp',right: '12vp'})
                    })
                }
                .width('100%')
                .height('100%')
            }
            .titleMode(NavigationTitleMode.Mini)
            .title('像素转换')
        }
        .backgroundColor($r('app.color.page_background'))
        .width('100%')
        .height('100%')
    }
}

完整代码

本例完整代码如下：

应用主页面：entry/src/main/ets/pages/IndexPage.ets。

  import router from '@ohos.router';
  @Entry
  @Component
  struct IndexPage {
      // 定义jumpPage方法，实现路由跳转
      jumpPage(url: string) {
          router.pushUrl({ url })
      }
  
      build() {
          Column({ space: 24 }) {
          Button('像素介绍')
              .height('40vp')
              .width('100%')
              .backgroundColor($r('app.color.blue_background'))
              // 点击时回调jumpPage方法，跳转到pages/IntroductionPage页面
              .onClick(() => this.jumpPage('pages/IntroductionPage'))
  
          Button('像素转换')
              .height('40vp')
              .width('100%')
              .backgroundColor($r('app.color.blue_background'))
              // 点击时回调jumpPage方法，跳转到pages/ConversionPage页面
              .onClick(() => this.jumpPage('pages/ConversionPage'))
          }
          .backgroundColor($r('app.color.page_background'))
          .justifyContent(FlexAlign.Center)
          .padding(24)
          .width('100%')
          .height('100%')
      }
  }

像素介绍ViewModel：entry/src/main/ets/viewmodel/IntroducitonViewModel.ets。

    // 创建自定义接口，定义每个Item中的内容
    interface IntroductionItem {
        name: string;
        title: string;
        subTitle: string;
        value: string;
        smallFontSize: number;
        largeFontSize: number;
    }
  
    // 根据自定义接口IntroductionItem，填充内容
    const INTRODUCE_LIST: IntroductionItem[] = [
    {
        name: 'px',
        title: '屏幕物理像素单位。',
        subTitle: null,
        value: Constants.PIXEL_WIDTH + 'px',
        smallFontSize: 0,
        largeFontSize: 0
    },
    {
        name: 'vp',
        title:'屏幕密度相关像素，根据屏幕像素密度转换为屏幕物理像素。',
        value: Constants.PIXEL_WIDTH + 'vp',
        subTitle:'像素密度为160dpi的设备上1vp=1px,1vp对应的物理屏幕像素=（屏幕像素密度/160）px',
        smallFontSize: 0,
        largeFontSize: 0
    },
    {
        name: 'lpx',
        title:'视窗逻辑像素单位，lpx单位为实际屏幕宽度与逻辑宽度（通过designWidth配置）的比值。',
        subTitle: null,
        value: Constants.PIXEL_WIDTH + 'lpx',
        smallFontSize: 0,
        largeFontSize: 0
    },
    {
        name: 'fp',
        title:'字体像素，与vp类似，随系统字体大小设置变化。',
        subTitle:'默认情况下与vp相同，即1vp=1fp,如果用户手动调整了系统字体，scale为缩放比例，设置后的字体大小（单位fp） = 设置前的字体大小 * scale',
        value: '',
        smallFontSize: Constants.SMALL_FONT_SIZE,
        largeFontSize: Constants.LARGE_FONT_SIZE
    }
    ];
  
    // 定义类IntroductionViewModel，获取像素介绍页面的数据
    class IntroductionViewModel {
        getIntroductionList() {
            let introductionItems = INTRODUCE_LIST;
            return introductionItems;
    	}
    }
  
    let introductionViewModel = new IntroductionViewModel();
    export default introductionViewModel as IntroductionViewModel;

像素介绍页面：entry/src/main/ets/pages/IntroducitonPages.ets。

  import IntroductionViewModel from '../viewmodel/IntroductionViewModel';
  
  interface IntroductionItem {
      name: string;
      title: Resource;
      subTitle: Resource;
      value: string;
      smallFontSize: number;
      largeFontSize: number;
  }
  
  @Extend(Text) function titleTextStyle() {
      .fontColor($r('app.color.title_font'))
      .fontFamily('HarmonyHeiTi_Medium')
      .fontWeight(500)
  }
  
  @Entry
  @Component
  struct IntroductionPage {
      build() {
          Column() {
              Navigation() {
                  List({ space: 12 }) {
                  //通过ForEach循环渲染Item，构建像素介绍页面
                      ForEach(IntroductionViewModel.getIntroductionList(), (item: IntroductionItem) => {
                          //渲染每个Item
                          ListItem() {
                              Column() {
                                  Text(item.name)
                                      .titleTextStyle()
                                      .fontSize('16fp')
                                  Text(item.title)
                                      .titleTextStyle()
                                      .fontSize('14fp')
                                      .fontFamily('HarmonyHeiTi')
                                      .lineHeight('20fp')
                                      .margin({ top: '8vp'})
                                      .fontWeight(400)
                                  // subTitle非空，添加Text组件，显示subTitle内容，同时添加样式；不存在则不显示
                                  if (item.subTitle) {
                                      Text(item.subTitle)
                                          .titleTextStyle()
                                          .opacity(0.6)
                                          .lineHeight('16fp')
                                          .fontSize('12fp')
                                          .fontFamily($r('app.string.HarmonyHeiTi'))
                                          .margin({ top: '20vp' })
                                          .fontWeight(400)
                                  }
  
                                  // value非空，添加Text组件且通过宽度属性设置不同的像素单位
                                  if (item.value.length > 0) {
                                      Text(item.value)
                                          .titleTextStyle()
                                          .fontColor($r('app.color.item_background'))
                                          .fontSize('16fp')
                                          .textAlign(TextAlign.Center)
                                          .backgroundColor($r('app.color.blue_background'))
                                          .height('28vp')
                                          .width(item.value)
                                          .borderRadius('4vp')
                                          .margin({ top: '12vp' })
                                  // value为空，添加两个text组件，使用fp像素单位设置为Text组件的字体大小
                                  } else {
                                      Column() {
                                          Text($r('app.string.font_desc', item.smallFontSize))
                                              .titleTextStyle()
                                              .fontSize(item.smallFontSize)
                                          Text($r('app.string.font_desc', item.largeFontSize))
                                              .titleTextStyle()
                                              .fontSize(item.largeFontSize)
                                              .margin({ top: '6vp' })
                                      }
                                          .alignItems(HorizontalAlign.Start)
                                          .backgroundColor($r('app.color.font_background'))
                                          .width('100%')
                                          .borderRadius('12vp')
                                          .padding('12vp')
                                          .margin({ top: '12vp' })
                                  }
                              }
                              .alignItems(HorizontalAlign.Start)
                              .width('100%')
                              .padding('12vp')
                              .borderRadius('24vp')
                              .backgroundColor('#FFFFFF')
                          }
                          .padding({
                          left: '12vp',
                          right: '12vp'
                          })
                      })
                  }
                  .width('100%')
                  .height('100%')
              }
              .titleMode(NavigationTitleMode.Mini)
              .title('像素介绍')
          }
          .backgroundColor($r('app.color.page_background'))
          .width('100%')
          .height('100%')
      }
  }

像素转换ViewModel：entry/src/main/ets/viewmodel/ConversionViewModel.ets。

    // 创建自定义接口，定义每个Item中的内容
    interface ConversionItem {
        title: string;
        subTitle: string;
        value: number;
        conversionTitle: string;
        conversionSubTitle: string;
        conversionValue: number;
        notice: string;
    }
  
    // 定义类ConversionViewModel，获取像素转换页面的数据
    class ConversionViewModel {
        getConversionList() {
            let conversionItems = CONVERSION_LIST;
            return conversionItems;
        }
    }
  
    // 根据自定义接口ConversionItem，填充内容
    export const CONVERSION_LIST: ConversionItem[] = [
    {
        title: 'vp > px',
        subTitle: `vp2px(60)`,
        value: vp2px(60),
        conversionTitle: 'px > vp',
        conversionSubTitle: `px2vp(60)`,
        conversionValue: px2vp(60),
        notice: null
    },
    {
        title: 'fp > px',
        subTitle: `fp2px(60)`,
        value: fp2px(60),
        conversionTitle: 'px > fp',
        conversionSubTitle: `px2fp(60})`,
        conversionValue: px2fp(60),
        notice: null
    },
    {
        title: 'lpx > px',
        subTitle: `lpx2px(60)`,
        value: lpx2px(60),
        conversionTitle: 'px > lpx',
        conversionSubTitle: `px2lpx(60)`,
        conversionValue: px2lpx(60),
        notice: 'lpx与px之间的转换，需要根据实际情况设置designWidth'
    }
    ];
  
    let conversionViewModel = new ConversionViewModel();
    export default conversionViewModel as ConversionViewModel;

像素转换页面：entry/src/main/ets/pages/ConversionPage.ets。

  import ConversionViewModel from '../viewmodel/ConversionViewModel';
  
  interface ConversionItem {
      title: string;
      subTitle: string;
      value: number;
      conversionTitle: string;
      conversionSubTitle: string;
      conversionValue: number;
      notice: string;
  }
  
  @Extend(Text) function descTextStyle() {
      .fontColor($r('app.color.title_font'))
      .fontSize('14fp')
      .fontFamily($r('app.string.HarmonyHeiTi'))
      .lineHeight('20fp')
      .fontWeight(400)
      .margin({ top: '8vp' })
  }
  
  @Extend(Text) function titleTextStyle() {
      .fontColor($r('app.color.title_font'))
      .fontSize('16fp')
      .fontFamily($r('app.string.HarmonyHeiTi_Medium'))
      .fontWeight(500)
  }
  
  @Styles function blueStyle() {
      .backgroundColor($r('app.color.blue_background'))
      .height('28vp')
      .borderRadius('4vp')
      .margin({ top: '4vp' })
  }
  
  @Entry
  @Component
  struct ConversionPage {
      build() {
          Column() {
              Navigation() {
                  List({ space: 12 }) {
                  //通过ForEach循环渲染Item，构建像素转换页面
                      ForEach(ConversionViewModel.getConversionList(), (item: ConversionItem) => {
                          //渲染每个Item
                          ListItem() {
                              Column() {
                                  Text(item.title)
                                      .titleTextStyle()
                                      .margin({ top: '6vp' })
                                      Text(item.subTitle)
                                      .descTextStyle()
                                      .opacity(0.6)
                                  Row()
                                  .blueStyle()
                                      // 为宽度属性设置不同的像素单位
                                      .width(item.value)
                                  Text(item.conversionTitle)
                                      .titleTextStyle()
                                      .margin({ top: '18vp' })
                                  Text(item.conversionSubTitle)
                                      .descTextStyle()
                                      .opacity(0.6)
                                  Row()
                                      .blueStyle()
                                      // 为宽度属性设置不同的像素单位
                                      .width(item.conversionValue)
                                  if (item.notice) {
                                      Text(item.notice)
                                          .descTextStyle()
                                          .fontColor($r('app.color.notice_font'))
                                  }
                              }
                              .alignItems(HorizontalAlign.Start)
                              .width('100%')
                              .padding('12vp')
                              .borderRadius('24vp')
                              .backgroundColor('#FFFFFF')
                          }
                          .padding({left: '12vp',right: '12vp'})
                      })
                  }
                  .width('100%')
                  .height('100%')
              }
              .titleMode(NavigationTitleMode.Mini)
              .title('像素转换')
          }
          .backgroundColor($r('app.color.page_background'))
          .width('100%')
          .height('100%')
      }
  }

## 参考