Die CSS-Eigenschaft background
Baseline
Weitgehend verfügbar
*
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Juli 2015 browserübergreifend verfügbar.
* Einige Teile dieser Funktion werden möglicherweise unterschiedlich gut unterstützt.
Die CSS-Kurzschreibweise background legt alle Eigenschaften für die Hintergrundgestaltung auf einmal fest, darunter Farbe, Bild, Ursprung, Größe und Wiederholungsmethode.
Probieren Sie es aus
background: green;
background: content-box radial-gradient(crimson, skyblue);
background: no-repeat url("/shared-assets/images/examples/lizard.png");
background: left 5% / 15% 60% repeat-x
url("/shared-assets/images/examples/star.png");
background:
center / contain no-repeat
url("/shared-assets/images/examples/firefox-logo.svg"),
#eeeeee 35% url("/shared-assets/images/examples/lizard.png");
<section id="default-example">
<div id="example-element"></div>
</section>
#example-element {
min-width: 100%;
min-height: 100%;
padding: 10%;
}
Zusammengefasste Eigenschaften
Diese Eigenschaft ist eine Kurzschreibweise für die folgenden CSS-Eigenschaften:
Nur zurückgesetzte Untereigenschaften
Diese Eigenschaft setzt die folgenden CSS-Eigenschaften auf ihre Anfangswerte zurück:
Syntax
/* Using a <background-color> */
background: green;
/* Using a <bg-image> and <repeat-style> */
background: url("test.jpg") repeat-y;
/* Using a <visual-box> and <'background-color'> */
background: border-box red;
/* A single image, centered and scaled */
background: no-repeat center/80% url("../img/image.png");
/* Global values */
background: inherit;
background: initial;
background: revert;
background: revert-layer;
background: unset;
Werte
<attachment>-
Siehe
background-attachment. Standardwert:scroll. <visual-box>-
Siehe
background-clipundbackground-origin. Standardwerte:border-boxbeziehungsweisepadding-box. <'background-color'>-
Siehe
background-color. Standardwert:transparent. <bg-image>-
Siehe
background-image. Standardwert:none. <bg-position>-
Siehe
background-position. Standardwert:0% 0%. <repeat-style>-
Siehe
background-repeat. Standardwert:repeat. <bg-size>-
Siehe
background-size. Standardwert:auto.
Beschreibung
Mit der Kurzschreibweise background können Sie alle CSS-Eigenschaften für den Hintergrund in einer einzigen Deklaration festlegen. Der Hintergrund liegt unter dem Inhalt eines Elements. Wenn Sie mehrere durch Kommas getrennte Hintergrundwerte angeben, bildet jeder Wert eine Hintergrundebene, die über den vorherigen Ebenen gezeichnet wird.
Die Eigenschaft background wird als eine oder mehrere durch Kommas getrennte Hintergrundebenen angegeben. Jede Ebene kann null, eine oder zwei <visual-box>-Komponenten sowie jeweils null oder eine <attachment>-, <bg-image>-, <bg-position>-, <bg-size>- und <repeat-style>-Komponente enthalten. Werden zwei <bg-position>-, <bg-size>- oder <repeat-style>-Komponenten angegeben, ist der erste Wert der horizontale und der zweite der vertikale Wert. Wird nur ein Wert angegeben, gilt er für beide Dimensionen.
Die Komponente <'background-color'> darf nur in der letzten angegebenen Hintergrundebene enthalten sein.
Komponenteneigenschaften, die in der Wertdeklaration der Kurzschreibweise background nicht festgelegt werden, erhalten ihre Standardwerte.
Reihenfolge der Komponenteneigenschaften
Da einige Komponenteneigenschaften dieselben Werttypen verwenden, ist ihre Reihenfolge innerhalb der Kurzschreibweise wichtig.
Der Wert <bg-size> darf nur unmittelbar nach <bg-position> stehen, getrennt durch das Zeichen /. Beispielsweise bedeutet 10px 10px / 80% 80%, dass das Hintergrundbild 80% der Höhe und Breite des Elements einnimmt und jeweils 10px vom oberen und linken Rand der oberen linken Ecke des Elements entfernt positioniert wird. Wenn innerhalb von <bg-position> beide Werte Längen sind oder ein Wert eine Länge und der andere center ist, bezieht sich der erste Wert auf die horizontale und der zweite auf die vertikale Position.
Jede Hintergrundebene kann null, einen oder zwei <visual-box>-Werte enthalten. Ist nur ein Wert vorhanden, legt er sowohl background-origin als auch background-clip fest. Sind zwei Werte vorhanden, bestimmt der erste background-origin und der zweite background-clip. Sind keine <visual-box>-Werte vorhanden, ist der Standardwert für background-origin padding-box und für background-clip border-box.
Für die anderen Hintergrundeigenschaften ist keine bestimmte Reihenfolge vorgeschrieben. Aus Gründen der Einheitlichkeit und Lesbarkeit wird jedoch die folgende Reihenfolge empfohlen. Beachten Sie, dass keiner der Werte erforderlich ist:
<bg-image> <bg-position> / <bg-size> <repeat-style> <attachment> <bg-clip> <bg-origin> <'background-color'>
Das folgende background legt alle Standardwerte ausdrücklich in dieser Reihenfolge fest:
background: none 0% 0% / auto auto repeat scroll border-box padding-box
transparent;
Die folgenden drei CSS-Zeilen sind mit der obigen Deklaration gleichwertig, obwohl sich die Reihenfolge unterscheidet:
background: none;
background: transparent;
background: repeat scroll 0% 0% / auto padding-box border-box none transparent;
Zeichenreihenfolge der Bilder
Wenn mehrere durch Kommas getrennte Hintergründe angegeben werden, bilden sie mehrere übereinanderliegende Hintergrundebenen. Der erste Hintergrund in der Liste bildet die oberste Ebene. Enthält diese Ebene keine transparenten Bereiche, ist sie die einzige sichtbare Ebene.
Die letzte Ebene ist die unterste. Die Hintergrundfarbe ist immer Teil dieser Ebene.
Body-Hintergrund für das gesamte Dokument
Wenn der berechnete Wert von background-image für das <html>-Element :root none ist und sein background-color-Wert transparent ist, überträgt der Browser die auf dem <body>-Element festgelegten background-Stile auf :root und behandelt <body> so, als wäre background: initial festgelegt. Anders ausgedrückt: Das <html>-Element erhält alle auf dem <body>-Element festgelegten background-Stile, während die Hintergrundeigenschaften des <body>-Elements auf ihre Anfangswerte gesetzt werden.
Aufgrund dieses Verhaltens empfehlen die Autoren der Spezifikation, die Hintergrundstile des Dokuments im Stilblock für body statt im Stilblock für html festzulegen. Beachten Sie jedoch, dass die Verwendung von Containment dieses Verhalten deaktiviert. Wenn die Eigenschaft contain entweder auf dem <html>- oder auf dem <body>-Element auf einen anderen Wert als none gesetzt ist, werden die Eigenschaft background und ihre einzelnen Komponenten nicht vom <body>-Element auf das Wurzelelement <html> übertragen.
Barrierefreiheit
Browser stellen assistiven Technologien keine besonderen Informationen über Hintergrundbilder bereit. Dies ist vor allem für Screenreader wichtig: Ein Screenreader kündigt ein Hintergrundbild nicht an und vermittelt den Nutzern daher keine Informationen darüber. Wenn das Bild Informationen enthält, die für das Verständnis des Gesamtzwecks der Seite wesentlich sind, sollten Sie diese im Dokument semantisch beschreiben.
Formale Definition
| Anfangswert | wie die jeweiligen Kurzschreibweisen:
|
|---|---|
| Anwendbar auf | alle Elemente. Auch anwendbar auf ::first-letter und ::first-line. |
| Vererbt | Nein |
| Prozentwerte | wie die jeweiligen Kurzschreibweisen:
|
| Berechneter Wert | wie die jeweiligen Kurzschreibweisen:
|
| Animationstyp | wie die jeweiligen Kurzschreibweisen:
|
Formale Syntax
background =
<bg-layer>#? , <final-bg-layer>
<bg-layer> =
<bg-image> ||
<bg-position> [ / <bg-size> ]? ||
<repeat-style> ||
<attachment> ||
<visual-box> ||
<bg-clip>
<final-bg-layer> =
<bg-image> ||
<bg-position> [ / <bg-size> ]? ||
<repeat-style> ||
<attachment> ||
<visual-box> ||
<bg-clip> ||
<'background-color'>
<bg-image> =
<image> |
none
<bg-position> =
<position> |
<position-three>
<bg-size> =
[ <length-percentage [0,∞]> | auto ]{1,2} |
cover |
contain
<repeat-style> =
repeat-x |
repeat-y |
repeat-block |
repeat-inline |
<repetition>{1,2}
<attachment> =
scroll |
fixed |
local
<visual-box> =
content-box |
padding-box |
border-box
<bg-clip> =
<visual-box> |
[ border-area || text ]
<background-color> =
<color>
<image> =
<url> |
<image()> |
<image-set()> |
<cross-fade()> |
<element()> |
<gradient>
<position> =
<position-one> |
<position-two> |
<position-four>
<position-three> =
[ left | center | right ] && [ [ top | bottom ] <length-percentage> ] |
[ [ left | right ] <length-percentage> ] && [ top | center | bottom ]
<length-percentage> =
<length> |
<percentage>
<repetition> =
repeat |
space |
round |
no-repeat
<image()> =
image( <image-tags>? [ <image-src>? , <color>? ]! )
<image-set()> =
image-set( <image-set-option># )
<cross-fade()> =
cross-fade( <cf-image># )
<element()> =
element( <id-selector> )
<position-one> =
left |
center |
right |
top |
bottom |
x-start |
x-end |
y-start |
y-end |
block-start |
block-end |
inline-start |
inline-end |
<length-percentage>
<position-two> =
[ left | center | right | x-start | x-end ] && [ top | center | bottom | y-start | y-end ] |
[ left | center | right | x-start | x-end | <length-percentage> ] [ top | center | bottom | y-start | y-end | <length-percentage> ] |
[ block-start | center | block-end ] && [ inline-start | center | inline-end ] |
[ start | center | end ]{2}
<position-four> =
[ [ left | right | x-start | x-end ] <length-percentage> ] && [ [ top | bottom | y-start | y-end ] <length-percentage> ] |
[ [ block-start | block-end ] <length-percentage> ] && [ [ inline-start | inline-end ] <length-percentage> ] |
[ [ start | end ] <length-percentage> ]{2}
<image-tags> =
ltr |
rtl
<image-src> =
<url> |
<string>
<image-set-option> =
[ <image> | <string> ] [ <resolution> || type( <string> ) ]?
<cf-image> =
[ <image> | <color> ] &&
<percentage [0,100]>?
<id-selector> =
<hash-token>
Beispiele
>Hintergründe mit Farbschlüsselwörtern und Bildern festlegen
HTML
<p class="top-banner">
Starry sky<br />
Twinkle twinkle<br />
Starry sky
</p>
<p class="warning">Here is a paragraph</p>
CSS
.warning {
background: pink;
}
.top-banner {
background: url("star-solid.gif") #9999ff repeat-y fixed;
}
Ergebnis
Spezifikationen
| Spezifikation |
|---|
| CSS Backgrounds and Borders Module Level 3> # background> |