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) | number | 0 | - |
返回值:
| 类型 | 说明 |
|---|---|
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。