HTML 属性:dirname
dirname
属性可用于 <textarea>
元素和几种 <input>
类型,并描述表单提交期间元素的文本内容的文本方向。浏览器使用此属性的值来确定用户输入的文本是左到右还是右到左的。使用时,元素的文本方向值会与 dirname
属性的值一起包含在表单提交数据中,作为字段的名称。
用法说明
dirname
属性可用于任何 <textarea>
元素,或任何具有 hidden、text、search、tel、url、email、password、submit、reset 或 button 类型的 <input>
元素。
提交数据的格式为 {dirname_value}={direction}
,其中 {dirname_value}
是 dirname
属性的值,{direction}
是文本的方向。例如,如果用户在具有 name="comment"
和 dirname="comment-direction"
属性的元素中输入“Hello”,则 GET
请求的 URL 编码表单提交数据将是 comment=Hello&comment-direction=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">Send my greetings</button>
</form>
当用户提交表单时,用户代理会包含两个字段,一个名为 comment
,值为“سيب”,另一个名为 comment-direction
,值为“rtl”。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">Send my greetings</button>
</form>
当用户提交表单时,用户代理会包含两个字段,一个名为 comment-input
,值为“Hello”,另一个名为 comment-direction
,值为“ltr”。
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">Post Comment</button>
</form>
</div>
URL 编码的提交体如下所示:
https://www.example.com/submit?user=LTR+Username&user-direction=rtl&comment=LTR+Comment&comment-direction=rtl
规范
规范 |
---|
HTML # attr-fe-dirname |
浏览器兼容性
html.elements.textarea.dirname
加载中…
html.elements.input.dirname
加载中…