Skip to content

number 数值换算 ​

17:43

说明 ​

$u.getPxNum 把数字、px、% 或 rpx 值换算成 px 数值,$u.toNumber 把数字、字符串或 null 安全转换为数字,非法输入统一返回 0。

示例 ​

尺寸换算 ​

getPxNum 对数字、px、%、rpx 分别换算,百分比依赖第二参数的总宽度,rpx 结果展示时保留两位小数。

查看源码
vue
<template>
    <ux-cell-group :border="false">
        <ux-cell-item
            v-for="(item, index) in pxList"
            :key="index"
            :title="item.desc"
            :value="item.result"
            :arrow="false"
            :border-bottom="!item.last"
        />
    </ux-cell-group>
</template>

<script setup lang="ts">
import { $u } from '@/uni_modules/uview-pro-x';

type Row = {
    desc: string;
    result: string;
    last: boolean;
};

// 结果统一转字符串,避免模板里数字与字符串混排
const pxList: Row[] = [
    // 数字入参在 config.unit 为 px 时原样返回
    { desc: '$u.getPxNum(10)', result: $u.getPxNum(10).toString(), last: false },
    { desc: "$u.getPxNum('20px')", result: $u.getPxNum('20px').toString(), last: false },
    // 百分比按第二参数的总宽度换算
    { desc: "$u.getPxNum('50%', 200)", result: $u.getPxNum('50%', 200).toString(), last: false },
    { desc: "$u.getPxNum('25%', 750)", result: $u.getPxNum('25%', 750).toString(), last: false },
    // rpx 走 uni.rpx2px,随屏宽变化
    { desc: "$u.getPxNum('20rpx')", result: $u.getPxNum('20rpx').toFixed(2), last: true }
];
</script>

转数值 ​

toNumber 采用 parseFloat 语义,'6px' 取 6,非数字与空串、null 都返回 0。

查看源码
vue
<template>
    <ux-cell-group :border="false">
        <ux-cell-item
            v-for="(item, index) in toNumList"
            :key="index"
            :title="item.desc"
            :value="item.result"
            :arrow="false"
            :border-bottom="!item.last"
        />
    </ux-cell-group>
</template>

<script setup lang="ts">
import { $u } from '@/uni_modules/uview-pro-x';

type Row = {
    desc: string;
    result: string;
    last: boolean;
};

// parseFloat 语义:截取前缀数字,非法值与 null 一律返回 0
const toNumList: Row[] = [
    { desc: "$u.toNumber('123')", result: $u.toNumber('123').toString(), last: false },
    { desc: "$u.toNumber('6px')", result: $u.toNumber('6px').toString(), last: false },
    { desc: '$u.toNumber(12.5)', result: $u.toNumber(12.5).toString(), last: false },
    { desc: "$u.toNumber('abc')", result: $u.toNumber('abc').toString(), last: false },
    { desc: "$u.toNumber('')", result: $u.toNumber('').toString(), last: false },
    { desc: '$u.toNumber(null)', result: $u.toNumber(null).toString(), last: true }
];
</script>

API ​

getPxNum ​

参数:

参数说明类型默认值版本
value数字,或 px / % / rpx 字符串string | number--
totalWidth百分比换算时的总宽度(px)number0-

返回值:

类型说明
number换算后的 px 数值

toNumber ​

参数:

参数说明类型默认值版本
value待转换的值number | string | null--

返回值:

类型说明
number解析后的数字;null、空串与非法值返回 0

注意事项 ​

  • getPxNum 的数字入参在 config.unit 不是 rpx 时原样返回,为 rpx 时先按 rpx 换算。
  • % 按 totalWidth 换算,totalWidth 默认 0,因此不传第二参数时百分比结果为 0。
  • rpx 走 uni.rpx2px,结果随屏幕宽度变化,不保证跨设备一致。
  • toNumber 采用 parseFloat 语义,只截取前缀数字,永远不返回 NaN。