Java自学者论坛

 找回密码
 立即注册

手机号码,快捷登录

恭喜Java自学者论坛(https://www.javazxz.com)已经为数万Java学习者服务超过8年了!积累会员资料超过10000G+
成为本站VIP会员,下载本站10000G+会员资源,会员资料板块,购买链接:点击进入购买VIP会员

JAVA高级面试进阶训练营视频教程

Java架构师系统进阶VIP课程

分布式高可用全栈开发微服务教程Go语言视频零基础入门到精通Java架构师3期(课件+源码)
Java开发全终端实战租房项目视频教程SpringBoot2.X入门到高级使用教程大数据培训第六期全套视频教程深度学习(CNN RNN GAN)算法原理Java亿级流量电商系统视频教程
互联网架构师视频教程年薪50万Spark2.0从入门到精通年薪50万!人工智能学习路线教程年薪50万大数据入门到精通学习路线年薪50万机器学习入门到精通教程
仿小米商城类app和小程序视频教程深度学习数据分析基础到实战最新黑马javaEE2.1就业课程从 0到JVM实战高手教程MySQL入门到精通教程
查看: 22622|回复: 0

(转)JS组件系列——BootstrapTable 行内编辑解决方案:x-editable

[复制链接]
  • TA的每日心情
    奋斗
    7 天前
  • 签到天数: 745 天

    [LV.9]以坛为家II

    2041

    主题

    2099

    帖子

    70万

    积分

    管理员

    Rank: 9Rank: 9Rank: 9

    积分
    704660
    发表于 2021-4-6 10:17:55 | 显示全部楼层 |阅读模式

     

    正文

    前言:之前介绍bootstrapTable组件的时候有提到它的行内编辑功能,只不过为了展示功能,将此一笔带过了,罪过罪过!最近项目里面还是打算将行内编辑用起来,于是再次研究了下x-editable组件,遇到过一些坑,再此做个采坑记录吧!想要了解bootstrapTable的园友可以移步 JS组件系列——表格组件神器:bootstrap table

    本文原创地址:http://www.cnblogs.com/landeanfen/p/5821192.html

    一、x-editable组件介绍

    x-editable组件是一个用于创建可编辑弹出框的插件,它支持三种风格的样式:bootstrap、Jquery UI、Jquery。大致效果如下图:

    根据博主一贯的风格,这里肯定是选用第一种喽。首先还是给出开源地址吧。

    x-editable开源地址:https://github.com/vitalets/x-editable

    x-editable文档地址:http://vitalets.github.io/x-editable/docs.html

    x-editable在线Demo:http://vitalets.github.io/x-editable/demo-bs3.html

     1、x-editable初体验。

    首先下载基于bootstrap的源码到本地。引用相关文件。

    <link href="/Content/bootstrap/css/bootstrap.min.css" rel="stylesheet" />
    <link href="~/Content/bootstrap3-editable/css/bootstrap-editable.css" rel="stylesheet" />
    
    <script src="/Scripts/jquery-1.9.1.min.js"></script>
    <script src="/Content/bootstrap/js/bootstrap.min.js"></script>
    <script src="~/Content/bootstrap3-editable/js/bootstrap-editable.js"></script>

     页面元素

    <a href="#" id="username" data-type="text" data-title="用户名">用户名</a>

    js初始化

        $(function () {
            $('#username').editable();
        });

    效果展示

    上面是通过html的data属性去设置x-editable的参数,当然,我也可以在初始化的时候去设置参数,比如,我仅仅给一个空的a标签:

    <a href="#" id="username">用户名</a>

    js初始化

    复制代码
        $(function () {
            $('#username').editable({
                type: "text",                //编辑框的类型。支持text|textarea|select|date|checklist等
                title: "用户名",              //编辑框的标题
                disabled: false,             //是否禁用编辑
                emptytext: "空文本",          //空值的默认文本
                mode: "inline",              //编辑框的模式:支持popup和inline两种模式,默认是popup
                validate: function (value) { //字段验证
                    if (!$.trim(value)) {
                        return '不能为空';
                    }
                }
            });
    
        });
    复制代码

    查看效果

    再来个稍微复杂一点的

    <a href="#" id="department">选择部门</a>
    复制代码
        $(function () {
            $('#department').editable({
                type: "select",              //编辑框的类型。支持text|textarea|select|date|checklist等
                source: [{ value: 1, text: "开发部" }, { value: 2, text: "销售部" }, {value:3,text:"行政部"}],
                title: "选择部门",           //编辑框的标题
                disabled: false,           //是否禁用编辑
                emptytext: "空文本",       //空值的默认文本
                mode: "popup",            //编辑框的模式:支持popup和inline两种模式,默认是popup
                validate: function (value) { //字段验证
                    if (!$.trim(value)) {
                        return '不能为空';
                    }
                }
            });
    
        });
    复制代码

    查看效果

    上文只是给出了一些常用字段,当然x-editable组件还有很多其他的功能参数,有兴趣可以看看文档,官方文档对每个参数都有详细的说明。 

    二、bootstrapTable行内编辑初始方案

    说了这么半天,上面的只是铺垫,我们最终是希望在bootstrapTable里面实现行内编辑。根据上面的规则,我们想要使用x-editable实现行内编辑,表格的单元格里面必须要有一个a标签,然后对a标签做x-editable的初始化。有了这个想法,我们按照这种思路先试试。

    引用相关文件

    复制代码
    <link href="/Content/bootstrap/css/bootstrap.min.css" rel="stylesheet" />
    <link href="~/Content/bootstrap3-editable/css/bootstrap-editable.css" rel="stylesheet" />
    <link href="/Content/bootstrap-table/bootstrap-table.min.css" rel="stylesheet" />
    
    <script src="/Scripts/jquery-1.9.1.min.js"></script>
    <script src="/Content/bootstrap/js/bootstrap.min.js"></script>
    <script src="~/Content/bootstrap3-editable/js/bootstrap-editable.js"></script>
    <script src="~/Content/bootstrap-table/bootstrap-table.js"></script>
    <script src="/Content/bootstrap-table/locale/bootstrap-table-zh-CN.js"></script>
    复制代码

    bootstrapTable的相关初始化

    复制代码
    <script type="text/javascript">
        var curRow = {};
        $(function () {
            $("#tb_user").bootstrapTable({
                toolbar: "#toolbar",
                idField: "Id",
                pagination: true,
                showRefresh: true,
                search: true,
                clickToSelect: true,
                queryParams: function (param) {
                    return {};
                },
                url: "/Editable/GetUsers",
                columns: [{
                    checkbox: true
                }, {
                    field: "UserName",
                    title: "用户名",
                    formatter: function (value, row, index) {
                        return "<a href=\"#\" name=\"UserName\" data-type=\"text\" data-pk=\""+row.Id+"\" data-title=\"用户名\">" + value + "</a>";
                    }
                }, {
                    field: "Age",
                    title: "年龄",
                }, {
                    field: "Birthday",
                    title: "生日",
                    formatter: function (value, row, index) {
                        var date = eval('new ' + eval(value).source)
                        return date.format("yyyy年MM月dd日");
                    }
                },
                {
                    field: "DeptName",
                    title: "部门"
                }, {
                    field: "Hodd",
                    title: "爱好"
                }],
                onClickRow: function (row, $element) {
                    curRow = row;
                },
                onLoadSuccess: function (aa, bb, cc) {
                    $("#tb_user a").editable({
                        url: function (params) {
                            var sName = $(this).attr("name");
                            curRow[sName] = params.value;
                            $.ajax({
                                type: 'POST',
                                url: "/Editable/Edit",
                                data: curRow,
                                dataType: 'JSON',
                                success: function (data, textStatus, jqXHR) {
                                    alert('保存成功!');
                                },
                                error: function () { alert("error");}
                            });
                        },
                        type: 'text'
                    });
                },
            });
        });</script>
    复制代码

    后台方法

      后台测试方法

    这样确实是可以实现想要的效果,貌似也能行内编辑了,可是如果没个列都需要行内编辑,并且列的个数很多,那么是不是每个列都得这样去formmater?并且这种写法狠显然很死板,博主着实难以接受。于是又找了找例子,发现在bootstrapTable的扩展里面存在bootstrap-table-editable.js这个js。

    三、bootstrapTable行内编辑最终方案

    好吧,博主承认,上面还是铺垫,因为博主觉得这可能是解决问题的一般思路,所以将这些铺垫的篇幅可能有点多。首先来看看bootstrap-table-editable.js这个文件

      bootstrap-table-editable.js

    这个js其实是对x-editable做了一个简单的封装,增加了列的editable属性以及编辑保存后的一些事件。有了这个作为基础,于是我们行内编辑的代码变成了这样。

    需要引用的文件如下:

    复制代码
    <link href="/Content/bootstrap/css/bootstrap.min.css" rel="stylesheet" />
    <link href="~/Content/bootstrap3-editable/css/bootstrap-editable.css" rel="stylesheet" />
    <link href="/Content/bootstrap-table/bootstrap-table.min.css" rel="stylesheet" />
    
    <script src="/Scripts/jquery-1.9.1.min.js"></script>
    <script src="/Content/bootstrap/js/bootstrap.min.js"></script>
    <script src="~/Content/bootstrap3-editable/js/bootstrap-editable.js"></script>
    <script src="~/Content/bootstrap-table/bootstrap-table.js"></script>
    <script src="/Content/bootstrap-table/locale/bootstrap-table-zh-CN.js"></script>
    <script src="~/Content/bootstrap-table/extensions/editable/bootstrap-table-editable.js"></script>
    复制代码

    1、文本框

    复制代码
      $(function () {
            $("#tb_user").bootstrapTable({
                toolbar: "#toolbar",
                idField: "Id",
                pagination: true,
                showRefresh: true,
                search: true,
                clickToSelect: true,
                queryParams: function (param) {
                    return {};
                },
                url: "/Editable/GetUsers",
                columns: [{
                    checkbox: true
                }, {
                    field: "UserName",
                    title: "用户名",
                    editable: {
                        type: 'text',
                        title: '用户名',
                        validate: function (v) {
                            if (!v) return '用户名不能为空';
    
                        }
                    }
                }, {
                    field: "Age",
                    title: "年龄",
                }, {
                    field: "Birthday",
                    title: "生日",
                    formatter: function (value, row, index) {
                        var date = eval('new ' + eval(value).source)
                        return date.format("yyyy-MM-dd");
                    }
                },
                {
                    field: "DeptName",
                    title: "部门"
                }, {
                    field: "Hobby",
                    title: "爱好"                
                }],
                onEditableSave: function (field, row, oldValue, $el) {
                    $.ajax({
                        type: "post",
                        url: "/Editable/Edit",
                        data: row,
                        dataType: 'JSON',
                        success: function (data, status) {
                            if (status == "success") {
                                alert('提交数据成功');
                            }
                        },
                        error: function () {
                            alert('编辑失败');
                        },
                        complete: function () {
    
                        }
    
                    });
                }
            });
        });
    复制代码

    后台对应的更新方法

            public JsonResult Edit(User user)
            {
                //更新实体
    
                return Json(new { }, JsonRequestBehavior.AllowGet);
            }

    经过测试,用户名这一列基本可以自由编辑。同样,年龄这一列也可改成这样

    复制代码
            {
                    field: "Age",
                    title: "年龄",
                    editable: {
                        type: 'text',
                        title: '年龄',
                        validate: function (v) {
                            if (isNaN(v)) return '年龄必须是数字';
                            var age = parseInt(v);
                            if (age <= 0) return '年龄必须是正整数';
                        }
                    }
                }
    复制代码

    其他基本不用做任何修改。

    代码释疑:上文在初始化的columns属性里面通过editable属性来配置可编辑的参数,注意这里每个列的editable属性对应的Json对象即为x-editable里面的初始化的Json对象,也就是说我们初始化x-editable的时候可以配置哪些属性,在列的editable属性里面也可以同样配置,这样用起来就爽多了吧。编辑后的提交方法统一放到onEditableSave事件里面统一处理。

    2、时间选择框

    有了上面的知识作为基础,我们来初始化生日这一列:

    复制代码
                {
                    field: "Birthday",
                    title: "生日",
                    formatter: function (value, row, index) {
                        var date = eval('new ' + eval(value).source)
                        return date.format("yyyy-MM-dd");
                    },
                    editable: {
                        type: 'date',
                        title: '生日'
                    }
                }
    复制代码

    其他地方不用做任何修改,得到效果:

    这是x-editable的默认样式,如果你看着不爽,可以自行配置,x-editable提供了许多配置日期框的参数,如下:

    当然,如果精确到时分秒,可以使用datetime类型的编辑框。如下是官方给出的时间框编辑效果,看着还不错。

    3、下拉框

    表单编辑里面还有一个重要的标签就是select了。上文我们知道x-editable为我们提供了下拉框的编辑模式,比如我们的部门这一列的编辑可以写成这样:

    复制代码
            {
                    field: "DeptId",
                    title: "部门",
                    editable: {
                        type: 'select',
                        title: '部门',
                        source:[{value:"1",text:"研发部"},{value:"2",text:"销售部"},{value:"3",text:"行政部"}]
                    }
                }
    复制代码

    得到效果

    当然,这种本地设置数据源的方法肯定是不能满足我们需求的,因为很多情况下拉框里面的选项是从数据库远程得到的。当然x-editable也为我们考虑到了,比如我们可以这样写:

    复制代码
            {
                    field: "DeptId",
                    title: "部门",
                    editable: {
                        type: 'select',
                        title: '部门',
                        source: function () {
                            var result = [];
                            $.ajax({
                                url: '/Editable/GetDepartments',
                                async: false,
                                type: "get",
                                data: {},
                                success: function (data, status) {
                                    $.each(data, function (key, value) {
                                        result.push({ value: value.ID, text: value.Name });
                                    });
                                }
                            });
                            return result;
                        }
                    }
                }
    复制代码

    后台我们配置一个方法

    复制代码
            public JsonResult GetDepartments()
            {
                var lstRes = new List<Department>();
                lstRes.Add(new Department() { ID = "1", Name = "研发部" });
                lstRes.Add(new Department() { ID = "2", Name = "销售部" });
                lstRes.Add(new Department() { ID = "3", Name = "行政部" });
                lstRes.Add(new Department() { ID = "4", Name = "创意部" });
                lstRes.Add(new Department() { ID = "5", Name = "事业部" });
                return Json(lstRes, JsonRequestBehavior.AllowGet);
            }
    复制代码

    同样能达到我们想要的结果。

    代码释疑:这里有一点需要说明一下,细心的园友可能发现了,我们这里的 field: "DeptId" ,为什么这里要配置DeptId而不是DeptName呢?很简单,因为我们需要和数据源里面的value值对应。

    4、复选框

    除了上述几种常见的编辑框,x-editable还为我们提供了复选框组的编辑。比如:

    复制代码
           {
                    field: "Hobby",
                    title: "爱好",
                    editable: {
                        type: "checklist",
                        separator:",",
                        source: [{ value: 'bsb', text: '篮球' },
                             { value: 'ftb', text: '足球' },
                             { value: 'wsm', text: '游泳' }],
                    }
                }
    复制代码

    得到效果:

    当然,如果远程数据,也可以使用类似上文的方法去取。

    5、“阴魂不散”的select2

    说到上文的复选框,博主不由自主又想到了Multiselect这些个东西,于是查找x-editable的文档,结果发现它不支持Multiselect,但是支持select2,也不知道这是不是一个好消息。根据博主自己的使用经历,也包括技术交流群里面的聊天经历,发现很多人在使用select2的时候都遇到过各种各样的样式问题,并且不太好解决。

    既然x-editable支持select2,那我们就用用试试呗,反正官方demo说得挺好的,下面是官方demo的使用示例:

     

    怀着忐忑的心情,博主自己尝试了一把。

    引用select2文件

    <link href="~/Content/select2-bootstrap.css" rel="stylesheet" />
    <link href="~/Content/select2-master/dist/css/select2.min.css" rel="stylesheet" />
    <script src="~/Content/select2-master/dist/js/select2.full.min.js"></script>

    代码尝试

    复制代码
            {
                    field: "Hobby",
                    title: "爱好",
                    editable: {
                        type: 'select2',
                        title: '爱好',
                        name: 'Hobby',
                        placement: 'top',
                        success: function (response, newValue) {
                            debugger;
                        },
                        error: function(response, newValue) {
                            debugger;
                        },
                        url: function(params) {
                            debugger;
                        },
                        source: [{ id: 'bsb', text: '篮球' },
                                 { id: 'ftb', text: '足球' },
                                 { id: 'wsm', text: '游泳' }],
                        inputclass: 'input-large',
                        select2: {
                            allowClear: true,
                            multiple: true,
                        } 
                    }
                }
    复制代码

    得到结果:

     结果发现select2的选中值不能正常传递到后台。反正博主试过各种参数,按照官方demo的写法也试过,均以失败告终。也不知道官方的demo如何成功的。这个问题先抛出来,如果有使用的园友欢迎指正与解答。后续如果博主解决了这个问题,也会在此更新。 

    四、总结

    还有一个问题就是在编辑完成提交之后,博主在项目中遇到这样一个问题:如果提交之后的文本内容过多,表格的thead里面th的宽度和tbody里面td的宽度不对其的问题,看着相当恶心。但是在写demo的时候又没有遇到这个问题。在此还是将解决方案给出来。

    就这么一句话解决你的困扰!

    本篇介绍了下bootstrapTable结合x-editable实现行内编辑的使用。文中很多问题都是根据博主的使用经历来说明,如果你打算将它用起来,也可以试试。如果本文能够帮到你,欢迎推荐

    本文原创出处:http://www.cnblogs.com/landeanfen/

    欢迎各位转载,但是未经作者本人同意,转载文章之后必须在文章页面明显位置给出作者和原文连接,否则保留追究法律责任的权利

    哎...今天够累的,签到来了1...
    回复

    使用道具 举报

    您需要登录后才可以回帖 登录 | 立即注册

    本版积分规则

    QQ|手机版|小黑屋|Java自学者论坛 ( 声明:本站文章及资料整理自互联网,用于Java自学者交流学习使用,对资料版权不负任何法律责任,若有侵权请及时联系客服屏蔽删除 )

    GMT+8, 2024-3-29 02:05 , Processed in 0.073151 second(s), 29 queries .

    Powered by Discuz! X3.4

    Copyright © 2001-2021, Tencent Cloud.

    快速回复 返回顶部 返回列表