1. 模板引擎
在传统的网站当中,客户端向服务器端发送请求,服务器端都是将数据和 html 拼接好,再将拼接好的html 字符串发送给客户端。
但是,现在我们使用ajax技术向服务器端发送请求,服务器端在大多数情况下都会采用 json格式的数据作为响应内容。
也就是说,原本数据和html的拼接是在服务器端完成的,但是,现在这项工作需要在客户端完成。
在客户端进行数据拼接时,我们也需要使用模板引擎。
接下来开始讲解 客户端模板引擎
1.1 模板引擎概述
无论是客户端模板引擎还是服务器端模板引擎,其作用就是:**使用模板引擎提供的模板语法,将数据和HTML拼接起来。
在Node 课程阶段,讲解的是 art-template 模板引擎(服务器端)。而且,art-template 模板引擎 也有对应的客户端版本。
因此,在客户端,我们不用学习一款新的模板引擎,直接使用art-template 即可。使用方式上仅有微小的变化。
官方地址:
https://aui.github.io/art-template/zh-cn/index.html
1.2 使用步骤
- 下载art-template 模板引擎文件并在HTML页面中引入库文件
- 准备art-template模板
客户端JavaScript不具备读取文件的能力,所以在客户端模板不是一个单独的文件(之前学习node时,模板存放在views/common/layout.art),而是html文件当中的代码片段,并且用script标签包裹,并且给客户端模板取一个id值
。
- 告诉模板引擎将哪一个模板和哪个数据进行拼接
- 将拼接好的html字符串添加到页面中
5. 通过模板语法告诉模板引擎,数据和html字符串要如何进行拼接
2. 代码演示
2.1示例一:验证邮箱地址唯一性
// 验证邮箱地址的正则表达式
var reg = /^[A-Za-z\d]+([-_.][A-Za-z\d]+)*@([A-Za-z\d]+[-.])+[A-Za-z\d]{2,4}$/
具体代码如下:
js/ajax.js
完整代码如下:
function ajax (options) {
// 默认值
var defaults = {
type: 'get',
url: '',
async: true,
data: {},
header: {
'Content-Type': 'application/x-www-form-urlencoded'
},
success: function () {},
error: function () {}
}
// 使用用户传递的参数替换默认值参数
Object.assign(defaults, options);
// 创建ajax对象
var xhr = new XMLHttpRequest();
// 参数拼接变量
var params = '';
// 循环参数
for (var attr in defaults.data) {
// 参数拼接
params += attr + '=' + defaults.data[attr] + '&';
// 去掉参数中最后一个&
params = params.substr(0, params.length-1)
}
// 如果请求方式为get
if (defaults.type == 'get') {
// 将参数拼接在url地址的后面
defaults.url += '?' + params;
}
// 配置ajax请求
xhr.open(defaults.type, defaults.url, defaults.async);
// 如果请求方式为post
if (defaults.type == 'post') {
// 设置请求头
xhr.setRequestHeader('Content-Type', defaults.header['Content-Type']);
// 如果想服务器端传递的参数类型为json
if (defaults.header['Content-Type'] == 'application/json') {
// 将json对象转换为json字符串
xhr.send(JSON.stringify(defaults.data))
}else {
// 发送请求
xhr.send(params);
}
} else {
xhr.send();
}
// 请求加载完成
xhr.onload = function () {
// 获取服务器端返回数据的类型
var contentType = xhr.getResponseHeader('content-type');
// 获取服务器端返回的响应数据
var responseText = xhr.responseText;
// 如果服务器端返回的数据是json数据类型
if (contentType.includes('application/json')) {
// 将json字符串转换为json对象
responseText = JSON.parse(responseText);
}
// 如果请求成功
if (xhr.status == 200) {
// 调用成功回调函数, 并且将服务器端返回的结果传递给成功回调函数
defaults.success(responseText, xhr);
} else {
// 调用失败回调函数并且将xhr对象传递给回调函数
defaults.error(responseText, xhr);
}
}
// 当网络中断时
xhr.onerror = function () {
// 调用失败回调函数并且将xhr对象传递给回调函数
defaults.error(xhr);
}
}
02-验证邮箱地址唯一性.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/bootstrap/dist/css/bootstrap.min.css">
<style type="text/css">
p:not(:empty) {
padding: 15px;
}
.container {
padding-top: 100px;
}
</style>
</head>
<body>
<div class="container">
<div class="form-group">
<label>邮箱地址</label>
<input type="email" class="form-control" placeholder="请输入邮箱地址" id="email">
</div>
<!-- 错误 bg-danger 正确 bg-success -->
<p id="info"></p>
</div>
<script src="/js/ajax.js"></script>
<script>
// 获取页面中的元素
var emailInp = document.getElementById('email')
var info = document.getElementById('info')
// 给emailInp添加离开焦点事件
emailInp.onblur = function() {
// 获取用户输入的邮箱地址
var email = this.value
// 验证邮箱地址的正则表达式
var reg = /^[A-Za-z\d]+([-_.][A-Za-z\d]+)*@([A-Za-z\d]+[-.])+[A-Za-z\d]{2,4}$/
// 如果用户输入的邮箱地址不符合规则
if (!reg.test(email)) {
// 阻止程序向下执行
info.innerHTML = '请输入符合规则的邮箱地址'
info.className = 'bg-danger'
return;
}
// 向服务器端发送请求
ajax({
type: 'get',
url: 'http://localhost:3000/verifyEmailAdress',
data: {
email: email
},
success: function(result) {
console.log(result)
info.innerHTML = result.message;
info.className = 'bg-success';
},
error: function(result) {
console.log(result)
info.innerHTML = result.message;
info.className = 'bg-danger';
}
})
}
</script>
</body>
</html>
app.js
中的对应代码:
// 邮箱地址验证
app.get('/verifyEmailAdress', (req, res) => {
// 接收客户端传递过来的邮箱地址
const email = req.query.email;
// 判断邮箱地址注册过的情况
if (email == 'itheima@itcast.cn') {
// 设置http状态码并对客户端做出响应
res.status(400).send({ message: '邮箱地址已经注册过了, 请更换其他邮箱地址' });
} else {
// 邮箱地址可用的情况
// 对客户端做出响应
res.send({ message: '恭喜, 邮箱地址可用' });
}
});
2.2 示例二:搜索框内容自动提示
具体代码如下:
03-搜索框内容自动提示.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/bootstrap/dist/css/bootstrap.min.css">
<style type="text/css">
.container {
padding-top: 150px;
}
.list-group {
display: none;
}
</style>
</head>
<body>
<div class="container">
<div class="form-group">
<input type="text" class="form-control" placeholder="请输入搜索关键字" id="search">
<ul class="list-group" id="list-box">
</ul>
</div>
</div>
<script src="/js/ajax.js"></script>
<script src="/js/template-web.js"></script>
<script type="text/html" id="tpl">
{{each result}}
<li class="list-group-item">{{$value}}</li>
{{/each}}
</script>
<script>
// 获取搜索框
var searchInp = document.getElementById('search')
// 获取提示文字的存放容器
var listBox = document.getElementById('list-box')
// 存储定时器的变量
var timer = null
// 当用户在文本框中输入的时候触发
searchInp.oninput = function() {
// 清除上一次开启的定时器
clearTimeout(timer)
// 获取用户输入的内容
var key = this.value
if (key.trim().length == 0) {
// 如果用户没有在搜索框中输入内容
// 将提示下拉框隐藏掉
listBox.style.display = 'none'
// 组织程序向下执行
return;
}
// 开启定时器,让请求延时发送
timer = setTimeout(function() {
// 向服务器端发送请求
// 向服务器端索取和用户输入关键字相关的内容
ajax({
type: 'get',
url: 'http://localhost:3000/searchAutoPrompt',
data: {
key: key
},
success: function(result) {
// 使用模板引擎拼接字符串
var html = template('tpl', {
result: result
})
// 将拼接好的字符串显示在页面中
listBox.innerHTML = html
// 显示ul容器
listBox.style.display = 'block'
}
})
}, 800)
}
</script>
</body>
</html>
app.js 中对应的代码:
// 输入框文字提示
app.get('/searchAutoPrompt', (req, res) => {
// 搜索关键字
const key = req.query.key;
// 提示文字列表
const list = [
'黑马程序员',
'黑马程序员官网',
'黑马程序员顺义校区',
'黑马程序员学院报名系统',
'传智播客',
'传智博客前端与移动端开发',
'传智播客大数据',
'传智播客python',
'传智播客java',
'传智播客c++',
'传智播客怎么样'
];
// 搜索结果
let result = list.filter(item => item.includes(key));
// 将查询结果返回给客户端
res.send(result);
});