輸入信箱時自動帶出 @ 後綴的候選清單,是註冊與登入表單常見的貼心設計。這裡用一個 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() 搭配事件委派,否則滑鼠交互會失效。