HTMLElement.dir

Baseline Widely available

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

HTMLElement.dir 属性用于获取或设置当前元素的元素内容的文本书写方向。

元素的文本书写方向性是指该文本呈现的方向（用于支持不同的语言系统）。阿拉伯语言和希伯来语是典型的使用 RTL 方向性的语言。

图片可以将其 dir 属性设置为“rtl”，在这种情况下，HTML 属性 title 和 alt 将被格式化并定义为“rtl”。

当表格的 dir 设置为“rtl”时，列是从右到左排列的。

当一个元素的 dir 设置为“auto”时，该元素的方向是根据其第一个强方向性字符决定的，或者默认为其父元素的方向性。

备注： 浏览器可能允许用户改变 <input> 和 <textarea> 的方向性，以协助编写内容。Chrome 和 Safari 在输入字段的上下文菜单中提供方向性选项，而 Internet Explorer 和 Edge 使用组合键 Ctrl + 左 Shift 和 Ctrl + 右 Shift。Firefox 使用组合键 Ctrl/Cmd + Shift + X，但不更新 dir 属性值。

值

下列值的其中一个：

  • ltr，表示从左到右；
  • rtl，表示从右到左；
  • auto，表示元素的方向必须根据元素的内容来确定。

示例

js
const parg = document.getElementById("para1");
parg.dir = "rtl";
// 改变 ID 为“para1”的元素内容的文本书写方向。

规范

Specification
HTML Standard
# dom-dir

浏览器兼容性

BCD tables only load in the browser

参见