在 AppCan 混合式 App 開發中,常需從後端 API 獲取 JSON 資料動態填充下拉選單。本文記錄使用 jQuery AJAX 獲取 JSONP 跨域資料,配合 AppCan 內建模板引擎 zy_tmpl 實現 Select 選項動態渲染的完整流程。
<?php
// json.php
header('Content-Type: application/javascript; charset=utf-8');
// 模擬資料來源
$buildings = [
['BuildingId' => 1, 'BuildingName' => 'A 棟'],
['BuildingId' => 2, 'BuildingName' => 'B 棟'],
['BuildingId' => 3, 'BuildingName' => 'C 棟'],
];
// JSONP 回調處理
$callback = isset($_GET['jsoncallback']) ? $_GET['jsoncallback'] : 'callback';
echo $callback . '(' . json_encode($buildings, JSON_UNESCAPED_UNICODE) . ')';
?>
<!-- 下拉選單容器 -->
<div class="ui-has-label">
<label class="ui-select">選擇樓群:</label>
<div class="ui-select">
<div class="ui-btn ui-btn-icon-right ui-btn-corner-all ui-btn-b">
<span class="ui-btn-inner ui-btn-corner-all">
<span class="ui-btn-text">樓名</span>
<div class="ui-li-link-alt ui-btn ui-btn-corner-right ui-shadow">
<span class="ui-icon ui-icon-arrow-d ui-icon-shadow"></span>
</div>
</span>
<!-- 關鍵:select 元素需預留 id -->
<select name="lc" id="lc" selectedIndex="0" onchange="zy_slectmenu(this.id)">
<option value="">數據加載中,請稍候</option>
</select>
</div>
</div>
</div>
<script>
// 獲取樓群資料並渲染下拉選單
function getBuildingList() {
$.getJSON('https://localhost/json.php?jsoncallback=?', function(data) {
// 定義模板:${屬性名} 對應 JSON 物件屬性
var tmpl = '<option value="${BuildingId}">${BuildingName}</option>';
// 清空現有選項
$("#lc").html("");
// zy_tmpl 渲染:模板 + 資料陣列 + 資料長度
$("#lc").append(zy_tmpl(tmpl, data, zy_tmpl_count(data)));
});
}
// 頁面載入時自動執行
$(document).ready(function() {
getBuildingList();
});
// 也可綁定到按鈕點擊、下拉觸發等事件
// onclick="getBuildingList()"
// onchange="getBuildingList()"
</script>
| 語法 | 說明 | 範例 |
|---|---|---|
${property} | 輸出資料物件屬性值 | ${BuildingName} |
#{expression} | 執行 JS 表達式 | #{BuildingId * 2} |
@if(condition) ... @endif | 條件渲染 | @if(BuildingId>1) ... @endif |
@each(item, index) ... @endeach | 陣列迭代(巢狀資料) | 處理多維陣列 |
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>AppCan 動態下拉選單範例</title>
<script src="jquery.min.js"></script>
<script src="appcan.js"></script> <!-- 含 zy_tmpl -->
</head>
<body>
<div class="ui-has-label">
<label class="ui-select">選擇樓群:</label>
<div class="ui-select">
<div class="ui-btn ui-btn-icon-right ui-btn-corner-all ui-btn-b">
<span class="ui-btn-inner ui-btn-corner-all">
<span class="ui-btn-text">樓名</span>
<div class="ui-li-link-alt ui-btn ui-btn-corner-right ui-shadow">
<span class="ui-icon ui-icon-arrow-d ui-icon-shadow"></span>
</div>
</span>
<select name="lc" id="lc" onchange="zy_slectmenu(this.id)">
<option value="">加載中...</option>
</select>
</div>
</div>
</div>
<script>
function loadBuildings() {
$.getJSON('https://your-api.com/buildings?jsoncallback=?', function(data) {
var tmpl = '<option value="${BuildingId}">${BuildingName}</option>';
$("#lc").html("").append(zy_tmpl(tmpl, data, zy_tmpl_count(data)));
}).fail(function() {
$("#lc").html('<option value="">加載失敗,請重試</option>');
});
}
$(function() { loadBuildings(); });
</script>
</body>
</html>
| 問題 | 原因 | 解決方案 |
|---|---|---|
| 選單顯示 "[object Object]" | 模板變數名與 JSON 屬性不匹配 | 檢查 ${BuildingId} 是否與 JSON 鍵名完全一致(區分大小寫) |
| JSONP 請求失敗 | 後端未正確包裝 callback | 確認輸出格式:callbackName({"data":...}) |
| zy_tmpl 未定義 | 未載入 appcan.js 或版本不含模板引擎 | 確認引入完整 AppCan JS SDK |
| 選單不更新 | 未清空原有選項直接 append | 先 .html("") 再 .append() |
AppCan 目前較少新專案採用,現代混合開發建議:
本文展示了在 AppCan 框架下,使用 jQuery JSONP 獲取後端資料,配合 zy_tmpl 模板引擎動態渲染 Select 下拉選單的完整實作。核心要點:後端輸出標準 JSONP、前端定義模板字串、清空後重新渲染、理解模板語法變數對應。雖屬較早期技術棧,但模板驅動視圖的思想在現代前端開發中依然通用。