JavaScript表單.png

前言

在 HTML 中使用 <form> 表單元素在 JavaScript 中對應(yīng)的是 HTMLFormElement 類型，而HTMLFormElement繼承了HTMLElement接口：

interface HTMLFormElement extends HTMLElement {
    ...
}

因此，HTMLFormElement 除了與 HTMLElement有一樣的屬性和方法外，還有自己獨(dú)有的屬性和方法：

• acceptCharset：服務(wù)器可以接收的字符集，等價于 HTML 的 accept-charset 屬性。
• action：請求的 URL，等價于 HTML 的 action 屬性。
• elements：表單中所有控件的 HTMLCollection。
• enctype：請求的編碼類型，等價于 HTML 的 enctype 屬性。
• length：表單中控件的數(shù)量。
• method：HTTP 請求的方法類型，通常是 get 或 post，等價于 HTML 的 method 屬性。
• name：表單的名字，等價于 HTML 的 name 屬性。
• target：用于發(fā)送請求和接收響應(yīng)的窗口的名字，等價于 HTML 的 target 屬性。
• reset()：把表單字段重置為各自的默認(rèn)值，如果沒有默認(rèn)值，則為空。
• submit()：提交表單。

如果想要獲取 <form> 表單元素的引用，需要使用 DOM 選擇器進(jìn)行查找，如 getElementById/getElementsByName/getElementsByClassName/getElementsByTagName/querySelector/querySelectorAll 這些方法，下面使用 getElementById() 方法獲取表單，只要給表單設(shè)置一個 id 屬性即可：

let form = document.getElementById("form-id");

Document中的<form>是document.forms的成員，因此可以通過索引或表單的 name 來訪問特定的表單。如下所示：

// 文檔中第一個元素
let firstForm = document.forms[0];
// 取得名字為"form-name"的表單
let formName = document.forms["form-name"];

<small>注意：表單可以同時擁有id和name，且兩者可以不相同。</small>

提交表單

一般情況下，<form>表單元素是通過客戶端用戶點(diǎn)擊的方式發(fā)送表單數(shù)據(jù)。而定義提交按鈕主要有：

• 定義使用 type=“submit” 屬性值的 <input> 元素，如 <input type="submit" value="提交">。
• 定義使用 type="submit" 屬性值的 <button> 元素，如 <button type="submit">提交</button>。
• 定義使用 type="image" 屬性值的 <input> 元素，如 <input type="image" src="submit.gif">。

這種方式提交表單會在請求之前觸發(fā) submit 事件。這就提供了一個驗(yàn)證表單數(shù)據(jù)的機(jī)會，可以根據(jù)驗(yàn)證結(jié)果來決定表單是否要提交。如下所示：

let form = document.getElementById("form-id");
form.addEventListener("submit", (event) => {
    // 驗(yàn)證表單
    if (...) {
        // 驗(yàn)證失敗后，就要阻止表單提交
        event.preventDefault();
        return;
    } 
    // 這里用于驗(yàn)證成功后將表單提交
});

調(diào)用 preventDefault() 方法可以阻止表單提交。通常，在表單數(shù)據(jù)無效以及不應(yīng)該發(fā)送到服務(wù)器可以這樣處理。

也可以調(diào)用submit() 方法提交表單，表單中不存在提交按鈕也不影響提交。如下所示：

let form = document.querySelector("#form-id");
// 提交表單
form.submit();

通過 submit() 方法提交的表單，submit 事件不會觸發(fā)。因此在調(diào)用這個方法前要先做數(shù)據(jù)驗(yàn)證。

表單提交的最大一個問題是可能會提交兩次。如果提交表單后沒有反應(yīng)，那么沒有耐心的用戶可能會多次點(diǎn)擊提交按鈕。因此，解決這種方法主要有兩種：表單提交后禁用按鈕，或者通過 onsubmit 事件取消之后的表單提交。

重置表單

一般用戶填寫完表單信息后，想要重新填寫時，可以使用重置按鈕來重置表單。而定義重置按鈕主要有：

• 定義使用 type="reset" 屬性值的 <input>元素，如 <input type="reset" value="重置">。
• 定義使用 type="reset" 屬性值的 <button> 元素，如 <button type="reset">重置</button>

重置成功后，表單字段的值會重置為默認(rèn)值；如果沒有默認(rèn)值，則會為空。

重置按鈕可以觸發(fā) reset 事件。這個事件為取消重置提供了機(jī)會。如下所示：

let form = document.getElementById("form-id");
form.addEventListener("reset", (event) => {
    event.preventDefault();
});

重置按鈕也可以調(diào)用 reset() 方法完成重置操作：

let form = document.getElementById("form-id");
// 重置表單
form.reset();

但 reset()方法會觸發(fā) reset 事件 。

<small>注意：表單設(shè)計中通常不提倡重置表單。</small>

表單字段

