DIV CSS 佈局教程網

Dojo 的 FilteringSelect:取出下拉選單的值與顯示文字
編輯:關於JavaScript     

關於 Dojo

Dojo 是以 JavaScript 實作的開源 DHTML 工具包,由 nWidgets、Burstlib、f(m) 等數個專案捐贈整合而成,這也是它被稱為 unified toolkit 的由來。它的目標是處理 DHTML 開發中長期存在的老問題,尤其是跨瀏覽器差異。

需求

一個下拉選單,選項是四季。選中之後,分別取得它的 value 與顯示文字。

實作

 <!DOCTYPE html>
<html>
<head>
<meta charset="utf-8" />
<title>dojo-獲取下拉框的值和文本</title>
<link rel="stylesheet" href="js/dojo/dijit/themes/claro/claro.css" />
<script type="text/javascript" src="js/jquery-1.12.4.js"></script>
<script type="text/javascript" src="js/dojo/dojo/dojo.js"></script>
<style>
#season { width: 200px; }
</style>

<!-- dojoConfig 必須在 dojo.js 之後、require 之前設定 -->
<script>
dojoConfig = { async: true, parseOnLoad: true };
</script>

<script>
require([
  "dojo/store/Memory",
  "dijit/form/FilteringSelect",
  "dojo/domReady!"
], function (Memory, FilteringSelect) {

  var seasonStore = new Memory({
    data: [
      { name: "春季", id: "spring" },
      { name: "夏季", id: "summer" },
      { name: "秋季", id: "autumn" },
      { name: "冬季", id: "winter" }
    ]
  });

  var seasonSelect = new FilteringSelect({
    id: "season",
    name: "season",
    value: "spring",
    store: seasonStore,
    searchAttr: "name"
  }, "season").startup();
});
</script>
</head>

<body class="claro">
<input id="season" /><br>
<button id="valueBtn" onclick="alert(dijit.byId('season').get('value'))">獲取下拉框 value</button>
<button id="textBtn" onclick="alert(dijit.byId('season').get('displayedValue'))">獲取下拉框 text</button>
</body>
</html>

關鍵就兩個方法

取值用 dijit.byId('season').get('value'),取顯示文字用 dijit.byId('season').get('displayedValue')。兩者對應到 store 裡不同的欄位:value 是 id(spring/summer/...),displayedValue 是 name(春季/夏季/...)。

這也是 Dojo 元件與原生 select 的差異所在:原生寫 select.value 與 select.options[select.selectedIndex].text,而 Dojo 把兩者抽象成屬性,透過統一的 get() 存取。

幾個實作細節

dojoConfig 的時機。它必須在 dojo.js 之後設定。若放到 dojo.js 之前,設定會被忽略,async 與 parseOnLoad 都不生效。

body 上的 claro class 不能省。Dojo 的主題樣式是靠這個 class 掛載的,少了它元件會以裸樣式呈現。

searchAttr 決定搜尋欄位。設為 name,使用者打字時比對的是顯示文字;改為 id 則比對內部值。這是 FilteringSelect 又叫「可搜尋下拉選單」的原因。

用 dijit.byId 而非 document.getElementById。前者取回的是 Dojo 的 widget 物件,才有 get() 方法;後者拿到的是底層 DOM 節點,無法直接取值。

最後補一句:Dojo 已不再是新專案的熱門選項,多數場景 React、Vue 搭配元件庫會更順手。上面這份整理對維護既有 Dojo 系統仍然有用,其中「widget 物件與 DOM 節點是兩層東西」這個觀念,在任何前端框架裡都同樣成立。

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