美文网首页
2019-07-17优秀的国产框架之LayUI

2019-07-17优秀的国产框架之LayUI

作者: 啊_6424 | 来源:发表于2019-07-18 12:47 被阅读0次

    说明:官方文档写的特别好!但是我吧,光看是记不到啥东西的,所以就挑着自己写了点,emmmm,基本都是copy官网,就当是我在誊抄,加强记忆吧!

    是一款国产的框架,可以让后端程序员不需学习太多就能操作页面

    下载

    官网:https://www.layui.com/

    下载文件说明

    下载的文件

    说明:

    • css

    • font

    • images

    • lay:
      我们可以看到他是分模块的管理我们的组件。并且帮我们集成了jQuery。

      • layui.all.js:默认引入modules里面的所有模块。需要使用的时候,不需要引入,直接声明就行了!
        var table = layui.table;
        var tree = layui.tree;
        var form = layui.form;

      • layui.js:默认不引入,如果想要使用必须手动引入,再声明。
        引入方式:

      <script>
            layui.use(['tree', 'table', 'form'], function (obj) {
                var table = layui.table;
                var tree = layui.tree;
                var form = layui.form;         
                ……
            });
      </script>
    

    准备工作

    我们先创建一个web项目

    图片.png

    在WEB-INF下新建classes和lib2个文件夹(Directory),配置java class字节码编译路径


    图片.png

    配置jar包存放路径 lib文件夹


    图片.png
    选择目标文件夹
    选择这个文件夹将要存放的文件类型
    再引入我们下载好的layui:

    在webapp下新建一个文件夹resources,将我们下载好的layui文件夹复制进去,最后在JSP文件里边引入就可以了。

    <%@ page contentType="text/html;charset=UTF-8" language="java" %>
    <html>
      <head>
        <title>button</title>
        <%--引入css--%>
        <link href="resources/layui/css/layui.css">
        <%--引入js--%>
        <script src="resources/layui/layui.js"></script>
      </head>
      <body>
        <div>
          我的web项目
        </div>
      </body>
    </html>
    
    整体项目结构

    按钮

    有直角按钮,有圆角按钮。大尺寸按钮,小尺寸按钮。通过不同的class名来设置
    默认的按钮与按钮之间有间隔,但我们可以使用按钮组来放置多个相连的按钮。

    图标

    布局

    选项卡

    进度条

    面板

    徽章

    动画

    时间和日期选择器

    表单

          //监听form表单的提交
          form.on('submit(formDemo)', function(data){
            console.log(data);
            //这里面的data对应的是设置了name属性的表单元素,如果表单元素没有设置name属性的话,他的值就不会被包含在data里边。
            layer.msg(JSON.stringify(data.field));
            return false;
          });
    

    通过事件监听来提交表单内容。
    form.on('event(过滤器值)', callback)
    本例中:
    form.on('submit(formDemo)', function(data){……}
    过滤器的值——有lay-submit属性对应元素的 lay-filter属性的值
    callback——回调函数
      回调函数的参数data:值如下图

    回调函数的参数data
      data包含的值解析:
    • elem:绑定提交事件的元素(通过lay-submit属性),必须给这个元素另一属性lay-filter,用来标识当前的表单。
    • field:对应for表单下的具有name属性表单元素的 name:值 组成的对象。
    • form:对应的form

    弹出层

    数据表格

    使用html方式(了解)

    使用js方式(掌握)渲染数据

      <%--表格的标题栏,数据栏我们采用js的方式动态显示--%>
      <table class="layui-table" id="user_table"></table>
    ......
    <script>
        //推荐使用这种方式使用layui模块
        layui.use(["table","layer"], function(){
          var table = layui.table;
          var layer = layui.layer,
          $ = layui.$,//不引入jquery是因为:内置的模块layer本身是依赖jquery的
    
          //执行一个 table 实例
          table.render({
            elem: '#user_table'
            ,url: './json/user.json' //数据接口
            ,cols: [[ //表头
              {type: 'checkbox', fixed: 'left'}
              ,{field: 'id', title: 'ID', width:80, sort: true, fixed: 'left', totalRowText: '合计:'}
              ,{field: 'username', title: '用户名', width:80}
              ,{field: 'experience', title: '积分', width: 90, sort: true, totalRow: true}
              ,{field: 'sex', title: '性别', width:80, sort: true}
              ,{field: 'score', title: '评分', width: 80, sort: true, totalRow: true}
              ,{field: 'city', title: '城市', width:150}
              ,{field: 'sign', title: '签名', width: 200}
              ,{field: 'classify', title: '职业', width: 100}
              ,{field: 'wealth', title: '财富', width: 135, sort: true, totalRow: true}
              ,{fixed: 'right', width: 165, align:'center', toolbar: '#barDemo'}
            ]]
            //以上的几个参数为必填。
            ,toolbar: '#toolbarDemo'
          });
    </script>
    

    table通过js渲染数据:
    1.先在html里面定义一个table,注意需要定义好id属性
    2.在js区域引入layui的js文件,并声明table组件
    3.通过函数的方式,设置Table的相关参数
    4.必填参数

    • elem:绑定将要显示数据的table(一般通过Id属性绑定)
    • url:获取数据的地址
    • cols:设置表头的相关信息。

    5.比较常见的选填参数

    • toolbar:表格头部工具栏区域。类型值:
      toolbar: '#toolbarDemo' :指向自定义工具栏模板选择器
      toolbar: '<div>xxx</div>' :直接传入工具栏模板字符
      toolbar: true :仅开启工具栏,不显示左侧模板
      toolbar: 'default':让工具栏左侧显示默认的内置模板
      若需要“列显示隐藏”、“导出”、“打印”等功能,则必须开启toolbar参数
    • page:是否开启分页功能,默认为false不开启

    6.cols以及cols的参数:cols用于设置表头,是一个一个二维数组

    • field:设定字段名,字段名是表格数据列的唯一标识
    • sort: true: 可以对本列进行 上升/下降 排序,不会新发起一次请求
    • fixed:left/right,当我们一行的单元格过多的时候后,表格就是横向滚动的了。这种情况如果想固定某一列,可以使用这个参数。
    • type:设置列类型,默认为normal,可选值:
      normal(常规列,无需设定)
      checkbox(复选框列)
      radio(单选框列,layui 2.4.0 新增)
      numbers(序号列)
      space(空列)
    • templet:自定义列模板,实现逻辑处理,以及将原始数据转化成其它格式,如时间戳转化为日期字符等
    • toolbar:String类型,绑定列工具条。设定后,可在每行列中出现一些自定义的操作性按钮

    templet 参数:自定义列模板

    单元格的内容默认是完全按照数据接口返回的content原样输出的。
    如果你想对某列的单元格实现逻辑处理,或者原始数据转化成其它格式,则需要用到这个参数。
    方式有三种:
    暂时先不学了,知道就行!

    toolbar参数: 绑定列工具条

    用于比如说在表格的每一行加上 查看、编辑、删除 这样类似的操作按钮。
    String类型无默认值:通常接受的是一个选择器,也可以是一段HTML字符

    数据的异步请求

    参数如下:

    • url:接口地址。
      默认会自动传递两个参数:?page=1&limit=30(该参数可通过 request 自定义)page 代表当前页码、limit 代表每页数据量
    • method: 接口http请求类型,默认:get
    • where: 接口的其它参数。如:where: {token: 'sasasas', id: 123}
    • contentType:发送到服务端的内容编码类型。如果你要发送 json 内容,可以设置:contentType: 'application/json'
    • headers:接口的请求头。如:headers: {token: 'sasasas'}
    • parseData:将返回的任意数据格式解析成 table 组件规定的数据格式
    • request:用于对分页请求的参数:page、limit重新设定名称
    • response:重新规定返回的数据格式

    获取选中行

    获取到表格所有的选中行相关数据。语法:table.checkStatus('ID'),其中 ID 为基础参数 id 对应的值

    1.通过方法渲染

    ……
    table.render({ 
      ……
      id: 'idTest'
    });
    

    2.调用

    var checkStatus = table.checkStatus('idTest'); //idTest 即为基础参数 id 对应的值 
    console.log(checkStatus.data) //获取选中行的数据
    console.log(checkStatus.data.length) //获取选中行数量,可作为是否有选中行的条件
    console.log(checkStatus.isAll ) //表格是否全选
    

    导出数据

    table的事件监听

    语法:table.on('event(filter)', callback)。event为内置事件名,filter为容器lay-filter设定的值

    table的监听有:
    监听复选框事:用户选择了哪些行
    监听头部工具栏事件:
    监听单元格编辑:在单元格里直接修改内容
    监听行单双击事件:列工具条中的删除/编辑等操作
    监听排序切换:列排序的切换

          <table class="layui-table" lay-filter="test_table" id="test_event_table"></table>
    
          //监听复选框事件
          table.on('checkbox(test_table)',function(obj){//
            console.log(obj);
          });
    

    文件上传

    富文本编辑

    底层方法

    全局配置

    方法:layui.config(options)

    可以在使用模块之前,全局化配置一些参数,目前支持的全局配置项如下:

    layui.config({
      dir: '/res/layui/' //layui.js 所在路径(注意,如果是script单独引入layui.js,无需设定该参数。),一般情况下可以无视
      ,version: false //一般用于更新模块缓存,默认不开启。设为true即让浏览器不缓存。也可以设为一个固定的值,如:201610
      ,debug: false //用于开启调试模式,默认false,如果设为true,则JS模块的节点会保留在页面
      ,base: '' //设定扩展的Layui模块的所在目录,一般用于外部模块扩展
    });
    

    自定义模块

    方法:layui.define([mods], callback)

    通过该方法可定义一个 Layui模块
    参数:
    mods:可选的,用于声明该模块所依赖的模块。
    callback:模块加载完毕的回调函数,返回一个exports参数,用于输出该模块的接口。

    layui.define(function(exports){
      exports('demo', function(){
        alert('Hello World!');
      });
    });
    

    相关文章

      网友评论

          本文标题:2019-07-17优秀的国产框架之LayUI

          本文链接:https://www.haomeiwen.com/subject/dsmflctx.html