萬盛學電腦網

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

JSF 中 confirm 確認框集成實戰:防止誤操作的最佳實踐

前言

在 JSF 應用中,關鍵操作(刪除、提交含附件郵件)前彈出確認框是標準交互。本文展示如何在 JSF 命令組件中優雅集成 confirm(),處理事件鏈、AJAX 與傳統提交的差異。

核心實現:攔截 onclick 事件鏈

<h:commandButton id="sendBtn" value="發送" action="#{mailBean.send}">
    <f:ajax execute="@form" render="@form" />
</h:commandButton>

<script>
// 頁面加載後綁定(或用 h:outputScript target="body")
document.addEventListener('DOMContentLoaded', function() {
    var btn = document.getElementById('form:sendBtn'); // JSF 客戶端 ID
    if (!btn) return;
    
    // 保存原有 onclick(JSF 生成的 AJAX/提交邏輯)
    var originalOnClick = btn.onclick;
    
    btn.onclick = function(event) {
        // 1. 業務邏輯判斷
        var content = $('#form\\:content').val(); // 注意 JSF ID 轉義
        var hasAttachment = $('#form\\:attachment').val();
        
        if (content.indexOf('附件') !== -1 && !hasAttachment) {
            // 2. 彈出確認框
            if (!confirm('您的郵件內容提到附件,但您可能忘記了添加附件。確定仍要發送?')) {
                return false; // 取消:阻止後續事件(含 JSF AJAX/提交)
            }
        }
        
        // 3. 確認:執行原有邏輯
        if (originalOnClick) {
            return originalOnClick.call(this, event);
        }
        return true;
    };
});</script>

關鍵技術點解析

1. JSF 生成的 onclick 內容

h:commandButton + f:ajax 生成類似:

onclick="mojarra.ab(this,event,'action',0,'@form','@form');return false"

直接覆蓋 onclick 會丟失 AJAX 行為,必須保存原函數並在確認後調用。

2. 兼容傳統提交(無 AJAX)

<h:commandButton id="submitBtn" value="提交" action="#{bean.submit}" />
// 生成: onclick="document.forms['form'].submit();return false"

// 同樣需保存並調用原 onclick
var original = btn.onclick;
btn.onclick = function(e) {
    if (!confirm('確定提交?')) return false;
    return original.call(this, e);
};

3. PrimeFaces / RichFaces 組件特殊處理

<p:commandButton id="pfBtn" value="PF提交" action="#{bean.submit}" onclick="return confirm('確定?')" />
// PrimeFaces 原生支援 onclick 返回 false 阻塞,無需手動綁定

// RichFaces
<a4j:commandButton onclick="if(!confirm('確定?')) return false;" />

進階:封裝為可復用 JSF 組件/標簽

<!-- confirmTag.xhtml -->
<ui:composition>
    <script>
        function confirmAction(source, message, originalFn) {
            if (confirm(message)) {
                return originalFn ? originalFn.call(source, event) : true;
            }
            return false;
        }
    </script>
</ui:composition>

<!-- 使用 -->
<h:commandButton value="刪除" action="#{bean.delete}">
    <f:ajax />
</h:commandButton>
<script>
    $('#form\\:deleteBtn').on('click', function(e) {
        return confirmAction(this, '確定刪除?', this.onclick);
    });
</script>

無障礙與 UX 增強

  • 使用自定義 Modal 替代原生 confirm:可自定義樣式、多語言、焦點管理、鍵盤操作。
  • 關鍵操作採用「二次確認」:第一次按鈕變色/文字變為「確定刪除」,第二次點擊真正執行。
  • 記錄操作日誌:確認框確認後,記錄用戶 ID、時間、操作類型供審計。

總結

JSF 中集成 confirm 關鍵在於保存並調用原有 onclick,不破壞 JSF 的 AJAX/提交鏈。現代項目建議遷移至組件庫(PrimeFaces p:confirmDialog、OmniFaces o:confirmDialog)或自定義 Modal 組件,獲得更好的 UX、無障礙支援和可維護性。

copyright © 萬盛學電腦網 all rights reserved