日期輸入欄最惱人的地方是格式:使用者可能打 2026-8-9、2026/08/09,甚至漏掉分隔符。與其送出後再驗證退回,不如在輸入當下就引導格式——打開時先顯示 ____-__-__ 這個骨架,只允許數字進場,游標自動跳到下一個該填的位置。本文記錄這個自製控件的完整思路,JavaScript 部分約一百多行。

日期: <input type="text" id="dateInputer" class="hhm-dateInputer" placeholder="請輸入日期">
約定很簡單:把 class 設為 hhm-dateInputer,程式靠這個 class 找出所有要套用的輸入框。用 class 而非 id,是為了讓同一頁能有多個日期欄位。
<script src="https://code.jquery.com/jquery-1.9.1.min.js"></script>
主要用來選取元素與綁定事件。
因為這個控件需要頻繁讀取與設定游標位置,先抽出四個工具函式。每個函式都分兩條路:支援 selectionStart 的現代瀏覽器走索引,舊版 IE 6~8 則改用 document.selection 與 TextRange。
//獲取光標位置
function getCursor(elem) {
//IE 9 ,10,其他浏覽器
if (elem.selectionStart !== undefined) {
return elem.selectionStart;
} else { //IE 6,7,8
var range = document.selection.createRange();
range.moveStart("character", -elem.value.length);
var len = range.text.length;
return len;
}
}
//設置光標位置
function setCursor(elem, index) {
//IE 9 ,10,其他浏覽器
if (elem.selectionStart !== undefined) {
elem.selectionStart = index;
elem.selectionEnd = index;
} else { //IE 6,7,8
var range = elem.createTextRange();
range.moveStart("character", -elem.value.length); //左邊界移動到起點
range.move("character", index); //光標放到index位置
range.select();
}
}
//獲取選中文字
function getSelection(elem) {
//IE 9 ,10,其他浏覽器
if (elem.selectionStart !== undefined) {
return elem.value.substring(elem.selectionStart, elem.selectionEnd);
} else { //IE 6,7,8
var range = document.selection.createRange();
return range.text;
}
}
//設置選中范圍
function setSelection(elem, leftIndex, rightIndex) {
if (elem.selectionStart !== undefined) { //IE 9 ,10,其他浏覽器
elem.selectionStart = leftIndex;
elem.selectionEnd = rightIndex;
} else { //IE 6,7,8
var range = elem.createTextRange();
range.move("character", -elem.value.length); //光標移到0位置。
//這裡一定是先moveEnd再moveStart
//因為如果設置了左邊界大於了右邊界,那麼浏覽器會自動讓右邊界等於左邊界。
range.moveEnd("character", rightIndex);
range.moveStart("character", leftIndex);
range.select();
}
}
程式先找出所有 hhm-dateInputer 元素,為每個綁定 focus、blur、keydown 三個事件。
focus:若內容為空,填入初始骨架 "____-__-__",並把游標移到第一個下劃線之前。
blur:若內容仍等於初始骨架(代表使用者什麼也沒填),就清空還原,避免送出無意義的底線。
keydown:這裡選擇 keydown 而非 keyup 是關鍵——keydown 觸發時按下的字元還沒進到輸入框,程式才有機會在它落地前決定要不要攔下來。判斷分三種:數字鍵就刪掉一個下劃線讓位、Backspace 就刪掉一個數字並補回下劃線、其他鍵一律 return false 擋掉。
前兩步都包在 setTimeout(..., 1) 裡,因為要等瀏覽器把字元真正寫入後再處理後續,否則讀到的還是舊值。而 resetCursor 會被反覆呼叫,負責把游標送到下一個待填位置。
//設置光標到正確的位置
function resetCursor(elem) {
var value = elem.value;
var index = value.length;
//當用戶通過選中部分文字並刪除時,此時只能將內容置為初始格式洛。
if (elem.value.length !== dateStr.length) {
elem.value = dateStr;
}
//把光標放到第一個_下劃線的前面
//沒找到下劃線就放到末尾
var temp = value.search(/_/);
index = temp > -1 ? temp : index;
setCursor(elem, index);
}
$(function(){
var inputs = $(".hhm-dateInputer");
var dateStr = "____-__-__";
inputs.each(function(index,elem){
var input = $(this);
input.on("keydown",function(event){
var that = this; //當前觸發事件的輸入框。
var key = event.keyCode;
var cursorIndex = getCursor(that);
//輸入數字
if(key >= 48 && key <= 57){
//光標在日期末尾或光標的下一個字符是"-",返回false,阻止字符顯示。
if(cursorIndex == dateStr.length || that.value.charAt(cursorIndex) === "-") {return false;}
//字符串中無下劃線時,返回false
if(that.value.search(/_/) === -1){return false;}
var fron = that.value.substring(0,cursorIndex); //光標之前的文本
var reg = /(\d)_/;
setTimeout(function(){ //setTimeout後字符已經輸入到文本中
//光標之後的文本
var end = that.value.substring(cursorIndex,that.value.length);
//去掉新插入數字後面的下劃線_
that.value = fron + end.replace(reg,"$1");
//尋找合適的位置插入光標。
resetCursor(that);
},1);
return true;
//"Backspace" 刪除鍵
}else if( key == 8){
//光標在最前面時不能刪除。 但是考慮全部文本被選中下的刪除情況
if(!cursorIndex && !getSelection(that).length){ return false;}
//刪除時遇到中劃線的處理
if(that.value.charAt(cursorIndex -1 ) == "-"){
var ar = that.value.split("");
ar.splice(cursorIndex-2,1,"_");
that.value = ar.join("");
resetCursor(that);
return false;
}
setTimeout(function(){
//值為空時重置
if(that.value === "") {
that.value = "____-__-__";
resetCursor(that);
}
//刪除的位置加上下劃線
var cursor = getCursor(that);
var ar = that.value.split("");
ar.splice(cursor,0,"_");
that.value = ar.join("");
resetCursor(that);
},1);
return true;
}
return false;
});
input.on("focus",function(){
if(!this.value){
this.value = "____-__-__";
}
resetCursor(this);
});
input.on("blur",function(){
if(this.value === "____-__-__"){
this.value = "";
}
});
});
//設置光標到正確的位置
function resetCursor(elem){
var value = elem.value;
var index = value.length;
//當用戶通過選中部分文字並刪除時,此時只能將內容置為初始格式洛。
if(elem.value.length !== dateStr.length){
elem.value = dateStr;
}
var temp = value.search(/_/);
index = temp> -1? temp: index;
setCursor(elem,index);
//把光標放到第一個_下劃線的前面
//沒找到下劃線就放到末尾
}
});
function getCursor(elem){
//IE 9 ,10,其他浏覽器
if(elem.selectionStart !== undefined){
return elem.selectionStart;
} else{ //IE 6,7,8
var range = document.selection.createRange();
range.moveStart("character",-elem.value.length);
var len = range.text.length;
return len;
}
}
function setCursor(elem,index){
//IE 9 ,10,其他浏覽器
if(elem.selectionStart !== undefined){
elem.selectionStart = index;
elem.selectionEnd = index;
} else{//IE 6,7,8
var range = elem.createTextRange();
range.moveStart("character",-elem.value.length); //左邊界移動到起點
range.move("character",index); //光標放到index位置
range.select();
}
}
function getSelection(elem){
//IE 9 ,10,其他浏覽器
if(elem.selectionStart !== undefined){
return elem.value.substring(elem.selectionStart,elem.selectionEnd);
} else{ //IE 6,7,8
var range = document.selection.createRange();
return range.text;
}
}
function setSelection(elem,leftIndex,rightIndex){
if(elem.selectionStart !== undefined){ //IE 9 ,10,其他浏覽器
elem.selectionStart = leftIndex;
elem.selectionEnd = rightIndex;
} else{//IE 6,7,8
var range = elem.createTextRange();
range.move("character",-elem.value.length); //光標移到0位置。
//這裡一定是先moveEnd再moveStart
//因為如果設置了左邊界大於了右邊界,那麼浏覽器會自動讓右邊界等於左邊界。
range.moveEnd("character",rightIndex);
range.moveStart("character",leftIndex);
range.select();
}
}
這個控件目前還有幾個可以改進的地方:缺少一個「以 JS 主動為元素掛上此功能」的公開接口,現在只能靠 class 自動掃描;鍵盤判斷依賴 keyCode(已屬淘汰屬性),小鍵盤數字、部分輸入法與行動裝置的 input 行為可能與預期不同;以及只檢查了格式骨架,並未驗證月份是否落在 1~12、日期是否超出該月天數。
若要 production 使用,建議直接採用原生 <input type="date">,它自帶日期選擇器、行動裝置鍵盤與無障礙支援;需要自訂外觀時再搭配 date-fns、Day.js 做驗證與格式化。不過就「理解游標操作與事件時序」而言,自己寫一遍這個控件收穫很大——特別是 keydown 與 setTimeout 的搭配,是許多輸入行為控制技巧的基礎。
以上就是本文的全部內容,希望對大家有所幫助,程式若有任何問題也歡迎指正。