大事件项目第三天

itpeilibo

已于 2022-11-06 22:10:11 修改

阅读量269

点赞数

分类专栏： Ajax git jQuery 文章标签： css html ajax jquery 前端

于 2022-06-07 18:45:00 首次发布

本文链接：https://blog.csdn.net/weixin_46862327/article/details/125171018

版权

jQuery 同时被 3 个专栏收录

9 篇文章 0 订阅

订阅专栏

git

5 篇文章 1 订阅

订阅专栏

Ajax

3 篇文章 1 订阅

订阅专栏

大事件项目第三天

文章目录

- - 大事件项目第三天

今日目标

能够完成文章类别的编辑功能
能够完成文章类别的删除功能
能够知道文章列表的分页查询参数的作用
能够完成文章列表的筛选功能
能够参照文档使用LayUI提供的自定义分页UI效果
知道laypage内置模块里面 layout属性和limits 属性的作用
能够解决 jump 回调函数中死循环的问题
能够获取 jump 回调中关键数据，页码值和每页条目数
能够实现分页查询功能
能够完成删除文章功能
能够完成新增文章功能

一、文章类别编辑

在这里插入图片描述

1、点击编辑按钮展示修改文章分类的弹出层

为编辑按钮添加 btn-edit 类名如下

html 结构（ /article/art_cate.html ）

<button type="button" class="layui-btn layui-btn-xs btn-edit">编辑</button>

定义 修改分类 的弹出层

html 结构（ /article/art_cate.html ）

<!-- 定义修改分类弹出层模板 -->
<script type="text/html" id="dialog-edit">
    <form class="layui-form" id="form-edit">
      <div class="layui-form-item">
        <label class="layui-form-label">分类名称</label>
        <div class="layui-input-block">
          <input type="text" name="name" required  lay-verify="required" placeholder="请输入分类名称" autocomplete="off" class="layui-input">
    </div>
    </div>
      <div class="layui-form-item">
        <label class="layui-form-label">分类别名</label>
        <div class="layui-input-block">
          <input type="text" name="alias" required  lay-verify="required" placeholder="请输入分类别名" autocomplete="off" class="layui-input">
    </div>
    </div>
      <div class="layui-form-item">
        <div class="layui-input-block">
          <button class="layui-btn" lay-submit lay-filter="formDemo">确认修改</button>
    </div>
    </div>
    </form>
</script>

修改 form 表单样式

css 样式（ /assets/css/article/art_cate.css ）

#form-add,
#form-edit {
    padding-top: 20px;
    padding-right: 30px;
}

通过 事件委派 的形式，为 btn-edit 按钮绑定点击事件

js 代码（ /assets/js/article/art_cate.js ）

// 通过代理方式，为 btn-edit 按钮绑定点击事件
let indexEdit = null;
$("tbody").on("click", ".btn-edit", function () {
    // 弹出修改文章分类的弹窗
    indexEdit = layer.open({
        type: 1,
        area: ["500px", "250px"],
        title: "修改文章分类",
        content: $("#dialog-edit").html(),
    });
});

2、为修改文章分类的弹出层填充表单数据

点击不同的条目，那么编辑里面的内容应该是对应的，目前问题，在代码层面，是不知道到底点击了哪个按钮，这里我们可以通过给对应编辑按钮绑定id来实现

为编辑按钮绑定 data-id 自定义属性

html 结构（ /article/art_cate.html ）

<button type="button" class="layui-btn layui-btn-xs btn-edit" data-id="{{$value.Id}}">编辑</button>

form元素添加 lay-filter=“form-edit” 属性

html 结构（ /article/art_cate.html ）

<form class="layui-form" id="form-edit" lay-filter="form-edit">

修改数据需要 id 值，需要给修改弹出层模板里增加隐藏域，用于存放 id

html 结构（ /article/art_cate.html ）

<form class="layui-form" id="form-edit" lay-filter="form-edit">
    <!-- 隐藏域 -->
    <input type="hidden" name="Id">
    <!-- 省略其他代码 -->
</form>

在展示弹出层之后，根据 id 的值发起请求获取文章分类的数据，并填充到表单中

js 代码（ /assets/js/article/art_cate.js ）

const id = $(this).attr("data-id");
// 发起请求获取对应分类的数据
$.ajax({
    method: "GET",
    url: "/my/article/cates/" + id,
    success: function (res) {
        layui.form.val("form-edit", res.data);
    },
});

3、更新文章分类的数据

通过事件委派的方式，给修改按钮绑定点击事件
查阅接口文档，利用 $.ajax() 发送 post 请求
判断服务器返回的 status 是否等于0，如果不等于，利用 layer.msg 提示用户
如果等于0，代表编辑成功，关闭当前弹出层，调用 initArtCateList() 方法获取最新的数据

