全局属性
全局属性是所有 HTML 元素共有的属性;它们可以用于所有元素,尽管对某些元素可能没有影响。
全局属性可以在所有HTML 元素上指定,即使标准中未指定。这意味着任何非标准元素都必须仍然允许这些属性,即使使用这些元素意味着文档不再符合 HTML5 标准。例如,即使<foo>
不是有效的 HTML 元素,符合 HTML5 标准的浏览器也会隐藏标记为<foo hidden>…</foo>
的内容。
除了基本的 HTML 全局属性之外,还存在以下全局属性
xml:lang
和xml:base
- 这些是从 XHTML 规范继承而来并已弃用,但出于兼容性目的而保留。- ARIA
role
属性和用于确保可访问性的多个aria-*
状态和属性。 - 事件处理程序属性:
onabort
、onautocomplete
、onautocompleteerror
、onblur
、oncancel
、oncanplay
、oncanplaythrough
、onchange
、onclick
、onclose
、oncontextmenu
、oncuechange
、ondblclick
、ondrag
、ondragend
、ondragenter
、ondragleave
、ondragover
、ondragstart
、ondrop
、ondurationchange
、onemptied
、onended
、onerror
、onfocus
、oninput
、oninvalid
、onkeydown
、onkeypress
、onkeyup
、onload
、onloadeddata
、onloadedmetadata
、onloadstart
、onmousedown
、onmouseenter
、onmouseleave
、onmousemove
、onmouseout
、onmouseover
、onmouseup
、onmousewheel
、onpause
、onplay
、onplaying
、onprogress
、onratechange
、onreset
、onresize
、onscroll
、onseeked
、onseeking
、onselect
、onshow
、onsort
、onstalled
、onsubmit
、onsuspend
、ontimeupdate
、ontoggle
、onvolumechange
、onwaiting
。
全局属性列表
accesskey
-
提供一个提示,用于为当前元素生成键盘快捷键。此属性由一个空格分隔的字符列表组成。浏览器应使用计算机键盘布局中存在的第一个字符。
anchor
非标准autocapitalize
-
控制输入文本是否自动大写,以及如果自动大写,则以何种方式大写。
autofocus
-
指示在页面加载时或其所属的
<dialog>
显示后应立即将焦点放在元素上。此属性为布尔值,初始值为false。 class
-
元素类的空格分隔列表。类允许 CSS 和 JavaScript 通过类选择器或诸如
Document.getElementsByClassName()
方法之类的函数来选择和访问特定元素。 contenteditable
-
一个枚举属性,指示用户是否可以编辑元素。如果是,则浏览器会修改其窗口小部件以允许编辑。该属性必须采用以下值之一
true
或空字符串,表示必须可编辑元素;false
,表示该元素不能编辑。plaintext-only
,表示元素的原始文本可编辑,但禁用富文本格式。
data-*
-
形成一类属性,称为自定义数据属性,允许在HTML及其DOM表示之间交换专有信息,脚本可以使用这些信息。所有此类自定义数据都可通过设置属性的元素的
HTMLElement
接口获得。HTMLElement.dataset
属性提供对其的访问。 dir
-
一个枚举属性,指示元素文本的方向性。它可以具有以下值
ltr
,表示从左到右,用于从左到右书写的语言(如英语);rtl
,表示从右到左,用于从右到左书写的语言(如阿拉伯语);auto
,让用户代理决定。它在解析元素内的字符时使用一个基本算法,直到找到具有强方向性的字符,然后将该方向性应用于整个元素。
draggable
-
一个枚举属性,指示是否可以使用拖放 API拖动元素。它可以具有以下值
true
,表示可以拖动元素false
,表示该元素不能被拖动。
enterkeyhint
-
提示在虚拟键盘上为 Enter 键显示的操作标签(或图标)。
exportparts
-
用于从嵌套的阴影树中传递地导出阴影部分到包含的光树中。
-
一个枚举属性,指示元素尚未或不再相关。例如,它可以用来隐藏在登录过程完成之前无法使用的页面元素。浏览器不会呈现此类元素。此属性不能用于隐藏可能合法显示的内容。
id
-
定义一个唯一的标识符 (ID),该标识符在整个文档中必须唯一。其目的是在链接(使用片段标识符)、脚本编写或样式设置(使用 CSS)时识别元素。
inert
-
一个布尔值,使浏览器忽略元素的用户输入事件。当存在点击事件时很有用。
inputmode
-
向浏览器提供有关在编辑此元素或其内容时要使用的虚拟键盘配置类型的提示。主要用于
<input>
元素,但在contenteditable
模式下可用于任何元素。 is
-
允许您指定标准 HTML 元素应表现得像已注册的自定义内置元素(有关更多详细信息,请参阅使用自定义元素)。
注意:item*
属性是WHATWG HTML 微数据功能的一部分。
itemid
-
项目的唯一全局标识符。
itemprop
-
用于向项目添加属性。每个 HTML 元素都可以指定一个
itemprop
属性,其中itemprop
由名称和值对组成。 itemref
-
不属于具有
itemscope
属性的元素的后代的属性可以使用itemref
与该项目关联。它提供了一个文档中其他位置具有其他属性的元素 ID(而不是itemid
)列表。 itemscope
-
itemscope
(通常)与itemtype
一起使用,以指定块中包含的 HTML 与特定项目相关。itemscope
创建项目并定义与其关联的itemtype
的范围。itemtype
是词汇表(例如schema.org)的有效 URL,该词汇表描述了项目及其属性上下文。 itemtype
-
指定将用于在数据结构中定义
itemprop
(项目属性)的词汇表的 URL。itemscope
用于设置在数据结构中的哪个位置设置由itemtype
设置的词汇表将处于活动状态。 lang
-
帮助定义元素的语言:不可编辑元素的语言,或用户应使用该语言编写可编辑元素的语言。该属性包含一个“语言标签”(由连字符分隔的“语言子标签”组成),其格式在RFC 5646:语言标识标签(也称为 BCP 47)中定义。
xml:lang
优先于它。 nonce
-
一个加密的 nonce(“一次性使用数字”),内容安全策略可以使用它来确定是否允许给定的提取继续进行。
part
-
元素的部件名称的空格分隔列表。部件名称允许 CSS 通过
::part
伪元素选择和设置阴影树中特定元素的样式。 popover
-
用于将元素指定为弹出窗口元素(请参阅Popover API)。弹出窗口元素通过
display: none
隐藏,直到通过调用/控制元素(即具有popovertarget
属性的<button>
或<input type="button">
)或HTMLElement.showPopover()
调用打开。 role
-
角色定义内容的语义含义,允许屏幕阅读器和其他工具以与用户对该类型对象期望一致的方式呈现和支持与对象的交互。
角色
使用role="role_type"
添加到 HTML 元素中,其中role_type
是 ARIA 规范中角色的名称。 slot
-
将阴影 DOM阴影树中的插槽分配给元素:具有
slot
属性的元素分配给由<slot>
元素创建的插槽,其name
属性的值与该slot
属性的值匹配。 spellcheck
-
一个枚举属性定义元素是否可以检查拼写错误。它可以具有以下值
- 空字符串或
true
,表示应在可能的情况下检查元素的拼写错误; false
,表示不应检查元素的拼写错误。
- 空字符串或
style
-
包含要应用于元素的CSS样式声明。请注意,建议在单独的文件或文件中定义样式。此属性和
<style>
元素的主要目的是允许快速样式设置,例如用于测试目的。 tabindex
-
一个整数属性,指示元素是否可以获取输入焦点(是否可聚焦),是否应参与顺序键盘导航,以及如果参与,则在什么位置。它可以取几个值
- 负值表示该元素应可聚焦,但不能通过顺序键盘导航访问;
0
表示该元素应可聚焦并可通过顺序键盘导航访问,但其相对顺序由平台约定定义;- 正值表示该元素应可聚焦并可通过顺序键盘导航访问;元素获得焦点的顺序是tabindex值的递增顺序。如果多个元素共享相同的 tabindex,则它们的相对顺序遵循它们在文档中的相对位置。
title
-
包含表示与其所属元素相关的建议信息的文本。此类信息通常(但不一定)可以作为工具提示呈现给用户。
translate
-
一个枚举属性,用于指定在本地化页面时是否要翻译元素的属性值及其
Text
节点子节点的值,或者是否保持不变。它可以具有以下值- 空字符串或
yes
,表示将翻译元素。 no
,表示该元素不会被翻译。
- 空字符串或
virtualkeyboardpolicy
实验性-
一个枚举属性,用于控制平板电脑、手机或其他可能没有硬件键盘的设备上的屏幕虚拟键盘行为,对于其内容可编辑的元素(例如,它是
<input>
或<textarea>
元素,或设置了contenteditable
属性的元素)。auto
或空字符串,当元素获得焦点或被点击时自动显示虚拟键盘。manual
,将元素的焦点和点击与虚拟键盘的状态分离。
writingsuggestions
-
用于控制浏览器在输入字段、页面的一部分或整个页面中写入建议的行为。
false
,禁用浏览器的写入建议。true
或空字符串,启用写入建议。
规范
浏览器兼容性
BCD 表格仅在浏览器中加载
另请参阅
Element
接口,允许查询大多数全局属性。