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-Eigenschaft CSS legt die Deckkraft eines Elements fest. Deckkraft ist der Grad, zu 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
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 von0.0bis einschließlich1.0oder ein<percentage>im Bereich von0%bis einschließlich100%, das die Deckkraft des Kanals darstellt (das heißt, den Wert seines Alphakanals). Jeder Wert außerhalb des Intervalls wird, obwohl er gültig ist, auf das nächstgelegene Limit im Bereich begrenzt.Wert Bedeutung 0Das Element ist vollständig transparent (d.h. unsichtbar). Jede <number>strikt zwischen0und1Das Element ist durchscheinend (d.h. Inhalte hinter dem Element sind sichtbar). 1(Standardwert)Das Element ist vollständig undurchsichtig (visuell solide).
Beschreibung
opacity gilt für das gesamte Element, einschließlich seiner Inhalte, obwohl der Wert nicht von Kindelementen geerbt wird. Daher haben das Element und seine Kinder dieselbe Deckkraft relativ zum Hintergrund des Elements, selbst wenn sie unterschiedliche Deckkräfte zueinander aufweisen.
Um die Deckkraft nur eines Hintergrunds zu ändern, verwenden Sie die background-Eigenschaft mit einem Farbwert, der einen Alphakanal ermöglicht. Zum Beispiel:
background: rgb(0 0 0 / 40%);
Wenn der opacity-Wert auf 0 gesetzt ist, erscheinen das Element und alle seine Kinder unsichtbar, sind aber immer noch Teil des DOM. Das bedeutet, dass sie weiterhin Pointevents registrieren und, falls sich die Elemente in einer Tabulatorreihenfolge befinden, sie Fokus erhalten. Für gute Benutzerfreundlichkeit stellen Sie sicher, dass solche Elemente sichtbar werden, wenn sie Nutzereingaben erhalten, oder verwenden Sie die CSS-Eigenschaft pointer-events, um Pointevents zu deaktivieren und das Element aus der Tab-Reihenfolge zu entfernen, indem Sie es mit dem disabled-Attribut deaktivieren oder tabindex="-1" für nicht formularbezogene interaktive Elemente setzen.
Die Verwendung von opacity mit einem anderen Wert als 1 platziert das Element in einem neuen stapelnden Kontext.
Deckkraft allein sollte nicht verwendet werden, um Bildschirmlesegeräten Informationen bereitzustellen. Verwenden Sie das HTML-Attribut hidden, die CSS-Eigenschaften visibility oder display. Es ist am besten, die Verwendung des Attributs aria-hidden zu vermeiden, aber wenn das Element mit Deckkraft versteckt ist, dann verstecken Sie es auch vor Bildschirmlesegeräten.
Übergang der Deckkraft
Beim Übergang der Deckkraft von Elementen, wenn Sie sie der Seite hinzufügen, nachdem Inhalte zuvor mit visibility: hidden, display: none oder content-visibility: hidden versteckt wurden, müssen sowohl ein @starting-style als auch transition-behavior: allow-discrete enthalten sein:
.card {
transition:
opacity 5s,
display 5s;
background-color: orange;
transition-behavior: allow-discrete;
@starting-style {
opacity: 0;
}
}
.card.hidden {
display: none;
opacity: 0;
}
Um Erststil-Übergänge zu aktivieren, 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. Für weitere Details siehe @starting-style.
Das Festlegen von transition-behavior: allow-discrete ist erforderlich, um zu display: none zu wechseln. Weitere Details finden Sie in 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 Personen mit Sehbehinderungen den Inhalt der Seite lesen können.
Das Kontrastverhältnis wird ermittelt, indem die Leuchtkraft der deckkraftangepassten Text- und Hintergrundfarbenwerte verglichen wird. Um den aktuellen Richtlinien für barrierefreie Webinhalte (WCAG) zu entsprechen, ist ein Verhältnis von 4,5:1 für Textinhalte und 3:1 für größere Texte wie Überschriften erforderlich. Großer Text ist als 18,66px und fett oder größer oder 24px oder größer definiert.
- WebAIM: Color Contrast Checker
- MDN Understanding WCAG, Guideline 1.4 explanations
- Understanding Success Criterion 1.4.3 | W3C Understanding WCAG 2.0
Verschiedene Betriebssysteme bieten eine Präferenz zur Reduzierung der Transparenz. Um die opacity basierend auf den Transparenzpräferenzen des Betriebssystems des Nutzers festzulegen, verwenden Sie die Medienabfrage prefers-reduced-transparency.
Formale Definition
| Anfangswert | 1 |
|---|---|
| Anwendbar auf | alle Elemente |
| Vererbt | Nein |
| Prozentwerte | map to the range [0,1] |
| Berechneter Wert | Derselbe wie der angegebene Wert nachdem die <number> auf den Bereich [0.0, 1.0] zugeschnitten wurde. |
| Animationstyp | by computed value type |
Formale Syntax
opacity =
<opacity-value>
<opacity-value> =
<number> |
<percentage>
Beispiele
>Deckkraft einstellen
Das folgende Beispiel zeigt, wie die opacity-Eigenschaft die gesamte Deckkraft des Elements und des Inhalts ändert, wodurch der Text sehr schwer lesbar wird.
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
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
Deckkraft beim Hover ändern
Im folgenden Beispiel wird die Deckkraft beim Hover geändert, sodass das gestreifte Hintergrundbild im übergeordneten Element durch das Bild hindurchscheint.
HTML
<div class="wrapper">
<img
src="/shared-assets/images/examples/dino.svg"
alt="MDN Dino"
width="128"
height="146"
class="opacity" />
</div>
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
Stil basierend auf Benutzerpräferenzen
Um Elemente basierend auf Transparenzpräferenzen des Betriebssystems des Benutzers zu gestalten, verwenden Sie die Medienabfrage prefers-reduced-transparency. Das folgende Beispiel zeigt, wie die Medienabfrage prefers-color-scheme verwendet wird, um die gewünschte opacity basierend auf den Benutzerpräferenzen zu spezifizieren.
.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
prefers-reduced-transparencyMedienabfrage- CSS color Modul
- SVG
opacityAttribut