萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網頁製作 >> HTML 腳本教學

HTML 隱藏域 `` 完整指南:六大用途、實戰範例與安全注意

<input type="hidden"> 在頁面**不可見**,但隨表單提交送往伺服器。它是前後端傳遞元數據、狀態標識、安全令牌的關鍵載體。

基本語法

<input type="hidden" name="field_name" value="value">
  • `name`:表單提交鍵名(必填)。
  • `value`:提交的值(可由 JS 動態設定)。
  • 無視覺呈現,不佔版面空間,不可被使用者直接操作。

六大核心用途

1. 傳遞不可見的業務標識(最常見)

<form action="/order/submit" method="POST">
  <input type="hidden" name="order_id" value="ORD-20240115-001">
  <input type="hidden" name="csrf_token" value="a1b2c3d4e5f6...">
  <!-- 使用者可見欄位 -->
  <button type="submit">確認訂單</button>
</form>
  • 訂單 ID、商品 SKU、返回頁面 URL (`redirect_url`)、分頁/排序參數。
  • CSRF Token** 是安全必備,防跨站請求偽造。

2. 多提交按鈕區分動作

<form action="/article" method="POST">
  <input type="hidden" name="action" value="" id="actionInput">
  <textarea name="content"></textarea>
  <button type="submit" onclick="document.getElementById('actionInput').value='save'">儲存草稿</button>
  <button type="submit" onclick="document.getElementById('actionInput').value='publish'">發布</button>
  <button type="submit" onclick="document.getElementById('actionInput').value='preview'">預覽</button>
</form>

伺服端依 `action` 值決定邏輯分支。

3. 多表單協作 / 多步驟精靈

  • 步驟 1 表單提交 → 伺服端驗證 → 將資料存入 Session/暫存表 → 重導向步驟 2,隱藏域帶上 `wizard_step=2`、`wizard_token=abc`。
  • 或前端單頁應用 (SPA) 內多 `
    ` 共用隱藏域同步狀態。

4. JavaScript 全域狀態替代(無全域變數環境)

<input type="hidden" id="appState" name="appState" value='{"userId":123,"theme":"dark"}'>

<script>
function getState() { return JSON.parse(document.getElementById('appState').value); }
function setState(key, val) {
  const state = getState();
  state[key] = val;
  document.getElementById('appState').value = JSON.stringify(state);
}
// 任意腳本可讀寫,頁面跳轉前自動攜帶提交
</script>

適用於無模組化、無狀態管理庫的舊專案。

5. 跨視窗/iframe 通訊協調

<!-- 父頁面 -->
<input type="hidden" id="childSignal" value="">
<iframe src="child.html" onload="setupChild()"></iframe>

<script>
function setupChild() {
  const iframe = document.querySelector('iframe').contentWindow;
  // 子頁面可讀寫 parent.document.getElementById('childSignal')
  // 父頁面監聽變化
  const signal = document.getElementById('childSignal');
  const observer = new MutationObserver(() => handleChildSignal(signal.value));
  observer.observe(signal, { attributes: true, attributeFilter: ['value'] });
}
</script>

現代應優先用 `postMessage`,但隱藏域在同源 iframe 簡單場景仍可用。

6. 檔案上傳表單必要欄位

<form action="/upload" method="POST" enctype="multipart/form-data">
  <input type="hidden" name="MAX_FILE_SIZE" value="5242880"> <!-- 5MB,PHP 專用提示 -->
  <input type="file" name="avatar">
  <button type="submit">上傳</button>
</form>

完整實戰範例:防重複提交 + CSRF + 狀態保持

<form id="commentForm" action="/comment" method="POST">
  <input type="hidden" name="csrf_token" value="<?= csrf_token() ?>">
  <input type="hidden" name="post_id" value="<?= $post_id ?>">
  <input type="hidden" name="reply_to" value="0" id="replyTo">
  <input type="hidden" name="form_token" value="<?= generate_form_token() ?>" id="formToken"> <!-- 防重複 -->
  
  <textarea name="content" required></textarea>
  <button type="submit" id="submitBtn">送出留言</button>
</form>

<script>
const form = document.getElementById('commentForm');
const btn = document.getElementById('submitBtn');
form.addEventListener('submit', async e => {
  e.preventDefault();
  btn.disabled = true; btn.textContent = '送出中...';
  
  // 檢查 form_token 是否已用過(配合伺服端一次性 token)
  const formData = new FormData(form);
  const res = await fetch(form.action, { method: 'POST', body: formData });
  if (res.ok) {
    // 成功:重置表單、更新 token
    form.reset();
    document.getElementById('formToken').value = await res.text(); // 新 token
  } else {
    alert('提交失敗:' + await res.text());
  }
  btn.disabled = false; btn.textContent = '送出留言';
});
</script>

安全與最佳實踐

風險對策
使用者可在 DevTools 修改 value**伺服端必須驗證權限、格式、業務邏輯**,不可信任前端值。
CSRF 攻擊每張表單帶唯一 `csrf_token`,伺服端驗證;SameSite Cookie 輔助。
敏感資訊洩露(如價格、ID)避免在 hidden 放敏感數據;若必須,加密/簽名,伺服端解密驗證。
重複提交一次性 `form_token` + 伺服端冪等鍵(如 `user_id + action + timestamp`)。
XSS 注入 value輸出 value 時正確編碼(`htmlspecialchars` / 模板引擎自動轉義)。

無障礙注意

  • 隱藏域**不需** `
  • 若隱藏域值對使用者有語義(如「當前頁面:3」),考慮用 `aria-live` 區域同步告知。

隱藏域看似簡單,實則是前後端協議的隱形紐帶。善用它傳遞狀態、保護安全、簡化邏輯,但切記:**永遠不信任客戶端提交的任何值**。

copyright © 萬盛學電腦網 all rights reserved