萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

jQuery 實現日期輸入格式化控件(YYYY-MM-DD 遮罩、鍵盤導航、自動補零)

效果展示

輸入框顯示固定格式 ____-__-__,用戶僅能輸入數字,自動跳過分隔符 -,Backspace 刪除數字並恢復底線,光標始終停留在下一個可輸入位置。

核心難點

  • 跨瀏覽器光標位置獲取/設定(IE 6-8 TextRange vs 現代 selectionStart)。
  • 在 keydown 階段攔截非法按鍵,並在 setTimeout 中處理字元實際寫入後的格式修正。
  • 處理選取刪除、貼上、拖拽等邊界情況。

工具函式:光標操作

// 獲取光標位置
function getCursor(el) {
  if (el.selectionStart !== undefined) return el.selectionStart;
  // IE 6-8
  const range = document.selection.createRange();
  range.moveStart('character', -el.value.length);
  return range.text.length;
}

// 設定光標位置
function setCursor(el, pos) {
  if (el.selectionStart !== undefined) {
    el.selectionStart = el.selectionEnd = pos;
  } else {
    const range = el.createTextRange();
    range.moveStart('character', -el.value.length);
    range.move('character', pos);
    range.select();
  }
}

// 獲取選取文字
function getSelection(el) {
  if (el.selectionStart !== undefined) return el.value.slice(el.selectionStart, el.selectionEnd);
  return document.selection.createRange().text;
}

// 設定選取範圍
function setSelection(el, start, end) {
  if (el.selectionStart !== undefined) {
    el.selectionStart = start; el.selectionEnd = end;
  } else {
    const range = el.createTextRange();
    range.move('character', -el.value.length);
    range.moveEnd('character', end);
    range.moveStart('character', start);
    range.select();
  }
}

主控制邏輯

const DATE_MASK = '____-__-__';
const DATE_REGEX = /^(\d{4})-(\d{2})-(\d{2})$/;

$('.date-input').each(function () {
  const $input = $(this);
  const el = this;

  // 重置光標到第一個底線
  function resetCursor() {
    if (el.value.length !== DATE_MASK.length) el.value = DATE_MASK;
    const idx = el.value.indexOf('_');
    setCursor(el, idx > -1 ? idx : DATE_MASK.length);
  }

  // focus:空值則填入遮罩
  $input.on('focus', function () {
    if (!this.value) this.value = DATE_MASK;
    resetCursor();
  });

  // blur:若仍為遮罩則清空
  $input.on('blur', function () {
    if (this.value === DATE_MASK) this.value = '';
  });

  // keydown:核心邏輯
  $input.on('keydown', function (e) {
    const key = e.which;
    const cursor = getCursor(el);
    const val = el.value;

    // 數字鍵 0-9
    if (key >= 48 && key <= 57) {
      if (cursor >= DATE_MASK.length || val[cursor] === '-') return false; // 末尾或分隔符處不輸入
      if (val.indexOf('_') === -1) return false; // 已滿

      const before = val.slice(0, cursor);
      setTimeout(() => {
        // 字元已寫入,移除新數字後的第一個底線
        const after = el.value.slice(cursor + 1);
        el.value = before + after.replace(/(\d)_/, '$1');
        resetCursor();
      }, 1);
      return true;
    }

    // Backspace
    if (key === 8) {
      if (cursor === 0 && !getSelection(el)) return false; // 行首且無選取
      // 刪除分隔符前的數字:將分隔符前的數字換回底線
      if (val[cursor - 1] === '-') {
        const arr = val.split('');
        arr.splice(cursor - 2, 1, '_');
        el.value = arr.join('');
        resetCursor();
        return false;
      }
      setTimeout(() => {
        if (el.value === '') el.value = DATE_MASK;
        const arr = el.value.split('');
        arr.splice(getCursor(el), 0, '_');
        el.value = arr.join('');
        resetCursor();
      }, 1);
      return true;
    }

    // 其他按鍵(含 Delete、字母、貼上等)全部攔截
    return false;
  });

  // 初始化
  if (!el.value) el.value = DATE_MASK;
  resetCursor();
});

HTML 使用

<input type="text" class="date-input" placeholder="請輸入日期">

驗證與取值

function getDateValue($input) {
  const val = $input.val();
  return DATE_REGEX.test(val) ? val : null;
}

// 表單提交前
$('form').on('submit', function () {
  const date = getDateValue($(this).find('.date-input'));
  if (!date) { alert('日期格式不正確'); return false; }
});

進階優化

  • 日期合法性檢查:失焦時用 `new Date(val)` 驗證月份/日期是否合法(如 2024-02-30 為無效)。
  • 支援貼上:監聽 paste 事件,清理非數字字元後按遮罩填入。
  • 無障礙:添加 `aria-label="日期,格式 YYYY-MM-DD"`、`role="textbox"`。
  • TypeScript 重寫:封裝為可複用的 Class/Component,提供型別定義。
copyright © 萬盛學電腦網 all rights reserved