本文将探讨在bootstrap模态框中通过jquery ajax提交表单时，模态框意外关闭的常见问题及其解决方案。核心在于识别并移除提交按钮上不必要的`data-dismiss=”modal”`属性，确保ajax请求在模态框保持打开状态下正常执行，从而实现无缝的用户体验。文章将提供详细的代码示例和最佳实践，指导开发者正确处理模态框内的异步表单提交。
问题剖析：模态框意外关闭的根源
在使用bootstrap模态框（Modal）加载动态内容，并在此内容中包含一个使用jquery AJAX进行提交的表单时，开发者可能会遇到一个常见问题：当用户点击表单的提交按钮时，模态框会意外关闭，而不是等待AJAX请求完成。
这个问题的根源在于Bootstrap模态框的内置行为。Bootstrap提供了一个方便的data-dismiss=”modal”属性，当应用于按钮时，它会自动关闭所属的模态框。许多开发者在创建模态框内的表单时，可能会无意中将这个属性添加到表单的提交按钮上。当提交按钮带有data-dismiss=”modal”属性时，无论表单是否绑定了AJAX提交事件，点击该按钮都会立即触发模态框的关闭动作，从而中断或覆盖了AJAX提交的预期流程。
核心解决方案：移除冲突属性
解决此问题的关键非常直接：从表单的提交按钮上移除data-dismiss=”modal”属性。
一旦移除了这个属性，提交按钮将不再触发模态框的关闭行为。这样，我们就可以完全控制表单的提交逻辑，通过jQuery的submit()事件处理器来执行AJAX请求，并在AJAX请求完成后，根据业务逻辑决定模态框的后续操作（例如，保持打开、更新内容或手动关闭）。
示例代码：模态框内AJAX表单提交的规范实现
以下是一个完整的示例，展示了如何在Bootstrap模态框中正确实现jQuery AJAX表单提交，同时避免模态框意外关闭。
1. 页面主结构与模态框定义
首先，我们需要一个触发模态框打开的按钮和模态框的基本html结构。模态框的modal-body部分将用于加载动态内容。
<!DOCTYPE html> <html lang="zh-CN"> <head> <meta charset="UTF-8"> <meta name="viewport" content="width=device-width, initial-scale=1.0"> <title>Bootstrap Modal AJAX 提交示例</title> <!-- 引入 Bootstrap css --> <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@3.3.7/dist/css/bootstrap.min.css" integrity="sha384-BVYiiSIFeK1dGmJRAkycuHAHRg32OmUcww7on3RYdg4Va+PmSTsz/K68vbdEjh4u" crossorigin="anonymous"> </head> <body> <div class="container"> <h1>模态框 AJAX 提交演示</h1> <!-- 触发模态框的按钮 --> <button class="btn btn-primary openStandings" data-href="modal-form-content.html">打开表单模态框</button> <!-- Bootstrap 模态框结构 --> <div id="myModalPositions" class="modal fade" tabindex="-1" role="dialog" aria-labelledby="myModalLabel" aria-hidden="true"> <div class="modal-dialog" role="document"> <div class="modal-content"> <div class="modal-header"> <button type="button" class="close" data-dismiss="modal" aria-hidden="true">×</button> <h4 class="modal-title" id="myModalLabel">数据提交</h4> </div> <div class="modal-body"> <!-- 动态内容将加载到这里 --> <p>加载中...</p> </div> <div class="modal-footer"> <button type="button" class="btn btn-default" data-dismiss="modal">关闭</button> </div> </div> </div> </div> </div> <!-- 引入 jQuery --> <script src="https://code.jquery.com/jquery-2.2.4.min.js" integrity="sha256-BbhdlvQf/xTY9gja0Dq3HiwQF8LaCRTXxZKRutelT44=" crossorigin="anonymous"></script> <!-- 引入 Bootstrap JS --> <script src="https://cdn.jsdelivr.net/npm/bootstrap@3.3.7/dist/js/bootstrap.min.js" integrity="sha384-Tc5IQib027qvyjSMfHjOMaLkfuWVxZxUPnCJA7l2mCWNIpG9mGCD8wGNIcPD7Txa" crossorigin="anonymous"></script> <script type="text/javascript"> // 模态框打开逻辑：点击按钮加载内容 $('.openStandings').on('click', function(e){ e.preventDefault(); var targetUrl = $(this).attr('data-href'); $('#myModalPositions').modal('show').find('.modal-body').load(targetUrl, function() { // 内容加载完成后，可以在这里执行一些初始化操作 console.log('模态框内容已加载。'); }); }); // 由于表单是动态加载的，需要使用事件委托来绑定提交事件 $(document).on('submit', '#form1', function(event) { event.preventDefault(); // 阻止表单默认提交行为 console.log("表单正在通过AJAX提交..."); var formData = $(this).serialize(); // 序列化表单数据 $.ajax({ type: "POST", url: "proceed.cfm", // 替换为你的后端处理URL data: formData, beforeSend: function() { // 可以在这里显示加载指示器 console.log("发送AJAX请求..."); } }).done(function (data) { // AJAX请求成功 console.log("AJAX请求成功，服务器响应：", data); // 根据服务器响应更新模态框内容或执行其他操作 // 例如：$('#myModalPositions .modal-body').html('<p>数据已成功提交！</p>'); // 如果需要关闭模态框：$('#myModalPositions').modal('hide'); }).fail(function(jqXHR, textStatus, errorThrown) { // AJAX请求失败 console.error("AJAX请求失败：", textStatus, errorThrown); // 显示错误信息 // 例如：$('#myModalPositions .modal-body').append('<p class="text-danger">提交失败，请重试。</p>'); }).always(function() { // 无论成功或失败都会执行，可以在这里隐藏加载指示器 console.log("AJAX请求完成。"); }); }); </script> </body> </html>
2. 动态加载的表单内容 (modal-form-content.html)
这个文件是data-href属性指向的URL所返回的内容，它只包含表单本身。注意，提交按钮上没有data-dismiss=”modal”属性。
<!-- modal-form-content.html --> <form name="form1" id="form1"> <div class="form-group"> <label for="name">姓名:</label> <input type="text" class="form-control" name="name" id="name" placeholder="请输入姓名"> </div> <!-- 提交按钮，注意：没有 data-dismiss="modal" 属性 --> <button type="submit" class="btn btn-primary updateData">提交</button> </form> <!-- 重要提示：如果此文件是动态加载的，请确保不要在此文件中重复引入jQuery或Bootstrap JS， 因为它们已经在主页面中