Thuộc tính toàn cục HTML dir

Thuộc tính toàn cục dir global attribute là thuộc tính enumerated cho biết hướng của văn bản trong phần tử.

Try it

<p dir="rtl">
  This paragraph is in English but incorrectly goes right to left.
</p>
<p dir="ltr">This paragraph is in English and correctly goes left to right.</p>

<hr />

<p>هذه الفقرة باللغة العربية ولكن بشكل خاطئ من اليسار إلى اليمين.</p>
<p dir="auto">
  هذه الفقرة باللغة العربية ، لذا يجب الانتقال من اليمين إلى اليسار.
</p>

Nó có thể có các giá trị sau:

  • ltr, có nghĩa là từ trái sang phải và được dùng cho các ngôn ngữ được viết từ trái sang phải (như tiếng Anh);
  • rtl, có nghĩa là từ phải sang trái và được dùng cho các ngôn ngữ được viết từ phải sang trái (như tiếng Ả Rập);
  • auto, để user agent tự quyết định. Nó dùng thuật toán cơ bản khi phân tích cú pháp các ký tự bên trong phần tử cho đến khi tìm thấy ký tự có hướng mạnh, sau đó áp dụng hướng đó cho toàn bộ phần tử.

Note: Giá trị auto nên được dùng cho dữ liệu có hướng không xác định, như dữ liệu đến từ đầu vào người dùng hoặc dữ liệu bên ngoài.

Nếu không được chỉ định, giá trị được kế thừa từ phần tử cha.

Thuộc tính này có thể bị ghi đè bởi các thuộc tính CSS directionunicode-bidi, nếu một trang CSS đang hoạt động và phần tử hỗ trợ các thuộc tính này.

Vì hướng của văn bản có liên quan ngữ nghĩa với nội dung của nó chứ không phải với cách trình bày của nó, khuyến nghị các nhà phát triển web dùng thuộc tính này thay vì các thuộc tính CSS liên quan khi có thể. Theo cách đó, văn bản sẽ hiển thị chính xác ngay cả trên trình duyệt không hỗ trợ CSS hoặc có CSS bị tắt.

Kế thừa

Nếu một phần tử không có thuộc tính dir, nó sẽ kế thừa giá trị dir được đặt trên node cha của nó, mà lần lượt có thể kế thừa từ cha của nó, v.v.

Ghi chú sử dụng

Một hình ảnh có thể có thuộc tính dir được đặt thành "rtl" trong đó các thuộc tính HTML titlealt sẽ được định dạng và xác định là "rtl".

Khi bảng có dir được đặt thành "rtl", thứ tự cột được sắp xếp từ phải sang trái.

Thuộc tính này là bắt buộc đối với phần tử <bdo> nơi nó có ý nghĩa ngữ nghĩa khác.

Thuộc tính này không được kế thừa bởi phần tử <bdi>. Nếu không được đặt, giá trị của nó là auto.

Các trình duyệt có thể cho phép người dùng thay đổi hướng của các phần tử <input><textarea> để hỗ trợ việc tạo nội dung. Chrome và Safari cung cấp tùy chọn hướng trong menu ngữ cảnh của các trường input. Firefox dùng Ctrl (Windows)/Cmd (macOS) + Shift + X bên trong <textarea> để chuyển đổi hướng văn bản. Các tính năng này chuyển đổi giá trị thuộc tính dir giữa ltrrtl.

Đặc tả

Specification
HTML
# the-dir-attribute

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

Xem thêm