全局属性

全局属性是所有 HTML 元素共有的属性;它们可以用于所有元素,尽管对某些元素可能没有影响。

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

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

  • xml:langxml:base - 这些是从 XHTML 规范继承而来并已弃用,但出于兼容性目的而保留。
  • ARIA role 属性和用于确保可访问性的多个 aria-* 状态和属性。
  • 事件处理程序属性:onabortonautocompleteonautocompleteerroronbluroncanceloncanplayoncanplaythroughonchangeonclickoncloseoncontextmenuoncuechangeondblclickondragondragendondragenterondragleaveondragoverondragstartondropondurationchangeonemptiedonendedonerroronfocusoninputoninvalidonkeydownonkeypressonkeyuponloadonloadeddataonloadedmetadataonloadstartonmousedownonmouseenteronmouseleaveonmousemoveonmouseoutonmouseoveronmouseuponmousewheelonpauseonplayonplayingonprogressonratechangeonresetonresizeonscrollonseekedonseekingonselectonshowonsortonstalledonsubmitonsuspendontimeupdateontoggleonvolumechangeonwaiting

全局属性列表

accesskey

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

anchor 非标准

将定位元素与锚元素关联。属性的值是您要将定位元素锚定的元素的id值。然后可以使用CSS锚点定位对元素进行定位。

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

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

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

指定将用于在数据结构中定义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空字符串,启用写入建议。

规范

规范
HTML 标准
# the-accesskey-attribute
HTML 标准
# attr-autocapitalize
HTML 标准
# dom-fe-autofocus
HTML 标准
# global-attributes:classes-2
HTML 标准
# attr-contenteditable
HTML 标准
# attr-data-*
HTML 标准
# the-dir-attribute
HTML 标准
# the-draggable-attribute
HTML 标准
# attr-enterkeyhint
CSS 阴影部件
# element-attrdef-html-global-exportparts
HTML 标准
# the-hidden-attribute
HTML 标准
# global-attributes:the-id-attribute-2
HTML 标准
# the-inert-attribute
HTML 标准
# attr-inputmode
HTML 标准
# attr-is
HTML 标准
# attr-lang
HTML 标准
# attr-nonce
CSS 阴影部件
# part-attr
HTML 标准
# the-popover-attribute
HTML 标准
# attr-slot
DOM 标准
# ref-for-dom-element-slot①
HTML 标准
# attr-spellcheck
HTML 标准
# the-style-attribute
HTML 标准
# attr-tabindex
HTML 标准
# the-title-attribute
HTML 标准
# attr-translate
虚拟键盘 API
# dom-elementcontenteditable-virtualkeyboardpolicy
HTML 标准
# 写入建议

浏览器兼容性

BCD 表格仅在浏览器中加载

另请参阅

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