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

View in English Always switch to English

print-color-adjust CSS property

Baseline 2025
Neu verfügbar

Seit May 2025 funktioniert diese Funktion auf aktuellen Geräten und in aktuellen Browserversionen. Auf älteren Geräten oder in älteren Browsern funktioniert sie möglicherweise nicht.

Die print-color-adjust CSS Eigenschaft legt fest, was, wenn überhaupt, der User-Agent tun darf, um das Erscheinungsbild des Elements auf dem Ausgabegerät zu optimieren. Standardmäßig darf der Browser alle Anpassungen am Erscheinungsbild des Elements vornehmen, die er für notwendig und sinnvoll hält, je nach Art und Fähigkeiten des Ausgabegeräts.

Syntax

css
print-color-adjust: economy;
print-color-adjust: exact;

/* Global values */
print-color-adjust: inherit;
print-color-adjust: initial;
print-color-adjust: revert;
print-color-adjust: revert-layer;
print-color-adjust: unset;

Werte

Diese Eigenschaft wird durch einen der folgenden Schlüsselwörterwerte spezifiziert:

economy

Der User-Agent darf Anpassungen am Element vornehmen, die er für geeignet und sinnvoll hält, um die Ausgabe für das Gerät zu optimieren, für das es gerendert wird. Zum Beispiel könnte ein Browser beim Drucken darauf verzichten, alle Hintergrundbilder anzuzeigen, und die Textfarben anpassen, um sicherzustellen, dass der Kontrast für das Lesen auf weißem Papier optimiert ist. Dies ist der Standardwert.

exact

Der Inhalt des Elements wurde speziell und sorgfältig so gestaltet, dass Farben, Bilder und Stile in einer durchdachten und/oder wichtigen Weise verwendet werden, sodass eine Änderung durch den Browser eher zu einer Verschlechterung als zu einer Verbesserung führen könnte. Das Erscheinungsbild des Inhalts sollte nur auf Benutzeranfrage geändert werden. Zum Beispiel könnte eine Seite eine Liste von Informationen enthalten, deren Zeilenhintergrundfarben zwischen Weiß und einem hellen Grau wechseln. Das Entfernen der Hintergrundfarbe würde die Lesbarkeit des Inhalts verringern.

Verwendungshinweise

Es gibt mehrere Gründe, warum ein Browser von der angegebenen Darstellung abweichen möchte, wie zum Beispiel:

  • Der Inhalt verwendet Text- und Hintergrundfarben, die auf dem Ausgabegerät zu ähnlich sind, um leserlich zu sein.
  • Wenn das Ausgabegerät ein Drucker ist und um Tinte zu sparen, könnten dunkle oder extrem dichte Hintergrundbilder entfernt werden.
  • Beim Drucken einer Seite möchte der Browser möglicherweise hellfarbigen Text auf einem dunklen Hintergrund durch dunklen Text auf einem weißen Hintergrund ersetzen.

Alle Optionen, die der User-Agent dem Benutzer bietet, um die Verwendung von Farbe und Bildern zu kontrollieren, haben Vorrang vor dem Wert von print-color-adjust. Mit anderen Worten, es gibt keine Garantie, dass print-color-adjust etwas bewirkt. Nicht nur kann der Benutzer das Verhalten überschreiben, sondern auch jeder User-Agent darf für sich selbst entscheiden, wie print-color-adjust in einer bestimmten Situation gehandhabt wird.

Formale Definition

Anfangswerteconomy
Anwendbar aufalle Elemente
VererbtJa
Berechneter Wertwie angegeben
Animationstypdiskret

Formale Syntax

print-color-adjust = 
economy |
exact

Beispiele

Erhaltung von geringem Kontrast

In diesem Beispiel wird ein Kasten gezeigt, der eine background-image und eine durchsichtige linear-gradient() Funktion über einer schwarzen Hintergrundfarbe verwendet, um einen dunkelblauen Verlauf hinter einem mittleren roten Text zu haben. Aus welchen Gründen auch immer, dies ist das gewünschte Erscheinungsbild in jeder Renderumgebung, einschließlich auf Papier, daher verwenden wir auch print-color-adjust: exact, um dem Browser zu sagen, dass er keine Farb- oder Stiländerungen am Kasten vornehmen soll, wenn er ihn rendert.

CSS

css
.my-box {
  background-color: black;
  background-image: linear-gradient(rgb(0 0 180 / 50%), rgb(70 140 220 / 50%));
  color: #990000;
  width: 15rem;
  height: 6rem;
  text-align: center;
  font:
    24px "Helvetica",
    sans-serif;
  display: flex;
  align-items: center;
  justify-content: center;
  print-color-adjust: exact;
}

HTML

html
<div class="my-box">
  <p>Need more contrast!</p>
</div>

Ergebnis

Spezifikationen

Spezifikation
CSS Color Adjustment Module Level 1
# propdef-print-color-adjust

Browser-Kompatibilität

Siehe auch