這篇文章適合前後端協同開發經驗還不足的新手。後端要把資料交給前端,方法不只一種,選錯了會付出代價:污染全域變數、拖慢首屏、或平白多出幾十個 HTTP 請求。以下依「資料量」與「時機」兩個維度,把常見做法完整梳理一次。
把值輸出到元素的 value 或自訂的 data-* 屬性上。
<input type="hidden" value="<?php echo $user_avatar;?>" /> <div data-avatar="<?php echo $user_avatar;?>"></div>
渲染結果:
<input type="hidden" value="https://avatars1.githubusercontent.com/u/3949015?v=3&s=40" /> <div data-avatar="https://avatars1.githubusercontent.com/u/3949015?v=3&s=40"></div>
前端讀取:
$('input').val();
$('div').data('avatar'); // jQuery 的 data() 會自動把駝峰式轉換回 dash 分隔
優點:不佔用全域變數,由 JS 自由取用。
適用:傳遞簡單資料,特別適合「多筆簡單資料與各元素綁定」的情境。
<ul>
<li>nimojs <span data-userid="1">刪除</span></li>
<li>nimo22 <span data-userid="2">刪除</span></li>
<li>nimo33 <span data-userid="3">刪除</span></li>
</ul>
<script>
$('span').on('click', function () {
$.post('/ajax/remove/', $(this).data('userid'), function (data) {
// ...
});
});
</script>
把資料填入 <script> 中的變數宣告。
<script> var user_avatar = "<?php echo $user_avatar;?>"; // 渲染結果:var user_avatar = "https://avatars1.githubusercontent.com/u/3949015?v=3&s=40"; </script>
用 Smarty 之類的模板引擎則是:
<script>
var user_avatar = "{$user_avatar}";
</script>
優點:傳遞方便,前端直接呼叫變數即可。
缺點:每一筆資料都佔一個全域變數,資料一多就難以維護。更麻煩的是,若內容含換行符會直接造成語法錯誤:
// 渲染結果含換行 var user_id = "https://avatars1.githubusercontent.com/u/3949015?v=3&s=40; "; // Uncaught SyntaxError: Unexpected token ILLEGAL
優化:用單一變數收攏所有後端資料,把全域污染降到最低:
var SERVER_DATA = {
username: {$username},
userid: {$userid},
title: {$title}
}
// 渲染結果
var SERVER_DATA = { username: "NimoChu", userid: 1, title: 'F2E' }
適用:需要最快把資料交到 JS 手上、且確定資料格式穩定時。結構複雜的資料建議走下一種做法。
把 JSON 字串放進一個非執行用的 <script> 標籤,前端再用 DOM 取出並解析。
<script type="text/template" id="data">{"username":"nimojs","userid":1}</script>
<script>
var data = JSON.parse($('#data').html());
// { username: "nimojs", userid: 1 }
</script>
優點:DOM 就緒後即可取得資料,不佔全域變數,能承載大量資料集合。
缺點:資料量過大時會拖慢首次載入——不只是因為檔案變大,也因為伺服器查詢並組出整個集合需要時間。
適用:DOM 完成時就需要用到的大量資料。例如後端輸出 JSON、前端用模板引擎進行渲染。
<span id="showdata">查看資料</span>
<div style="display:none;" id="box">
<h2>用戶信息</h2>
<p id="info"><img src="loading.gif" /></p>
</div>
$('#showdata').on('click', function () {
$('#box').show();
$.getJSON('/ajax/userdata/', function (oData) {
// oData = { username: "nimojs", userid: 1 }
$('#info').html('用戶名:' + oData.username + '<br>用戶ID:' + oData.userid);
});
});
流程:頁面只顯示「查看資料」→ 使用者點擊 → 顯示容器與 loading 圖 → 送出請求 → 伺服器回傳 JSON,$.getJSON 自動解析成物件 → 填入畫面。
優點:不佔全域變數與 DOM 節點,可自由控制觸發時機,讀取期間能用 loading 提示,避免首屏被大量資料拖慢。
缺點:會產生額外 HTTP 請求;無法在 DOM 就緒的瞬間立刻拿到資料,必須等請求與回應。
適用:非主要資訊、需要設定觸發條件、需要等待提示的情境。
如果把 AJAX 比喻成「傳短信給伺服器再等回覆」,那 WebSocket 就像「直接打電話」——連線建立後,伺服器可以主動推送資料,雙向且持續。
延伸閱讀方向:WebSocket 的 Wiki 條目、以 HTML5 WebSocket 建構即時 Web 應用的相關論述,以及 Ajax 與 WebSocket 的比較討論。
沒有絕對正確的方法,只有更合適的場景。可以用兩個問題快速判斷:
另外兩個務必守住的原則:後端輸出到 JavaScript 時一律經過 JSON 序列化(避免引號與換行釀成語法錯誤);前端把資料寫進畫面時優先用 textContent,避免 XSS。