CSS Typed Object Model API
The type() method of the CSSNumericValue interface returns a CSSNumericType dictionary that describes the type of the CSSNumericValue, such as whether it's a length, an angle, or a time.
Syntax
type()
Parameters
None.
Return value
A CSSNumericType dictionary (an object) with the following properties.
Only the properties that apply to the value are included, so a plain number has the type {}.
length,angle,time,frequency,resolution,flex, andpercent- : Integers giving the power of each of these base types in the value, included only if they aren't
0. For example, a length has the type{ length: 1 }, and a length multiplied by a length has the type{ length: 2 }.
- : Integers giving the power of each of these base types in the value, included only if they aren't
percentHint- : A string naming the base type that percentages in the value will become, such as
"length". Only included if the value mixes a percentage with another type.
- : A string naming the base type that percentages in the value will become, such as
Exceptions
None.
Description
Every numeric value has a type, made up of one or more base types: length (such as px or em), angle (such as deg), time (s or ms), frequency (Hz or kHz), resolution (such as dpi), flex (fr), and percent (%).
Most values have a single base type with a power of 1.
Calculations change the type.
Multiplying values adds the powers of their base types, so 10px * 2px has the type { length: 2 }, which is an area.
Dividing subtracts them, so 100px / 2s has the type { length: 1, time: -1 }, which is a speed, and 10px / 2px has the type {}, which is a plain number.
When a percentage is added to another type, as in calc(50% + 10px), the percentage becomes that type when the page is laid out, because 50% of a width is a length.
So the type is reported as { length: 1, percentHint: "length" }: a length, with a hint that it includes a percentage.
Examples
Getting the type of single values
console.log(CSS.px(10).type()); // { length: 1 }
console.log(CSS.deg(45).type()); // { angle: 1 }
console.log(CSS.number(3).type()); // {}
Getting the type of calculations
console.log(CSS.px(2).mul(CSS.px(3)).type()); // { length: 2 }
console.log(CSS.px(100).div(CSS.s(2)).type()); // { length: 1, time: -1 }
console.log(CSS.px(10).div(CSS.px(2)).type()); // {}
Getting the type of a value that includes a percentage
const width = CSS.percent(50).add(CSS.px(10));
console.log(width.type()); // { length: 1, percentHint: "length" }
Specifications
Browser compatibility
See also
- CSSNumericValue.add()
- CSSNumericValue.mul()
- CSS values and units
- Using the CSS Typed OM
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