js 代码（ /assets/js/article/art_cate.js ）

// 更新文章分类
$("body").on("submit", "#form-edit", function (e) {
    e.preventDefault();
    $.ajax({
        method: "POST",
        url: "/my/article/updatecate",
        data: $(this).serialize(),
        success: (res) => {
            if (res.status !== 0) {
                return layer.msg("更新分类数据失败！");
            }
            layer.msg("更新分类数据成功！");
            layer.close(indexEdit);
            initArtCateList();
        },
    });
});

二、删除文章分类

在这里插入图片描述

1、删除文章分类

为删除按钮绑定 btn-delete 类名，并添加 data-id 自定义属性

html 结构（ /article/art_cate.html ）

<button type="button" class="layui-btn layui-btn-danger layui-btn-xs btn-delete" data-id="{{$value.Id}}">
    删除
</button>

通过代理的形式，为删除按钮绑定点击事件

js 代码（ /assets/js/article/art_cate.js ）

// 删除文章分类
$("tbody").on("click", ".btn-delete", function () {
    const id = $(this).attr("data-id");
    // 提示用户是否删除
    layer.confirm("确定删除吗？", { icon: 3, title: "提示" }, function (index) {
        $.ajax({
            method: "GET",
            url: "/my/article/deletecate/" + id,
            success: function (res) {
                if (res.status !== 0) {
                    return layer.msg("删除分类失败！");
                }
                layer.msg("删除分类成功！");
                layer.close(index);
                initArtCateList();
            },
        });
    });
});

三、文章列表功能

1、创建文章列表页面

新建 /article/art_list.html 页面

利用卡片区域搭建结构

html 结构（ /article/art_list.html ）

<!DOCTYPE html>
<html lang="en">
    <head>
        <meta charset="UTF-8" />
        <meta http-equiv="X-UA-Compatible" content="IE=edge" />
        <meta name="viewport" content="width=device-width, initial-scale=1.0" />
        <title>Document</title>
        <link rel="stylesheet" href="/assets/lib/layui/css/layui.css" />
        <link rel="stylesheet" href="/assets/css/article/art_list.css" />
    </head>
    <body>
        <!-- 卡片区域 -->
        <div class="layui-card">
            <div class="layui-card-header">文章列表</div>
            <div class="layui-card-body">
                <!-- 筛选区域 -->
                <!-- 列表区域 -->
                <!-- 分页区域 -->
            </div>
        </div>
    </body>
    <script src="/assets/lib/layui/layui.all.js"></script>
    <script src="/assets/lib/jquery.js"></script>
    <script src="/assets/js/baseAPI.js"></script>
    <script src="/assets/lib/template-web.js"></script>
    <script src="/assets/js/article/art_list.js"></script>
</html>

修改 css 样式

css 样式（ /assets/css/article/art_cate.css ）

html,
body {
    margin: 0;
    padding: 0;
}

body {
    padding: 15px;
    background-color: #f2f3f5;
}

新建 /assets/js/article/art_list.js 脚本文件

2、定义查询参数对象 q

查阅接口文档我们发现，需要提交的参数是比较多的，所以我们可以先来定义一下这个查询的参数对象，由于服务器文章的数量会很多，不能一次性请求回来，这种功能也是很常见的，分页查询

在这里插入图片描述

pagenum 告知服务器我们需要的是第几页数据
pagesize 每页能够显示的条目数
cate_id 你需要找哪一个分类下的文章，默认是所有文章
state 你需要查找的是什么状态的文章

js 代码（ /assets/js/article/art_list.js ）

// 定义一个查询的参数对象，将来请求数据的时候，
// 需要将请求参数对象提交到服务器
const q = {
    pagenum: 1, // 页码值，默认请求第一页的数据
    pagesize: 2, // 每页显示几条数据，默认每页显示2条
    cate_id: "", // 文章分类的 Id
    state: "", // 文章的发布状态
};

3、请求文章列表数据并使用模板引擎渲染列表结构

定义获取文章列表数据的方法 initTable()

js 代码（ /assets/js/article/art_list.js ）

$(function() {
    // 获取文章列表数据
    const initTable = () => {
        $.ajax({
            type: "GET",
            url: "/my/article/list",
            data: q,
            success: (res) => {
                if (res.status !== 0) {
                    return layer.msg("获取文章列表失败！");
                }
                // 使用模板引擎渲染页面的数据
                var htmlStr = template("tpl-table", res);
                $("tbody").html(htmlStr);
            },
        });
    };

    initTable();
})

