Image alt 属性

HTML DOM Image 对象

定义和用法

alt 属性设置或返回图像的 alt 属性 的值。

如果由于某种原因无法显示图像（由于连接速度慢、src 属性错误或用户使用屏幕阅读器），这个必需的 alt 属性 规定图像的替代文本。

注释：当鼠标悬停在 <img> 元素上时，Internet Explorer 将 alt 属性的值显示为工具提示。根据 HTML 规范，这不是正确的行为。所有其他浏览器都遵循规范，并且仅在图像无法显示时才显示替代文本。

提示：如果要为图像创建工具提示，请使用全局的 title 属性。

实例

例子 1

返回图像的替代文本：

var x = document.getElementById("myImg").alt;

亲自试一试

例子 2

更改图像的替代文本：

document.getElementById("myImg").alt = "北京风光";

亲自试一试

语法

返回 alt 属性：

imageObject.alt

设置 alt 属性：

imageObject.alt = text

属性值

值 描述
text

规定图像的替代文本。

替代文本指南：

  • 如果图像包含信息，则文本应描述图像
  • 如果图像在 <a> 元素内，文本应说明链接的位置
  • 如果图像仅用于装饰，则请使用 alt=""

技术细节

返回值： 字符串值，表示图像的替代文本。

浏览器支持

Chrome Edge Firefox Safari Opera
Chrome Edge Firefox Safari Opera
支持 支持 支持 支持 支持

相关页面

HTML 参考手册：HTML <img> alt 属性

HTML DOM Image 对象