全局属性

全局属性是所有 HTML 元素共有的属性;它们可以用于所有元素,即使属性可能对某些元素不起作用。

我们可以在所有的 HTML 元素甚至是在标准里没有指定的元素上指定全局属性。这意味着任何非标准元素仍必须能够允许应用这些属性,即使使用这些元素意味着文档不再是 HTML5 兼容的。例如,虽然 <foo> 不是一个有效的 HTML 元素,但是 HTML5 兼容的浏览器隐藏了标记为 <foo hidden>…</foo> 的内容。

除了基本的 HTML 全局属性之外,还存在以下全局属性:

  • xml:langxml:base——两者都是从 XHTML 规范继承且被弃用,但为了兼容性而被保留的。
  • ARIA role 和多重 aria-* 状态和属性,用于保证无障碍。
  • 事件处理器属性:onabortonautocompleteonautocompleteerroronbluroncanceloncanplayoncanplaythroughonchangeonclickoncloseoncontextmenuoncuechangeondblclickondragondragendondragenterondragleaveondragoverondragstartondropondurationchangeonemptiedonendedonerroronfocusoninputoninvalidonkeydownonkeypressonkeyuponloadonloadeddataonloadedmetadataonloadstartonmousedownonmouseenteronmouseleaveonmousemoveonmouseoutonmouseoveronmouseuponmousewheelonpauseonplayonplayingonprogressonratechangeonresetonresizeonscrollonseekedonseekingonselectonshowonsortonstalledonsubmitonsuspendontimeupdateontoggleonvolumechangeonwaiting

全局属性列表

accesskey

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

autocapitalize

控制用户的文本输入是否和如何自动大写,它可以有以下的值:

  • offnone,不应用自动大写(所有字母都默认为小写字母)。
  • onsentences,每个句子的第一个字母默认为大写字母,所有其他字母都默认为小写字母。
  • words,每个单词的第一个字母默认为大写字母,所有其他字母都默认为小写字母。
  • characters,所有的字母都应该默认为大写。
autofocus

表示一个元素将在页面加载时自动聚焦,或者在其所属的 <dialog> 显示时被聚焦。该属性是一个布尔值,初始化为 false。

class

一个以空格分隔的元素的类名列表,它允许 CSS 和 Javascript 通过类选择器或 DOM 方法 Document.getElementsByClassName() 来选择和访问特定的元素。

contenteditable

一个枚举属性,表示元素是否可被用户编辑。如果可以,浏览器会调整元素的部件以允许编辑。该属性必须是下列值之一:

  • true 或者空字符串,表明元素是可被编辑的;
  • false,表明元素不能被编辑。
data-*

形成一类属性,称为自定义数据属性,允许在 HTML 和其 DOM 表示之间交换专有信息,可由脚本使用。所有这些自定义数据属性都可以通过所属元素的 HTMLElement 接口来访问。通过 HTMLElement.dataset 属性可以访问它们。

dir

一个指示元素中文本方向的枚举属性。它的取值如下:

  • ltr,指从,用于那种从左向右书写的语言(比如英语);
  • rtl,指从,用于那种从右向左书写的语言(比如阿拉伯语);
  • auto,指由用户代理决定方向。它在解析元素中字符时会运用一个基本算法,直到发现一个具有强方向性的字符,然后将这一方向应用于整个元素。
draggable

一种枚举属性,指示是否可以使用 Drag and Drop API 拖动元素。它可以有以下的值:

  • true, 这表明元素可被拖动;
  • false, 这表明元素不可被拖动。
enterkeyhint

提示在虚拟键盘上为回车键呈现什么动作标签(或图标)。

exportparts 实验性

用于将隐藏部分从一个嵌套的影子树(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

帮助定义元素的语言:不可编辑元素所在的语言,或者应该由用户编写的可编辑元素的语言。该属性包含一个“语言标记”(由用连字符分隔的“语言子标记”组成),格式在 RFC 5646: Tags for Identifying Languages(也称为 BCP 47) 中定义。xml:lang 优先于它。

nonce

一个加密的 nonce(“只使用一次的数字”),可以被内容安全策略使用,以确定是否允许进行给定的获取。

part

元素的部件名称的空格分隔列表。Part 名称允许 CSS 通过 ::part 伪元素选择和设置影子树中的特定元素。

popover

用于将某个元素指定为弹出式元素(详见 Popover API)。弹出式元素通过 display: none 隐藏,直到通过调用/控制元素(即 <button><input type="button"> 带有 popovertarget 属性)或 HTMLElement.showPopover() 调用而打开。

role

Role 定义了内容的语义,允许屏幕阅读器和其他工具以符合用户对该类型对象的期望的方式来展示和支持与该对象的互动。rolesrole="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

一个枚举属性,用于控制屏幕上的虚拟键盘行为,如平板电脑、手机或其他设备上的硬件键盘可能无法使用的元素,也使用 contenteditable 属性。

  • auto 或一个空字符串,当元素被聚焦或点击时自动显示虚拟键盘。
  • manual,它将焦点和元素上的点击与虚拟键盘的状态解耦。

规范

Specification
HTML Standard
# attr-is
HTML Standard
# writing-suggestions
HTML Standard
# attr-autocorrect
HTML Standard
# the-hidden-attribute
HTML Standard
# attr-lang
HTML Standard
# the-popover-attribute
HTML Standard
# global-attributes:the-id-attribute-2
HTML Standard
# the-style-attribute
CSS Style Attributes
# style-attribute
HTML Standard
# attr-spellcheck
HTML Standard
# the-accesskey-attribute
HTML Standard
# attr-translate
HTML Standard
# the-title-attribute
HTML Standard
# attr-slot
DOM Standard
# ref-for-dom-element-slot①
HTML Standard
# attr-tabindex
HTML Standard
# attr-inputmode
HTML Standard
# attr-enterkeyhint
HTML Standard
# nonce-does-not-update-dom
HTML Standard
# global-attributes:classes-2
HTML Standard
# attr-autocapitalize
HTML Standard
# attr-nonce
HTML Standard
# dom-fe-autofocus
CSS Shadow Parts
# element-attrdef-html-global-exportparts
HTML Standard
# attr-data-*
CSS Shadow Parts
# part-attr
HTML Standard
# the-inert-attribute
VirtualKeyboard API
# dom-elementcontenteditable-virtualkeyboardpolicy
HTML Standard
# the-draggable-attribute
HTML Standard
# the-dir-attribute
HTML Standard
# attr-contenteditable

浏览器兼容性

BCD tables only load in the browser

参见

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