在页面中添加表格结构

html 结构（ /article/art_list.html ）

<!-- 列表区域 -->
<table class="layui-table">
    <colgroup>
        <col />
        <col width="150" />
        <col width="180" />
        <col width="150" />
        <col width="150" />
    </colgroup>
    <thead>
        <tr>
            <th>文章标题</th>
            <th>分类</th>
            <th>发表时间</th>
            <th>状态</th>
            <th>操作</th>
        </tr>
    </thead>
    <tbody></tbody>
</table>

定义列表数据的模板结构

html 结构（ /article/art_list.html ）

<!-- 定义 template 模板 -->
<script type="text/html" id="tpl-table">
    {{each data}}
    <tr>
      <td>{{$value.title}}</td>
      <td>{{$value.cate_name}}</td>
      <td>{{$value.pub_date}}</td>
      <td>{{$value.state}}</td>
      <td>
        <button type="button" class="layui-btn layui-btn-xs">编辑</button>
        <button type="button" class="layui-btn layui-btn-danger layui-btn-xs">删除</button>
    </td>
    </tr>
    {{/each}}
</script>

4、定义美化时间格式的过滤器

通过 template.defaults.imports 定义过滤器

js 代码（ /assets/js/article/art_list.js ）

// 定义美化时间的过滤器
template.defaults.imports.dataFormat = function(date) {
    const dt = new Date(date)

    var y = dt.getFullYear()
    var m = padZero(dt.getMonth() + 1)
    var d = padZero(dt.getDate())

    var hh = padZero(dt.getHours())
    var mm = padZero(dt.getMinutes())
    var ss = padZero(dt.getSeconds())

    return y + '-' + m + '-' + d + ' ' + hh + ':' + mm + ':' + ss
}

// 定义补零的函数
function padZero(n) {
    return n > 9 ? n : '0' + n
}

在模板引擎中使用过滤器

html 结构（ /article/art_list.html ）

<td>{{$value.pub_date|dataFormat}}</td>

5、绘制筛选区域的`UI`结构

绘制 UI 结构

默认的两个select 和 button 都是独自占据一行的
我们可以给三个模块设置 layui-inline
分类的数据是动态进行获取的，第一个下拉框我们先不设置内容
第二个下拉选择框里面内容是死的，我们可以定义三个 option 添加对应的内容即可

html 结构（ /article/art_list.html ）

<!-- 筛选区域 -->
<form class="layui-form" id="form-search">
    <div class="layui-form-item layui-inline">
        <select name="cate_id"></select>
    </div>
    <div class="layui-form-item layui-inline">
        <select name="state">
            <option value="">所有状态</option>
            <option value="已发布">已发布</option>
            <option value="草稿">草稿</option>
        </select>
    </div>
    <div class="layui-form-item layui-inline">
        <button class="layui-btn" lay-submit lay-filter="formDemo">筛选</button>
    </div>
</form>

6、发起请求获取并渲染文章分类的下拉选择框

定义 initCate 函数请求文章分类的列表数据

利用$.ajax() 发送get请求
判断服务器返回的 status 是否等于0，如果不等于，提示用户
如果等于，通过template得到渲染完毕后的html结构
利用属性选择器渲染到第一个select里面

js 代码（ /assets/js/article/art_list.js ）

const form = layui.form;

// 初始化文章分类的方法
const initCate = () => {
    $.ajax({
        method: "GET",
        url: "/my/article/cates",
        success: function (res) {
            console.log(res);
            if (res.status !== 0) {
                return layer.msg("获取分类数据失败！");
            }
            // 调用模板引擎渲染分类的可选项
            var htmlStr = template("tpl-cate", res);
            $("[name=cate_id]").html(htmlStr);
            // 通过 layui 重新渲染表单区域的UI结构
            form.render();
        },
    });
};

initCate();

定义分类可选项的模板结构

html 结构（ /article/art_list.html ）

<script type="text/html" id="tpl-cate">
  <option value="">所有分类</option>
  {{each data}}
  <option value="{{$value.Id}}">{{$value.name}}</option>
  {{/each}}
</script>

7、实现筛选的功能

需要先绑定表单的 submit 事件
在事件里面获取到表单中选中的值
然后把这个值同步到我们参数对象 q 里面
再次调用 initTable() 方法即可

js 代码（ /assets/js/article/art_list.js ）

$('#form-search').on('submit', function(e) {
    e.preventDefault()
    // 获取表单中选中项的值
    var cate_id = $('[name=cate_id]').val()
    var state = $('[name=state]').val()
    // 为查询参数对象 q 中对应的属性赋值
    q.cate_id = cate_id
    q.state = state
    // 根据最新的筛选条件，重新渲染表格的数据
    initTable()
})

