jQuery UI 模态表单疯狂踩坑
Posted
tags:
篇首语：本文由小常识网(cha138.com)小编为大家整理，主要介绍了jQuery UI 模态表单疯狂踩坑相关的知识，希望对你有一定的参考价值。
想套用一下前端的组件写一个表单验证的页面，于是试了一下jQuery UI
官网的例子
首先把官网的例子贴上：
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>jQuery UI Dialog - Modal form</title>
<link rel="stylesheet" href="//code.jquery.com/ui/1.12.1/themes/base/jquery-ui.css">
<link rel="stylesheet" href="/resources/demos/style.css">
<style>
label, input { display:block; }
input.text { margin-bottom:12px; width:95%; padding: .4em; }
fieldset { padding:0; border:0; margin-top:25px; }
h1 { font-size: 1.2em; margin: .6em 0; }
div#users-contain { width: 350px; margin: 20px 0; }
div#users-contain table { margin: 1em 0; border-collapse: collapse; width: 100%; }
div#users-contain table td, div#users-contain table th { border: 1px solid #eee; padding: .6em 10px; text-align: left; }
.ui-dialog .ui-state-error { padding: .3em; }
.validateTips { border: 1px solid transparent; padding: 0.3em; }
</style>
<script src="https://code.jquery.com/jquery-1.12.4.js"></script>
<script src="https://code.jquery.com/ui/1.12.1/jquery-ui.js"></script>
<script>
$( function() {
var dialog, form,
// From http://www.whatwg.org/specs/web-apps/current-work/multipage/states-of-the-type-attribute.html#e-mail-state-%28type=email%29
emailRegex = /^[a-zA-Z0-9.!#$%&‘*+\/=?^_`{|}~-][email protected][a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?(?:\.[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?)*$/,
name = $( "#name" ),
email = $( "#email" ),
password = $( "#password" ),
allFields = $( [] ).add( name ).add( email ).add( password ),
tips = $( ".validateTips" );
function updateTips( t ) {
tips
.text( t )
.addClass( "ui-state-highlight" );
setTimeout(function() {
tips.removeClass( "ui-state-highlight", 1500 );
}, 500 );
}
function checkLength( o, n, min, max ) {
if ( o.val().length > max || o.val().length < min ) {
o.addClass( "ui-state-error" );
updateTips( "Length of " + n + " must be between " +
min + " and " + max + "." );
return false;
} else {
return true;
}
}
function checkRegexp( o, regexp, n ) {
if ( !( regexp.test( o.val() ) ) ) {
o.addClass( "ui-state-error" );
updateTips( n );
return false;
} else {
return true;
}
}
function addUser() {
var valid = true;
allFields.removeClass( "ui-state-error" );
valid = valid && checkLength( name, "username", 3, 16 );
valid = valid && checkLength( email, "email", 6, 80 );
valid = valid && checkLength( password, "password", 5, 16 );
valid = valid && checkRegexp( name, /^[a-z]([0-9a-z_\s])+$/i, "Username may consist of a-z, 0-9, underscores, spaces and must begin with a letter." );
valid = valid && checkRegexp( email, emailRegex, "eg. [email protected]" );
valid = valid && checkRegexp( password, /^([0-9a-zA-Z])+$/, "Password field only allow : a-z 0-9" );
if ( valid ) {
$( "#users tbody" ).append( "<tr>" +
"<td>" + name.val() + "</td>" +
"<td>" + email.val() + "</td>" +
"<td>" + password.val() + "</td>" +
"</tr>" );
dialog.dialog( "close" );
}
return valid;
}
dialog = $( "#dialog-form" ).dialog({
autoOpen: false,
height: 400,
width: 350,
modal: true,
buttons: {
"Create an account": addUser,
Cancel: function() {
dialog.dialog( "close" );
}
},
close: function() {
form[ 0 ].reset();
allFields.removeClass( "ui-state-error" );
}
});
form = dialog.find( "form" ).on( "submit", function( event ) {
event.preventDefault();
addUser();
});
$( "#create-user" ).button().on( "click", function() {
dialog.dialog( "open" );
});
});
</script>
</head>
<body>
<div id="dialog-form" title="Create new user">
<p class="validateTips">All form fields are required.</p>
<form>
<fieldset>
<label for="name">Name</label>
<input type="text" name="name" id="name" value="Jane Smith" class="text ui-widget-content ui-corner-all">
<label for="email">Email</label>
<input type="text" name="email" id="email" value="[email protected]" class="text ui-widget-content ui-corner-all">
<label for="password">Password</label>
<input type="password" name="password" id="password" value="xxxxxxx" class="text ui-widget-content ui-corner-all">
<!-- Allow form submission with keyboard without duplicating the dialog button -->
<input type="submit" tabindex="-1" style="position:absolute; top:-1000px">
</fieldset>
</form>
</div>
<div id="users-contain" class="ui-widget">
<h1>Existing Users:</h1>
<table id="users" class="ui-widget ui-widget-content">
<thead>
<tr class="ui-widget-header ">
<th>Name</th>
<th>Email</th>
<th>Password</th>
</tr>
</thead>
<tbody>
<tr>
<td>John Doe</td>
<td>[email protected]m</td>
<td>johndoe1</td>
</tr>
</tbody>
</table>
</div>
<button id="create-user">Create new user</button>
</body>
</html>试了一下，一切都很美好。
From表单DIV的位置
首先看到CSS写的很粗，比如第一条：
label, input { display:block; }直接就定义了所有label和input标签的样式。看着body里是2个DIV，于是想把2个div外面再包一层div，像下面这样：
<body>
<div id="myui">
<div id="dialog-form" title="Create new user"></div>
<div id="users-contain" class="ui-widget"></div>
</div>
</body>然后所有的css样式前面都加上自己的这个div，就不会和别的样式冲突了，比如这样：
#myui label, #myui input { display:block; }问题：修改后，模态框里的css样式都没有应用上。比如lable和input没有变成块级标签，导致没有换行
原因：这里 id="dialog-form" 这个div的位置变了，跑到了 id="myui" 这个div的外面了。造成这个情况的原因是，jQuery UI就是这么做的，把 id="dialog-form" 这个div挖出来，出来好之后append到一个位置，而默认位置是 body 标签。
解决方法：知道原因后，修改css的写法也是可以实现的。但是也是有方法按照原来想的那样，让 id="dialog-form" 这个div仍然放在 id="myui" 里面的。在dialog里加上一个 appendTo 参数，指定模态框要添加的位置，之前没有指定就是默认（body）：
dialog = $( "#dialog-form" ).dialog({
appendTo: ‘#myui‘,
autoOpen: false,
height: 400,
width: 350,
modal: true,
buttons: {
"Create an account": addUser,
Cancel: function() {
dialog.dialog( "close" );
}
},
close: function() {
form[ 0 ].reset();
allFields.removeClass( "ui-state-error" );
}
});实际有2个提交的按钮
在提交表单之前，先要知道，实际这个例子中有2个按钮可以用来提交的。其中一个隐藏了。
写在form里的submit按钮：
<!-- Allow form submission with keyboard without duplicating the dialog button -->
<input type="submit" tabindex="-1" style="position:absolute; top:-1000px">实际位置应该是跑到屏幕外面去了。这里把style属性去掉就能看到了。这个按钮的作用是方便我们用键盘的回车键操作的。
另外jQuery UI帮我们生成的按钮是在 dialog = $( "#dialog-form" ).dialog() 里用buttons属性生成的，这里可以自定义以及添加更多的按钮：
buttons: {
"Create an account": addUser,
Cancel: function() {
dialog.dialog( "close" );
}
},另外这里的确认按钮不是submit，而是触发一个addUser进行表单验证的方法。addUser里验证通过后会生成前端的标签，在前端添加一行数据，但是submit提交。
表单无法提交
演示的代码是一个纯前端的实现，如果要提交到后端，那么就是在form标签里加上action属性。然后先把submit按钮的style属性去掉，用submit先提交。
问题：后端收不到发来的请求
原因：前端阻止了submit事件的默认操作，具体就是下面这句
form = dialog.find( "form" ).on( "submit", function( event ) {
event.preventDefault(); // 这句的意思就是取消事件的默认操作
addUser();
});解决方法：这里直接把阻止的代码注释掉就好了
现在可以使用回车键进行submit提交了，但是确认按钮并不能提交
问题2：确认按钮不是submit
原因：这个按钮绑定的是addUser，而addUser里也没有submit提交
解决方法：把确认按钮的click绑定为触发form的submit事件，这样这个确认按钮的效果就和submit一样了，而且submit里也是要先执行addUser()进行验证的。把 dialog = $( "#dialog-form" ).dialog() 里用buttons属性改成了下面这样，这个buttons的参数是可支持 Object 和 Array 两种形式，这里我改用了Array的形式：
buttons: [
{text: "确认", click: function () {
form.submit();
}},
{text: "取消", click: function () {
dialog.dialog(‘close‘);
}
}
],请求的表单内容为空
现在后端可以收到请求了，但是收到的都是没有值的空的请求。
问题：后端内收到请求，但是请求的值都是空值
原因：前端在发送submit请求前，清空了表单的内容。在 dialog = $( "#dialog-form" ).dialog() 里最后有一个close属性，值是一个方法：
close: function() {
form[ 0 ].reset();
allFields.removeClass( "ui-state-error" );
}close属性是在对话框关闭的时候要执行的内容，这里面清空了form表单的内容。
具体步骤是，submit事件会首先触发addUser()进行表单验证。addUser()里面会先用 checkLength() 验证长度，然后用 checkRegexp() 进行正则的验证。如果验证失败会返回false组织之后事件的发生。如果验证通过则会先执行关闭模态框的操作：
dialog.dialog( "close" );这里就要关闭模态框了，然后返回true，之后才是执行submit提交的动作。但是关闭模态框的时候，数据就清空了。服务的收到的就是被清空后的空表单发来的请求，并且是在通过了前端的数据验证之后的。
解决方法：应该可以先不关闭模态框，等submit提交之后再关闭。不过实现起来也不方便。表单清空的功能还是有用的，但是只要在下次打开前清空就好了。这里可以用一个open方法替代原来的close方法。
另外一个坑：官网的页面里是有一个create方法的，本来想用这个的。但是发现没有用，然后去源码里找了一下(jquery-ui.js)：
$.widget( "ui.dialog", {
version: "1.12.1",
options: {
appendTo: "body",
autoOpen: true,
buttons: [],
classes: {
"ui-dialog": "ui-corner-all",
"ui-dialog-titlebar": "ui-corner-all"
},
closeOnEscape: true,
closeText: "Close",
draggable: true,
hide: null,
height: "auto",
maxHeight: null,
maxWidth: null,
minHeight: 150,
minWidth: 150,
modal: false,
position: {
my: "center",
at: "center",
of: window,
collision: "fit",
// Ensure the titlebar is always visible
using: function( pos ) {
var topOffset = $( this ).css( pos ).offset().top;
if ( topOffset < 0 ) {
$( this ).css( "top", pos.top - topOffset );
}
}
},
resizable: true,
show: null,
title: null,
width: 300,
// Callbacks
beforeClose: null,
close: null,
drag: null,
dragStart: null,
dragStop: null,
focus: null,
open: null,
resize: null,
resizeStart: null,
resizeStop: null
},上面的Callbacks应该就是所有的方法了，并没有create。然后才试的open。
优化-调整模态框大小
还是这个生成模态框的函数 dialog = $( "#dialog-form" ).dialog() ，里面的 height 和 width 属性，可以设置模态框的默认大小
问题：这里模态框有可能会出现滚轮
原因：模态框 id="dialog-form" 这个div里有这个样式 overflow: auto ，所以溢出会出现滚动条。
解决方法：把overflow样式覆盖掉应该就可以了，不过根本问题是溢出。我这里造成溢出的标签是form里的input标签。样式是这样的：
input.text { margin-bottom:12px; width:95%; padding: .4em; }这里我调整了 width 的宽度就好了。
优化-直接隐藏模态框
例子中没有这个情况，但是我用的时候页面加载的时候会首先显示出模态框，等加载完毕后模态框会隐藏掉。
问题：加载页面的时候会有一瞬出现模态框
原因：因为我把js代码的位置放到的最后，所以模态框的标签的代码读完的时候会显示出来，等js代码读取完的时候才会隐藏
解决方法：应该把生成模态框的js主要是 dialog = $( "#dialog-form" ).dialog() 方法提到前面就好了。不过我用了另外一个方法，给我的模态框的div标签加上了这个类：
<div class="ui-helper-hidden" id="dialog-form" title="Create new user">jquery-ui.css 里，这个类是这样的：
.ui-helper-hidden {
display: none;
}就是简单的隐藏掉，试过之后依然可以显示出来。
修改后的版本
替换掉了模板语言的部分，我用的修改后的版本如下：
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>Title</title>
<link rel="stylesheet" href="//code.jquery.com/ui/1.12.1/themes/base/jquery-ui.css">
<style>
#jqui-dialog label, #jqui-dialog input { display:block; }
#jqui-dialog form input { margin-bottom:12px; width: 92%; padding: .4em; }
#jqui-dialog fieldset { padding:0; border:0; margin-top:25px; }
#jqui-dialog h1 { font-size: 1.2em; margin: .6em 0; }
#jqui-dialog div#users-contain { width: 350px; margin: 20px 0; }
#jqui-dialog div#users-contain table { margin: 1em 0; border-collapse: collapse; width: 100%; }
#jqui-dialog div#users-contain table td, #jqui-dialog div#users-contain table th {
border: 1px solid #eee;
padding: .6em 10px;
text-align: left;
}
#jqui-dialog .ui-dialog .ui-state-error { padding: .3em; }
#jqui-dialog .validateTips { border: 1px solid transparent; padding: 0.3em; }
</style>
</head>
<body>
<div id="jqui-dialog">
<div class="ui-helper-hidden" id="dialog-form" title="添加新用户组">
<p class="validateTips">请填写要新建的组的名称</p>
<form action="." method="post">
<fieldset>
<label for="group_name">组名称</label>
<input type="text" name="group_name" id="group_name" class="text ui-widget-content ui-corner-all">
<label for="comments">备注</label>
<input type="text" name="comments" id="comments" class="text ui-widget-content ui-corner-all">
<!-- Allow form submission with keyboard without duplicating the dialog button -->
<input type="submit" tabindex="-1" style="position:absolute; top:-1000px">
</fieldset>
</form>
</div>
<div id="users-contain" class="ui-widget">
<h1>用户组列表：</h1>
<button id="create-user">添加新用户组</button>
<table id="users" class="ui-widget ui-widget-content">
<thead>
<tr class="ui-widget-header ">
<th>id</th>
<th>群组名</th>
<th>备注</th>
</tr>
</thead>
<tbody>
<tr>
<td>1</td>
<td>测试一</td>
<td>test1</td>
</tr>
<tr>
<td>2</td>
<td>测试2</td>
<td>test2</td>
</tr>
<tr>
<td>3</td>
<td>测试三</td>
<td>test3</td>
</tr>
</tbody>
</table>
</div>
</div>
<script src="https://code.jquery.com/jquery-1.12.4.js"></script>
<script src="https://code.jquery.com/ui/1.12.1/jquery-ui.js"></script>
<script>
$(function () {
var dialog, form,
group_name = $(‘#group_name‘),
comments = $(‘#comments‘),
allFields = $([]).add(group_name).add(comments),
tips_msg = null,
tips = $(‘.validateTips‘);
// 长度验证
function checkLength(o, n, min, max) {
if (o.val().length > max || o.val().length < min) {
o.addClass("ui-state-error");
updateTips(n + "的长度必须在" +
min + "与" + max + "之间。");
return false
} else {
return true
}
}
// 正则验证
function checkRegexp(o, regexp, n) {
if (!(regexp.test(o.val()))) {
o.addClass("ui-state-error");
updateTips(n);
return false
} else {
return true
}
}
// 显示错误信息
function updateTips(t) {
tips_msg = tips_msg || tips.text();
tips.text(t).addClass("ui-state-highlight");
setTimeout(function () {
tips.removeClass("ui-state-highlight", 1500);
}, 500);
}
function addUser() {
var valid = true;
allFields.removeClass("ui-state-error");
valid = valid && checkLength(group_name, "组名称", 3, 32);
valid = valid && checkLength(comments, "备注", 0, 64);
valid = valid && checkRegexp(group_name, /^[^0-9]/, "组名称不能以数字开头");
if (valid) {
$( "#users tbody" ).append( "<tr>" +
"<td>" + ‘x‘ + "</td>" +
"<td>" + group_name.val() + "</td>" +
"<td>" + comments.val() + "</td>" +
"</tr>" );
dialog.dialog(‘close‘);
}
return valid
}
dialog = $("#dialog-form").dialog({
appendTo: ‘#jqui-dialog‘,
autoOpen: false,
height: 400,
width: 350,
modal: true,
buttons: [
{text: "提交", click: function () {
form.submit();
}},
{text: "取消", click: function () {
dialog.dialog(‘close‘);
}
}
],
open: function() {
form[ 0 ].reset();
allFields.removeClass( "ui-state-error" );
tips_msg && tips.text(tips_msg);
}
});
form = dialog.find("form").on("submit", function(event) {
event.preventDefault(); // 阻止默认操作，需要提交到后端的时候注释掉这句
return addUser(); // 返回验证的结果，如果为false，会阻止submit提交
});
$("#create-user").button().on("click", function() {
dialog.dialog( "open" );
});
})
</script>
</body>
</html>以上是关于jQuery UI 模态表单疯狂踩坑的主要内容，如果未能解决你的问题，请参考以下文章
VS Code安装PlatformIO疯狂踩坑记 Arduino环境配置