Skip to content

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 | nullnull-

返回值 ​

类型说明
string补齐单位后的字符串;null 输入返回 auto,空串返回 '',已带单位或 auto 原样返回

注意事项 ​

  • 只有 unit 为 null 时才回退到 config.unit;value 为 null 时直接返回 auto,不使用 config.unit。
  • 只补单位、不做数值换算,px / rpx / % / em / rem / vh / vw 结尾的值原样保留。
  • 空格分隔的多值逐段处理,auto 与已带单位的值保持不变。
  • 既不是数字也不带单位的字符串原样返回。