四、分页功能

在这里插入图片描述

1、定义渲染分页的 `renderPage` 方法

定义渲染分页的方法，接收一个总数量的参数

js 代码（ /assets/js/article/art_list.js ）

// 定义渲染分页方法
function renderPage(total) {
  console.log(total);
}

在渲染表格完后调用这个方法

js 代码（ /assets/js/article/art_list.js ）

function initTable() {
    $.ajax({
        method: 'GET',
        url: '/my/article/list',
        data: q,
        success: function(res) {
            if (res.status !== 0) {
                return layer.msg('获取文章列表失败！')
            }
            // 使用模板引擎渲染页面的数据
            var htmlStr = template('tpl-table', res)
            $('tbody').html(htmlStr)
            // 调用渲染分页的方法
            renderPage(res.total)
        }
    })
}

2、调用 `laypage.render` 方法渲染分页的基本结构

借助layui提供的分页的方式

在这里插入图片描述

在页面中定义分页的区域

html 结构（ /article/art_list.html ）

<!-- 分页区域 -->
<div id="pageBox"></div>

调用 laypage.render() 方法来渲染分页的结构

elem 分页容器的 id
count 总数据条数
limit 每页显示几条数据
curr 设置默认被选中的分页

js 代码（ /assets/js/article/art_list.js ）

// 定义渲染分页的方法
function renderPage(total) {
    // 调用 laypage.render() 方法来渲染分页的结构
    laypage.render({
        elem: 'pageBox', // 分页容器的 Id
        count: total, // 总数据条数
        limit: q.pagesize, // 每页显示几条数据
        curr: q.pagenum // 设置默认被选中的分页
    })
}

3、在`jump`回调函数中通过`obj.curr`获取到最新的页码值

分页发生切换的时候，触发 jump 回调
把最新的页码值赋值给请求参数 q

js 代码（ /assets/js/article/art_list.js ）

// 定义渲染分页的方法
function renderPage(total) {
    // 调用 laypage.render() 方法来渲染分页的结构
    laypage.render({
        elem: 'pageBox', // 分页容器的 Id
        count: total, // 总数据条数
        limit: q.pagesize, // 每页显示几条数据
        curr: q.pagenum, // 设置默认被选中的分页
        // 分页发生切换的时候，触发 jump 回调
        jump: function(obj) {
            console.log(obj.curr)
            // 把最新的页码值，赋值到 q 这个查询参数对象中
            q.pagenum = obj.curr
        }
    })
}

4、解决 `jump` 回调函数发生死循环的问题

目前有个问题，默认这个 jump 是一个循环不断在触发，所以我们还不能直接进行网络请求
触发jump的原因
- 点击页码的时候会触发 jump 的回调
- 只要调用了 laypage.render() 方法就会触发jump回调
  - 我们在定义分页结构的时候，我们调用了 laypage.render() 方法，一旦调用，我们触发了 jump回调
  - 我们在 jump回调里面又调用了 initTable() 方法
  - initTable() 里面请求成功之后，又调用了 laypage.render() 方法，所以发生了死循环
判断 jump 回调的触发方式就可以解决了
jump 的第二个参数就能帮我们判断出来，如果第二个参数为true，就代表是利用 laypage.render() 方法触发的

js 代码（ /assets/js/article/art_list.js ）

// 定义渲染分页的方法
function renderPage(total) {
    // 调用 laypage.render() 方法来渲染分页的结构
    laypage.render({
        elem: 'pageBox', // 分页容器的 Id
        count: total, // 总数据条数
        limit: q.pagesize, // 每页显示几条数据
        curr: q.pagenum, // 设置默认被选中的分页
        // 分页发生切换的时候，触发 jump 回调
        // 触发 jump 回调的方式有两种：
        // 1. 点击页码的时候，会触发 jump 回调
        // 2. 只要调用了 laypage.render() 方法，就会触发 jump 回调
        jump: function(obj, first) {
            // 可以通过 first 的值，来判断是通过哪种方式，触发的 jump 回调
            // 如果 first 的值为 true，证明是方式2触发的
            // 否则就是方式1触发的
            console.log(first)
            console.log(obj.curr)
            // 把最新的页码值，赋值到 q 这个查询参数对象中
            q.pagenum = obj.curr
            // 根据最新的 q 获取对应的数据列表，并渲染表格
            // initTable()
            if (!first) {
                initTable()
            }
        }
    })
}

5、自定义分页的功能项

查阅了 layui内置模块分页区域的文档后，我们发现可以通过一个参数来配置layout

