文档手册

长度 Length

2024-07-18 17:28:02

长度

 class 长度

数据类型,表示 CSS 中使用的长度和百分比单位。

Sciter 中的 JavaScript 已扩展为支持长度文字,因此这些是有效的声明:

const width = 12px;
const fontSize = 10pt;

长度文字是紧跟在单位字符后面的 JS 数字。

支持的单位列表,标准CSS单位:

  • px

  • pt

  • em

  • ch

  • rem

  • ex

  • in

  • cm

  • mm

  • pc

  • vw

  • vh

  • vmin

  • vmax

  • pct

 Sciter 特定单位

  • ppx - 物理像素,始终为整数。

  • dip - 与设备无关的像素(英寸(n):长度 px 的 1/96),在默认 Sciter 配置中 dip 是等效的。

  • fx - Sciter 的柔性装置。 style.width = 1fx in script 等同于 width:1* (或只是 width:* )在 CSS 中。

 性能:

  • length.quantity:number

报告长度中的单位数。因为它 12px 会回来 12 .

  • length.units:string

报告单位名称。因为它 12px 会回来 "px" .

 方法:

  • length.valueOf():number

返回像素数。

  • length.toString():number

返回字符串表示形式。

 运营商:

长度单位支持以下运算符:

  • a * n - 乘以数字;

  • a / n - 按数字划分;

  • a + b - 两个长度的总和;

  • a - b - 减去两个长度;

  • a == b - 两个长度相等;

  • a < ba > ba <= b , - a >= b 两个长度的比较;

  • +a - 一元加运算符;

  • -a - 一元减号运算符;

  • ++aa++ - 增量运算符;

  • --aa-- - 递减运算符;

 静态方法:

  • Length.px(n):length

  • Length.em(n):length

  • Length.ex(n):length

  • Length.pct(n):length

  • Length.fx(n):length

  • Length.in(n):length

  • Length.cm(n):length

  • Length.mm(n):length

  • Length.pt(n):length

  • Length.pc(n):length

  • Length.dip(n):length

  • Length.percentOfWidth(n):length

  • Length.percentOfHeight(n):length

  • Length.vw(n):length

  • Length.vh(n):length

  • Length.vmin(n):length

  • Length.vmax(n):length

  • Length.rem(n):length

  • Length.ppx(n):length

  • Length.ch(n):length

    上面的这些函数是长度值的静态构造函数。

  • Length.morph(from:Length,to:Length,ratio:0...1[,element]):length

    根据比例从长度变为长度值。如果 ratio == 0.0,则返回值,如果 ratio == 1.0,则返回值。