全局属性

¥List of global attributes

accesskey

提供为当前元素生成键盘快捷键的提示。该属性由空格分隔的字符列表组成。浏览器应使用计算机键盘布局上存在的第一个键盘布局。

autocapitalize

控制输入的文本是否自动大写，如果是，则以何种方式自动大写。

autofocus

指示某个元素将在页面加载时聚焦，或者在显示它所属的 <dialog> 时立即聚焦。该属性是一个布尔值，最初为 false。

class

以空格分隔的元素类列表。类允许 CSS 和 JavaScript 通过 类选择器 或类似方法 Document.getElementsByClassName() 的函数来选择和访问特定元素。

contenteditable

enumerated 属性指示该元素是否可由用户编辑。如果是这样，浏览器会修改其小部件以允许编辑。该属性必须采用以下值之一：

• true 或空字符串，表示该元素必须是可编辑的；
• false，表示该元素不可编辑。

data-*

形成一类属性，称为自定义数据属性，允许在 HTML 及其可由脚本使用的 DOM 表示之间交换专有信息。所有此类自定义数据均可通过设置属性的元素的 HTMLElement 接口获得。HTMLElement.dataset 属性允许访问它们。

dir

指示元素文本方向性的枚举属性。它可以具有以下值：

• ltr，表示从左到右，用于从左到右书写的语言（如英语）；
• rtl，表示从右到左，用于从右到左书写的语言（如阿拉伯语）；
• auto，让用户代理决定。它使用基本算法来解析元素内的字符，直到找到具有强方向性的字符，然后将该方向性应用于整个元素。

draggable

一个枚举属性，指示元素是否可以拖动，使用 拖放 API。它可以具有以下值：

• true，表示该元素可以被拖动
• false，表示该元素不可拖动。

enterkeyhint

提示为虚拟键盘上的 Enter 键呈现什么操作标签（或图标）。

exportparts

用于将阴影部分从嵌套阴影树传递导出到包含的灯光树中。

hidden

一个枚举属性，指示该元素尚不相关或不再相关。例如，它可用于隐藏在登录过程完成之前无法使用的页面元素。浏览器不会渲染此类元素。该属性不得用于隐藏可以合法显示的内容。

id

定义唯一标识符 (ID)，该标识符在整个文档中必须是唯一的。其目的是在链接（使用片段标识符）、脚本或样式设置（使用 CSS）时识别元素。

inert

一个布尔值，使浏览器忽略该元素的用户输入事件。当存在点击事件时很有用。

inputmode

向浏览器提供有关编辑此元素或其内容时要使用的虚拟键盘配置类型的提示。主要用于 <input> 元素，但在 contenteditable 模式下可用于任何元素。

is

允许你指定标准 HTML 元素的行为应类似于已注册的自定义内置元素（有关更多详细信息，请参阅 使用自定义元素）。

注意：item* 属性是 WHATWG HTML 微数据功能 的一部分。

¥Note: The item* attributes are part of the WHATWG HTML Microdata feature.

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: Tags for Identifying Languages (also known as BCP 47) 中定义。xml:lang 优先于它。

nonce

内容安全政策 可以使用加密随机数 ("使用过一次的号码") 来确定是否允许进行给定的提取。

part

以空格分隔的元素部分名称列表。部分名称允许 CSS 通过 ::part 伪元素选择影子树中的特定元素并设置其样式。

popover

用于将元素指定为弹出元素（参见 Popover API）。弹出框元素通过 display: none 隐藏，直到通过调用/控制元素（即具有 popovertarget 属性的 <button> 或 <input type="button">）或 HTMLElement.showPopover() 调用打开。

role

角色定义内容的语义，允许屏幕阅读器和其他工具以符合用户对该类型对象的期望的方式呈现和支持与对象的交互。roles 使用 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 Experimental

enumerated 属性，用于控制平板电脑、手机或其他设备上的屏幕虚拟键盘行为，在这些设备上，硬件键盘可能无法用于其内容可编辑的元素（例如，它是 <input> 或 <textarea> 元素，或具有 contenteditable 属性集的元素）。

• auto 或空字符串，当元素获得焦点或点击时自动显示虚拟键盘。
• manual，它将焦点和点击元素与虚拟键盘的状态分离。

¥See also

• Element 接口，允许查询大多数全局属性。