表單元素可以像頁面中的其它元素一樣使用原生 DOM 方法來訪問。此外，調(diào)用 elements 屬性為表單的有序列表，包含表單中所有標(biāo)簽元素的引用，包括<input>、<textarea>、<button>、<select>和<fieldset>元素，并按照在 HTML 中出現(xiàn)的次序保存，通過索引和name屬性進(jìn)行訪問。如下所示：

let form = document.getElementById("form-id");
// 取得表單中的第一個字段
let field1 = form.elements[0];
// 取得表單中名為"textbox-name"的字段
let field2 = form.elements["textbox-name"];
// 取得字段的數(shù)量
let fieldCount = form.elements.length;

如果多個表單控件使用同一個 name 值，比如 <input>元素設(shè)置type="radio"屬性為單選，就會返回包含所有同名元素的 HTMLCollection。如下所示：

<form method="post" id="form-id">
    <ul>
        <li><input type="radio" name="sex" value="男">男</li>
        <li><input type="radio" name="sex" value="女">女</li>
        <li><input type="radio" name="sex" value="未知">未知</li>
    </ul>
</form>

因此，訪問 elements["sex"] 返回的 NodeList 就包含著 3 個元素；而使用索引訪問時，就會返回當(dāng)前位置的元素。如下所示：

let form = document.getElementById("form-id");
let sexes = form.elements["sex"];
console.log(sexes.length); // 3
let index_one = sexes[1];
let form_one = form.elements[1];
console.log(index_one === form_one); // true

公共屬性

除了 <fieldset> 元素以外，所有表單字段都有一組同樣的屬性。由于 <input> 類型可以表示多種表單字段，因此某些屬性只適用于特定類型的字段。除此之外的屬性可以在任何表單字段上使用。以下列出了這些表單字段的公共屬性和方法。

• disabled：布爾值，表示表單字段是否禁用。
• form：指針，指向表單字段所屬的表單。這個屬性是只讀的。
• name：字符串，這個字段的名字。
• readOnly：布爾值，表示這個字段是否只讀。
• tabIndex：數(shù)值，表示這個字段在按Tab 鍵時的切換順序。
• type：字符串，表示字段類型，如"checkbox"、"radio"等。
• value：要提交給服務(wù)器的字段值。對文件輸入字段來說，這個屬性是只讀的，僅包含計算機(jī)上某個文件的路徑。

JavaScript 可以動態(tài)修改任何屬性，當(dāng)然，form屬性除外。如下所示：

let form = document.getElementById("form-id");
let field = form.elements[0];
// 修改字段的值
field.value = "修改后的值";
// 檢查字段所屬的表單
console.log(field.form === form); // true
// 給字段設(shè)置焦點(diǎn)
field.focus();
// 禁用字段
field.disabled = true;
// 改變字段的類型（不推薦，但對<input>來說是可能的）
field.type = "checkbox";

動態(tài)修改表單字段屬性的能力為修改表單提供了方便。如當(dāng)點(diǎn)擊兩次提交按鈕時，會在第一次提交后，通過監(jiān)聽submit事件來實(shí)現(xiàn)禁用提交按鈕。如下所示：

// 避免多次提交表單的代碼
let form = document.getElementById("form-id");
form.addEventListener("submit", (event) => {
let target = event.target;
// 取得提交按鈕
let btn = target.elements["submit-btn"];
// 禁用提交按鈕
btn.disabled = true;
});

以上代碼，通過監(jiān)聽 submit 事件，并在函數(shù)中獲取按鈕并設(shè)置disabled=true，來達(dá)到提交按鈕禁用。注意：這個功能不能通過直接給提交按鈕添加 onclick 事件進(jìn)行實(shí)現(xiàn)，原因是不同瀏覽器觸發(fā)事件的時機(jī)不一樣。有些瀏覽器會在觸發(fā)表單的 submit 事件前先觸發(fā) onclick 事件，有些瀏覽器會后觸發(fā) onclick 事件。對于先觸發(fā) onclick 事件的瀏覽器，這個按鈕會在表單提交前被禁用，這意味著表單不會被提交。因此，最好使用表單的 submit 事件進(jìn)行禁用提交按鈕。但這種方式不適用于沒有提交按鈕的表單提交，因?yàn)?，只有提交按鈕才能觸發(fā) submit 事件。

type 屬性可以用于除<fieldset>之外的任何表單字段。對于<input>元素，這個值等于 HTML 的 type 屬性值。對于其他元素，這個 type 屬性的值按照下表設(shè)置。

對于<input>和<button>元素，可以動態(tài)修改其 type 屬性。但<select>元素的 type 屬性是只讀的。

公共方法

每個表單字段都有兩個公共方法：

• focus()：把瀏覽器焦點(diǎn)設(shè)置到表單字段，該字段會變成活動字段并可以響應(yīng)鍵盤事件。
• blur()：從元素上移出焦點(diǎn)，焦點(diǎn)不會轉(zhuǎn)移到任何特定元素，僅僅是從調(diào)用這個方法的元素上移除。

