萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

jQuery + zy_tmpl 實現 JSON 資料動態渲染下拉選單 (AppCan 開發實戰)

專案背景

在 AppCan 混合式 App 開發中,常需從後端 API 獲取 JSON 資料動態填充下拉選單。本文記錄使用 jQuery AJAX 獲取 JSONP 跨域資料,配合 AppCan 內建模板引擎 zy_tmpl 實現 Select 選項動態渲染的完整流程。

後端 PHP 介面實作 (JSONP 格式)

<?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) . ')';
?>

前端模板結構 (AppCan UI 框架)

<!-- 下拉選單容器 -->
<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>

核心 JS 邏輯:獲取資料 + 模板渲染

<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>

zy_tmpl 模板引擎核心語法

語法說明範例
${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 目前較少新專案採用,現代混合開發建議:

  • Vue/React + Capacitor/Ionic:生態成熟、TypeScript 支援
  • Uni-app:一碼多端、Vue 語法、支援模板渲染
  • 原生 Web Components:無框架依賴、瀏覽器原生支援

總結

本文展示了在 AppCan 框架下,使用 jQuery JSONP 獲取後端資料,配合 zy_tmpl 模板引擎動態渲染 Select 下拉選單的完整實作。核心要點:後端輸出標準 JSONP、前端定義模板字串、清空後重新渲染、理解模板語法變數對應。雖屬較早期技術棧,但模板驅動視圖的思想在現代前端開發中依然通用。

copyright © 萬盛學電腦網 all rights reserved