dirname 属性仅在表单提交时自动附加方向信息,不控制文本显示或输入流向;它根据输入内容首个强方向字符推断“ltr”或“rtl”,生成同名加“.dir”后缀的独立字段,需配合 dir 属性使用。

dirname 属性本身不提交方向信息,也不控制 <input> 文本的流向或传递逻辑 —— 它只是读取当前元素文本的 Unicode 双向算法(Bidi)基础方向,并在表单提交时把该方向作为额外字段发送。
为什么 dirname 不影响文本显示或输入流向
很多人误以为加了 dirname="auto" 或 dirname="rtl" 就能改变输入框内文字从右往左显示,其实不是:
-
dir属性(如dir="rtl")才真正控制渲染方向和光标行为 -
dirname是纯表单数据字段:它只在提交时附带一个名为xxx.dir的隐藏值(xxx是name值),内容为"ltr"或"rtl" - 浏览器不会用它调整布局、换行、光标移动顺序,也不会影响
textarea的回车/Tab 行为
dirname 在表单提交中的实际表现
启用后,它会生成一个额外的键值对,和原字段并列提交。比如:
<input name="msg" dirname="msg.dir" value="مرحبا">
当用户输入的是阿拉伯文或希伯来文,且浏览器检测到基础方向为 RTL 时,提交的表单数据会包含:
msg=مرحباmsg.dir=rtl
注意:dirname 的值不是由开发者写死的,而是由浏览器根据输入内容的首个强方向字符自动推断(类似 dir="auto" 的逻辑),你不能手动设成 "ltr" 或 "rtl" —— 它只接受属性名,不接受值。
常见错误与兼容性坑点
这个属性看似简单,但实际落地容易翻车:
- Chrome 和 Firefox 支持,但 Safari 直到 v16.4 才支持
dirname,iOS Safari 仍不支持(截至 iOS 17.5) - 如果
<input>没有name属性,dirname字段根本不会提交(连.dir后缀都不会出现) - 服务器端必须显式接收
xxx.dir字段,不能假设它和主字段同名或合并处理 - 对纯英文、数字、符号混合输入,方向可能判定为
ltr,即使用户手动切了输入法;反之,开头是空格或标点也可能导致方向识别失败
真正需要控制文本流向,请用 dir;想记录用户输入时的语言方向倾向,再加 dirname。两者常一起用,但职责完全分离 —— 混用或只靠其中一个,都会漏掉关键上下文。










