分析
通过接口文档提供的接口信息,以及利用bootstrap.css库,jQuery.js库,实现页面的样式,通过js将从接口获取到的数据渲染到页面中
代码及接口文档
引入bootstrap,以及jQuery才能正常运行
其中bootstrap部分使用了:
1.bs3-panel:primary作为表单区域的样式,后续添加div,input class="form-control"以及button class"btn btn-peimary"
2.bs3-list-group:badges作为用来渲染加载评论列表的样式,将li中的span复制一份作为右边浮动的元素
接口文档
### 请求的根路径
> http://www.liulongbin.top:3006
### 评论列表
+ 接口URL: /api/cmtlist
+ 调用方式: GET
+ 参数格式:无
+ 响应格式:
| 数据名称 | 数据类型 | 说明 |
| --------- | -------- | ------------------------ |
| status | Number | 200 成功;500 失败; |
| msg | String | 对 status 字段的详细说明 |
| data | Array | 评论列表 |
| +id | Number | 评论Id |
| +username | String | 评论人姓名 |
| +content | String | 评论内容 |
| +time | String | 评论时间 |
+ 返回示例:
```json
{
"status": 200,
"msg": "获取评论列表成功",
"data": [
{
"id": 2,
"username": "李四",
"content": "宝塔镇河妖",
"time": "2019-10-25 16:18:52"
},
{
"id": 1,
"username": "张三",
"content": "天王盖地虎",
"time": "2019-10-25 16:12:57"
}
]
}
```
### 发表评论
+ 接口URL: /api/addcmt
+ 调用方式: POST
+ 参数格式:
| 参数名称 | 参数类型 | 是否必选 | 参数说明 |
| -------- | -------- | -------- | ---------- |
| username | String | 是 | 评论人名称 |
| content | String | 是 | 评论内容 |
+ 响应格式:
| 数据名称 | 数据类型 | 说明 |
| -------- | -------- | ------------------------------------------------------------ |
| status | Number | 201 发表评论成功;500 请填写完整的评论信息; 501 执行Sql失败; |
| msg | String | 对 status 字段的详细说明 |
+ 返回示例:
```json
{
"status": 201,
"msg": "发表评论成功"
}
```
### 新闻列表
+ 接口URL: /api/news
+ 调用方式: GET
+ 参数格式:无
+ 响应格式:
| 数据名称 | 数据类型 | 说明 |
| --------- | -------- | -------------------------------------------- |
| status | Number | 200 获取新闻列表成功;500 获取新闻列表失败! |
| msg | String | 对 status 字段的详细说明 |
| data | Array | 新闻列表数组 |
| +id | Number | 新闻Id |
| +title | String | 新闻标题 |
| +source | String | 新闻来源 |
| +cmtcount | Number | 评论数量 |
| +tags | String | 标签 |
| +img | String | 图片地址 |
| +time | String | 发表时间 |
+ 返回示例:
```json
{
"status": 200,
"msg": "获取新闻列表成功",
"data": [
{
"id": 1,
"title": "5G商用在即,三大运营商营收持续下降",
"source": "新京报经济新闻",
"cmtcount": 58,
"tags": "三大运营商,中国移动,5G商用",
"img": "/images/0.webp",
"time": "2019-10-28T03:50:28.000Z"
}
]
}
```
index.html
<!DOCTYPE html>
<html lang="zh-CN">
<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="../../../js/bootstrap/css/bootstrap.css" />
<script src="../../../js/jQuery.js"></script>
<script src="./js/index.js"></script>
</head>
<body style="padding: 15px;">
<!--评论面板-->
<div class="panel panel-primary">
<div class="panel-heading">
<h3 class="panel-title">发表评论</h3>
</div>
<form class="panel-body" id="formAddCmt">
<div>评论人:</div>
<input type="text" class="form-control" name="username" autocomplete="off" />
<div>评论内容</div>
<textarea class="form-control" style="resize: none;" name="content"></textarea>
<button type="submit" class="btn btn-primary">发表评论</button>
</form>
</div>
<!--评论列表-->
<ul class="list-group" id="cmt-list">
<li class="list-group-item">
<span class="badge" style="background-color: #F0AD4E;">评论时间: </span>
<span class="badge" style="background-color: #5BC0DE;">评论人: </span> Item 1
</li>
</ul>
</body>
</html>
index.js
$(function() {
//定义获取接口评论列表方法 通过ajax的get方法获取评论列表
function getCommentList() {
$.ajax({
method: 'GET',
url: 'http://www.liulongbin.top:3006/api/cmtlist',
data: {}, //因为本次GET请求不需要传输data信息 所以可以为空或者删除data参数
success: function(res) { //请求后的回调函数
if (res.status !== 200) return alert('获取评论列表失败');
//定义一个空数组来存放获取的评论数据
var rows = [];
//遍历获取的评论数据 并渲染加载评论列表到页面中
$.each(res.data, function(i, item) {
//每循环一次 创建一个字符串 结构
var str = '<li class="list-group-item"><span class="badge" style="background-color: #F0AD4E;">评论时间: ' + item.time + '</span><span class="badge" style="background-color: #5BC0DE;">评论人: ' + item.username + '</span> ' + item.content + '</li>'
rows.push(str);
})
//直接插入的rows为数组类型 使用join()方法将其变为字符串类型
$('#cmt-list').empty().append(rows.join(''));
}
})
}
//阻止提交表单默认行为并且获取formAddCmt表单的数据
$('#formAddCmt').on('submit', function(e) {
//阻止提交表单默认行为
e.preventDefault();
//获取formAddCmt表单中的数据
var data = $(this).serialize();
// console.log(data);
// 通过ajax的post方法提交表单数据 实现发表评论
$.post('http://www.liulongbin.top:3006/api/addcmt', data, function(res) {
if (res.status !== 201) {
alert('发表评论失败');
}
console.log(data);
//再次调用获取评论列表方法 发布评论后重新渲染列表
getCommentList();
//先将jQuery对象$('#formAddCmt')转换为DOM对象 再利用reset()方法在发表评论后重置表单
$('#formAddCmt')[0].reset();
})
})
getCommentList();
})