萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

iframe 父頁面獲取子頁面元素值的跨域與同域方案

同域:直接訪問 contentWindow/document

<!-- 父頁面 -->
<iframe name="childFrame" id="childFrame" src="child.html"></iframe>
<button onclick="getChildValue()">獲取子頁面輸入值</button>

<script>
function getChildValue() {
  var iframe = document.getElementById('childFrame');
  // 方式 1:contentWindow(推薦)
  var win = iframe.contentWindow;
  var val = win.document.getElementById('date').value;

  // 方式 2:contentDocument(標準)
  // var val = iframe.contentDocument.getElementById('date').value;

  // 方式 3:window.frames 集合(舊寫法)
  // var val = window.frames['childFrame'].document.getElementById('date').value;

  console.log('子頁面值:', val);
}
</script>

子頁面 child.html

<input type="text" id="date" value="2024-01-15" />

跨域:postMessage 安全通訊

同源策略禁止父頁面讀取跨域 iframe 內容。必須雙向協作:

子頁面主動發送數據

<!-- child.html (不同域) -->
<script>
function sendData() {
  var val = document.getElementById('date').value;
  // 發送給父頁面,目標源建議指定具體域名而非 '*'
  parent.postMessage({type: 'childData', value: val}, 'https://parent-domain.com');
}
// 數據變化時發送
document.getElementById('date').addEventListener('change', sendData);
// 頁面加載時發送
window.addEventListener('load', sendData);
</script>

父頁面接收數據

<!-- 父頁面 -->
<script>
window.addEventListener('message', function(event) {
  // 安全驗證來源
  if (event.origin !== 'https://child-domain.com') return;
  var data = event.data;
  if (data && data.type === 'childData') {
    console.log('收到子頁面值:', data.value);
    // 更新 UI 或業務邏輯
  }
}, false);
</script>

雙向通訊完整模式

// 父頁面發送命令
iframe.contentWindow.postMessage({cmd: 'refresh'}, 'https://child-domain.com');

// 子頁面接收命令
window.addEventListener('message', function(e) {
  if (e.origin !== 'https://parent-domain.com') return;
  if (e.data.cmd === 'refresh') { /* 執行刷新 */ }
});

常見坑點

  • iframe 尚未加載完成:需監聽 iframe.onload 後再訪問。
  • 子頁面跳轉導致引用失效:同域下跳轉後 contentWindow 仍可用,但文檔已換新;跨域跳轉後無法通訊。
  • X-Frame-Options / CSP frame-ancestors:服務端頭可能禁止嵌入,導致 iframe 空白。
  • 性能:頻繁跨 iframe 訪問屬性會觸發佈局抖動,批量讀取時建議子頁面主動 postMessage 推送聚合數據。

現代替代:避免 iframe

  • 前端微前端:qiankun、single-spa、Web Components。
  • 組件化嵌入:同域直接用組件庫(Vue/React)替代 iframe。
  • SSO/第三方登入:OAuth2 重定向流程,無需 iframe。
copyright © 萬盛學電腦網 all rights reserved