HTML 输入属性

本章描述了 HTML <input> 元素的不同属性。

value 属性

输入字段的 value 属性指定输入字段的初始值:

实例

带有初始(默认)值的输入字段:

<form>
  <label for="fname">First name:</label><br>
  <input type="text" id="fname" name="fname" value="Bill"><br>
  <label for="lname">Last name:</label><br>
  <input type="text" id="lname" name="lname" value="Gates">
</form>

亲自试一试

readonly 属性

输入字段的 readonly 属性指定输入字段为只读。

只读输入字段无法修改(但用户可以切换到该字段、选中其中的文本并复制文本)。

在提交表单时,只读输入字段的值将被发送!

实例

一个只读输入字段:

<form>
  <label for="fname">First name:</label><br>
  <input type="text" id="fname" name="fname" value="Bill" readonly><br>
  <label for="lname">Last name:</label><br>
  <input type="text" id="lname" name="lname" value="Gates">
</form>

亲自试一试

disabled 属性

输入字段的 disabled 属性指定输入字段应被禁用。

禁用的输入字段不可用且不可点击。

在提交表单时,禁用的输入字段的值不会被发送!

实例

一个禁用的输入字段:

<form>
  <label for="fname">First name:</label><br>
  <input type="text" id="fname" name="fname" value="Bill" disabled><br>
  <label for="lname">Last name:</label><br>
  <input type="text" id="lname" name="lname" value="Gates">
</form>

亲自试一试

size 属性

输入字段的 size 属性指定输入字段的可见宽度(以字符为单位)。

size 的默认值为 20。

注意:size 属性适用于以下输入类型:textsearchtelurlemailpassword

实例

为输入字段设置宽度:

<form>
  <label for="fname">First name:</label><br>
  <input type="text" id="fname" name="fname" size="50"><br>
  <label for="pin">PIN:</label><br>
  <input type="text" id="pin" name="pin" size="4">
</form>

亲自试一试

maxlength 属性

输入字段的 maxlength 属性指定输入字段允许的最大字符数。

注意:设置 maxlength 后,输入字段将不接受超过指定数量的字符。但是,此属性不提供任何反馈。因此,如果您想提醒用户,必须编写 JavaScript 代码。

实例

为输入字段设置最大长度:

<form>
  <label for="fname">First name:</label><br>
  <input type="text" id="fname" name="fname" size="50"><br>
  <label for="pin">PIN:</label><br>
  <input type="text" id="pin" name="pin" maxlength="4" size="4">
</form>

亲自试一试

min 和 max 属性

输入字段的 minmax 属性指定输入字段的最小值和最大值。

minmax 属性适用于以下输入类型:numberrangedatedatetime-localmonthtimeweek

提示:同时使用 maxmin 属性可以创建一个合法值的范围。

实例

设置最大日期、最小日期和合法值范围:

<form>
  <label for="datemax">输入 1980-01-01 之前的日期:</label>
  <input type="date" id="datemax" name="datemax" max="1979-12-31"><br><br>

  <label for="datemin">输入 2000-01-01 之后的日期:</label>
  <input type="date" id="datemin" name="datemin" min="2000-01-02"><br><br>

  <label for="quantity">数量(1 到 5 之间):</label>
  <input type="number" id="quantity" name="quantity" min="1" max="5">
</form>

亲自试一试

multiple 属性

输入字段的 multiple 属性指定允许用户在输入字段中输入多个值。

multiple 属性适用于以下输入类型:emailfile

实例

一个允许多个值的文件上传字段:

<form>
  <label for="files">选择文件:</label>
  <input type="file" id="files" name="files" multiple>
</form>

亲自试一试

pattern 属性

输入字段的 pattern 属性指定一个正则表达式,用于在提交表单时检查输入字段的值。

pattern 属性适用于以下输入类型:textdatesearchurltelemailpassword

提示:使用全局 title 属性来描述模式以帮助用户。

提示:请在我们的 JavaScript 教程中学习更多关于正则表达式的知识。

实例

一个只能包含三个字母(不能有数字或特殊字符)的输入字段:

<form>
  <label for="country_code">国家代码:</label>
  <input type="text" id="country_code" name="country_code"
  pattern="[A-Za-z]{3}" title="三个字母的国家代码">
</form>

亲自试一试

placeholder 属性

输入字段的 placeholder 属性指定一个简短的提示,描述输入字段的预期值(示例值或预期格式的简短描述)。

