image-orientation CSS property
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit April 2020 browserübergreifend verfügbar.
Die image-orientation CSS Eigenschaft spezifiziert eine layoutunabhängige Korrektur der Ausrichtung eines Bildes.
Probieren Sie es aus
image-orientation: none;
image-orientation: from-image;
<section id="default-example">
<img
class="transition-all"
id="example-element"
src="/shared-assets/images/examples/hummingbird.jpg" />
</section>
#example-element {
height: inherit;
}
Syntax
/* keyword values */
image-orientation: none;
image-orientation: from-image; /* Use EXIF data from the image */
/* Global values */
image-orientation: inherit;
image-orientation: initial;
image-orientation: revert;
image-orientation: revert-layer;
image-orientation: unset;
Werte
none-
Wendet keine zusätzliche Bilddrehung an; das Bild wird so ausgerichtet, wie es kodiert ist oder wie es andere CSS-Eigenschaftswerte vorgeben.
from-image-
Standardanfangswert. Die im Bild enthaltenen EXIF-Informationen werden verwendet, um das Bild entsprechend zu drehen.
Warnung:
image-orientation: none; überschreibt nicht die Ausrichtung von Bildern ohne sichere Herkunft, wie sie von ihren EXIF-Informationen kodiert ist, aus Sicherheitsgründen. Erfahren Sie mehr im Entwurfsthema der CSS-Arbeitsgruppe.
Beschreibung
Diese Eigenschaft ist ausschließlich dazu gedacht, die Ausrichtung von Bildern zu korrigieren, die mit gedrehter Kamera aufgenommen wurden. Sie sollte nicht für willkürliche Drehungen verwendet werden. Für alle anderen Zwecke als die Korrektur der Ausrichtung eines Bildes aufgrund der Art und Weise, wie es aufgenommen oder gescannt wurde, verwenden Sie die transform-Eigenschaft mit dem Schlüsselwort rotate, um die Drehung zu spezifizieren. Dies schließt alle benutzergesteuerten Änderungen der Ausrichtung des Bildes ein oder Änderungen, die für den Druck im Hoch- versus Querformat erforderlich sind.
Wenn diese Eigenschaft in Verbindung mit anderen CSS-Eigenschaften wie einer <transform-function> verwendet wird, wird die image-orientation-Drehung vor allen anderen Transformationen angewendet.
Formale Definition
| Anfangswert | from-image |
|---|---|
| Anwendbar auf | alle Elemente |
| Vererbt | Ja |
| Berechneter Wert | ein <angle>, auf den nächsten Viertel von 0deg gerundet (üblicherweise 1turn) |
| Animationstyp | diskret |
Formale Syntax
image-orientation =
from-image |
none |
[ <angle> || flip ]
Beispiele
>Orientierung des Bildes basierend auf Bilddaten
Das folgende Bild wurde um 180 Grad gedreht, und die image-orientation-Eigenschaft wird verwendet, um ihre Ausrichtung basierend auf den EXIF-Daten im Bild zu korrigieren. Durch Ändern der image-orientation-Anzeige auf none können Sie die Wirkung der Eigenschaft sehen.
CSS
#image {
image-orientation: from-image; /* Can be changed in the live sample */
}
Ergebnis
Spezifikationen
| Spezifikation |
|---|
| CSS Images Module Level 3> # the-image-orientation> |
Browser-Kompatibilität
Siehe auch
- Andere bildbezogene CSS-Eigenschaften:
object-fit,object-position,image-rendering,image-resolution. transformundrotate