image-orientation

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since April 2020.

Thuộc tính CSS image-orientation xác định một chỉnh sửa độc lập với bố cục đối với hướng của một hình ảnh.

Try it

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;
}

Cú pháp

css
/* Giá trị từ khóa */
image-orientation: none;
image-orientation: from-image; /* Dùng dữ liệu EXIF từ hình ảnh */

/* Giá trị toàn cục */
image-orientation: inherit;
image-orientation: initial;
image-orientation: revert;
image-orientation: revert-layer;
image-orientation: unset;

Giá trị

none

Không áp dụng xoay hình ảnh bổ sung nào; hình ảnh được định hướng theo cách đã mã hóa hoặc theo các giá trị thuộc tính CSS khác quy định.

from-image

Giá trị ban đầu mặc định. Thông tin EXIF chứa trong hình ảnh được dùng để xoay hình ảnh cho phù hợp.

Warning: image-orientation: none; không ghi đè hướng của các hình ảnh từ nguồn gốc không an toàn được mã hóa bởi thông tin EXIF của chúng, do lo ngại về bảo mật. Tìm hiểu thêm từ bản nháp vấn đề của nhóm làm việc CSS.

Mô tả

Thuộc tính này chỉ được dùng duy nhất cho mục đích chỉnh sửa hướng của các hình ảnh được chụp khi camera bị xoay. Không nên dùng nó cho các phép xoay tùy ý. Đối với bất kỳ mục đích nào khác ngoài việc chỉnh sửa hướng của hình ảnh do cách chụp hoặc quét, hãy dùng thuộc tính transform với từ khóa rotate để chỉ định phép xoay. Điều này bao gồm bất kỳ thay đổi nào về hướng hình ảnh do người dùng chỉ đạo, hoặc các thay đổi cần thiết để in theo chiều dọc so với chiều ngang.

Nếu được dùng kết hợp với các thuộc tính CSS khác, chẳng hạn như <transform-function>, bất kỳ phép xoay image-orientation nào sẽ được áp dụng trước bất kỳ phép biến đổi nào khác.

Định nghĩa hình thức

Initial valuefrom-image
Applies toall elements
Inheritedyes
Computed valuean <angle>, rounded to the next quarter turn from 0deg and normalized, that is moduloing the value by 1turn
Animation typediscrete

Cú pháp hình thức

image-orientation = 
from-image |
none |
[ <angle> || flip ]

Ví dụ

Định hướng hình ảnh từ dữ liệu hình ảnh

Hình ảnh sau đây đã bị xoay 180 độ, và thuộc tính image-orientation được dùng để chỉnh sửa hướng của nó dựa trên dữ liệu EXIF trong hình ảnh. Bằng cách thay đổi image-orientation thành none, bạn có thể thấy hiệu ứng của thuộc tính.

CSS

css
#image {
  image-orientation: from-image; /* Can be changed in the live sample */
}

Kết quả

Đặc tả kỹ thuật

Specification
CSS Images Module Level 3
# the-image-orientation

Tương thích trình duyệt

Xem thêm