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

View in English Always switch to English

opacity

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨Juli 2015⁩.

Die opacity CSS Eigenschaft legt die Deckkraft eines Elements fest. Deckkraft ist das Maß, in dem Inhalte hinter einem Element verborgen sind, und ist das Gegenteil von Transparenz.

Probieren Sie es aus

opacity: 0;
opacity: 0.33;
opacity: 1;
<section class="default-example" id="default-example">
  <p id="example-element">
    London. Michaelmas term lately over, and the Lord Chancellor sitting in
    Lincoln's Inn Hall. Implacable November weather. As much mud in the streets
    as if the waters had but newly retired from the face of the earth, and it
    would not be wonderful to meet a Megalosaurus, forty feet long or so,
    waddling like an elephantine lizard up Holborn Hill.
  </p>
</section>
#example-element {
  background-color: #963770;
  color: white;
  padding: 1em;
}

Syntax

css
opacity: 0.9;
opacity: 90%;

/* Global values */
opacity: inherit;
opacity: initial;
opacity: revert;
opacity: revert-layer;
opacity: unset;

Werte

<alpha-value>

Eine <number> im Bereich von 0.0 bis 1.0, inklusive, oder ein <percentage> im Bereich von 0% bis 100%, inklusive, die die Deckkraft des Kanals darstellen (das heißt, den Wert seines Alphakanals). Jeder Wert außerhalb des Intervalls ist zwar gültig, wird jedoch auf das nächstliegende Limit im Bereich begrenzt.

Wert Bedeutung
0 Das Element ist vollständig transparent (d.h. unsichtbar).
Jeder <number> strikt zwischen 0 und 1 Das Element ist durchscheinend (d.h. Inhalte hinter dem Element sind sichtbar).
1 (Standardwert) Das Element ist vollständig opak (visuell solide).

Beschreibung

opacity gilt für das gesamte Element, einschließlich seiner Inhalte, auch wenn der Wert nicht von Kindelementen geerbt wird. Daher haben das Element und seine Kinder alle die gleiche Deckkraft relativ zum Hintergrund des Elements, selbst wenn sie unterschiedliche Deckkräfte relativ zueinander haben.

Um die Deckkraft nur eines Hintergrunds zu ändern, verwenden Sie die background Eigenschaft mit einem Farbwert, der einen Alphakanal zulässt. Zum Beispiel:

css
background: rgb(0 0 0 / 40%);

Wenn der opacity-Wert auf 0 gesetzt ist, erscheinen das Element und alle seine Kinder unsichtbar, sind aber weiterhin Teil des DOM. Das bedeutet, dass sie weiterhin Zeigerereignisse registrieren und, wenn die Elemente in einer Tabulatorreihenfolge sind, sie den Fokus erhalten. Zur guten Benutzerfreundlichkeit, stellen Sie sicher, dass solche Elemente sichtbar werden, wenn sie Benutzerinteraktionen erhalten, oder verwenden Sie die CSS pointer-events Eigenschaft, um Zeigerereignisse zu deaktivieren und das Element aus der Tabulatorreihenfolge zu entfernen, indem Sie das Attribut disabled deaktivieren oder tab-index="-1" für nicht formularbezogene interaktive Elemente setzen.

Die Verwendung von opacity mit einem anderen Wert als 1 platziert das Element in einem neuen Stapelfluss.

Allein Deckkraft sollte nicht verwendet werden, um Informationen für Screenreader bereitzustellen. Verwenden Sie das HTML hidden Attribut, CSS visibility, oder CSS display Stil-Eigenschaften. Am besten ist es, die Verwendung des aria-hidden Attributs zu vermeiden, aber wenn das Element mit Deckkraft verborgen ist, dann verbergen Sie es auch vor Screenreadern.

Übergang der Deckkraft

Beim Übergang der Deckkraft von Elementen, wenn sie zur Seite hinzugefügt werden, wenn der Inhalt zuvor mit visibility: hidden, display: none oder content-visibility: hidden verborgen war, müssen Sie sowohl ein @starting-style als auch transition-behavior: allow-discrete einschließen:

css
.card {
  transition:
    opacity 5s,
    display 5s;
  background-color: orange;

  transition-behavior: allow-discrete;
  @starting-style {
    opacity: 0;
  }
}

.card.hidden {
  display: none;
  opacity: 0;
}

