1. Web
  2. HTML
  3. 参考
  4. 全局属性

全局属性

全局属性是所有 HTML 元素共有的属性；它们可以用于所有元素，尽管在某些元素上可能没有效果。

全局属性可以指定在所有 HTML 元素上，即使是那些非标准元素。这意味着任何非标准元素都必须允许这些属性，即使使用这些元素意味着文档不再是 HTML5 兼容的。例如，符合 HTML5 标准的浏览器会隐藏标记为 <foo hidden>…</foo> 的内容，尽管 <foo> 不是一个有效的 HTML 元素。

除了基本的 HTML 全局属性外，还存在以下全局属性：

  • xml:lang 和 xml:base——它们继承自 XHTML 规范，已被弃用，但为了兼容性目的而保留。
  • ARIA 的 role 属性和多个 aria-* 状态和属性，用于确保可访问性。
  • 下面列出的事件处理程序属性。

全局属性列表

accesskey

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

anchor

将一个已定位的元素与一个锚点元素关联起来。该属性的值是你想要锚定已定位元素的目标元素的 id 值。然后可以使用 CSS 锚定定位来定位该元素。

autocapitalize

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

autocorrect

控制输入的文本是否自动进行拼写错误纠正。这可以应用于具有可编辑文本的元素，但具有以下属性的 <input> 元素除外：type="password"、type="email" 或 type="url"。

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

提示在虚拟键盘上为回车键呈现何种操作标签（或图标）。

exportparts

用于将 shadow parts 从嵌套的 shadow tree 传递性地导出到包含的 light tree 中。

hidden

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

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

指定将用于定义数据结构中 itemprops（项目属性）的词汇表的 URL。itemscope 用于设置由 itemtype 设置的词汇表在数据结构中生效的范围。

lang

帮助定义元素的语言：不可编辑元素所使用的语言，或者用户在可编辑元素中应使用的语言。该属性应包含一个有效的 BCP 47 语言标签。xml:lang 的优先级高于它。

nonce

一个密码学随机数（“一次性数字”），可被内容安全策略用来确定是否允许进行给定的获取操作。

part

一个由空格分隔的元素 part 名称列表。Part 名称允许 CSS 通过 ::part 伪元素选择和样式化 shadow tree 中的特定元素。

popover

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

role

Role 定义了内容的语义含义，允许屏幕阅读器和其他工具以符合用户对该类型对象的期望的方式呈现和支持与对象的交互。role 通过 role="role_type" 添加到 HTML 元素中，其中 role_type 是 ARIA 规范中角色的名称。

slot

将 shadow DOM 影子树中的一个插槽分配给一个元素：一个带有 slot 属性的元素被分配给由 <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 或空字符串，启用书写建议。

全局事件处理程序属性列表

不推荐使用 HTML 事件处理程序属性；有关其工作原理，请参见HTML 属性参考。

虽然下面列出的属性适用于所有元素，但它们并非在所有元素上都有用。例如，onvolumechange HTML 属性被所有元素接受，并为 volumechange 事件附加一个事件监听器，但只有媒体元素会收到由浏览器触发的 volumechange 事件。对于其他元素，你只能使用 EventTarget.dispatchEvent() 来手动派发一个。某些属性可以指定在 <body> 上，但它们会转而监听 window 上的事件。

规范

规范
VirtualKeyboard API
# dom-elementcontenteditable-virtualkeyboardpolicy
HTML
# the-popover-attribute
HTML
# attr-nonce
HTML
# the-accesskey-attribute
HTML
# the-draggable-attribute
HTML
# attr-autocapitalize
HTML
# the-inert-attribute
HTML
# dom-fe-autofocus
HTML
# attr-lang
HTML
# attr-inputmode
HTML
# attr-translate
HTML
# the-hidden-attribute
HTML
# writing-suggestions
HTML
# the-dir-attribute
HTML
# attr-autocorrect
HTML
# attr-spellcheck
HTML
# attr-data-*
HTML
# attr-slot
HTML
# attr-is
HTML
# attr-enterkeyhint
HTML
# classes
HTML
# the-style-attribute
HTML
# nonce-does-not-update-dom
HTML
# inert-subtrees
HTML
# the-id-attribute
HTML
# the-title-attribute
HTML
# attr-tabindex
HTML
# attr-popover-hint
HTML
# attr-contenteditable
CSS 影子部分
# part-attr
CSS 影子部分
# element-attrdef-html-global-exportparts
DOM
# ref-for-dom-element-slot①
CSS Style Attributes
# style-attribute

浏览器兼容性

另见

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

帮助改进 MDN

了解如何贡献

此页面最后修改于 ，由 MDN 贡献者们修改。

在 GitHub 上查看此页面 • 报告此内容的问题