大网数据广告活动
Web 标准与前端开发

HTML 属性:readonly

· 52CE 我爱测

当 **`readonly`** 布尔属性存在时,元素是不可变的,意味着用户无法编辑控件。

当 readonly 布尔属性存在时,元素是不可变的,意味着用户无法编辑控件。

HTML Demo: readonly

<label for="firstName">First Name:</label>
<input id="firstName" name="firstName" type="text" value="Adam" />

<label for="age">Age:</label>
<input id="age" name="age" type="number" value="42" readonly />

<label for="hobbies">Hobbies:</label>
<textarea id="hobbies" name="hobbies" readonly>Baseball</textarea>
label {
  display: block;
  margin-top: 1em;
}

input:read-only,
textarea:read-only {
  background-color: silver;
}

概述

如果在 input 元素上指定了 readonly 属性,由于用户无法编辑输入内容,因此该元素不参与约束验证。

input/text、input/search、input/url、input/tel、input/email、input/password、input/date、input/month、input/week、input/time、input/datetime-local、input/number 这些 input 类型和 textarea 表单控件元素均支持 readonly 属性。如果这些输入类型和元素中存在这个属性,则匹配 :read-only 伪类。如果不包含该属性,则将匹配 :read-write 伪类。

该属性不支持 select 或已不可变的 input 类型,也与之无关,如 input/checkbox、input/radio 或根据定义不能以值开头的 input 类型,如 input/file input 类型。input/range 和 input/color 都有默认值。input/hidden input 类型也不支持该属性,因为用户不可能填写隐藏的表单。也不支持任何按钮类型,包括 image。

[!NOTE] 只有文本控件可以设置为只读,因为对于其他控件(如复选框和按钮)来说,只读和禁用之间没有任何有用的区别,所以 readonly 属性并不适用。

当输入具有 readonly 属性时,:read-only 伪类也适用于该输入。反之,支持 readonly 属性但未设置该属性的输入将匹配 :read-write 伪类。

属性交互

disabled 与 readonly 的区别在于,只读控件仍可发挥作用,仍可被聚焦,而禁用控件不能接收聚焦,不能随表单提交,一般在启用前不能作为控件发挥作用。

由于只读字段不能通过用户交互改变其值,因此 required 对同时指定了 readonly 属性的输入没有任何影响。

动态修改只读属性值的唯一方法是通过脚本。

[!NOTE] required 属性不可以在指定了 readonly 属性上的 input 控件上使用。

可用性

浏览器会显示 readonly 属性。

约束验证

如果元素是只读的,则用户不能更新该元素的值,元素的值也不参与约束验证。

示例

HTML

<div class="group">
  <input type="text" value="一些值" readonly="readonly" id="text" />
  <label for="text">文本框</label>
</div>
<div class="group">
  <input type="date" value="2020-01-01" readonly="readonly" id="date" />
  <label for="date">日期</label>
</div>
<div class="group">
  <input type="email" value="一些值" readonly="readonly" id="email" />
  <label for="email">电子邮件</label>
</div>
<div class="group">
  <input type="password" value="一些值" readonly="readonly" id="pwd" />
  <label for="pwd">密码</label>
</div>
<div class="group">
  <textarea readonly="readonly" id="ta">一些值</textarea>
  <label for="ta">消息</label>
</div>

结果

示例

规范

浏览器兼容性

参见

  • :read-only 和 :read-write 伪类
  • input
  • select

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。