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

说明:官方文档写的特别好!但是我吧,光看是记不到啥东西的,所以就挑着自己写了点,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!');
  });
});
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 213,099评论 6 492
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 90,828评论 3 387
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 158,540评论 0 348
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 56,848评论 1 285
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 65,971评论 6 385
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 50,132评论 1 291
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,193评论 3 412
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 37,934评论 0 268
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,376评论 1 303
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,687评论 2 327
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,846评论 1 341
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,537评论 4 335
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,175评论 3 317
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,887评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,134评论 1 267
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 46,674评论 2 362
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 43,741评论 2 351

推荐阅读更多精彩内容