HTML 裡要呈現文字輸入,主要有兩種元素:單行的 input(需指定 type="text")與多行的 textarea。兩者在屬性與腳本操作上有些差異,值得先釐清。
textarea 的初始值必須寫在開始與結束標籤之間,而它用 cols 表示字元列寬、rows 表示行數,且在 HTML 層面無法直接指定最大字元數。
兩種文字框都支援 select() 方法,用來選取全部內容,不接受參數;對應的 select 事件則在文字被選取時觸發。
以下寫法讓文字框一取得焦點就全選:
var textBox = document.getElementById("myForm").elements["firstName"];
textBox.value = "input your firstName"; // 設定預設值
textBox.addEventListener("focus", function () {
event.target.select();
});
觸發時機有幾個差異要注意:
var textBox = document.getElementById("myForm").elements["firstName"];
textBox.value = "input your firstName";
textBox.addEventListener("select", function () {
console.log("selected");
});
selectionStart 與 selectionEnd 保存的是以 0 起算的偏移量,代表選取範圍:
var textBox = document.getElementById("myForm").elements["firstName"];
textBox.value = "input your firstName";
textBox.addEventListener("select", function () {
var selected = textBox.value.substring(textBox.selectionStart, textBox.selectionEnd);
console.log(selected);
});
反過來,也可以用它設定「取得焦點即全選」:
textBox.addEventListener("focus", function () {
textBox.selectionStart = 0;
textBox.selectionEnd = textBox.value.length;
});
IE8 不支援這兩個屬性,而是提供 document.selection 物件來取得整個文件範圍內的選取資訊。相容寫法如下:
function getSelectedText(textbox) {
if (typeof textbox.selectionStart == "number") {
return textbox.value.substring(textbox.selectionStart, textbox.selectionEnd);
} else if (document.selection) {
return document.selection.createRange().text;
}
}
setSelectionRange() 接收兩個參數:起始索引與結束索引。以下範例阻止使用者選取任何內容:
textBox.addEventListener("focus", function () {
textBox.setSelectionRange(0, 0);
});
textBox.addEventListener("select", function () {
textBox.setSelectionRange(0, 0);
});
呼叫 setSelectionRange() 前後要確保文字框已帶焦點。IE 則改用文字範圍物件處理:
var range = textBox.createTextRange();
range.collapse(true); // 範圍折疊到開頭
range.moveStart("character", 0);
range.moveEnd("character", textBox.value.length);
range.select();
相容版本(實務上很常用):
function selectText(textbox, startIndex, stopIndex) {
if (textbox.setSelectionRange) {
textbox.setSelectionRange(startIndex, stopIndex);
} else if (textbox.createTextRange) {
var range = textbox.createTextRange();
range.collapse(true);
range.moveStart("character", startIndex);
range.moveEnd("character", stopIndex);
range.select();
}
}
只允許輸入數字的寫法:
var textBox = document.getElementById("myForm").elements["firstName"];
textBox.autofocus = true;
textBox.addEventListener("keypress", function (event) {
if (!/\d/.test(String.fromCharCode(event.charCode))) {
event.preventDefault();
}
});
但部分瀏覽器會對上下鍵、退格鍵觸發 keypress,因此需要放行這些常用按鍵,只要干擾字元碼小於 10 的按鍵即可:
textBox.addEventListener("keypress", function (event) {
if (!/\d/.test(String.fromCharCode(event.charCode))
&& event.charCode > 9 && !event.ctrlKey) {
event.preventDefault();
}
});
共有六個剪貼簿事件:
// 複製前先改寫內容
textBox.addEventListener("beforecopy", function () {
textBox.value = "do not copy";
});
// 複製時直接攔截
textBox.addEventListener("copy", function (event) {
event.preventDefault();
});
要存取剪貼簿資料可用 clipboardData 物件。IE 把它掛在 window 上且隨時可存取;Firefox、Safari、Chrome 則掛在事件物件上,且僅在處理剪貼簿事件期間有效。它有三個方法:getData()、setData()、clearData()。getData() 接收一個格式參數(IE 支援 text 與 URL,其他瀏覽器使用 MIME 類型,可用 text 代替 text/plain);setData() 接收型別與內容兩個參數。
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);
}
}
值得一提的是,現代瀏覽器已大幅收緊對剪貼簿的存取權限,實務上應以 Clipboard API 為主。
常見於電話號碼分格輸入:前一格填滿就自動跳到下一格。
<form action=""> <input type="text" name="tel11" id="txtTel1" maxLength="3"> <input type="text" name="tel12" id="txtTel2" maxLength="3"> <input type="text" name="tel13" id="txtTel3" maxLength="4"> <input type="submit" name="btn" id="btn" value="submit"> </form>
var textbox1 = document.getElementById("txtTel1");
var textbox2 = document.getElementById("txtTel2");
var textbox3 = document.getElementById("txtTel3");
textbox1.addEventListener("keyup", tabForward);
textbox2.addEventListener("keyup", tabForward);
textbox3.addEventListener("keyup", tabForward);
function tabForward() {
var target = event.target;
// 當內容長度已達上限
if (target.value.length == target.maxLength) {
var form = target.form;
for (var i = 0, len = form.elements.length; i < len; i++) {
if (form.elements[i] == target) {
var next = form.elements[i + 1];
if (next && next.nodeType == 1
&& next.tagName.toLowerCase() == "input"
&& next.type == "text") {
next.focus();
}
}
}
}
}
必填欄位加上 required 即可,適用於 input、textarea、select。偵測瀏覽器支援情況:
var isRequiredSupported = "required" in document.createElement("input");
input 的 type 增加了 email 與 url,各瀏覽器也提供了對應的驗證機制:
var input = document.createElement("input");
input.type = "email";
var isEmailSupported = (input.type == "email");
HTML5 另外定義了 number、range、datetime、datetime-local、date、month、week、time 等數值型輸入元素,並可用 min、max、step 屬性限制範圍,同時提供 stepUp() 與 stepDown() 兩個方法(各接受一個步進參數)。
<form action=""> <input type="range" name="tel14" id="txtTel4" required min="10" max="20" step="1"> <input type="button" value="up" id="up"> <input type="text" id="output"> <input type="submit" name="btn" id="btn" value="submit"> </form>
var input = document.getElementById("txtTel4");
var up = document.getElementById("up");
input.addEventListener("mousemove", function () {
document.getElementById("output").value = input.value;
});
up.addEventListener("click", function () {
input.stepUp(2); // 以 2 為單位遞增
document.getElementById("output").value = input.value;
});
pattern 屬性的值是一段正則表達式,用來約束文字框的值:
<input type="text" id="number" pattern="\d{3}">
var num = document.getElementById("number");
console.log(num.pattern); // \d{3}
var isPatternSupported = "pattern" in document.createElement("input");
所有表單欄位都有 checkValidity() 方法,有效時回傳 true:
var form = document.forms[0];
var check = document.getElementById("check");
var submit = document.getElementById("submit");
check.addEventListener("click", function () {
console.log(form.checkValidity()); // 整個表單是否正確
if (form.checkValidity()) {
submit.removeAttribute("disabled");
check.disabled = true;
} else {
alert("請檢查表單");
}
});
validity 屬性則提供更具體的失敗原因:
var inputName = document.getElementById("inputName");
inputName.onblur = function () {
if (inputName.checkValidity()) {
inputName.style.color = "white";
inputName.style.backgroundColor = "green";
} else {
inputName.style.color = "white";
inputName.style.backgroundColor = "red";
if (inputName.validity.patternMismatch) {
inputName.value = "請填寫正確的格式";
}
}
};
inputName.addEventListener("mouseenter", function () {
inputName.focus();
inputName.select();
});
validity 包含的屬性有:
表單加上 novalidate 屬性即可略過驗證;提交按鈕加上 formnovalidate 屬性,則只讓該按鈕跳過驗證。
var form = document.forms[0];
form.noValidate = true; // 整個表單不驗證
var submit = document.getElementById("submit");
submit.formNoValidate = true; // 僅該按鈕不驗證並直接送出
掌握這些 API,多數前端表單驗證都能在不引入額外套件的情況下完成,同時兼顧無障礙與瀏覽器原生體驗。