QQ 郵箱的收件者提示、百度的搜尋框提示、淘寶的商品搜尋提示,這類「打字時即時列出候選」的效果現在幾乎是標配,因為它確實能降低輸入成本、減少出錯。這個元件把常見需求包成一個可重複使用的建構函式。
new InputSuggest({
input: HTMLInputElement, // 必選:要掛提示的輸入框
data: ['sina.cn', 'sina.com', '2008.sina.com', 'vip.sina.com.cn'], // 必選:候選清單
containerCls: '容器 className',
itemCls: '容器子項 className',
activeCls: '高亮子項 className',
width: '寬度設定,會覆蓋 containerCls 的 width',
opacity: '透明度設定,會覆蓋 containerCls 的 opacity'
});
所有外觀都透過 className 注入,這意味著樣式完全交由呼叫端決定,元件本身不寫死任何視覺風格——這是讓小元件能被不同專案 reuse 的關鍵設計。
<!DOCTYPE HTML>
<html>
<head>
<title>inputSuggest 輸入字符時提示</title>
<style type="text/css">
body{margin:0;padding:0;}
input{width:200px;}
.suggest-container{border:1px solid #C1C1C1;visibility:hidden;}
.suggest-item{padding:3px 2px;}
.suggest-active{background:#33CCFF;color:white;padding:3px 2px;}
</style>
</head>
<body>
<label>新浪</label>
<input type="text" id="sina" />
<br><br><br><br><br><br><br><br><br><br>
<label>搜狐</label>
<input type="text" id="sohu" />
</body>
</html>
注意 .suggest-container 的預設狀態是 visibility:hidden 而非 display:none。這樣做的用意是:候選清單在首次顯示前就已经參與排版、取得了正確尺寸,避免「顯示的瞬間才計算位置」導致提示框位置算錯或閃跳。
自動補全的實作骨架通常不複雜,難的是細節:
HTML5 已經內建了這個功能:加上 list 屬性並搭配 <datalist>,瀏覽器會直接提供原生候選清單與鍵盤操作,一行都不用寫 JavaScript。
<input type="text" list="domains" /> <datalist id="domains"> <option value="sina.cn"> <option value="sina.com"> <option value="2008.sina.com"> </datalist>
它的限制是樣式幾乎無法客製(清單外觀由作業系統決定),所以當設計稿要求特定的視覺呈現時,仍需回到自製元件的路。若想自製,現代做法是搭配 role="combobox"、aria-expanded、aria-activedescendant 等 ARIA 屬性,讓螢幕閱讀器也能正確朗讀候選狀態——這是以後寫任何自訂互動元件都該一併考慮的事。