addUnit 单位转换
17:43说明
$u.addUnit 为数字或 CSS 长度值补齐单位并返回字符串。数字不做数值换算,已带单位的字符串原样返回,空格分隔的多值逐项补齐;value 传 null 时返回 auto。
示例
基础用法(传入数字)
数字入参按 config.unit(默认 px)补齐单位,0 也会得到单位。
查看源码
vue
<template>
<ux-cell-group :border="false">
<ux-cell-item title="$u.addUnit(10)" :value="$u.addUnit(10)" :arrow="false" />
<ux-cell-item title="$u.addUnit(16)" :value="$u.addUnit(16)" :arrow="false" />
<ux-cell-item title="$u.addUnit(20)" :value="$u.addUnit(20)" :arrow="false" />
<ux-cell-item title="$u.addUnit(0)" :value="$u.addUnit(0)" :arrow="false" :border-bottom="false" />
</ux-cell-group>
</template>
<script setup lang="ts">
import { $u } from '@/uni_modules/uview-pro-x';
</script>传字符串(已有单位)
已带 px / rpx / % / em 单位的字符串原样返回,不会重复追加单位。
查看源码
vue
<template>
<ux-cell-group :border="false">
<ux-cell-item title="$u.addUnit('10px')" :value="$u.addUnit('10px')" :arrow="false" />
<ux-cell-item title="$u.addUnit('10rpx')" :value="$u.addUnit('10rpx')" :arrow="false" />
<ux-cell-item title="$u.addUnit('50%')" :value="$u.addUnit('50%')" :arrow="false" />
<ux-cell-item title="$u.addUnit('2em')" :value="$u.addUnit('2em')" :arrow="false" :border-bottom="false" />
</ux-cell-group>
</template>
<script setup lang="ts">
import { $u } from '@/uni_modules/uview-pro-x';
</script>特殊值
auto 与空串原样返回,null 返回 auto,第二个参数可显式指定单位(如 16, 'px')。
查看源码
vue
<template>
<ux-cell-group :border="false">
<ux-cell-item title="$u.addUnit('auto')" :value="$u.addUnit('auto')" :arrow="false" />
<ux-cell-item title="$u.addUnit('')" :value="$u.addUnit('')" :arrow="false" />
<ux-cell-item title="$u.addUnit(null)" :value="$u.addUnit(null)" :arrow="false" />
<ux-cell-item title="$u.addUnit(16, 'px')" :value="$u.addUnit(16, 'px')" :arrow="false" :border-bottom="false" />
</ux-cell-group>
</template>
<script setup lang="ts">
import { $u } from '@/uni_modules/uview-pro-x';
</script>多值(空格分隔)
空格分隔的多值逐段补单位,已带单位的值和 auto 保持原样,适合 margin / padding 简写。
查看源码
vue
<template>
<ux-cell-group :border="false">
<ux-cell-item title="$u.addUnit('10 20')" :value="$u.addUnit('10 20')" :arrow="false" />
<ux-cell-item title="$u.addUnit('10px 20')" :value="$u.addUnit('10px 20')" :arrow="false" />
<ux-cell-item title="$u.addUnit('10 10px 30')" :value="$u.addUnit('10 10px 30')" :arrow="false" />
<ux-cell-item title="$u.addUnit('auto 10')" :value="$u.addUnit('auto 10')" :arrow="false" :border-bottom="false" />
</ux-cell-group>
</template>
<script setup lang="ts">
import { $u } from '@/uni_modules/uview-pro-x';
</script>API
参数
| 参数 | 说明 | 类型 | 默认值 | 版本 |
|---|---|---|---|---|
| value | 待补单位的数字或字符串 | number | string | null | - | - |
| unit | 追加的单位,null 时取 config.unit(默认 px) | string | null | null | - |
返回值
| 类型 | 说明 |
|---|---|
string | 补齐单位后的字符串;null 输入返回 auto,空串返回 '',已带单位或 auto 原样返回 |
注意事项
- 只有
unit为null时才回退到config.unit;value为null时直接返回auto,不使用config.unit。 - 只补单位、不做数值换算,
px/rpx/%/em/rem/vh/vw结尾的值原样保留。 - 空格分隔的多值逐段处理,
auto与已带单位的值保持不变。 - 既不是数字也不带单位的字符串原样返回。