HTML 属性 参考
HTML 属性参考
下表列出了所有 HTML 属性及其可用的元素。
| Attribute | 所属 | 描述 |
|---|---|---|
| accept | <input> | 指定服务器接受的文件类型（仅用于 type="file"） |
| accept-charset | <form> | 指定用于表单提交的字符编码 |
| accesskey | 全局属性 | 指定激活/聚焦元素的快捷键 |
| action | <form> | 指定提交表单数据时发送到的位置 |
| align | HTML5 中不支持。 | 根据周围元素指定对齐方式。请改用 CSS。 |
| alt | <area>, <img>, <input> | 当原始元素无法显示时指定备用文本 |
| async | <script> | 指定脚本是异步执行的（仅适用于外部脚本） |
| autocomplete | <form>, <input> | 指定是否为 <form> 或 <input> 元素启用自动完成 |
| autofocus | <button>, <input>, <select>, <textarea> | 指定当页面加载时元素应自动获得焦点 |
| autoplay | <audio>, <video> | 指定音频/视频一准备好即开始播放 |
| bgcolor | HTML5 中不支持。 | 指定元素的背景颜色。请改用 CSS。 |
| border | HTML5 中不支持。 | 指定元素边框的宽度。请改用 CSS。 |
| charset | <meta>, <script> | 指定字符编码 |
| checked | <input> | 指定页面加载时 <input> 元素应被预先选中（适用于 type="checkbox" 或 type="radio"） |
| cite | <blockquote>, <del>, <ins>, <q> | 指定解释引文/删除/插入文本的 URL |
| 类别 | 全局属性 | 为元素指定一个或多个类名（指向样式表中的类） |
| color | HTML5 中不支持。 | 指定元素的文本颜色。请改用 CSS。 |
| cols | <textarea> | 指定文本区域的可见宽度 |
| colspan | <td>, <th> | 指定表单元格应跨越的列数 |
| content | <meta> | 提供 http-equiv 或 name 属性的信息/值的 HTTP 标头 |
| contenteditable | 全局属性 | 指定元素的内容是否可编辑 |
| controls | <audio>, <video> | 指定是否显示音频/视频控件（如播放/暂停按钮等） |
| coords | <area> | 指定区域的坐标 |
| data | <object> | 指定对象使用的资源 URL |
| data-* | 全局属性 | 用于存储页面或应用程序的自定义私有数据 |
| datetime | <del>, <ins>, <time> | 指定日期和时间 |
| default | <track> | 如果用户偏好设置未指明其他轨道更合适，则指定该轨道将被启用 |
| defer | <script> | 指定页面已解析后执行脚本（仅适用于外部脚本） |
| dir | 全局属性 | 指定元素中内容的文本方向 |
| dirname | <input>, <textarea> | 指定将提交文本方向 |
| disabled | <button>, <fieldset>, <input>, <optgroup>, <option>, <select>, <textarea> | 指定应禁用指定的元素/元素组 |
| download | <a>, <area> | 指定用户点击超链接时将下载目标 |
| draggable | 全局属性 | 指定元素是否可拖动 |
| enctype | <form> | 指定提交表单数据时如何进行编码（仅适用于 method="post"） |
| enterkeyhint | 全局属性 | 指定虚拟键盘上 Enter 键的文本 |
| for | <label>, <output> | 指定标签/计算绑定到哪个表单元素 |
| form | <button>, <fieldset>, <input>, <label>, <meter>, <object>, <output>, <select>, <textarea> | 指定元素所属的表单的名称 |
| formaction | <button>, <input> | 指定提交表单数据时发送到的位置。仅适用于 type="submit" |
| headers | <td>, <th> | 指定单元格相关的表头单元格的一个或多个 |
| height | <canvas>, <embed>, <iframe>, <img>, <input>, <object>, <video> | 指定元素的高度 |
| hidden | 全局属性 | 指定元素尚未相关，或已不再相关 |
| high | <meter> | 指定被视为高值的范围 |
| href | <a>, <area>, <base>, <link> | 指定链接指向的页面的 URL |
| hreflang | <a>, <area>, <link> | 指定链接文档的语言 |
| http-equiv | <meta> | 为 content 属性的信息/值提供 HTTP 标头 |
| id | 全局属性 | 为元素指定唯一 ID |
| inert | 全局属性 | 指定浏览器应忽略此部分 |
| inputmode | 全局属性 | 指定虚拟键盘的模式 |
| ismap | <img> | 将图像指定为服务器端图像映射 |
| kind | <track> | 指定文本轨道的种类 |
| 标签 | <track>, <option>, <optgroup> | 指定文本轨道的标题 |
| lang | 全局属性 | 指定元素内容的语言 |
| 列表 | <input> | 引用一个包含 <input> 元素预定义选项的 <datalist> 元素 |
| 循环 | <audio>, <video> | 指定音频/视频每次结束时都重新开始 |
| low | <meter> | 指定被视为低值的范围 |
| max | <input>, <meter>, <progress> | 指定最大值 |
| maxlength | <input>, <textarea> | 指定元素中允许的最大字符数 |
| media | <a>, <area>, <link>, <source>, <style> | 指定链接文档的目标媒体/设备 |
| method | <form> | 指定发送表单数据时要使用的 HTTP 方法 |
| 分钟 | <input>, <meter> | 指定最小值 |
| multiple | <input>, <select> | 指定用户可以输入多个值 |
| muted | <video>, <audio> | 指定视频的音频输出应被静音 |
| name | <button>, <fieldset>, <form>, <iframe>, <input>, <map>, <meta>, <object>, <output>, <param>, <select>, <textarea> | 指定元素的名称 |
| novalidate | <form> | 指定提交表单时不对表单进行验证 |
| onabort | <audio>, <embed>, <img>, <object>, <video> | 在中止时运行的脚本 |
| onafterprint | <body> | 在打印文档后运行的脚本 |
| onbeforeprint | <body> | 在打印文档前运行的脚本 |
| onbeforeunload | <body> | 在卸载文档时运行的脚本 |
| onblur | 所有可见元素。 | 在元素失去焦点时运行的脚本 |
| oncanplay | <audio>, <embed>, <object>, <video> | 在文件可以开始播放时运行的脚本（当它已经缓冲到足以开始播放时） |
| oncanplaythrough | <audio>, <video> | 在文件可以一直播放到结束而无需缓冲暂停时运行的脚本 |
| onchange | 所有可见元素。 | 在元素值更改时运行的脚本 |
| onclick | 所有可见元素。 | 在元素被点击时运行的脚本 |
| oncontextmenu | 所有可见元素。 | 触发上下文菜单时运行的脚本 |
| oncopy | 所有可见元素。 | 在元素内容被复制时运行的脚本 |
| oncuechange | <track> | 当 <track> 元素中的提示更改时运行的脚本 |
| oncut | 所有可见元素。 | 在元素内容被剪切时运行的脚本 |
| ondblclick | 所有可见元素。 | 在元素被双击时运行的脚本 |
| ondrag | 所有可见元素。 | 在元素被拖动时运行的脚本 |
| ondragend | 所有可见元素。 | 在拖动操作结束时运行的脚本 |
| ondragenter | 所有可见元素。 | 当拖动元素到有效目标上时运行的脚本 |
| ondragleave | 所有可见元素。 | 当元素离开有效目标时运行的脚本 |
| ondragover | 所有可见元素。 | 当元素被拖动到有效目标上时运行的脚本 |
| ondragstart | 所有可见元素。 | 在拖动操作开始时运行的脚本 |
| ondrop | 所有可见元素。 | 当拖动元素被释放时运行的脚本 |
| ondurationchange | <audio>, <video> | 媒体长度改变时运行的脚本 |
| onemptied | <audio>, <video> | 当由于某种原因导致文件突然不可用时运行的脚本（例如意外断开连接） |
| onended | <audio>, <video> | 媒体已达到结束时运行的脚本（例如“感谢收听”之类的消息的有用事件） |
| onerror | <audio>, <body>, <embed>, <img>, <object>, <script>, <style>, <video> | 发生错误时运行的脚本 |
| onfocus | 所有可见元素。 | 元素获得焦点时运行的脚本 |
| onhashchange | <body> | URL 的锚点部分发生变化时运行的脚本 |
| oninput | 所有可见元素。 | 元素获得用户输入时运行的脚本 |
| oninvalid | 所有可见元素。 | 元素无效时运行的脚本 |
| onkeydown | 所有可见元素。 | 用户按下按键时运行的脚本 |
| onkeypress | 所有可见元素。 | 用户按下按键时运行的脚本 |
| onkeyup | 所有可见元素。 | 用户释放按键时运行的脚本 |
| onload | <body>, <iframe>, <img>, <input>, <link>, <script>, <style> | 元素加载完成时运行的脚本 |
| onloadeddata | <audio>, <video> | 加载媒体数据时运行的脚本 |
| onloadedmetadata | <audio>, <video> | 加载元数据（如尺寸和时长）时运行的脚本 |
| onloadstart | <audio>, <video> | 在文件开始加载之前（在实际加载任何内容之前）运行的脚本 |
| onmousedown | 所有可见元素。 | 鼠标按钮在元素上按下时运行的脚本 |
| onmousemove | 所有可见元素。 | 当鼠标指针在元素上移动时运行的脚本 |
| onmouseout | 所有可见元素。 | 鼠标指针移出元素时运行的脚本 |
| onmouseover | 所有可见元素。 | 鼠标指针在元素上移动时运行的脚本 |
| onmouseup | 所有可见元素。 | 鼠标按钮在元素上释放时运行的脚本 |
| onmousewheel | 所有可见元素。 | 当鼠标滚轮在元素上滚动时运行的脚本 |
| onoffline | <body> | 浏览器开始离线工作时运行的脚本 |
| ononline | <body> | 浏览器开始在线工作时运行的脚本 |
| onpagehide | <body> | 用户离开页面时运行的脚本 |
| onpageshow | <body> | 用户进入页面时运行的脚本 |
| onpaste | 所有可见元素。 | 用户在元素中粘贴内容时运行的脚本 |
| onpause | <audio>, <video> | 用户或程序将媒体暂停时运行的脚本 |
| onplay | <audio>, <video> | 媒体开始播放时运行的脚本 |
| onplaying | <audio>, <video> | 媒体开始播放时运行的脚本 |
| onpopstate | <body> | 窗口历史记录更改时运行的脚本。 |
| onprogress | <audio>, <video> | 浏览器正在获取媒体数据时运行的脚本 |
| onratechange | <audio>, <video> | 播放速率改变时运行的脚本（例如，当用户切换到慢动作或快进模式时）。 |
| onreset | <form> | 表单中的重置按钮被点击时运行的脚本。 |
| onresize | <body> | 浏览器窗口正在调整大小时运行的脚本。 |
| onscroll | 所有可见元素。 | 元素滚动条滚动时运行的脚本 |
| onsearch | <input> | 用户在搜索字段中输入内容时运行的脚本（用于 <input type="search">） |
| onseeked | <audio>, <video> | 当 seeking 属性设置为 false，表示已完成查找时运行的脚本 |
| onseeking | <audio>, <video> | 当 seeking 属性设置为 true，表示查找正在进行时运行的脚本 |
| onselect | 所有可见元素。 | 元素被选中时运行的脚本 |
| onstalled | <audio>, <video> | 无论何种原因，浏览器无法获取媒体数据时运行的脚本 |
| onstorage | <body> | Web Storage 区域更新时运行的脚本 |
| onsubmit | <form> | 提交表单时运行的脚本 |
| onsuspend | <audio>, <video> | 无论何种原因，在媒体数据下载完成之前停止下载时运行的脚本 |
| ontimeupdate | <audio>, <video> | 播放位置已更改时运行的脚本（例如，当用户快进到媒体的不同点时） |
| ontoggle | <details> | 当用户打开或关闭 <details> 元素时运行的脚本 |
| onunload | <body> | 页面卸载时（或浏览器窗口关闭时）运行的脚本 |
| onvolumechange | <audio>, <video> | 视频/音频音量更改时运行的脚本 |
| onwaiting | <audio>, <video> | 媒体暂停但预计会恢复时运行的脚本（例如，当媒体因缓冲更多数据而暂停时） |
| onwheel | 所有可见元素。 | 当鼠标滚轮在元素上向上或向下滚动时运行的脚本 |
| open | <details> | 指定详细信息应向用户可见（打开） |
| optimum | <meter> | 指定仪表盘的最佳值 |
| pattern | <input> | 指定一个正则表达式，用于检查 <input> 元素的 值 |
| placeholder | <input>, <textarea> | 指定一个简短提示，描述元素的预期值 |
| popover | 全局属性 | 指定一个弹出元素 |
| popovertarget | <button>, <input> | 指定要调用的弹出元素 |
| popovertargetaction | <button>, <input> | 指定点击按钮时对弹出元素的操作 |
| poster | <video> | 指定在视频下载期间或用户点击播放按钮之前显示的图像 |
| preload | <audio>, <video> | 指定页面加载时音频/视频的加载方式 |
| readonly | <input>, <textarea> | 指定元素是只读的 |
| rel | <a>, <area>, <form>, <link> | 指定当前文档与链接文档之间的关系 |
| required | <input>, <select>, <textarea> | 指定在提交表单之前必须填写该元素 |
| reversed | <ol> | 指定列表顺序应为降序（9,8,7...） |
| rows | <textarea> | 指定文本区域的可见行数 |
| rowspan | <td>, <th> | 指定表单元格应跨越的行数 |
| sandbox | <iframe> | 启用对 <iframe> 中内容的额外限制 |
| scope | <th> | 指定表头单元格是列、行或列/行组的表头 |
| selected | <option> | 指定页面加载时应预先选中一个选项 |
| shape | <area> | 指定区域的形状 |
| 大小 | <input>, <select> | 指定文本区域中的字符数（对于 <input>）或可选项目的可见数量（对于 <select>） |
| sizes | <img>, <link>, <source> | 指定链接资源的尺寸 |
| span | <col>, <colgroup> | 指定要跨越的列数 |
| 拼写检查 | 全局属性 | 指定是否检查元素的拼写和语法 |
| src | <audio>, <embed>, <iframe>, <img>, <input>, <script>, <source>, <track>, <video> | 指定媒体文件的 URL |
| srcdoc | <iframe> | 显示在 <iframe> 中的页面 HTML 内容 |
| srclang | <track> | 指定文本轨道的语言（当 kind="subtitles" 时必需） |
| srcset | <img>, <source> | 指定在不同情况下使用的图像 URL |
| start | <ol> | 指定有序列表的起始值 |
| step | <input> | 指定输入字段的合法数值区间 |
| 样式 | 全局属性 | 为元素指定内联 CSS 样式 |
| tabindex | 全局属性 | 指定元素的制表符顺序 |
| target | <a>, <area>, <base>, <form> | 指定链接文档的打开目标或表单的提交目标 |
| title | 全局属性 | 指定元素的额外信息 |
| 翻译 | 全局属性 | 指定元素内容是否应被翻译 |
| type | <a>, <button>, <embed>, <input>, <link>, <menu>, <object>, <script>, <source>, <style> | 指定元素的类型 |
| usemap | <img>, <object> | 将图像指定为客户端图像映射 |
| value | <button>, <input>, <li>, <option>, <meter>, <progress>, <param> | 指定元素的值 |
| width | <canvas>, <embed>, <iframe>, <img>, <input>, <object>, <video> | 指定元素的宽度 |
| wrap（换行） | <textarea> | 指定文本区域中的文本在表单中提交时如何换行 |