給一個 focus() 方法的例子：

window.addEventListener("load", (event) => {
    document.forms[0].elements[0].focus();
});

上述情況就是在頁面加載后，把焦點(diǎn)定位到表單中的第一個字段。注意：如果表單中第一個字段是type="hidden"屬性的<input>元素，或者該字段被 CSS 屬性 display 或 visibility 隱藏，以上代碼就會出錯。

在 HTML5 中，表單字段增加了 autofocus 屬性，支持的瀏覽器會自動為帶有該屬性的元素設(shè)置焦點(diǎn)，無須使用 JavaScript。如下所示：

<input type="text" autofocus>

為了讓之前的代碼在使用autofocus時也能正常工作，必須先檢測元素上是否設(shè)置了該屬性。如果設(shè)置了 autofocus，就不再調(diào)用 focus()：

window.addEventListener("load", (event) => {
    let element = document.forms[0].elements[0];
    if (element.autofocus !== true) {
        element.focus();
    }
});

<small>注意：默認(rèn)情況下只能給表單元素設(shè)置焦點(diǎn)。不過，通過將 tabIndex 屬性設(shè)置為–1 再調(diào)用focus()，也可以給任意元素設(shè)置焦點(diǎn)。</small>

再給一個 blur() 的例子：

document.forms[0].elements[0].blur();

在瀏覽器支持 readOnly 屬性之前，Web 開發(fā)者通常會使用這個方法創(chuàng)建只讀字段?，F(xiàn)在很少有需要調(diào)用blur()的了。

公共事件

除了鼠標(biāo)、鍵盤、變化和HTML 事件外，所有字段還支持以下 3 個事件：

• blur：字段失去焦點(diǎn)時，會觸發(fā)該事件。
• change：<input>和<textarea>元素的 value 發(fā)生變化且失去焦點(diǎn)時觸發(fā)，或者在<select>元素中選中項(xiàng)發(fā)生變化時觸發(fā)。
• focus：在字段獲得焦點(diǎn)時觸發(fā)。

blur 和 focus 事件是用戶手動改變焦點(diǎn)或調(diào)用blur/focus方法時觸發(fā)。change事件是因控件不同而改變觸發(fā)時機(jī)。

• <input> 和 <textarea>：change事件會在字段失去焦點(diǎn)，同時 value 自控件獲得焦點(diǎn)后發(fā)生改變時觸發(fā)。
• <select>：change 事件會在用戶改變選中項(xiàng)時觸發(fā)，不需要控件失去焦點(diǎn)。

focus 和 blur 事件通常用于改變用戶界面，提供可見的提示或額外功能；change事件通常用于驗(yàn)證用戶在字段中輸入的內(nèi)容。比如，有的文本框可能只限于接收數(shù)值，focus 事件用來改變控件的背景顏色以便更清楚地表明當(dāng)前字段獲得了焦點(diǎn)，blur 事件用于去掉這個背景顏色，change 事件用于在用戶輸入了非數(shù)值時把背景顏色改為紅色。如下所示：

let textbox = document.forms[0].elements[0];
textbox.addEventListener("focus", (event) => {
    let target = event.target;
    if (target.style.backgroundColor != "red") {
        target.style.backgroundColor = "yellow";
    }
});
textbox.addEventListener("blur", (event) => {
    let target = event.target;
    target.style.backgroundColor = /[^\d]/.test(target.value) ? "red" : "";
});
textbox.addEventListener("change", (event) => {
    let target = event.target;
    target.style.backgroundColor = /[^\d]/.test(target.value) ? "red" : "";
});

上述代碼中，onfocus 事件會把文本框的背景改為黃色，表明是當(dāng)前活動字段。onblur 和 onchange 事件會在發(fā)現(xiàn)非數(shù)值字符時把背景改為紅色。為測試非數(shù)值字符，這里使用了簡單的正則表達(dá)式來檢測文本框的value。這個功能必須同時在 onblur 和 onchange 事件上實(shí)現(xiàn)，確保無論文本框是否改變都能執(zhí)行驗(yàn)證。

<small>注意：blur 和 change 事件的關(guān)系并沒有明確定義。在某些瀏覽器中，blur事件會先于 change 事件觸發(fā)；在其它瀏覽器中，觸發(fā)順序會相反。因此不能依賴這兩個事件觸發(fā)的順序，必須區(qū)分時要多加注意。</small>

總結(jié)

HTML 和 ECMAScript 都更新了好幾個版本，但是表單幾乎從來沒有改變。但是，通過 JavaScript 可以增加現(xiàn)有表單字段以提供新功能或增強(qiáng)易用性。也因此，表單字段也暴露了屬性、方法和事件供 JavaScript 調(diào)用使用。

更多內(nèi)容請關(guān)注公眾號「海人為記」