電商頁面的「套餐選擇」通常是一排可點選的標籤,選中後要能回傳選項的顯示文字與值。這個範例把它做成一個可重複使用的元件,同時支援本地 JSON 陣列與遠端 AJAX 兩種資料來源。

<meta http-equiv="content-type" content="text/html; charset=UTF-8" /> <script type="text/javascript" src="js/jquery.min.js"></script> <script type="text/javascript" src="./option-jquery-dc.js"></script> <link rel="stylesheet" href="css/option-jquery-dc.css"/> <div> <dt>本地調用</dt> <dd class="tb-prop testlocal"></dd> </div> <div> <dt>ajax 調用</dt> <dd class="tb-prop testajax"></dd> </div>
<script>
/************************************
* 基於本地 json 數據的選項列創建
************************************/
var datanodes = [
{ text:"官方標配", value:"1", selected:true },
{ text:"套餐一", value:"2" },
{ text:"套餐二", value:"3" },
{ text:"套餐三", value:"4" },
{ text:"套餐四", value:"5" },
{ text:"套餐五", value:"6" },
{ text:"套餐六", value:"7" },
{ text:"套餐七", value:"8" },
{ text:"套餐八", value:"9" },
{ text:"套餐九", value:"10" }
];
/**
* @param className 容器支撐層的 css 名稱
* @param mycall 用戶點擊後的回呼函式,由開發者自定義
*/
var mylistobjLocal = new OptionList("testlocal", "mycall");
mylistobjLocal.createListHtml(datanodes);
/************************************
* 基於遠程服務器 json 數據的選項列創建
************************************/
var mylistobjAjax = new OptionList("testajax", "mycall");
var url = "https://127.0.0.1/option-jquery-dc/testJson.php";
mylistobjAjax.createListHtmlForAjax(url);
/***
* 用戶選中某一個選項的回呼函式
* @param result 返回當前選中項的相關參數
*/
var mycall = function(result){
alert("您選中了: " + result.text + ":" + result.value);
}
</script>
統一的資料格式:不論資料來自本地陣列還是伺服器回應,都是 {text, value, selected} 的陣列。這讓 createListHtml() 與 createListHtmlForAjax() 這兩個入口最終能共用同一套渲染邏輯,AJAX 版本只是在成功回呼裡呼叫本地版本而已。
回呼函式由外部注入:元件本身不知道「選中之後要做什麼」,只負責把 {text, value} 交出去。於是同一個元件可以用在商品頁、規格頁或後台設定頁,各自傳入不同的處理函式。這是元件化的關鍵——把變化點留在外部。
用 class 定位容器:以 className 而非 id 來找容器,同一頁就能放多組不同資料的選項列,彼此不衝突。
範例把回呼函式以名稱字串("mycall")傳入,元件內部再用 eval 之類的方式呼叫。這麼做有安全風險且不嚴謹,直接傳函式參照即可:new OptionList("testlocal", mycall)。
另外,選中狀態建議不要只存在 DOM 上,而是同時維護一份內部狀態,並在初始化時依 selected: true 設定 aria 屬性(如 aria-selected),讓螢幕閱讀器能讀出目前選項。若要支援「只能選一個」的情境,也可加上 multiple: false 這類設定。