CSSUnitValue

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

See full compatibility

The CSSUnitValue interface of the CSS Typed Object Model API represents values that contain a single unit type.

For example, the value 42px (a <dimension>) would be represented by a CSSNumericValue.

Constructor

CSSUnitValue(): Creates a new CSSUnitValue object.

Instance properties

CSSUnitValue.value: Returns a double indicating the number of units. For a CSSNumericValue representing 42px, this would be 42.
CSSUnitValue.unit: Returns a string indicating the type of unit. For a CSSNumericValue representing 42px, this would be "px".

Static methods

The interface may also inherit methods from its parent interface, CSSNumericValue.

Instance methods

The interface may also inherit methods from its parent interface, CSSNumericValue.

Examples

The following shows a method of creating a CSSPositionValue from individual CSSUnitValue constructors.

let pos = new CSSPositionValue(
  new CSSUnitValue(5, "px"),
  new CSSUnitValue(10, "px"),
);

Specifications

Specification
CSS Typed OM Level 1 # simple-numeric

Browser compatibility

	desktop					mobile
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox for Android	Opera Android	Safari on iOS	Samsung Internet	WebView Android	WebView on iOS
`CSSUnitValue`	Chrome – Full support Chrome 66 (Release date: 2018-04-17) footnote Full support	Edge – Full support Edge 79 (Release date: 2020-01-15) footnote Full support	Firefox – No support Firefox footnote footnote See bug 1278697	Opera – Full support Opera 53 (Release date: 2018-05-10) footnote Full support	Safari – Full support Safari 16.4 (Release date: 2023-03-27) footnote Full support	Chrome Android – Full support Chrome Android 66 (Release date: 2018-04-17) footnote Full support	Firefox for Android – No support Firefox for Android footnote footnote See bug 1278697	Opera Android – Full support Opera Android 47 (Release date: 2018-07-23) footnote Full support	Safari on iOS – Full support Safari on iOS 16.4 (Release date: 2023-03-27) footnote Full support	Samsung Internet – Full support Samsung Internet 9 (Release date: 2018-09-15) footnote Full support	WebView Android – Full support WebView Android 66 (Release date: 2018-04-17) footnote Full support	WebView on iOS – Full support WebView on iOS 16.4 (Release date: 2023-03-27) footnote Full support
`CSSUnitValue()` constructor	Chrome – Full support Chrome 66 (Release date: 2018-04-17) footnote Full support	Edge – Full support Edge 79 (Release date: 2020-01-15) footnote Full support	Firefox – No support Firefox footnote footnote See bug 1278697	Opera – Full support Opera 53 (Release date: 2018-05-10) footnote Full support	Safari – Full support Safari 16.4 (Release date: 2023-03-27) footnote Full support	Chrome Android – Full support Chrome Android 66 (Release date: 2018-04-17) footnote Full support	Firefox for Android – No support Firefox for Android footnote footnote See bug 1278697	Opera Android – Full support Opera Android 47 (Release date: 2018-07-23) footnote Full support	Safari on iOS – Full support Safari on iOS 16.4 (Release date: 2023-03-27) footnote Full support	Samsung Internet – Full support Samsung Internet 9 (Release date: 2018-09-15) footnote Full support	WebView Android – Full support WebView Android 66 (Release date: 2018-04-17) footnote Full support	WebView on iOS – Full support WebView on iOS 16.4 (Release date: 2023-03-27) footnote Full support
`unit`	Chrome – Full support Chrome 66 (Release date: 2018-04-17) footnote Full support	Edge – Full support Edge 79 (Release date: 2020-01-15) footnote Full support	Firefox – No support Firefox footnote footnote See bug 1278697	Opera – Full support Opera 53 (Release date: 2018-05-10) footnote Full support	Safari – Full support Safari 16.4 (Release date: 2023-03-27) footnote Full support	Chrome Android – Full support Chrome Android 66 (Release date: 2018-04-17) footnote Full support	Firefox for Android – No support Firefox for Android footnote footnote See bug 1278697	Opera Android – Full support Opera Android 47 (Release date: 2018-07-23) footnote Full support	Safari on iOS – Full support Safari on iOS 16.4 (Release date: 2023-03-27) footnote Full support	Samsung Internet – Full support Samsung Internet 9 (Release date: 2018-09-15) footnote Full support	WebView Android – Full support WebView Android 66 (Release date: 2018-04-17) footnote Full support	WebView on iOS – Full support WebView on iOS 16.4 (Release date: 2023-03-27) footnote Full support
`value`	Chrome – Full support Chrome 66 (Release date: 2018-04-17) footnote Full support	Edge – Full support Edge 79 (Release date: 2020-01-15) footnote Full support	Firefox – No support Firefox footnote footnote See bug 1278697	Opera – Full support Opera 53 (Release date: 2018-05-10) footnote Full support	Safari – Full support Safari 16.4 (Release date: 2023-03-27) footnote Full support	Chrome Android – Full support Chrome Android 66 (Release date: 2018-04-17) footnote Full support	Firefox for Android – No support Firefox for Android footnote footnote See bug 1278697	Opera Android – Full support Opera Android 47 (Release date: 2018-07-23) footnote Full support	Safari on iOS – Full support Safari on iOS 16.4 (Release date: 2023-03-27) footnote Full support	Samsung Internet – Full support Samsung Internet 9 (Release date: 2018-09-15) footnote Full support	WebView Android – Full support WebView Android 66 (Release date: 2018-04-17) footnote Full support	WebView on iOS – Full support WebView on iOS 16.4 (Release date: 2023-03-27) footnote Full support

Tip: you can click/tap on a cell for more information.

Full support: Full support
No support: No support
: See implementation notes.

CSSUnitValue

Legend