docs(elements): edit input

This commit is contained in:
ruanyf
2018-05-12 11:23:06 +08:00
parent 19db1a21d0
commit 46b04ffcd6

View File

@@ -75,3 +75,33 @@
- `step`:字符串,表示在`min`属性到`max`属性之间,每次递增或递减时的数值或时间。
- `valueAsDate``Date`实例,一旦设置,该`<input>`元素的值会被解释为指定的日期。如果无法解析该属性的值,`<input>`节点的值将是`null`
- `valueAsNumber`:浮点数,当前`<input>`元素的值会被解析为这个数值。
## HTMLInputElement 的实例方法
- `focus()`:当前`<input>`元素获得焦点。
- `blur()`:移除`<input>`元素的焦点。
- `select()`:选中`<input>`元素内部的所有文本。该方法不能保证`<input>`获得焦点,最好先用`focus()`方法,再用这个方法。
- `click()`:模拟鼠标点击当前的`<input>`元素。
- `setSelectionRange()`:选中`<input>`元素内部的一段文本但不会将焦点转移到选中的文本。该方法接受三个参数第一个参数是开始的位置从0开始第二个参数是结束的位置不包括该位置第三个参数是可选的表示选择的方向有三个可能的值`forward``backward`和默认值`none`)。
- `setRangeText()`:新文本替换选中的文本。该方法接受四个参数,第一个参数是新文本,第二个参数是替换的开始位置,第三个参数是结束位置,第四个参数表示替换后的行为(可选),有四个可能的值:`select`(选中新插入的文本)、`start`(选中的开始位置移到插入的文本之前)、`end`(选中的文本移到插入的文本之后)、`preserve`(保留原先选中的位置,默认值)。
- `setCustomValidity()`:该方法调用后,会提示用户校验失败。它的参数就是报错的提示信息。
- `checkValidity()`:返回一个布尔值,表示当前节点的校验结果。如果返回`false`,表示不满足校验要求,否则就是校验成功或不必校验。
- `stepDown()`:将当前`<input>`节点的值减少一个步长。该方法可以接受一个整数`n`作为参数,表示一次性减少`n`个步长,默认是`1`。有几种情况会抛错:当前`<input>`节点不适合递减或递增、当前节点没有`step`属性、`<input>`节点的值不能转为数字、递减之后的值小于`min`属性或大于`max`属性。
- `stepUp()`:将当前`<input>`节点的值增加一个步长。其他与`stepDown()`方法相同。
下面是`setSelectionRange()`方法的一个例子。
```javascript
/* HTML 代码如下
<p><input type="text" id="mytextbox" size="20" value="HelloWorld"/></p>
<p><button onclick="SelectText()">选择文本</button></p>
*/
function SelectText() {
var input = document.getElementById('mytextbox');
input.focus();
input.setSelectionRange(2, 5);
}
```
上面代码中,点击按钮以后,会选中`llo`三个字符。