<input type="hidden"> 在頁面**不可見**,但隨表單提交送往伺服器。它是前後端傳遞元數據、狀態標識、安全令牌的關鍵載體。
<input type="hidden" name="field_name" value="value">
<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>
<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` 值決定邏輯分支。
<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>
適用於無模組化、無狀態管理庫的舊專案。
<!-- 父頁面 -->
<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 簡單場景仍可用。
<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>
<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` / 模板引擎自動轉義)。 |
隱藏域看似簡單,實則是前後端協議的隱形紐帶。善用它傳遞狀態、保護安全、簡化邏輯,但切記:**永遠不信任客戶端提交的任何值**。