開發中若遇到需要填寫城市名稱的表單,這個效果能大幅加快輸入速度。它以純 JavaScript 實作,支援滑鼠點擊選擇,也支援輸入城市拼音或拼音首字母來篩選,並可快速切換定位。
線上體驗:https://hovertree.com/texiao/js/36/
HTML 程式碼:
<!DOCTYPE html>
<html lang="zh">
<head>
<meta charset="UTF-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>js 中國各大城市快速選擇</title>
<link rel="stylesheet" href="https://hovertree.com/texiao/js/36/css/cityselect.css">
<style type="text/css">
.demo { width: 220px; margin: 50px auto; }
.demo input { padding: 12px 18px; }
a { color: deepskyblue; }
</style>
</head>
<body>
<h3 style="text-align: center;margin-top: 15px;">在下面的輸入框中輸入城市名稱:</h3>
<div class="demo">
<!-- 加上 id 供腳本掛載 -->
<input type="text" class="cityinput" id="citySelect" placeholder="請輸入目的地">
</div>
<script type="text/javascript" src="https://hovertree.com/texiao/js/36/js/cityselect.js"></script>
<script type="text/javascript">
var hovertree = new Vcity.CitySelector({ input: 'citySelect' });
</script>
<div style="text-align:center;margin:150px 0; font:normal 14px/24px 'MicroSoft YaHei';">
<p>來源:<a href="https://hovertree.com/" target="_blank">何問起</a></p>
</div>
</body>
</html>
原始碼下載:https://hovertree.com/h/bjag/qd1jxjuh.htm
使用方式與設計思路
接入成本很低:引入 cityselect.js 之後,只要 new 一個 CitySelector 並把輸入框的 id 傳進去,功能就完成了。這也是這類自作者是與外掛最理想的形式——呼叫端一行搞定,其餘細節全部封裝在內部。
這類元件的核心資料結構通常是「城市名稱 + 全拼 + 首字母」三欄對照的清單。使用者輸入時,同時拿輸入內容去比對名稱、全拼前綴與首字母前綴,就能做到「北京」、「beijing」、「bj」三種寫法都命中。若還想支援更模糊的匹配,可以再對全拼做 includes 而非 startsWith,但要注意命中結果過多時反而降低效率。
實務上有幾個細節決定成品好不好用:一是下拉列表必須支援鍵盤上下鍵選擇與 Enter 確認,否則純滑鼠操作在桌面端很綁手;二是要注意中文輸入法在組字期間會觸發多次 input 事件,需用 compositionstart / compositionend 避開中間狀態,否則候選字會被當成已確認的查詢字串;三是行動裝置上鍵盤彈起會壓縮可用高度,下拉層最好靠 fixed 定位並動態計算方向,避免被鍵盤遮住。
最後,若城市資料量不大(縣級以上約三千筆),整包直接內嵌在前端是合理的;但若是更細的區域資料,建議改成輸入時向後端請求,並加上 debounce 與最小輸入長度限制,同時別忘了對回傳結果做轉義處理,避免資料中含有特殊字元時造成 XSS。