DIV CSS 佈局教程網

JavaScript 表單文字框腳本開發重點整理
編輯:關於JavaScript     

HTML 裡要呈現文字輸入,主要有兩種元素:單行的 input(需指定 type="text")與多行的 textarea。兩者在屬性與腳本操作上有些差異,值得先釐清。

  • size:指定單行文字框可顯示的字元數。
  • value:設定文字框的初始值。
  • maxlength:限制可接受的最大字元數。

textarea 的初始值必須寫在開始與結束標籤之間,而它用 cols 表示字元列寬、rows 表示行數,且在 HTML 層面無法直接指定最大字元數。

一、選取文字

兩種文字框都支援 select() 方法,用來選取全部內容,不接受參數;對應的 select 事件則在文字被選取時觸發。

1. select() 方法

以下寫法讓文字框一取得焦點就全選:

var textBox = document.getElementById("myForm").elements["firstName"];
textBox.value = "input your firstName"; // 設定預設值
textBox.addEventListener("focus", function () {
  event.target.select();
});

2. select 事件

觸發時機有幾個差異要注意:

  • 一般情況下,使用者選取文字並放開滑鼠後才觸發。
  • IE8 及更早版本中,只要選中一個字母(不必放開滑鼠)就會觸發。
  • 呼叫 select() 方法時也會觸發。
var textBox = document.getElementById("myForm").elements["firstName"];
textBox.value = "input your firstName";
textBox.addEventListener("select", function () {
  console.log("selected");
});

3. 取得被選取的文字

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();
  }
});

四、操作剪貼簿

共有六個剪貼簿事件:

  • beforecopy:複製操作發生前觸發
  • copy:複製時觸發
  • beforecut:剪下操作發生前觸發
  • cut:剪下時觸發
  • beforepaste:貼上操作發生前觸發
  • paste:貼上時觸發
// 複製前先改寫內容
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();
        }
      }
    }
  }
}

六、HTML5 約束驗證 API

1. required 屬性

必填欄位加上 required 即可,適用於 input、textarea、select。偵測瀏覽器支援情況:

var isRequiredSupported = "required" in document.createElement("input");

2. 新增的輸入型別

input 的 type 增加了 email 與 url,各瀏覽器也提供了對應的驗證機制:

var input = document.createElement("input");
input.type = "email";
var isEmailSupported = (input.type == "email");

3. 數值範圍

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;
});

4. 輸入模式 pattern

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");

5. 檢測有效性

所有表單欄位都有 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 包含的屬性有:

  • customError:是否呼叫過 setCustomValidity()
  • patternMismatch:是否與 pattern 不符
  • rangeOverflow:是否大於 max
  • rangeUnderflow:是否小於 min
  • stepMismatch:步長是否不合規則
  • tooLong:是否超過 maxlength
  • typeMismatch:是否非 email / url 等指定型別
  • valid:以上皆為 false 時回傳 true
  • valueMissing:required 卻沒有值時回傳 true

6. 關閉驗證

表單加上 novalidate 屬性即可略過驗證;提交按鈕加上 formnovalidate 屬性,則只讓該按鈕跳過驗證。

var form = document.forms[0];
form.noValidate = true;                       // 整個表單不驗證
var submit = document.getElementById("submit");
submit.formNoValidate = true;                 // 僅該按鈕不驗證並直接送出

掌握這些 API,多數前端表單驗證都能在不引入額外套件的情況下完成,同時兼顧無障礙與瀏覽器原生體驗。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved