一。swig
/*app.js
应用(启动)入口文件
*/
//加载express模块
var express = require('express');
//加载模板处理模块
var swig = require('swig');
//加载数据库模块
var mongoose = require("mongoose");
//加载body-parser,用来处理post提交过来的数据
var bodyParser = require('body-parser');
//加载cookies模块
var Cookies = require("cookies");
//创建app应用 => NodeJS Http.createServer()
var app = express();
var User = require('./models/User');
//设置静态文件托管
//当用户访问的url以 /public 开始,那么直接返回对应的__dirname + '/public' 下的文件
app.use('/public', express.static(__dirname + '/public'));
//配置应用模板
//定义当前应用所使用的模板引擎
//第一个参数:模板引擎的名称,同时也是模板文件的后缀,第二个参数表示用于解析处理模板内容的方法
app.engine('html', swig.renderFile);
//设置模板文件存放的目录,第一个参数是views,第二个参数是目录
app.set('views', './views');
//注册所使用的模板引擎,第一个参数必须是 view engine ,第二个参数是app.engine
//这个方法定义的模板引擎的名称(第一个参数)是一致的
app.set('view engine', 'html');
//在开发过程中,需要取消模板缓存
swig.setDefaults({cache: false});
//bodyparser设置
app.use(bodyParser.urlencoded({extended:true}));
//设置cookie
app.use(function(req,res, next){
req.cookies = new Cookies(req,res);
req.userInfo={};
//解析登录用户的cookie信息
if (req.cookies.get('userInfo')){
try{
req.userInfo = JSON.parse(req.cookies.get('userInfo'));
//获取当前登录用户的类型,是否是管理员
User.findById(req.userInfo._id).then(function(userInfo){
req.userInfo.isAdmin = boolean(userInfo.isAdmin);
//上面哪个语句不好用,用下面的编写一个代替吧
// req.userInfo.isAdmin = false;
next();
})
}catch(e){
next();
}
}
// console.log(req.cookies.get('userInfo'));
next();
})
//根据不同的功能划分模块
app.use('/admin', require('./routers/admin'));
app.use('/api', require('./routers/api'));
app.use('/', require('./routers/main'));
/*
首页
req request对象
res response对象
next 函数
*/
// app.get('/',function(req, res, next){
// // res.send('<h1>欢迎光临我的博客<h1>');
// /*
// 读取views目录下的指定文件,解析并返回给客户端
// 第一个参数:表示模板的文件,相对于views目录 views/index.html
// 第二个参数:传递给模板使用的数据
// */
// res.render('index');
// })
/*这种设置css的方式太麻烦了,实际操作不需要,只是在这里演示一下.
app.get('/main.css', function(req, res, next){
res.setHeader('content-type', 'text/css');
res.send("body{background:red;}");
})
*/
//监听http请求
mongoose.connect('mongodb://localhost:27018/blog',function(err){
if(err){
console.log(err);
console.log('数据库连接失败!');
}else{
console.log("数据库连接成功!");
app.listen(8081);
}
});
//用户发送http请求 -> url -> 解析路由 -> 找到匹配的规则 -> 执行指定绑定函数,返回对应内容至用户
// /public -> 静态文件 -> 直接读取指定目录下的文件,返回给用户
// 使用路由方式 -> 动态文件 -> 处理业务逻辑,记载模板,解析模板 -> 返回数据给用户
语法:{{ title }}
学习swig:
Swig 使用指南
一、如何使用
1、API
swig.init({
allowErrors: false,
autoescape: true,
cache: true,
encoding: 'utf8',
filters: {},
root: '/',
tags: {},
extensions: {},
tzOffset: 0
});
options:
allowErrors: 默认值为 false。将所有模板解析和编译错误直接输出到模板。如果为 true,则将引发错误,抛出到 Node.js 进程中,可能会使您的应用程序崩溃。
autoescape: 默认true,强烈建议保持。字符转换表请参阅转义过滤器。
true: HTML安全转义
false: 不转义,除非使用转义过滤器或者转义标签
'js': js安全转义
cache: 更改为 false 将重新编译每个请求的模板的文件。正式环境建议保持true。
encoding: 模板文件编码
root: 需要搜索模板的目录。如果模板传递给 swig.compileFile 绝对路径(以/开头),Swig不会在模板root中搜索。如果传递一个数组,使用第一个匹配成功的数组项。
tzOffset: 设置默认时区偏移量。此设置会使转换日期过滤器会自动的修正相应时区偏移量。
filters:自定义过滤器或者重写默认过滤器,参见自定义过滤器指南。
tags: 自定义标签或者重写默认标签,参见自定义标签指南。
extensions: 添加第三方库,可以在编译模板时使用,参见参见自定义标签指南。
2、nodejs
var tpl = swig.compileFile("path/to/template/file.html");
var renderedHtml = tpl.render({ vars: 'to be inserted in template' });
或者
var tpl = swig.compile("Template string here");
var renderedHtml = tpl({ vars: 'to be inserted in template' });
3、结合Express
npm install express
npm install consolidate
然后
app.engine('.html', cons.swig);
app.set('view engine', 'html');
4、浏览器
Swig浏览器版本的api基本与nodejs版相同,不同点如下:
不能使用swig.compileFile,浏览器没有文件系统
你必须提前使用swig.compile编译好模板
按顺序使用extends, import, and include,同时在swig.compile里使用参数templateKey来查找模板
var template = swig.compile('<p>{% block content %}{% endblock %}</p>', { filename: 'main' });
var mypage = swig.compile('{% extends "main" %}{% block content %}Oh hey there!{% endblock %}', { filename: 'mypage' });
二、基础
1、变量
{{ foo.bar }}
{{ foo['bar'] }}
如果变量未定义,输出空字符。
变量可以通过过滤器来修改:
{{ name|title }} was born on {{ birthday|date('F jS, Y') }}
// Jane was born on July 6th, 1985
2、逻辑标签
参见标签部分。
3、注释
4、空白
模板里的空白在最终输出时默认保留,如果需要去掉空白,可以在逻辑标签前后加上空白控制服-:
{% for item in seq -%}
{{ item }}
{%- endfor %}
三、模板继承
Swig 使用 extends 和 block 来实现模板继承 layout.html
<!doctype html>
<html>
<head>
<meta charset="utf-8">
<title>{% block title %}My Site{% endblock %}</title>
{% block head %}
<link rel="stylesheet" href="main.css">
{% endblock %}
</head>
<body>
{% block content %}{% endblock %}
</body>
</html>
index.html
{% extends 'layout.html' %}
{% block title %}My Page{% endblock %}
{% block head %}
{% parent %}
<link rel="stylesheet" href="custom.css">
{% endblock %}
{% block content %}
<p>This is just an awesome page.</p>
{% endblock %}
四、变量过滤器
用于修改变量。变量名称后用 | 字符分隔添加过滤器。您可以添加多个过滤器。
1、例子
{{ name|title }} was born on {{ birthday|date('F jS, Y') }}
and has {{ bikes|length|default("zero") }} bikes.
也可以使用 filter 标签来为块内容添加过滤器
{% filter upper %}oh hi, paul{% endfilter %}
2、内置过滤器
add(value):使变量与value相加,可以转换为数值字符串会自动转换为数值。
addslashes:用 \ 转义字符串
capitalize:大写首字母
date(format[, tzOffset]):转换日期为指定格式
format:格式
tzOffset:时区
default(value):默认值(如果变量为undefined,null,false)
escape([type]):转义字符
默认: &, <, >, ", '
js: &, <, >, ", ', =, -, ;
first:返回数组第一个值
join(glue):同[].join
json_encode([indent]):类似JSON.stringify, indent为缩进空格数
last:返回数组最后一个值
length:返回变量的length,如果是object,返回key的数量
lower:同''.toLowerCase()
raw:指定输入不会被转义
replace(search, replace[, flags]):同''.replace
reverse:翻转数组
striptags:去除html/xml标签
title:大写首字母
uniq:数组去重
upper:同''.toUpperCase
url_encode:同encodeURIComponent
url_decode:同decodeURIComponemt
3、自定义过滤器
创建一个 myfilter.js 然后引入到 Swig 的初始化函数中
swig.init({ filters: require('myfilters') });
在 myfilter.js 里,每一个 filter 方法都是一个简单的 js 方法,下例是一个翻转字符串的 filter:
exports.myfilter = function (input) {
return input.toString().split('').reverse().join('');
};
你的 filter 一旦被引入,你就可以向下面一样使用:
{{ name|myfilter }}
{% filter myfilter %}
I shall be filtered
{% endfilter %}
你也可以像下面一样给 filter 传参数:
exports.prefix = function(input, prefix) {
return prefix.toString() + input.toString();
};
{{ name|prefix('my prefix') }}
{% filter prefix 'my prefix' %I will be prefixed with "my prefix".{% endfilter %}
{% filter prefix foo %}I will be prefixed with the value stored to `foo`.{% endfilter %}
五、标签
1、内置标签
extends:使当前模板继承父模板,必须在文件最前
参数file:父模板相对模板 root 的相对路径 block:定义一个块,使之可以被继承的模板重写,或者重写父模板的同名块
参数name:块的名字,必须以字母数字下划线开头 parent:将父模板中同名块注入当前块中 include:包含一个模板到当前位置,这个模板将使用当前上下文
参数file: 包含模板相对模板 root 的相对路径
参数ignore missing:包含模板不存在也不会报错
参数with x:设置 x 至根上下文对象以传递给模板生成。必须是一个键值对
参数only:限制模板上下文中用 with x 定义的参数
{% include template_path %}
{% include "path/to/template.js" %}
你可以标记 ignore missing,这样如果模板不存在,也不会抛出错误
{% include "foobar.html" ignore missing %}
本地声明的上下文变量,默认情况不会传递给包含的模板。例如以下情况,inc.html 无法得到 foo 和 bar
{% set foo = "bar" %}
{% include "inc.html" %}
{% for bar in thing %}
{% include "inc.html" %}
{% endfor %}
如果想把本地声明的变量引入到包含的模板种,可以使用 with 参数来把后面的对象创建到包含模板的上下文中
{% set foo = { bar: "baz" } %}
{% include "inc.html" with foo %}
{% for bar in thing %}
{% include "inc.html" with bar %}
{% endfor %}
如果当前上下文中 foo 和 bar 可用,下面的情况中,只有 foo 会被 inc.html 定义
{% include "inc.html" with foo only %}
only 必须作为最后一个参数,放在其他位置会被忽略
raw:停止解析标记中任何内容,所有内容都将输出
参数file: 父模板相对模板 root 的相对路径 for:遍历对象和数组
参数x:当前循环迭代名
参数in:语法标记
参数y:可迭代对象。可以使用过滤器修改
{% for x in y %}
{% if loop.first %}<ul>{% endif %}
<li>{{ loop.index }} - {{ loop.key }}: {{ x }}</li>
{% if loop.last %}</ul>{% endif %}
{% endfor %}
特殊循环变量
loop.index:当前循环的索引(1开始)
loop.index0:当前循环的索引(0开始)
loop.revindex:当前循环从结尾开始的索引(1开始)
loop.revindex0:当前循环从结尾开始的索引(0开始)
loop.key:如果迭代是对象,是当前循环的键,否则同 loop.index
loop.first:如果是第一个值返回 true
loop.last:如果是最后一个值返回 true
loop.cycle:一个帮助函数,以指定的参数作为周期 ```
{% for item in items %}
<li class="{{ loop.cycle('odd', 'even') }}">{{ item }}</li>
{% endfor %}
在 for 标签里使用 else
{% for person in people %}
{{ person }}
{% else %}
There are no people yet!
{% endfor %}
if:条件语句
参数:接受任何有效的 JavaScript 条件语句,以及一些其他人类可读语法
{% if x %}{% endif %}
{% if !x %}{% endif %}
{% if not x %}{% endif %}
{% if x and y %}{% endif %}
{% if x && y %}{% endif %}
{% if x or y %}{% endif %}
{% if x || y %}{% endif %}
{% if x || (y && z) %}{% endif %}
{% if x [operator] y %}
Operators: ==, !=, <, <=, >, >=, ===, !==
{% endif %}
{% if x == 'five' %}
The operands can be also be string or number literals
{% endif %}
{% if x|length === 3 %}
You can use filters on any operand in the statement.
{% endif %}
{% if x in y %}
If x is a value that is present in y, this will return true.
{% endif %}
else 和 else if
{% if foo %}
Some content.
{% else if "foo" in bar %}
Content if the array `bar` has "foo" in it.
{% else %}
Fallback content.
{% endif %}
autoescape:改变当前变量的自动转义行为
参数on:当前内容是否转义
参数type:转义类型,js 或者 html,默认 html
假设
some_html_output = '<p>Hello "you" & \'them\'</p>';
然后
{% autoescape false %}
{{ some_html_output }}
{% endautoescape %}
{% autoescape true %}
{{ some_html_output }}
{% endautoescape %}
{% autoescape true "js" %}
{{ some_html_output }}
{% endautoescape %}
将会输出
<p>Hello "you" & 'them'</p>
<p>Hello "you" & 'them' </p>
\u003Cp\u003EHello \u0022you\u0022 & \u0027them\u0027\u003C\u005Cp\u003E
set:设置一个变量,在当前上下文中复用
参数name:变量名
参数=:语法标记
参数value:变量值
{% set foo = [0, 1, 2, 3, 4, 5] %} {% for num in foo %}
<li>{{ num }}</li>
{% endfor %}
macro:创建自定义可服用的代码段
参数...: 用户定义
{% macro input type name id label value error %}
<label for="{{ name }}">{{ label }}</label>
<input type="{{ type }}" name="{{ name }}" id="{{ id }}" value="{{ value }}"{% if error %} class="error"{% endif %}>
{% endmacro %}
然后像下面使用
<div>
{{ input("text", "fname", "fname", "First Name", fname.value, fname.errors) }}
</div>
<div>
{{ input("text", "lname", "lname", "Last Name", lname.value, lname.errors) }}
</div>
输出如下
<div>
<label for="fname">First Name</label>
<input type="text" name="fname" id="fname" value="Paul">
</div>
<div>
<label for="lname">Last Name</label>
<input type="text" name="lname" id="lname" value="" class="error">
</div>
import:允许引入另一个模板的宏进入当前上下文
参数file:引入模板相对模板 root 的相对路径
参数as:语法标记 var: 分配给宏的可访问上下文对象
{% import 'formmacros.html' as form %}
{# this will run the input macro #}
{{ form.input("text", "name") }}
{# this, however, will NOT output anything because the macro is scoped to the "form" object: #}
{{ input("text", "name") }}
filter:对整个块应用过滤器
参数filter_name: 过滤器名字
参数... : 若干传给过滤器的参数 父模板相对模板 root 的相对路径
{% filter uppercase %}
oh hi, {{ name }}
{% endfilter %}
{% filter replace "." "!" "g" %}
Hi. My name is Paul.
{% endfilter %}
输出
OH HI, PAUL Hi! My name is Paul!
spaceless:尝试移除html标签间的空格
{% spaceless %}
{% for num in foo %}
<li>{{ loop.index }}</li>
{% endfor %}
{% endspaceless %}
输出
<li>1</li><li>2</li><li>3</li>
二。ejs
/*app.js
*/
var createError = require('http-errors');
var express = require('express');
var path = require('path');
var cookieParser = require('cookie-parser');
var logger = require('morgan');
var ejs = require('ejs'); //我是新引入的ejs插件
var indexRouter = require('./routes/index');
var usersRouter = require('./routes/users');
var app = express();
// view engine setup
app.set('views', path.join(__dirname, 'views'));
app.engine("html", ejs.__express);
app.set('view engine', 'html');
app.use(logger('dev'));
app.use(express.json());
app.use(express.urlencoded({ extended: false }));
app.use(cookieParser());
app.use(express.static(path.join(__dirname, 'public')));
app.use('/', indexRouter);
app.use('/users', usersRouter);
// catch 404 and forward to error handler
app.use(function(req, res, next) {
next(createError(404));
});
// error handler
app.use(function(err, req, res, next) {
// set locals, only providing error in development
res.locals.message = err.message;
res.locals.error = req.app.get('env') === 'development' ? err : {};
// render the error page
res.status(err.status || 500);
res.render('error');
});
module.exports = app;
(1)配置方法:
npm install ejs
var ejs = require('ejs');
app.engine('html', ejs.__express);
app.set('view engine', 'html');
语法: <%= title %>
学习:可以去ejs官网 https://ejs.bootcss.com/
简略学习:
入门
安装
利用 NPM 安装 EJS 很简单。
$ npm install ejs
Use
将模板字符串和一些数据作为参数传递给 EJS,Duang,HTML 出来了。
var ejs = require('ejs'),
people = ['geddy', 'neil', 'alex'],
html = ejs.render('<%= people.join(", "); %>', {people: people});
浏览器支持
从这里下载 最新的浏览器版本,然后引入页面即可。
<script src="ejs.js"></script>
<script>
var people = ['geddy', 'neil', 'alex'],
html = ejs.render('<%= people.join(", "); %>', {people: people});
</script>
文档
实例
<% if (user) { %>
<h2><%= user.name %></h2>
<% } %>
用法
var template = ejs.compile(str, options);
template(data);
// => 输出绘制后的 HTML 字符串
ejs.render(str, data, options);
// => 输出绘制后的 HTML 字符串
ejs.renderFile(filename, data, options, function(err, str){
// str => 输出绘制后的 HTML 字符串
});
参数
cache 缓存编译后的函数,需要提供 filename
filename 被 cache 参数用做键值,同时也用于 include 语句
context 函数执行时的上下文环境
compileDebug 当为 false 时不编译调试语句
client 返回独立的编译后的函数
delimiter 放在角括号中的字符,用于标记标签的开与闭
debug 将生成的函数体输出
_with 是否使用 with() {} 结构。如果为 false,所有局部数据将存储在 locals 对象上。
localsName 如果不使用 with ,localsName 将作为存储局部变量的对象的名称。默认名称是 locals
rmWhitespace 删除所有可安全删除的空白字符,包括开始与结尾处的空格。对于所有标签来说,它提供了一个更安全版本的 -%> (在一行的中间并不会剔除标签后面的换行符)。
escape 为 <%= 结构设置对应的转义(escape)函数。它被用于输出结果以及在生成的客户端函数中通过 .toString() 输出。(默认转义 XML)。
标签含义
<% '脚本' 标签,用于流程控制,无输出。
<%_ 删除其前面的空格符
<%= 输出数据到模板(输出是转义 HTML 标签)
<%- 输出非转义的数据到模板
<%# 注释标签,不执行、不输出内容
<%% 输出字符串 '<%'
%> 一般结束标签
-%> 删除紧随其后的换行符
_%> 将结束标签后面的空格符删除
包含(include)
通过 include 指令将相对于模板路径中的模板片段包含进来。(需要提供 'filename' 参数。) 例如,如果存在 "./views/users.ejs" 和 "./views/user/show.ejs" 两个模板文件,你可以通过 <%- include('user/show'); %> 代码包含后者。
你可能需要能够输出原始内容的标签 (<%-) 用于 include 指令,避免对输出的 HTML 代码做转义处理。
<ul>
<% users.forEach(function(user){ %>
<%- include('user/show', {user: user}); %>
<% }); %>
</ul>
自定义分隔符
可针对单个模板或全局使用自定义分隔符:
var ejs = require('ejs'),
users = ['geddy', 'neil', 'alex'];
// 单个模板文件
ejs.render('<?= users.join(" | "); ?>', {users: users},
{delimiter: '?'});
// => 'geddy | neil | alex'
// 全局
ejs.delimiter = '$';
ejs.render('<$= users.join(" | "); $>', {users: users});
// => 'geddy | neil | alex'