大网数据广告活动
Web 标准与前端开发

HTML 属性:dirname

· 52CE 我爱测

**`dirname`** 属性描述了提交表单时元素文本内容的方向,可用于 textarea 元素和一些 input 类型。浏览器使用此属性值来决定用户输入的文本是从左到右,还是从右到左的。当使用此属性值时,元素的文本方向性值与作为字段名称的 `dirname` 属性值一起包含在表单提交数据中。

dirname 属性描述了提交表单时元素文本内容的方向,可用于 textarea 元素和一些 input 类型。浏览器使用此属性值来决定用户输入的文本是从左到右,还是从右到左的。当使用此属性值时,元素的文本方向性值与作为字段名称的 dirname 属性值一起包含在表单提交数据中。

使用说明

dirname 属性可用于任意 textarea 元素及 input/hidden、input/text、input/search、input/tel、input/url、input/email、input/password、input/submit、input/reset 或 input/button 这些类型的 input 元素。

提交数据的格式为 {dirname_value}={direction},其中 {dirname_value} 是 dirname 属性的值,{direction} 是文本的方向性值。例如,如果用户在具有 name="comment" 和 dirname="comment-direction" 的元素中输入“Hello”,则 GET 请求的 URL 编码的表单提交数据将为 comment=Hello&comment-direction=ltr。方向性值为以下之一:

  • rtl
    • : 用户输入文本的书写方向是从右到左。
  • ltr
    • : 用户输入文本的书写方向是从左到右。

如果未指定文本方向性,用户代理将使用包含表单的父元素的方向性;如果未指定父元素的方向性,则使用用户代理的默认方向性。

示例

textarea 元素方向性

在本示例中,textarea 元素的 dir="auto" 属性允许用户输入的文本自动决定文本的方向性。

<form method="get" action="https://www.example.com/submit">
  <textarea name="comment" dir="auto" dirname="comment-direction">سيب</textarea>
  <button type="submit">致以问候</button>
</form>

当用户提交表单时,用户代理包含两个字段:其中一个为具有“سيب”值的 comment,另外一个为具有“rtl”值的 comment-direction。URL 编码的提交体看起来像这样:

https://www.example.com/submit?comment=%D8%B3%D9%8A%D8%A8&comment-direction=rtl

input 元素方向性

在本示例中,input 元素的 dir="auto" 属性允许用户输入的文本自动决定文本的方向性。

<form method="get" action="https://www.example.com/submit">
  <input
    type="text"
    name="comment-input"
    dir="auto"
    dirname="comment-direction"
    value="Hello" />
  <button type="submit">致以问候</button>
</form>

当用户提交表单时,用户代理包含两个字段:其中一个为具有“Hello”值的 comment-input,另外一个为具有“ltr”值的 comment-direction:

https://www.example.com/submit?comment-input=Hello&comment-direction=ltr

继承方向性

以下 <input> 和 <textarea> 元素并不具有 dir 属性,故它们继承了父元素的显式方向性(即 rtl):

<div dir="rtl">
  <form method="get" action="https://www.example.com/submit">
    <input
      type="text"
      name="user"
      dirname="user-direction"
      value="LTR Username" />
    <textarea name="comment" dirname="comment-direction">LTR Comment</textarea>
    <button type="submit">发表评论</button>
  </form>
</div>

URL 编码的提交体类似如下:

https://www.example.com/submit?user=LTR+Username&user-direction=rtl&comment=LTR+Comment&comment-direction=rtl

规范

浏览器兼容性

参见

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。