Important: This documentation covers Yarn 1 (Classic).
For Yarn 2+ docs and migration guide, see yarnpkg.com.

Package detail

style-unit

alibaba8.1kBSD-3-Clause3.0.5

style-unit

readme

style-unit

Unit conversion for calculating dimensional css attributes, especially for rpx.

API

convertUnit(value, prop, platform);

Property Type Required Description
value string/number true
prop string true
platform string false Auto assignment with universal-env, different platforms have different rpx conversion. Details are as follows.

Web

In Web, Calculate rpx to vw (relative to viewport width 750).

750rpx -> 100vw

setViewportWidth

You can use setViewportWidth method update viewport width

setViewportWidth(1500);

750rpx -> 50vw

Weex

In Weex, Calculate rpx to px (viewport width is 750).

750rpx -> 750px

setRpx

You can use setRpx method update coefficient of 750

setRpx(1500 / 750)

750rpx -> 1500px

MiniApp

rpx (responsive pixel): Adaptable to the screen width in MiniApp. The specified screen width is 750 rpx. If the screen width on iPhone6 is 375 px (750 physical pixels), then 750 rpx = 375 px = 750 physical pixels, i.e. 1 rpx = 0.5 px = 1 physical pixel.

Node.js

Use Weex result:

convertUnit('500rpx', 'width', 'weex')

Use Web result:

convertUnit('500rpx', 'width', 'web')

changelog

Changelog

v3.0.5

  • Fix: fix transform rpx error in node env.

v3.0.4

  • Fix: add esmodule result

v3.0.3

  • Chore: add @babel/runtime as dependency

v3.0.2

  • Bump version

v3.0.1

  • Refactor: avoid pollute global variable
  • Fix: converted property cache key is invalid
  • Fix: will not replace rpx to vw when value contains rpx