在这里插入图片描述

里面传递的是一个数组，分页的顺序是通过我们配置数组的顺序来显示的
通过limits参数可以来设置每页来显示多少条

js 代码（ /assets/js/article/art_list.js ）

// 定义渲染分页的方法
function renderPage(total) {
    // 调用 laypage.render() 方法来渲染分页的结构
    laypage.render({
        elem: 'pageBox', // 分页容器的 Id
        count: total, // 总数据条数
        limit: q.pagesize, // 每页显示几条数据
        curr: q.pagenum, // 设置默认被选中的分页
        layout: ['count', 'limit', 'prev', 'page', 'next', 'skip'],
        limits: [2, 3, 5, 10],// 每页展示多少条
        ...
    })
  }

6、实现切换每页展示多少条数据的功能

通过 jump 回调来实现，当我们切换了每页显示条目数后，会触发这个回调
通过 obj.limit 就能获取用户选择的是第几条
拿到最新条目数后，我们设置给请求对象q里面
然后重新调用 initTable() 来获取最新数据

js 代码（ /assets/js/article/art_list.js ）

// 定义渲染分页的方法
function renderPage(total) {
    // 调用 laypage.render() 方法来渲染分页的结构
    laypage.render({
        elem: 'pageBox', // 分页容器的 Id
        count: total, // 总数据条数
        limit: q.pagesize, // 每页显示几条数据
        curr: q.pagenum, // 设置默认被选中的分页
        layout: ['count', 'limit', 'prev', 'page', 'next', 'skip'],
        limits: [2, 3, 5, 10],
        // 分页发生切换的时候，触发 jump 回调
        // 触发 jump 回调的方式有两种：
        // 1. 点击页码的时候，会触发 jump 回调
        // 2. 只要调用了 laypage.render() 方法，就会触发 jump 回调
        jump: function(obj, first) {
            // 可以通过 first 的值，来判断是通过哪种方式，触发的 jump 回调
            // 把最新的页码值，赋值到 q 这个查询参数对象中
            q.pagenum = obj.curr
            // 把最新的条目数，赋值到 q 这个查询参数对象的 pagesize 属性中
            q.pagesize = obj.limit
            // 根据最新的 q 获取对应的数据列表，并渲染表格
            if (!first) {
                initTable()
            }
        }
    })
}

五、删除文章

在这里插入图片描述

1、实现删除文章的功能

为删除按钮绑定 btn-delete 类名和 data-id 自定义属性

html 结构（ /article/art_list.html ）

<button type="button" class="layui-btn layui-btn-danger layui-btn-xs btn-delete" data-id="{{$value.Id}}">删除</button>

通过代理的形式，为删除按钮绑定点击事件处理函数

弹出确认取消框提示用户
用户点击确认，发送请求，删除当前文章，携带文章id
请求成功之后，获取最新的文章列表信息
关闭当前弹出层

js 代码（ /assets/js/article/art_list.js ）

$('tbody').on('click', '.btn-delete', function() {
    // 获取到文章的 id
    var id = $(this).attr('data-id')
    // 询问用户是否要删除数据
    layer.confirm('确认删除?', { icon: 3, title: '提示' }, function(index) {
        $.ajax({
            method: 'GET',
            url: '/my/article/delete/' + id,
            success: function(res) {
                if (res.status !== 0) {
                    return layer.msg('删除文章失败！')
                }
                layer.msg('删除文章成功！')
                initTable()
            }
        })

        layer.close(index)
    })
})

2、解决删除文章时的小 Bug

问题：删除后，页码值虽然正常，但是当前页码的数据没有渲染出来

解决：

判断删除后，页面上是否还有数据
- 判断当前页面的删除按钮的长度是否等于1
- 如果等于1，那么我们让当前页码-1即可，如果不等于1，不用处理

js 代码（ /assets/js/article/art_list.js ）

$('tbody').on('click', '.btn-delete', function() {
    // 获取删除按钮的个数
    var len = $('.btn-delete').length
    // 获取到文章的 id
    var id = $(this).attr('data-id')
    // 询问用户是否要删除数据
    layer.confirm('确认删除?', { icon: 3, title: '提示' }, function(index) {
        $.ajax({
            method: 'GET',
            url: '/my/article/delete/' + id,
            success: function(res) {
                if (res.status !== 0) {
                    return layer.msg('删除文章失败！')
                }
                layer.msg('删除文章成功！')
                // 当数据删除完成后，需要判断当前这一页中，是否还有剩余的数据
                // 如果没有剩余的数据了,则让页码值 -1 之后,
                // 再重新调用 initTable 方法
                // 4
                if (len === 1) {
                    // 如果 len 的值等于1，证明删除完毕之后，页面上就没有任何数据了
                    // 页码值最小必须是 1
                    q.pagenum = q.pagenum === 1 ? 1 : q.pagenum - 1
                }
                initTable()
            }
        })

        layer.close(index)
    })
})