Um Übergänge im ersten Stil zu ermöglichen, sind @starting-style Regeln erforderlich. Im obigen Code bietet das Setzen von opacity: 0 im @starting-style einen Ausgangspunkt für den Übergang, wenn das Element seine anfängliche Stilaktualisierung erhält. Weitere Details finden Sie unter @starting-style.

Das Setzen von transition-behavior: allow-discrete ist erforderlich, um den Übergang zu display: none zu ermöglichen. Weitere Details finden Sie bei der transition-behavior Eigenschaft.

Barrierefreiheit

Wenn die Deckkraft von Text angepasst wird, ist es wichtig sicherzustellen, dass das Kontrastverhältnis zwischen der Farbe des Textes und dem Hintergrund, über dem der Text platziert ist, hoch genug ist, damit Menschen mit Sehschwäche in der Lage sind, den Inhalt der Seite zu lesen.

Das Farbkontrastverhältnis wird ermittelt, indem die Helligkeit der deckkraftangepassten Text- und Hintergrundfarben verglichen wird. Um die aktuellen Web Content Accessibility Guidelines (WCAG) zu erfüllen, ist ein Verhältnis von 4.5:1 für Textinhalt und 3:1 für größeren Text wie Überschriften erforderlich. Großer Text wird definiert als 18.66px und fett oder größer, oder 24px oder größer.

Verschiedene Betriebssysteme bieten eine Präferenz für die Reduzierung von Transparenz. Um die opacity basierend auf den Transparenzeinstellungen des Betriebssystems des Nutzers einzustellen, verwenden Sie die prefers-reduced-transparency Media Query.

Formale Definition

Anfangswert1
Anwendbar aufalle Elemente
VererbtNein
Prozentwertemap to the range [0,1]
Berechneter WertDerselbe wie der angegebene Wert nachdem die <number> auf den Bereich [0.0, 1.0] zugeschnitten wurde.
Animationstypby computed value type

Formale Syntax

opacity = 
<opacity-value>

<opacity-value> =
<number> |
<percentage>

Beispiele

Festlegen der Deckkraft

Das folgende Beispiel zeigt, wie die opacity Eigenschaft die Deckkraft des gesamten Elements und Inhalts verändert, wodurch der Text sehr schwer lesbar wird.

HTML

html
<div class="light">You can barely see this.</div>
<div class="medium">This is easier to see.</div>
<div class="heavy">This is very easy to see.</div>

CSS

css
div {
  background-color: yellow;
  font-weight: bold;
  font-size: 130%;
}
.light {
  opacity: 0.2; /* Barely see the text over the background */
}
.medium {
  opacity: 0.5; /* See the text more clearly over the background */
}
.heavy {
  opacity: 0.9; /* See the text very clearly over the background */
}

Ergebnis

Festlegen der Deckkraft beim Hovern

Im folgenden Beispiel wird die Deckkraft beim Hovern geändert, sodass das gestreifte Hintergrundbild des übergeordneten Elements durch das Bild hindurch sichtbar wird.

HTML

html
<div class="wrapper">
  <img
    src="/shared-assets/images/examples/dino.svg"
    alt="MDN Dino"
    width="128"
    height="146"
    class="opacity" />
</div>

CSS

css
img.opacity {
  opacity: 1;
}

img.opacity:hover {
  opacity: 0.5;
}

.wrapper {
  width: 200px;
  height: 160px;
  background-color: #f03cc3;
  background-image: linear-gradient(
    90deg,
    transparent 50%,
    rgb(255 255 255 / 50%) 50%
  );
  background-size: 20px 20px;
}

Ergebnis

Styling basierend auf Benutzereinstellungen

Um Elemente basierend auf den Transparenzeinstellungen des Betriebssystems des Benutzers zu stylen, verwenden Sie die prefers-reduced-transparency Media Query. Das folgende Beispiel zeigt, wie die prefers-color-scheme Media Query verwendet wird, um die gewünschte opacity basierend auf den Präferenzen des Benutzers festzulegen.

css
.element {
  opacity: 0.5;
}

@media (prefers-reduced-transparency) {
  .element {
    opacity: 1;
  }
}

Spezifikationen

Specification
CSS Color Module Level 4
# propdef-opacity
Scalable Vector Graphics (SVG) 2
# ObjectAndGroupOpacityProperties

Browser-Kompatibilität

Siehe auch