Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

CSSMathClamp: CSSMathClamp()-Konstruktor

Eingeschränkt verfügbar

Diese Funktion ist nicht Baseline, da sie in einigen der am weitesten verbreiteten Browser nicht funktioniert.

Want more browser support for this feature? Tell us why.

Hinweis: Diese Funktion ist in Web Workers verfügbar.

Der CSSMathClamp()-Konstruktor erstellt ein neues CSSMathClamp-Objekt, das eine CSS-clamp()-Funktion darstellt.

Syntax

js
new CSSMathClamp(lower, value, upper)

Parameter

lower

Eine Zahl oder ein CSSNumericValue, das den minimalen Wert darstellt.

value

Eine Zahl oder ein CSSNumericValue, das den bevorzugten Wert darstellt.

upper

Eine Zahl oder ein CSSNumericValue, das den maximalen Wert darstellt.

Ausnahmen

TypeError

Wird ausgelöst, wenn die Parameter widersprüchliche Einheitstypen haben. Zum Beispiel das Mischen eines Längenwertes mit einem Zeitwert.

Beispiele

Grundlegende Verwendung

Der folgende Code erstellt eine CSSMathClamp-Instanz aus drei Längen und liest dann die Eigenschaften lower, value und upper aus.

js
const clamp = new CSSMathClamp(CSS.px(10), CSS.percent(50), CSS.px(500));

console.log(clamp.constructor.name); // "CSSMathClamp"
console.log(clamp.lower); // CSSUnitValue {value: 10, unit: "px"}
console.log(clamp.value); // CSSUnitValue {value: 50, unit: "percent"}
console.log(clamp.upper); // CSSUnitValue {value: 500, unit: "px"}

Umgang mit inkompatiblen Typen

Der Konstruktor löst einen TypeError aus, wenn die drei Argumente keinen kompatiblen Typ ergeben. Im folgenden Code wird eine Länge mit einer Zeit gemischt und der Fehler wird protokolliert.

js
try {
  // Mixes a length (px) with a time (s): incompatible types
  new CSSMathClamp(CSS.px(10), CSS.s(2), CSS.px(500));
} catch (e) {
  console.log(e instanceof TypeError); // true
  console.log(e.message);
}

Spezifikationen

Spezifikation
CSS Typed OM Level 1
# dom-cssmathclamp-cssmathclamp

Browser-Kompatibilität