六、发布文章

在这里插入图片描述

1、创建文章发布页面的基本结构

新建 /article/art_pub.html 页面结构

利用卡片区域进行结构布局

html 结构（ /article/art_pub.html ）

<!DOCTYPE html>
<html lang="en">
    <head>
        <meta charset="UTF-8" />
        <meta http-equiv="X-UA-Compatible" content="IE=edge" />
        <meta name="viewport" content="width=device-width, initial-scale=1.0" />
        <title>Document</title>
        <link rel="stylesheet" href="/assets/lib/layui/css/layui.css" />
        <link rel="stylesheet" href="/assets/css/article/art_pub.css" />
    </head>
    <body>
        <!-- 卡片区域 -->
        <div class="layui-card">
            <div class="layui-card-header">写文章</div>
            <div class="layui-card-body">
                卡片式面板面板通常用于非白色背景色的主体内<br />
                从而映衬出边框投影
            </div>
        </div>
    </body>
    <script src="/assets/lib/layui/layui.all.js"></script>
    <script src="/assets/lib/jquery.js"></script>
    <script src="/assets/js/baseAPI.js"></script>
    <script src="/assets/js/article/art_pub.js"></script>
</html>

新建 /assets/css/article/art_pub.css 样式文件

css 样式（ /assets/css/article/art_pub.css ）

html,
body {
    margin: 0;
    padding: 0;
}

body {
    padding: 15px;
    background-color: #f2f3f5;
}

新建 /assets/js/article/art_pub.js 脚本文件

2、新建基本的表单结构

自上而下文章标题 → 文章类别 → 文章内容 → 文章封面 → 表单操作按钮

html 结构（ /article/art_pub.html ）

<!-- 发布文章的表单 -->
<form class="layui-form">
    <!-- 第一行 -->
    <div class="layui-form-item">
        <label class="layui-form-label">文章标题</label>
        <div class="layui-input-block">
            <input
                   type="text"
                   name="title"
                   required
                   lay-verify="required"
                   placeholder="请输入标题"
                   autocomplete="off"
                   class="layui-input"
                   />
        </div>
    </div>
</form>

3、渲染文章类别对应的下拉选择框结构

第二行右侧内容应该是下拉选择框 select，必填项，里面的内容是动态进行获取的

html 结构（ /article/art_pub.html ）

<!-- 第二行 -->
<div class="layui-form-item">
    <label class="layui-form-label">文章类别</label>
    <div class="layui-input-block">
        <select name="cate_id" lay-verify="required"></select>
    </div>
</div>

导入 art-template

html 结构（ /article/art_pub.html ）

<script src="/assets/lib/template-web.js"></script>

定义模板结构，多个条目，利用列表渲染

html 结构（ /article/art_pub.html ）

<script type="text/html" id="tpl-cate">
  <option value="">请选择文章类别</option>
  {{each data}}
  <option value="{{$value.Id}}">{{$value.name}}</option>
  {{/each}}
</script>

定义 initCate 方法，请求文章类别的列表，利用模板引擎渲染到页面

js 代码（ /assets/js/article/art_pub.js ）

$(function() {
    const form = layui.form;
    const layer = layui.layer;

    // 获取文章分类
    const initCate = () => {
        $.ajax({
            type: "GET",
            url: "/my/article/cates",
            success: function (res) {
                if (res.status !== 0) {
                    return layer.msg("初始化文章分类失败！");
                }
                // 调用模板引擎，渲染分类的下拉菜单
                var htmlStr = template("tpl-cate", res);
                $("[name=cate_id]").html(htmlStr);
                // 一定要记得调用 form.render() 方法 否则看不到页面的变化
                form.render();
            },
        });
    };

    initCate();
})

4、渲染富文本编辑器

添加如下的 layui 表单行

html 结构（ /article/art_pub.html ）

<div class="layui-form-item">
    <!-- 左侧的 label -->
    <label class="layui-form-label">文章内容</label>
    <!-- 为富文本编辑器外部的容器设置高度 -->
    <div class="layui-input-block" style="height: 400px;">
        <!-- 重要：将来这个 textarea 会被初始化为富文本编辑器 -->
        <textarea name="content"></textarea>
    </div>
</div>

导入富文本必须的 script 脚本

html 结构（ /article/art_pub.html ）

