CSS Typed Object Model API
The CSSMathMax interface of the CSS Typed Object Model API represents the CSS max function.
Constructor
- CSSMathMax.CSSMathMax
- : Creates a new
CSSMathMaxobject.
- : Creates a new
Instance properties
Also inherits properties from its parent interface, CSSMathValue.
- CSSMathMax.values
- : Returns a CSSNumericArray object which contains one or more CSSNumericValue objects.
Static methods
Also inherits methods from its parent interface, CSSMathValue.
Instance methods
Also inherits methods from its parent interface, CSSMathValue.
Description
The CSS max function takes one or more comma-separated values as arguments and returns the largest of them.
If all arguments are absolute values, such as pixel lengths, max() is resolved to a single value at parse time, represented by the CSS Typed Object Model as a CSSUnitValue.
If the max() expression can't be resolved to a single value at parse time (say, because one of its arguments uses a relative unit like vw or %), the function is represented as a CSSMathMax object, and the arguments passed to max() (or to the CSSMathMax() constructor) are exposed as the values property.
Note that CSSMathMax represents the max() function, not its resolved value.
In order to determine the value of a property using max(), you need to read its computed style (for example with Window.getComputedStyle).
Examples
Basic usage
The following code creates a CSSMathMax instance from three values, then reads back its operator and values properties.
const max = new CSSMathMax(CSS.px(10), CSS.em(5), CSS.percent(50));
console.log(max.constructor.name); // "CSSMathMax"
console.log(max.operator); // 'max'
console.log(max.values); // CSSNumericArray {0: CSSUnitValue, 1: CSSUnitValue, 2: CSSUnitValue, length: 3}
console.log(max.values[0]); // CSSUnitValue {value: 10, unit: "px"}
max() representations
This example shows how max is represented by a CSSUnitValue or a CSSMathMax, depending on whether all of its arguments are absolute values.
HTML
<div id="demoBox">Text</div>
<pre id="log"></pre>
CSS
width is set using a max() whose arguments are all absolute lengths, so the browser can resolve it to a single fixed value immediately.
font-size is set using a max() where one argument uses the relative unit vw, so the browser can't resolve it until layout (this will be represented by a CSSMathMax).
#demoBox {
width: max(10px, 50px);
font-size: max(1rem, 5vw);
}
#log {
height: 200px;
overflow: scroll;
padding: 0.5rem;
border: 1px solid black;
}
JavaScript
const logElement = document.querySelector("#log");
function log(text) {
logElement.innerText += `${text}\n`;
}
First we find the demo box's style rule and read its width and font-size values using CSSStyleRule.styleMap.
const demoBox = document.querySelector("#demoBox");
const rules = document.getElementById("css-output").sheet.cssRules;
const rule = [...rules].find((r) => r.selectorText === "#demoBox");
const styleMap = rule.styleMap;
const width = styleMap.get("width");
const fontSize = styleMap.get("font-size");
We then log the type and value of the CSS Typed OM representations, followed by the computed (resolved) values.
log("width");
log(` type: ${width.constructor.name}`);
log(` value: ${width}`);
log(` resolved: ${getComputedStyle(demoBox).width}`);
log("\nfont-size");
log(` type: ${fontSize.constructor.name}`);
log(` values: [${[...fontSize.values].join(", ")}]`);
log(` resolved: ${getComputedStyle(demoBox).fontSize}`);
Result
width is represented by a CSSUnitValue object, which has a value that matches the resolved width.
font-size is represented by a CSSMathMax object that exposes the max() function's original operands.
max() representations
Specifications
Browser compatibility
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