在用户输入值之前,该简短提示会显示在输入字段中。

placeholder 属性适用于以下输入类型:textsearchurlnumbertelemailpassword

实例

带有占位符文本的输入字段:

<form>
  <label for="phone">输入电话号码:</label>
  <input type="tel" id="phone" name="phone"
  placeholder="123-45-678"
  pattern="[0-9]{3}-[0-9]{2}-[0-9]{3}">
</form>

亲自试一试

required 属性

输入字段的 required 属性指定必须在提交表单之前填写输入字段。

required 属性适用于以下输入类型:textsearchurltelemailpassword、日期选择器、numbercheckboxradiofile

实例

一个必填的输入字段:

<form>
  <label for="username">用户First name:</label>
  <input type="text" id="username" name="username" required>
</form>

亲自试一试

step 属性

输入字段的 step 属性指定输入字段的合法数字间隔。

示例:如果 step="3",合法数字可能是 -3、0、3、6 等。

提示:此属性可以与 maxmin 属性一起使用,以创建合法值的范围。

step 属性适用于以下输入类型:numberrangedatedatetime-localmonthtimeweek

实例

具有指定合法数字间隔的输入字段:

<form>
  <label for="points">Points:</label>
  <input type="number" id="points" name="points" step="3">
</form>

亲自试一试

注意:输入限制并非万无一失,JavaScript 提供了许多添加非法输入的方法。为了安全地限制输入,还必须由接收者(服务器)进行检查!

autofocus 属性

输入字段的 autofocus 属性指定页面加载时输入字段应自动获得焦点。

实例

让“名”输入字段在页面加载时自动获得焦点:

<form>
  <label for="fname">First name:</label><br>
  <input type="text" id="fname" name="fname" autofocus><br>
  <label for="lname">Last name:</label><br>
  <input type="text" id="lname" name="lname">
</form>

亲自试一试

height 和 width 属性

输入字段的 heightwidth 属性指定 <input type="image"> 元素的高度和宽度。

提示:请始终为图像同时指定 heightwidth 属性。如果设置了高度和宽度,则在加载页面时为图像预留所需的空间。没有这些属性,浏览器就不知道图像的大小,也无法为其预留适当的空间。这样做的效果是页面布局在加载过程中会发生变化(当图像加载时)。

实例

将图像定义为提交按钮,并设置高度和宽度属性:

<form>
  <label for="fname">First name:</label>
  <input type="text" id="fname" name="fname"><br><br>
  <label for="lname">Last name:</label>
  <input type="text" id="lname" name="lname"><br><br>
  <input type="image" src="submit.gif" alt="提交" width="48" height="48">
</form>

亲自试一试

list 属性

输入字段的 list 属性引用一个 <datalist> 元素,该元素包含 <input> 元素的预定义选项。

实例

一个在 <datalist> 中具有预定义值的 <input> 元素:

<form>
  <input list="browsers">
  <datalist id="browsers">
    <option value="Edge">
    <option value="Firefox">
    <option value="Chrome">
    <option value="Opera">
    <option value="Safari">
  </datalist>
</form>

亲自试一试

autocomplete 属性

输入字段的 autocomplete 属性指定表单或输入字段是否应开启自动完成功能。

自动完成允许浏览器预测值。当用户开始在字段中键入时,浏览器应根据之前键入的值显示填充字段的选项。

autocomplete 属性适用于 <form> 和以下 <input> 类型:textsearchurltelemailpassword、日期选择器、rangecolor

实例

一个开启自动完成的 HTML 表单,但其中一个输入字段关闭自动完成:

<form action="/action_page.php" autocomplete="on">
  <label for="fname">First name:</label>
  <input type="text" id="fname" name="fname"><br><br>
  <label for="lname">Last name:</label>
  <input type="text" id="lname" name="lname"><br><br>
  <label for="email">Email:</label>
  <input type="email" id="email" name="email" autocomplete="off"><br><br>
  <input type="submit" value="提交">
</form>

亲自试一试

提示:在某些浏览器中,您可能需要激活自动完成功能才能使其工作(在浏览器的菜单中查找“偏好设置”)。

HTML 表单和输入元素

标签 描述
<form> 定义用于用户输入的 HTML 表单。
<input> 定义输入控件。

有关所有可用 HTML 标签的完整列表,请访问我们的 HTML 标签参考页面