<!-- 富文本 -->
<script src="/assets/lib/tinymce/tinymce.min.js"></script>
<script src="/assets/lib/tinymce/tinymce_setup.js"></script>

调用 initEditor() 方法，初始化富文本编辑器

js 代码（ /assets/js/article/art_pub.js ）

// 初始化富文本编辑器
initEditor()

5、渲染封面裁剪区域

在 <head> 中导入 cropper.css 样式表

html 结构（ /article/art_pub.html ）

<link rel="stylesheet" href="/assets/lib/cropper/cropper.css" />

在 <body> 的结束标签之前，按顺序导入如下的 js 脚本

html 结构（ /article/art_pub.html ）

<script src="/assets/lib/jquery.js"></script>
<script src="/assets/lib/cropper/Cropper.js"></script>
<script src="/assets/lib/cropper/jquery-cropper.js"></script>

在表单中，添加如下的表单行结构

html 结构（ /article/art_pub.html ）

<div class="layui-form-item">
    <!-- 左侧的 label -->
    <label class="layui-form-label">文章封面</label>
    <!-- 选择封面区域 -->
    <div class="layui-input-block cover-box">
        <!-- 左侧裁剪区域 -->
        <div class="cover-left">
            <img id="image" src="/assets/images/sample2.jpg" alt="" />
        </div>
        <!-- 右侧预览区域和选择封面区域 -->
        <div class="cover-right">
            <!-- 预览的区域 -->
            <div class="img-preview"></div>
            <!-- 选择封面按钮 -->
            <button type="button" class="layui-btn layui-btn-danger">选择封面</button>
        </div>
    </div>
</div>

美化的样式

css 样式（ /assets/css/article/art_pub.css ）

/* 封面容器的样式 */
.cover-box {
    display: flex;
}

/* 左侧裁剪区域的样式 */
.cover-left {
    width: 400px;
    height: 280px;
    overflow: hidden;
    margin-right: 20px;
}

/* 右侧盒子的样式 */
.cover-right {
    display: flex;
    flex-direction: column;
    align-items: center;
}

/* 预览区域的样式 */
.img-preview {
    width: 200px;
    height: 140px;
    background-color: #ccc;
    margin-bottom: 20px;
    overflow: hidden;
}

实现基本裁剪效果

js 代码（ /assets/js/article/art_pub.js ）

// 1. 初始化图片裁剪器
var $image = $('#image')

// 2. 裁剪选项
var options = {
    aspectRatio: 400 / 280,
    preview: '.img-preview'
}

// 3. 初始化裁剪区域
$image.cropper(options)

6、渲染提交按钮区域

html 结构（ /article/art_pub.html ）

<!-- 第五行 -->
<div class="layui-form-item">
    <div class="layui-input-block">
        <button class="layui-btn" lay-submit>发布</button>
        <button class="layui-btn layui-btn-primary" lay-submit>存为草稿</button>
    </div>
</div>

7、点击选择封面按钮打开文件选择框

修改 UI 结构，为 选择封面 按钮添加 id，并且在按钮后面添加 文件选择框

html 结构（ /article/art_pub.html ）

<!-- 选择封面按钮 -->
<button type="button" class="layui-btn layui-btn-danger" id="btnChooseImage">选择封面</button>
<!-- 隐藏的文件选择框 -->
<input type="file" id="coverFile" style="display: none;" accept="image/png,image/jpeg,image/gif" />

为选择封面的按钮，绑定点击事件处理函数

js 代码（ /assets/js/article/art_pub.js ）

$('#btnChooseImage').on('click', function() {
    $('#coverFile').click()
})

8、将选择的图片设置到裁剪区域中

监听 coverFile 的 change 事件，获取用户选择的文件列表
跟进文件，创建对应的 URL 地址
为裁剪区域重新设置图片
- 销毁旧的裁剪区域
- 重新设置图片路径
- 重新初始化裁剪区域

js 代码（ /assets/js/article/art_pub.js ）

// 监听 coverFile 的 change 事件，获取用户选择的文件列表
$('#coverFile').on('change', function(e) {
    // 获取到文件的列表数组
    var files = e.target.files
    // 判断用户是否选择了文件
    if (files.length === 0) {
        return
    }
    // 根据文件，创建对应的 URL 地址
    var newImgURL = URL.createObjectURL(files[0])
    // 为裁剪区域重新设置图片
    $image
        .cropper('destroy') // 销毁旧的裁剪区域
        .attr('src', newImgURL) // 重新设置图片路径
        .cropper(options) // 重新初始化裁剪区域
})

9、分析发布文章的实现步骤

为存为草稿按钮添加 id 属性

html 结构（ /article/art_pub.html ）

