DIV CSS 佈局教程網

信箱欄位的自動補全:jQuery mailAutoComplete 外掛實作
編輯:JavaScript綜合知識     

輸入信箱時自動帶出 @ 後綴的候選清單,是註冊與登入表單常見的貼心設計。這裡用一個 jQuery 外掛來實作。

外掛的設定選項

mailAutoComplete 接受一個 options 物件,常用的有 boxClass(外層容器樣式)、listClass(一般列表項)、focusClass(目前選取項)、markCalss(高亮片段)、autoClass(是否使用外掛內建樣式)、mailArr(網域陣列)以及 textHint 與 hintText(提示文字的顯示與隱藏):

var defaults = {
  boxClass: "mailListBox",
  listClass: "mailListDefault",
  focusClass: "mailListFocus",
  markCalss: "mailListHlignt",
  zIndex: 1,
  autoClass: true,
  mailArr: ["qq.com","gmail.com","126.com","163.com","hotmail.com",
            "yahoo.com","yahoo.com.cn","live.com","sohu.com","sina.com"],
  textHint: false,
  hintText: "",
  focusColor: "#333",
  blurColor: "#999"
};

運作方式

外掛會把輸入框包進一個相對定位的 span,並在其後插入一個絕對定位的列表容器。使用者在 keyup 時,程式取出 @ 前的字串作為比對關鍵字,若 @ 後已有內容則一併用正則篩選 mailArr,再用 createHtml 組出候選清單;上下鍵移動 index、Enter 直接採用該項。滑鼠移入會同步更新 index 與高亮樣式,mousedown 時把值寫回輸入框——用 mousedown 而非 click,是為了避開輸入框先失焦導致清單被隱藏的時序問題。

頁面中的使用

<style type="text/css">
  .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>

<p>自定義 class 展示:<input type="text" id="customTest" size="28" /></p>

<script src="js/jquery-1.6.min.js"></script>
<script src="js/jquery.mailAutoComplete-3.1.js"></script>
<script type="text/javascript">
$(function () {
  $("#customTest").mailAutoComplete({
    boxClass: "out_box",
    listClass: "list_box",
    focusClass: "focus_box",
    markCalss: "mark_box",
    autoClass: false,
    textHint: true,
    hintText: "請輸入郵箱地址"
  });
});
</script>

使用提醒

把 autoClass 設為 false 時,外掛不會注入內建樣式,必須自行準備外框、列表項與高亮三種 class,否則清單會失去外觀。另外範例中的 .live() 在 jQuery 1.9 之後已移除,若使用新版 jQuery 需改寫為 .on() 搭配事件委派,否則滑鼠交互會失效。

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