萬盛學電腦網

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

jQuery 郵箱自動完成外掛:jquery.mailAutoComplete 使用詳解

外掛簡介

jquery.mailAutoComplete 是一款輕量級 jQuery 外掛,在輸入框輸入「@」後自動彈出常見郵箱域名建議清單,支援鍵盤上下選擇、Enter 確認、滑鼠點擊、自訂樣式與提示文字。

引入檔案

<script src="jquery-1.6.min.js"></script> <!-- jQuery 核心 -->
<script src="jquery.mailAutoComplete-3.1.js"></script> <-- 外掛 -->

基本用法(使用預設樣式與郵箱清單)

<input type="text" id="email" size="28" />

<script>
$(function() {
  $("#email").mailAutoComplete(); // 預設支援 qq.com, gmail.com, 126.com 等 10 種
});
</script>

進階配置:自訂樣式、郵箱清單、提示文字

<style>
.out_box  { border:1px solid #ccc; background:#fff; font:12px/20px Tahoma; }
.list_box { border-bottom:1px solid #eee; padding:0 5px; cursor:pointer; }
.focus_box { background:#f0f3f9; }
.mark_box { color:#c00; }
</style>

<input type="text" id="customTest" size="28" />

<script>
$(function() {
  $("#customTest").mailAutoComplete({
    boxClass: "out_box",       // 外層容器 class
    listClass: "list_box",     // 列表項預設 class
    focusClass: "focus_box",   // 游標選中 class
    markCalss: "mark_box",     // 高亮標記 class(域名匹配部分)
    autoClass: false,          // false=不注入預設 CSS,改用自訂樣式
    textHint: true,            // 顯示提示文字
    hintText: "請輸入郵箱地址", // 提示文字內容
    mailArr: ["qq.com", "gmail.com", "163.com", "126.com", "company.com"] // 自訂域名
  });
});
</script>

核心參數說明

參數預設值說明
boxClass"mailListBox"下拉清單外層容器 class
listClass"mailListDefault"清單項預設 class
focusClass"mailListFocus"鍵盤/滑鼠選中項 class
markCalss"mailListHlignt"域名匹配高亮部分 class
zIndex1下拉層級
autoClasstrue是否自動注入預設 CSS
mailArr10 大常見域名郵箱域名陣列
textHintfalse是否啟用提示文字
hintText""提示文字內容
focusColor"#333"焦點時文字顏色
blurColor"#999"失焦時文字顏色

內部運作原理

  1. 包裹輸入框於 <span style="position:relative"> 中,建立絕對定位下拉容器。
  2. 監聽 keyup 事件,解析「@」前後字串,過濾 mailArr 產生匹配清單。
  3. 鍵盤上下鍵切換 index,Enter 確認填入,滑鼠點擊直接填入。
  4. 失焦時隱藏清單,若啟用 textHint 則恢復提示文字。

常見問題與解決

  • 清單定位錯誤:確保輸入框無 transform 父層,或手動計算 offset() 定位。
  • 中文輸入法干擾:composition 事件期間暫停過濾,避免拼音中途觸發。
  • 動態新增輸入框:需在元素插入 DOM 後再呼叫 .mailAutoComplete()。
copyright © 萬盛學電腦網 all rights reserved