zoukankan      html  css  js  c++  java
  • 后台UI模板开发规范

    AdminLTE模板

    在接触新模板之前,需要对bootstrap有初步了解,文档戳这里  主要是了解有哪些控件、样式、元素 可以直接follow使用(形成需要什么的时候直接去查文档的意识,而不是都自己创造)。 AdminLTE是基于bs 搭建的前端样式框架,完全遵循bs的前端规范。

    AdminLTE有完善的Demo及文档说明,已部署到本地,戳这里。另外在新版的后台中也附带了链接

    图片

    小图标

    AdminLTE采用fonticon来作为默认的小图标,默认的FontIcon库(字体图标,这种方式的图标其实是字体,因此可以用css控制颜色,大小,甚至加动画,比单纯使用图片的方式更加灵活可控,是目前前端流行技术之一。),请参看Demo文档戳这里。模板附带了两套FontIcon,用法分别如下:

    1. font awesome字体
      <i class="fa fa-dashboard"></i> 前面的fa是固定的 后面的是对应的图标
    2. glyphicons
      <i class="glyphicon glyphicon-adjust"></i>
       

    标准文档结构

    这节的内容基于原版文档(全部的请戳详细文档),针对Razor引擎,做了相应修改。

    1. 页头部分

      一个页面有3个Title,分别是html head里的title、文档结构正文中的大标题和副标题。针对Razor,需要在页面上对以下三个参数赋值:


      (1) ViewBag.Title => 页面大标题, (请设置)


      (2) ViewBag.PageTitle => 显示在页面里的标题 (请设置)


      (3) VIewBag.SubTitle => 显示在页面里的小标题 (可不设)

    1. 菜单部分

      左侧的菜单经过修改之后,添加了小图标,在api设置页可以设置特定的小图标,一定是模板附带的font icon。 还有一个菜单是右上的面包屑菜单,这个菜单整体是个ul,请使用razor语法:


      @section headernav{	//section是Razor 预定义节,这里headernav被声明为必须
      
      <li><a href="#">Charts</a></li>
      <li class="active">ChartJS</li>
      }

      ATT:这部分等空了再改成配置,前期请自行添加!!!

    1. 正文

      这里的正文指的是html文档结构右边的正文部分,在模板里必须是在div.content底下(bootstrap标准, 也可以采用其他允许的class,详细参考BootStrap 格栅系统),下面以一个标准的表格页面作为例子:

    <section class="content">  //正文定义
        <div class="row">      //bs格栅 定义一个行
            <div class="col-xs-12">   //bs格栅 定义一个12格占位的列
                <div class="box box-default">    //模板控件 BOX,详见下面的说明
                    <div class="box-header with-border">
                        <h3 class="box-title">搜索条件</h3>
                        <div class="box-tools pull-right">
                            <button class="btn btn-box-tool" data-tooltip="tooltip" title="隐藏" data-widget="collapse"><i class="fa fa-minus"></i></button>   // 这个box附带隐藏按钮
                        </div><!-- /.box-tools -->
                    </div><!-- /.box-header -->
                    <div class="box-body">
                        <div class="form-inline">  //form-inline 定义一行多列的表单
                            <div class="form-group">  //form-group 定义div内元素为一个行组
                                <block>
                                    <label for="userId">客户编号:</label>
                                    <input id="userId" type="text" style="90px;" placeholder="客户编号" />
                                </block>
                            </div>                       
                            <button class="btn btn-info btn-flat btn-sm" id="search">搜索</button>
                        </div>
                    </div><!-- /.box-body -->
                </div>
                <!-- /.box -->
    
                <div class="box">    
                    <div class="box-header">
                        <h3 class="box-title">数据</h3>
                    </div><!-- /.box-header -->
                    <div class="box-body">
                        <table id="example2" class="table table-bordered table-hover">  //定义表格
                           。。。。
                        </table>
                    </div><!-- /.box-body -->
                    <div id="processingIndicator" class="overlay" style="display:none"> //一个loading层, 见下面的说明
                        <i class="fa fa-refresh fa-spin"></i>
                    </div>
                </div><!-- /.box -->
            </div>
        </div>
    </section>
    

    这个页面的完整例子,请查看CRM-客户列表页面(请戳详细页面

    上面的例子中使用了一些特殊的组件:

    (1) Box, Box作为AdminLTE模板附带的块组件,是最常用的排版组建,应该作为基础牢记,Box有多种样式及用法(原文档)。 我们的页面结构里,content里一定是以Box为基础的!

    (2)Loading组件, 模板中提供了非常方便的Loading使用方式,只要在Box的body块之下添加一段loading html即可,html见上面的代码,如果要控制loading显示隐藏,请使用js配合处理



    DataTable.js (表格控件)

    官方文档,请戳这里,可能需要翻墙,实在翻不出去,找Gondar吧 - -!

    这里只讲最常见的通用用法,直接上代码

     

    var srtable = $('#example2').on('processing.dt', function (e, settings, processing) {
                    //自定义loading,就是控制上面提到的loading html组件 这段照抄就好
                    $('#processingIndicator').css('display', processing ? 'block' : 'none');
                }).DataTable({ //开始声明Table
                    processing: false,//禁掉原生的loading,你也可以扔掉上面的代码用这个
                    paging: true, //是否分页,要是!
                    serverSide: true,//是否服务器端处理数据,要是! 否则分页、排序之类会针对本地数据缓存
                    ajax: {  //和jquery ajax一样
                        url: '@Url.Action("GetCustomerList")',
                        type: 'POST',
                        data: function (d) {
                            return $.extend({}, d, {
                                //自定义参数, 此处非常要注意,d是 datatable的默认ajax参数,最好带着吧,除非你真的不需要。 采用jquery 复制函数来扩展自定义参数~!
                                "UserId": $('#userId').val(),                            
                            });
                        }
                    },
                    columns: [
                        { data: 'UserId' },//列的映射, datatable的好用之处是,他会记录下完整的后台json数据,即使列不显示,数据还是在的,至于如何取一会讲。
                        。。。
                    ],
                    columnDefs: [
                        { "render": function ( data, type, row ) {
                        return '<a target="_blank" href="http://www.@CurrentShareDomain/hpsc/hpfcl-' + row.ID +'.html">查看</a>'
                    }, "targets": 4 }    //列定义 这里扩展了一个操作列,用来查看,注意看 row就是一行的元数据,是个JSON
                    ],
                    "lengthChange": true,//每页大小
                    "searching": true,//搜索
                    "ordering": true,//排序
                    "info": true,//?
                    "autoWidth":true,//自动列宽, 这里顺带提一提,列多的时候thead的字体可以设置小一些
                    sDom: 'lrtip'//dom结构 该语句 隐藏filter搜索条 我们这默认搜索应该不需要,有些页面只有一个搜索条,那直接使用这个 删掉这句话
                });
    
                //这里开始最强大的交互部分,注意一定on去挂一个事件委托,否则因为html是动态的 事件要丢的,而on是基于事件冒泡,遍历了当前元素的委托而响应的。
                $('#example2').on('click', 'tr', function (event) {
                    var data = srtable.row(this).data();//看行数据就是这么取到的!!! 这句话一定要记住啊!!!千万!!
                    if (data != null && data.UserId != null && data.UserId > 0) {
                        //跳转
                        window.location = '@Url.Action("userdetail")?userid=' + data.UserId;
                    }
    
                }).on('dblclick', 'td', function (event) {
                    //$(this).css('background', '#000');
                });

    上面提到的是非常非常基本的用法,而深入用法,用到的时候自行查看API,如果看不到那就只好找Gondar 翻墙看。 另外与knockoutjs等mvvm框架的交互,可以粗糙的使用事件手动挂接的方式,参考CRM-用户详情页-访问记录里的增删改。有更强大的框架支持的话,请post给gondar!

    由于DataTable的ajax参数众多,因此我封装了部分参数,如果没有封装进去,而需要使用的请找Gondar!

    对DataTable Request的参数,封装成了JQDataTableModel类,使用时先集成此类,然后再Action参数处,声明自定义Bind

    例如:

    [ModelBinder(typeof(JQTBinder))]UserListJQTModel viewModel  // 这里需要特别注意的是SortColumn参数,对应的是列序号

    Response参数, 封装成了JQDataTableResponse, 使用如下

    var response = new JQDataTableResponse<OpUserDetail>
                {
                    recordsTotal = (int)total,
                    recordsFiltered = (int)total,
                    data = data.ToList(),
                    draw = viewModel.Draw
                };
                return response.ToJsonResult();

    日期范围选择控件

    在模板里看到这个控件,文档戳这

    组建依赖 moment.js 文档戳这

     

    $('#daterange-btn').daterangepicker(
                    {
                        ranges: { //声明快速选择按钮
                            '今天': [moment(), moment().add(1, 'days')],
                            '昨天': [moment().subtract(1, 'days'), moment()],
                            '最近7天': [moment().subtract(6, 'days'), moment()],
                            '最近30天': [moment().subtract(29, 'days'), moment()],
                            '本月': [moment().startOf('month'), moment().endOf('month')],
                            '上月': [moment().subtract(1, 'month').startOf('month'), moment().subtract(1, 'month').endOf('month')]
                        },
                        startDate: moment().subtract(29, 'days'),
                        endDate: moment()
                    },
            function (start, end) {//应用按钮的响应事件,这里格式化
                $('#startDate').html(start.format('YYYY-MM-DD'));
                $('#endDate').html(end.format('YYYY-MM-DD HH:mm:ss'))
            }
            );

    Messenger提示框

    文档

    图片

    这里只说明最简单的用法,已集成到模板,使用页面直接调用如下代码

    $.message = {
                error: function (msg) {
                    Messenger().post({ message: msg, type: "error", hideAfter: 5, showCloseButton: true });
                },
                info: function (msg) {
                    Messenger().post({ message: msg, type: "info", hideAfter: 5, showCloseButton: true });
                },
                success: function (msg) {
                    Messenger().post({ message: msg, type: "success", hideAfter: 5, showCloseButton: true });
                }};
    
    //上面的代码已写到模板页,调用页调用如下:
    $.message.error('保存失败!');
    

    ArtDialog(弹出框)

    这个组建提供了丰富的弹出功能,我们这里使用alter、confirm这些功能, 文档在这里

    $.message = {
    confirm: function (msg, okf, canf) {                
                    var d = dialog({
                        title: '提示',
                        content: msg,
                        okValue: '确定',
                        ok: function () {
                            if (okf != null)
                                okf();
                        },
                        cancelValue: '取消',
                        cancel: function () {
                            if (canf != null)
                                canf();
                        },
                         '20em'
                    });
                    d.show();
                }
    }
    //以上代码同样写到模板页了,调用如下:
    $.meesage.confirm('确认删除?',function(){
    //...删除
    });
    

    Tab

    Tab控件是模板自带的,使用上非常简单,只要定义如下的Html结构:(具体的参考CRM-用户详情页)

     <ul class="nav nav-tabs ui-sortable-handle"> // Nav导航 其中active指的是当前激活的tab, 默认应该填上一个
                    <li class="active"><a href="#company-info" data-toggle="tab" aria-expanded="true">公司信息</a></li>
                    <li class=""><a href="#buyerdemands" data-toggle="tab">发布的货盘</a></li>
        </ul>
                <div class="tab-content no-padding"> //文档内容
                    <!-- Morris chart - Sales -->
                    <div class="box box-solid tab-pane active" id="company-info" style="position: relative; height: 600px;">
                        <div class="box-body">
                              // 看这里又实用了Box组件 
                        </div>
                        <div class="overlay">
                            <i class="fa fa-refresh fa-spin"></i>
                        </div>
                    </div>
    
                    
                  </div>
    

    复杂表单弹出(Modal)

    这个Modal是bootstrap自带的弹出框,术语模态框。 用于弹出显示复杂的自定义的html内容, 完整的api请见文档

    这里不贴Html代码了,只讲用法,代码见CRM-用户详情.

    $('#md-visit-record .modal-title').text('添加访问记录');//修改title
      $('#md-visit-record').modal('show');//弹窗

    Modal其实也可以用来做为ArtDialog的功能,只不过比较不同样,所以和argDialog的使用场合,请大家自行区别!

    其他组件

    模板里附带了很多控件,尤其是在DashBoard页面,大家自行参考,有需要统一说明的可以找Gondar一起。我们使用控件的原则是,简单,方便,不与模板冲突。最重要的是方便大家开发。



    MVVM

    关于MVVM,我建议大家自行学习,这对前端的建模和写法有很大的启发,传统的依赖Jquery的写法在大型数据交互的情景下,效率非常差,代码可维护性也非常低!这部分下次再详细写。参考Knockoutjs.

    上面提到的点,很粗略,大家在使用过程中,还是要养成一定要记得文档和询问,不要简单的Copy就用了,一知半解也许就埋下了BUG点了。而且只用了解熟悉了之后,才能充分发挥控件对我们工作效率的提升。

  • 相关阅读:
    自动化测试===Httprunner测试框架介绍
    java===java基础学习(6)---流程控制,for,if,switch,continue,break
    java===java基础学习(5)---文件读取,写入操作
    电子书免费下载地址整理
    java===java基础学习(4)---字符串操作
    java===字符串常用API介绍(转)
    java===java基础学习(3)---数据类型转换,运算符级别,枚举类型
    java===java基础学习(2)---运算符,三元操作符,数学函数
    java===java基础学习(1)---数据类型,运算,变量,常量
    爬虫===登陆CSDN的方法
  • 原文地址:https://www.cnblogs.com/donchen/p/4744186.html
Copyright © 2011-2022 走看看