<button class="layui-btn layui-btn-primary" lay-submit id="btnSave2">
  存为草稿
</button>

定义文章的发布状态

js 代码（ /assets/js/article/art_pub.js ）

let art_state = '已发布'

为存为草稿按钮，绑定点击事件处理函数

js 代码（ /assets/js/article/art_pub.js ）

$('#btnSave2').on('click', function() {
    art_state = '草稿'
})

10、基于`Form`表单创建`FormData`对象

为发布文章的 Form 表单添加 id 属性

html 结构（ /article/art_pub.html ）

<form class="layui-form" id="form-pub"></form>

为表单绑定 submit 提交事件

阻止表单默认提交行为
基于 form 表单，快速创建一个 FormData 对象
将文章的发布状态，存到 FormData 对象中

js 代码（ /assets/js/article/art_pub.js ）

$('#form-pub').on('submit', function(e) {
    // 1. 阻止表单的默认提交行为
    e.preventDefault()
    // 2. 基于 form 表单，快速创建一个 FormData 对象
    var fd = new FormData($(this)[0]);
    // 3. 将文章的发布状态，存到 fd 中
    fd.append('state', art_state)
})

11、将裁剪后的封面追加到`FormData`对象中

将裁剪后的图片输出成一个文件
把文件追加到 formData 中即可

js 代码（ /assets/js/article/art_pub.js ）

// 为表单绑定 submit 提交事件
$('#form-pub').on('submit', function(e) {
    ...
    // 4. 将封面裁剪过后的图片，输出为一个文件对象
    $image
        .cropper('getCroppedCanvas', {
        // 创建一个 Canvas 画布
        width: 400,
        height: 280
    })
        .toBlob(function(blob) {
        // 将 Canvas 画布上的内容，转化为文件对象
        // 得到文件对象后，进行后续的操作
        // 5. 将文件对象，存储到 fd 中
        fd.append('cover_img', blob)
        // 6. 发起 ajax 数据请求
    })
})

12、发起`Ajax`请求实现发布文章的功能

定义一个发布文章的方法
注意：如果是提交的是FormData格式数据，需要添加 contentType：false ，processData：false

js 代码（ /assets/js/article/art_pub.js ）

function publishArticle(fd) {
    $.ajax({
        method: 'POST',
        url: '/my/article/add',
        data: fd,
        // 注意：如果向服务器提交的是 FormData 格式的数据，
        // 必须添加以下两个配置项
        contentType: false,
        processData: false,
        success: function(res) {
            if (res.status !== 0) {
                return layer.msg('发布文章失败！')
            }
            layer.msg('发布文章成功！')
            // 发布文章成功后，跳转到文章列表页面
            location.href = '/article/art_list.html'
        }
    })
}

把裁剪的图片追加到 FormData 对象中之后，调用 publishArticle 方法

js 代码（ /assets/js/article/art_pub.js ）

// 为表单绑定 submit 提交事件
$('#form-pub').on('submit', function(e) {
    // 1. 阻止表单的默认提交行为
    e.preventDefault()
    // 2. 基于 form 表单，快速创建一个 FormData 对象
    var fd = new FormData($(this)[0])
    // 3. 将文章的发布状态，存到 fd 中
    fd.append('state', art_state)
    // 4. 将封面裁剪过后的图片，输出为一个文件对象
    $image
        .cropper('getCroppedCanvas', {
        // 创建一个 Canvas 画布
        width: 400,
        height: 280
    })
        .toBlob(function(blob) {
        // 将 Canvas 画布上的内容，转化为文件对象
        // 得到文件对象后，进行后续的操作
        // 5. 将文件对象，存储到 fd 中
        fd.append('cover_img', blob)
        // 6. 发起 ajax 数据请求
        publishArticle(fd)
    })
})

13、将开发完成的项目代码推送到`GitHub`

运行 git add . 命令
运行 git commit -m "完成文章管理相关功能的开发" 命令
运行 git push -u origin article 命令
运行 git checkout master 命令
运行 git merge article 命令
运行 git push 命令

itpeilibo

关注

0
点赞
踩
3

收藏

觉得还不错? 一键收藏
打赏
0
评论
大事件项目第三天

一、文章类别编辑二、删除文章分类三、文章列表功能四、分页功能五、删除文章六、发布文章为编辑按钮添加类名如下html 结构（ /article/art_cate.html ）定义修改分类的弹出层html 结构（ /article/art_cate.html ）修改 form 表单样式css 样式（ /assets/css/article/art_cate.css ）通过事件委派的形式，为按钮绑定点击事件js 代码（ /assets/js/article/art_cate.js
复制链接

扫一扫