HTML 中应用 <input>
元素示意单行输入框和 <textarea>
元素示意多行文本框。
HTML 中应用的 <input>
元素在 JavaScript 中对应的是 HTMLInputElement
类型。HTMLInputElement
继承自 HTMLElement
接口:
interface HTMLInputElement extends HTMLElement {...}
HTMLInputElement
类型有一些独有的属性和办法:
name
:示意<input>
元素的名称。disabled
:示意<input>
元素是否禁止应用。在表单提交时不会蕴含被禁止的<input>
元素。autofocus
:示意页面加载时,该元素是否会主动取得焦点。required
:示意表单提交时,该<input>
元素是否为必填。value
:示意该<input>
元素的值。validity
:返回一个ValidityState
对象,示意<input>
元素的校验状态。是只读属性。validationMessage
:示意<input>
元素校验失败时,用户看到的报错信息。如果该元素不须要校验,或者通过校验,该属性为空字符串。是只读属性。willValidate
:示意表单提交时,<input>
元素是否会被校验。是只读属性。select()
:选中<input>
元素外部的所有文本。click()
:模仿鼠标点击以后的<input>
元素。
而在上述介绍 HTMLInputElement
类型中的属性时,type
属性要特地关注一下,因为依据 type
属性的扭转,能够扭转 <input>
的属性。
类型 | 形容 |
---|---|
text | 文本输出 |
password | 明码输出 |
submit | 表单数据提交 |
button | 按钮 |
radio | 单选框 |
checkbox | 复选框 |
file | 文件 |
hidden | 暗藏的字段 |
image | 定义图像作为提交按钮 |
reset | 重置按钮 |
省略 type
属性与 type="text"
成果一样,<input>
元素显示为文本框。
当 type
的值为 text/password/number/
时,会有以下属性对 <input>
元素无效。
属性 | 类型 | 形容 |
---|---|---|
autocomplete | string | 字符串 on 或 off,示意 <input> 元素的输出内容能够被浏览器主动补全。 |
maxLength | long | 指定 <input> 元素容许的最多字符数。 |
size | unsigned long | 示意 <input> 元素的宽度,这个宽度是以字符数来计量的。 |
pattern | string | 示意 <input> 元素的值应该满足的正则表达式 |
placeholder | string | 示意 <input> 元素的占位符,作为对元素的提醒。 |
readOnly | boolean | 示意用户是否能够批改 <input> 的值。 |
min | string | 示意 <input> 元素的最小数值或日期。 |
max | string | 示意 <input> 元素的最大数值或日期。 |
selectionStart | unsigned long | 示意选中文本的起始地位。如果没有选中文本,返回光标在 <input> 元素外部的地位。 |
selectionEnd | unsigned long | 示意选中文本的完结地位。如果没有选中文本,返回光标在 <input> 元素外部的地位。 |
selectionDirection | string | 示意选中文本的方向。可能的值包含forward 、backward 、none 。 |
上面创立一个 type="text"
,一次显示 25 个字符,但最多容许显示 50 个字符的文本框:
<input type="text" size="25" maxlength="50" value="initial value">
HTML 应用的 <textarea>
元素在 JavaScript 中对应的是 HTMLTextAreaElement
类型。HTMLTextAreaElement
类型继承自 HTMLElement
接口:
interface HTMLTextAreaElement extends HTMLElement {...}
HTMLTextAreaElement
类型有一些独有的属性和办法:
form
:只读属性,返回对父表单元素的援用。如果此元素未蕴含在表单元素中,则它能够是同一文档中id
属性同form
值的<form>
元素,如果没有,该值为null
。type
:只读属性,返回字符串textarea
。value
:string
类型,返回 / 设置控件中蕴含的原始值。textLength
:只读属性,long
类型,返回<textarea>
元素的value
值的长度。与value.length
雷同。defaultValue
:string
类型,返回 / 设置textarea
元素的默认值。placeholder
:string
类型,返回 / 设置textarea
元素的占位符,作为对输出内容的提醒。rows
:unsigned long
类型,返回 / 设置textarea
元素的可见文本行数。cols
:unsigned long
类型,返回 / 设置textarea
元素的可见宽度。autofocus
:boolean
类型,返回 / 设置textarea
元素在页面加载时主动获取焦点。name
:返回 / 设置textarea
元素的名称。disabled
:boolean
类型,返回 / 设置textarea
元素是否该当被禁用。HTMLTextAreaElement.labels
:NodeList
类型,返回与此select
元素关联的标签元素列表。maxLength
:long
类型,返回 / 设置元素能够输出的最大字符数。仅在值更改时才评估此束缚。minLength
:long
类型,返回 / 设置元素能够输出的最小字符数。仅在值更改时才评估此束缚。accessKey
:boolean
类型,返回 / 设置拜访textarea
的键盘快捷键。readOnly
:boolean
类型,返回 / 设置textarea
元素是否为只读。required
:boolean
类型,返回 / 设置textarea
元素是否为必填项。tabIndex
:long
类型,返回 / 设置textarea
元素的tab
键导航程序中元素的地位。
上面创立一个高度为 25,宽度为 5 的 <textarea>
多行文本框。它与 <input>
不同的是,初始值显示在 <textarea>...</textarea>
之间:
<textarea rows="25" cols="5">initial value</textarea>
留神:解决文本框值的时候最好不要应用 DOM
办法,而应该应用 value
属性。
抉择文本
<input>
与 <textarea>
都反对 select()
办法,该办法用于选中文本框中的所有内容。该办法的语法为:
select(): void
上面看一个示例:
let textbox = document.forms[0].elements["input-box"];
textbox.select();
也能够在文本框取得焦点时,选中文本框的内容:
textbox.addEventListener("focus", (event) => {event.target.select();
});
select 事件
入选中文本框中的文本或应用 select()
办法时,会触发 select
事件。
let textbox = document.forms[0].elements["textbox1"];
textbox.addEventListener("select", (event) => {console.log(`Text selected: ${textbox.value}`);
});
获得选中的文本
HTML5 对 select
事件进行了扩大,通过 selectionStart
和 selectionEnd
属性获取文本选区的终点偏移量和起点偏移量。如下所示:
function getSelectedText(textbox){
return textbox.value.substring(textbox.selectionStart,
textbox.selectionEnd);
}
留神:在 IE8 及更早版本不反对这两个属性。
选中局部文本
HTML5 提供了 setSelectionRange()
办法用于选中局部文本:
setSelectionRange(start, end, direction): void;
start
:被选中的第一个字符的地位索引,从 0 开始。如果这个值比元素的value
长度还大,则会被看做value
最初一个地位的索引。end
:被选中的最初一个字符的下一个地位索引。如果这个值比元素的value
长度还大,则会被看做value
最初一个地位的索引。direction
:该参数是可选的字符串类型,示意抉择方向,能够传入“forward”/“backward”/“none”
三个值。
上面看一个例子:
<input type="text" id="text-sample" size="20" value="Hello World!">
<button onclick="selectText()"> 选中局部文本 </button>
<script>
function selectText() {let input = document.getElementById("text-sample");
input.focus();
input.setSelectionRange(4, 8); // o Wo
}
</script>
如果想要看到选中成果,必须让文本框取得焦点。
输出过滤
不同文本框常常须要保障输出特定类型或格局的数据,或者数据须要蕴含特定字符或必须匹配某个特定模式。而文本框并未提供验证性能,因而要配合 JavaScript 脚本实现输出过滤性能。
屏蔽字符
有些输入框须要呈现或不呈现特定字符。如果想要将输入框变成只读的,只须要应用 preventDefault()
办法将按键都屏蔽:
input.addEventListener("keypress", (event) => {event.preventDefault();
});
而要屏蔽特定字符,就须要查看事件的 charCode
属性。如下所示,应用正则表达式实现只容许输出数字的输入框:
input.addEventListener("keypress", (event) => {if (!/\d/.test(event.key)) {event.preventDefault();
}
});
还有一个问题须要解决:复制、粘贴及波及 Ctrl 键的其余性能。在除 IE 外的所有浏览器中,后面代码会屏蔽快捷键 Ctrl+C、Ctrl+V 及其他应用 Ctrl 的组合键。因而,最初一项检测是确保没有按下 Ctrl 键,如上面的例子所示:
textbox.addEventListener("keypress", (event) => {if (!/\d/.test(String.fromCharCode(event.charCode)) &&
event.charCode > 9 &&
!event.ctrlKey){event.preventDefault();
}
});
最初这个改变能够确保所有默认的文本框行为不受影响。这个技术能够用来自定义是否容许在文本框中输出某些字符。
解决剪贴板
IE 是第一个实现了剪切板相干的事件以及通过 JavaScript 拜访剪切板数据的浏览器,其它浏览器在起初也都反对了雷同的事件和剪切板的拜访,起初 HTML5 将其纳入了标准。以下是与剪切板相干的 6 个事件:
beforecopy
:产生复制操作前触发。copy
:产生复制操作时触发。beforecut
:产生剪切操作前触发。cut
:产生剪切操作时触发。beforepaste
:产生粘贴操作前触发。paste
:产生粘贴操作时触发。
剪切板事件的行为及相干对象会因浏览器而异。在 Safari、Chrome 和 Firefox 中,beforecopy
、beforecut
和 beforepaste
事件只会在显示文本框的上下文菜单时触发,但 IE 不仅在这种状况下触发,也会在 copy
、cut
和 paste
事件在所有浏览器中都会按预期触发。
在理论的事件产生之前,通过 beforecopy
、beforecut
和 beforepaste
事件能够在向剪贴板发送或从中检索数据前批改数据。不过,勾销这些事件并不会勾销剪贴板操作。要阻止理论的剪贴板操作,必须勾销 copy
、cut
和 paste
事件。
剪贴板的数据通过 clipboardData
对象来获取,且clipboardData
对象提供 3 个操作数据的办法:
getData(format)
:从剪贴板获取指定格局的数据,接管的参数为指定获取的数据格式,如果没有指定数据格式或指定数据格式不存在,则此办法返回一个空字符串。setData(format, data)
:给剪贴板赋予指定格局的数据,第一个参数指定数据格式,第二个参数为第一个参数赋予数据。如果指定数据格式不存在,则将其增加到数据存储的开端;如果指定数据格式存在,则将数据替换在指定数据格式的地位。clearData(format)
:删除指定格局的数据,接管的参数为指定要删除的数据格式,如果指定格局不存在,则此办法不执行任何操作;如果此参数为空字符串或未提供,则将删除所有格局的数据。
而 clipboardData
对象在 IE 中应用 window
获取,在 Firefox、Safari 和 Chrome 中应用 event
获取。为避免未经受权拜访剪贴板,只能在剪贴板事件期间拜访 clipboardData
对象;IE 会在任何时候都裸露 clipboardData
对象。因而,要兼容两者,最好在剪贴板事件期间应用该对象。
function getClipboardText(event){var clipboardData = (event.clipboardData || window.clipboardData);
return clipboardData.getData("text");
}
function setClipboardText (event, value){if (event.clipboardData){return event.clipboardData.setData("text/plain", value);
} else if (window.clipboardData){return window.clipboardData.setData("text", value);
}
}
如果文本框只有数字,那剪贴时,就须要应用 paste
事件查看剪贴板上的文本是否有效。如果有效,能够勾销默认行为:
input.addEventListener("paste", (event) => {let text = getClipboardText(event);
if (!/^\d*$/.test(text)){event.preventDefault();
}
});
留神:Firefox、Safari 和 Chrome 只容许在 onpaste
事件中拜访 getData()
办法。
主动切换
在 JavaScript 中,能够用在以后字段实现时主动切换到下一个字段的形式来加强表单字段的易用性。比方,罕用手机号分为国家好加手机号。因而,咱们设置 2 个文本框:
<form>
<input type="text" name="phone1" id="phone-id-1" maxlength="4">
<input type="text" name="phone2" id="phone-id-2" maxlength="11">
</form>
当文本框输出到最大容许字符数后,就把焦点移到下一个文本框,这样能够减少表单的易用性并减速数据输出。如下所示:
<script>
function tabForward(event){
let target = event.target;
if (target.value.length == target.maxLength){
let form = target.form;
for (let i = 0, len = form.elements.length; i < len; i++) {if (form.elements[i] == target) {if (form.elements[i+1]) {form.elements[i+1].focus();}
return;
}
}
}
}
let inputIds = ["phone-id-1", "phone-id-2"];
for (let id of inputIds) {let textbox = document.getElementById(id);
textbox.addEventListener("keyup", tabForward);
}
</script>
这里,tabForward()
函数通过比拟用户输出文本的长度与 maxLength
属性的值来检测输出是否达到了最大长度。如果两者相等,就通过循环表中的元素汇合找到以后文本框,并把焦点设置到下一个元素。
留神:下面的代码只实用于之前既定的标记,没有思考可能存在的暗藏字段。
HTML5
HTML5 新增了一些表单提交前,浏览器会基于指定的规定进行验证,并在出错时显示适当的错误信息。而验证会基于某些条件利用到表单字段中。
必填字段
表单字段中增加 required
属性,用于标注该字段是必填项,不填则无奈提交。该属性实用于 <input>
、<textarea>
和<select>
。如下所示:
<input type="text" name="account" required>
也能够通过 JavaScript 检测对应元素的 required
属性来判断表单字段是否为必填项:
let isRequired = document.forms[0].elements["account"].required;
也能够检测浏览器是否反对 required
属性:
let isRequiredSupported = "required" in document.createElement("input");
留神:不同浏览器解决必填字段的机制不同。Firefox、Chrome、IE 和 Opera 会阻止表单提交并在相应字段上面显示有帮忙信息的弹框,而 Safari 什么也不做,也不会阻止提交表单。
更多输出类型
HTML5 为 <input>
元素减少了几个新的 type
值。如下所示:
类型 | 形容 |
---|---|
number | 数字值的输出 |
date | 日期输出 |
color | 色彩输出 |
range | 肯定范畴内的值的输出 |
month | 容许用户抉择月份和年份 |
week | 容许用户抉择周和年份 |
time | 容许用户抉择工夫(无时区) |
datetime | 容许用户抉择日期和工夫(有时区) |
datetime-local | 容许用户抉择日期和工夫(无时区) |
电子邮件地址的输出 | |
search | 搜寻(体现相似惯例文本) |
tel | 电话号码的输出 |
url | URL 地址的输出 |
这些输出表名字段应该输出的数据类型,并且提供了默认验证。如下所示:
<input type="email" name="email">
<input type="url" name="homepage">
要检测浏览器是否反对新类型,能够在 JavaScript 中创立 <input>
并设置 type
属性,之后读取它即可。老版本中会将我只类型设置为 text
,而反对的会返回正确的值。如下所示:
let input = document.createElement("input");
input.type = "email";
let isEmailSupported = (input.type == "email");
数值范畴
而下面介绍的几个如 number/range/datetime/datetime-local/date/month/week/time
几个填写数字的类型,都能够指定 min/max/step
等几个与数值无关的属性。step
属性用于规定非法数字距离,如 step="2"
,则非法数字应该为 0、2、4、6,顺次类推。如下所示:
<input type="number" min="0" max="100" step="5" name="count">
下面的例子是 <input>
中只能输出从 0 到 100 中 5 的倍数。
也能够应用 stepUp()
和 stepDown()
办法对 <input>
元素中的值进行加减,它俩会接管一个可选参数,用于示意加减的数值。如下所示:
input.stepUp(); // 加 1
input.stepUp(5); // 加 5
input.stepDown(); // 减 1
input.stepDown(10); // 减 10
输出模式
HTML5 还为文本增加了 pattern
属性,用于指定一个正则表达式。这样就能够本人设置 <input>
元素的输出模式了。如下所示:
<input type="text" pattern="\d+" name="count">
留神模式的结尾和开端别离假如有 ^
和$
。这意味着输出内容必须从头到尾都严格与模式匹配。
与新增的输出类型一样,指定 pattern
属性也不会阻止用户输出有效内容。模式会利用到值,而后浏览器会晓得值是否无效。通过拜访 pattern
属性能够读取模式:
let pattern = document.forms[0].elements["count"].pattern;
应用如下代码能够检测浏览器是否反对 pattern 属性:
let isPatternSupported = "pattern" in document.createElement("input");
检测有效性
HTML5 新增了 checkValidity()
办法,用来检测表单中任意给定字段是否无效。而判断的条件是约束条件,因而必填字段如果没有值会被视为有效,字段值不匹配 pattern
属性也会被视为有效。如下所示:
if (document.forms[0].elements[0].checkValidity()){// 字段无效,持续} else {// 字段有效}
要查看整个表单是否无效,能够间接在表单上调用 checkValidity()
办法。这个办法会在所有字段都无效时返回true
,有一个字段有效就会返回false
:
if(document.forms[0].checkValidity()){// 表单无效,持续} else {// 表单有效}
validity
属性会返回一个ValidityState
对象,示意 <input>
元素的校验状态。返回的对象蕴含一些列的布尔值的属性:
customError
:如果设置了setCustomValidity()
就返回 true,否则返回 false。patternMismatch
:如果字段值不匹配指定的pattern
属性则返回 true。rangeOverflow
:如果字段值大于max
的值则返回 true。rangeUnderflow
:如果字段值小于min
的值则返回 true。stepMisMatch
:如果字段值与min
、max
和step
的值不相符则返回 true。tooLong
:如果字段值的长度超过了maxlength
属性指定的值则返回 true。typeMismatch
:如果字段值不是"email"
或"url"
要求的格局则返回 true。valid
:如果其余所有属性的值都为 false 则返回 true。与checkValidity()
的条件统一。valueMissing
:如果字段是必填的但没有值则返回 true。
因而,通过 validity
属性能够检查表单字段的有效性,从而获取更具体的信息,如下所示:
if (input.validity && !input.validity.valid){if (input.validity.valueMissing){console.log("请指定值.")
} else if (input.validity.typeMismatch){console.log("请指定电子邮件地址.");
} else {console.log("值有效.");
}
}
禁用验证
通过指定 novalidate
属性能够禁止对表单进行任何验证:
<form method="post" action="/signup" novalidate>
<!-- 表单元素 -->
</form>
也能够在 JavaScript 通过 noValidate
属性设置,为 true
示意属性存在,为 false
示意属性不存在:
document.forms[0].noValidate = true; // 敞开验证
如果一个表单中有多个提交按钮,那么能够给特定的提交按钮增加formnovalidate
属性,指定通过该按钮无需验证即可提交表单:
<form method="post" action="/foo">
<!-- 表单元素 -->
<input type="submit" value="注册提交">
<input type="submit" formnovalidate name="btnNoValidate"
value="没有验证的提交按钮">
</form>
也能够应用 JavaScript 设置 formNoValidate
属性:
// 敞开验证
document.forms[0].elements["btnNoValidate"].formNoValidate = true;
总结
以上总结了 <input>
和 <textarea>
两个元素的一些性能,次要是 <input>
元素能够通过设置 type
属性获取不同类型的输入框,能够通过监听键盘事件并检测要插入的字符来管制文本框的内容。
还有一些与剪贴板相干的事件,并对剪贴的内容进行检测。还介绍了一些 HTML5 新增的属性和办法和新增的更多的 <input>
元素的类型,和一些与验证相干的属性和办法。
更多内容请关注公众号「海人为记」