1.模板简介
模板
模板是web开发必备的模块。因为我们在渲染网页的时候,并不是只渲染一个纯文本字符串,而是需要渲染一个有富文本标签的页面。这个时候我们需要使用模板。flask中配套模板是jinja2,这个模板效率高。
flask渲染jinja模板
要渲染一个模板,通过render_template方法。
from flask import Flask,render_template
app=Flask(__name__)
@app.route('/about/')
def about():
return render_template('about.html') #需要建立一个templates文件,把html文件放进去
想更改模板文件地址,应该在创建app的时候,给Flask传递 关键字参数template_folder,指定具体的路径。
from flask import Flask,render_template
#会在c盘中templates文件中寻找模板文件。
app = Flask(__name__,template_folder=r'c:\xxxx\templates')
@app.route('/about/')
def about():
return render_template('about.html')
模板中有参数需要传递
from flask import Flask,render_template
app=Flask(__name__)
@app.route('/about/')
def about():
#return render_template('about.html',user='lizhe')
return render_template('about.html',**{'user':'lizhe'})
#模板中有参数需要传递
用了两种传参方式,因为render_template需要传递的是一个关键字参数,但是当你的模板中要传递的参数过多的时候,把所有参数放在一个函数中不是好的选择,因此我们使用字典进行包装,并用**,来转换成关键字参数。
2.jinja2模板过滤器
过滤器是通过管道符号(|)进行使用的,{{ name|length }},将返回name的长度。过滤器相当于是一个函数,把当前的变量传入到过滤器中,然后过滤器根据自己的功能,在返回相应的值,之后再将结果渲染到页面中。jiaja2中内置很多过滤器。
- abs(value):返回一个数值的绝对值。
- default(value,default_value,boolean=false):如果当前变量没有值,则会使用参数中的值来代替。nameldefault("juran’)——如果name不存在,则会使用lizhe来替代。boolean=False默认是在只有这个变量为undefined的时候才会使用default中的值,如果想使用python的形式判断是否为false,则可以传递boolean=true。也可以使用or来替换。
- escape(value)或e:转义字符,会将<、>等符号转义成HTML中的符号。例如:contentlescape或contentle。
- first(value):返回一个序列的第一个元素。names|first。
- format(value,*arags,**kwargs):格式化字符串。例如以下代码
{{ "%s" - "%s"|format('Hello?',"Foo!") }}将输出:Helloo? - Foo!
- last(value):返回一个序列的最后一个元素。name|last
- length(value):返回一个序列或者字典的长度。names|length
- join(value,d=u’’):将一个序列用d这个参数的值拼接成字符串
- safe(value):如果开启了全局转义,那么safe过滤器将会变量关掉专业。content_html|safe
- int(value):将值转换为float类型
- lower(value):将字符串转换为小写
- upper(value):将字符串转换为小写
- replace(value,old,new):替换将old替换为new的字符串
- truncate(value,length=255,killwords=False):截取length长度的字符串
- striptags(value):删除字符串中所有的HTML标签,如果出现了多个空格,将替换成一个空格。
- trim:截取字符串前面和后面的空白字符
- string(value):将变量转换为字符串
- worldcount(s):计算一个字符串中单词的个数。
3.控制语句
所有的控制语句放在{% … %}中,并且有一个语句{% endxxx %}来进行结束,jiaja中常用的控制语句有if/for…in…
if: if语句和python中类似,可以使用 > < >= <= == != 来判断,也可以通过and, or, not,()来进行逻辑合并操作。
{% if kenny.sick %}
Kenny is sick.
{% elif kenny.dead %}
You killed Kenny! You bastard!!!
{% else %}
Kenny looks okay --- so far
{% endif %}
for…in…:for循环可以遍历任何一个序列包括列表,字典,元组。可以进行反向遍历。
- 普通遍历
<ul>
{% for user in users%}
<li>{{ user }}</li>
{% endfor %}
</ul>
- 遍历字典
<dl>
{% for key, value in my_dict.items() %}
<dt>{{ key }}</dt>
<dd>{{ value }}</dd>
{% endfor %}
</dl>
- 如果序列中没有值的时候,进入else
<ul>
{% for user in users %}
<li>{{ user.username }}</li>
{% else %}
<li><em>no users found</em></li>
{% endfor %}
</ul>
并且jinja中for循环还包括以下变量,可以用来获取当前的遍历状态。
变量 | 描述 |
---|---|
loop.index | 当前迭代的索引(从1开始) |
loop.index() | 当前迭代的索引(从0开始) |
loop.first | 是否是第一次迭代,返回True或False |
loop.last | 是否是最后一次迭代,返回True或False |
loop.length | 序列的长度 |
不可以使用continue和break表达式来控制循环。
4.宏和import语句
宏
模板中的宏根python中的函数类似,可以传递参数,但是不能有返回值,可以将一些经常用到的代码片段放到宏中,然后把一些不固定的值抽取出来当成一个变量。
{% macro input(name, value='', type='text') %}
<input type="{{ type }}" name="{{ name }}" value="{{ value }}">
{% endmacro %}
#可以抽取出一个input标签,指定了一些默认参数,那么我们以后创建input标签的时候可以通过他快速创建。
<p>{{ input('username') }}</p>
<p>{{ input('password', type='password') }}</p>
import语句
forms.html:
{% macro input(name, value='', type='text') %}
<input type="{{ type }}" value="{{ value|e }}" name="{{ name }}">
{% endmacro %}
{% macro textarea(name, value='', rows=10, cols=40) %}
<textarea name="{{ name }}" rows="{{ rows }}" cols="{{ cols
}}">{{ value|e }}</textarea>
{% endmacro %}
导入宏的例子
1.import…as…形式
{% import 'macro.html' as macro %}
<tr>
<td>用户名:</td>
<td>{{ macro.input('username') }}</td>
</tr>
2.from…import…as…/from…import…形式
{% from "macro.html" import input %}
<tr>
<td>密码:</td>
<td>{{ input("password",type="password") }}</td>
</tr>
另外需要注意的是,导入模板并不会把当前上下文中的变量添加到被导入的模板中,如果你想要导入一个需要访问当前上下文变量的宏,有两种可能的方法
- 显式地传入请求或请求对象的属性作为宏的参数
- 与上下文一起(with context)导入宏
{% import ‘macro.html’ as macro with context %}
5.include和set语句
include语句
include语句可以把一个模板引入到另一个模板中,类似于把一个模板的代码copy到另一个模板的指定位置
{% include 'header.html' %}
主体内容
{% include 'footer.html' %}
赋值(set)语句
有时候我们想在模板中添加变量,这时候赋值语句(set)就派上用场了
{% set name='lizhe' %}
那么以后就可以使用name来替代lizhe这个值,也可以给他赋值为列表和元组:
{% set navigation = [('index.html', 'Index'), ('about.html', 'About')] %}
赋值语句创建的变量在其之后都是有效的,如果不想让一个变量污染全局环境,可以使用with语句来创建一个内部的作用域,将set语句放在其中,这样创建的变量只在with代码块中才有效。
{% with %}
{% set foo = 42 %}
{{ foo }} foo is 42 here
{% endwith %}
也可以在with的后面直接添加变量,比如以上的写法可以修改成这样:
{% with foo = 42 %}
{{ foo }}
{% endwith %}
这两种方式都是等价的,一旦超出with代码块,就不能再使用foo这个变量了。
6.模板继承
flask中的模板可以继承,通过继承可以把模板中许多重复出现的元素抽取出来,放在父模板通过定义block给字模版开一个口,子幕版根据需要,再实现这个block,假设现在有一个base.html这个父模板。
<!DOCTYPE html>
<html lang="en">
<head>
<link rel="stylesheet" href="base.css" />
<title>{% block title %}{% endblock %}</title>
{% block head %}{% endblock %}
</head>
<body>
<div id="body">{% block body %}{% endblock %}</div>
<div id="footer">
{% block footer %}
© Copyright 2008 by <a href="http://domain.invalid/">you</a>
{% endblock %}
</div>
</body>
</html>
以上父模板中,抽取了所有模板都需要用到html、body,并且对于一些所有模板都要用到的样式文件style.css也进行抽取,同时对一些子模版需要重写的地方,比如title、head、body都定义成block,然后子模板可以根据自己的需要,再具体的实现。
{% extends "base.html" %}
{% block title %}首页{% endblock %}
{% block head %}
{{ super() }}
<style type="text/css">
.detail{
color: red;
}
</style>
{% endblock %}
{% block content %}
<h1>这里是首页</h1>
<p class="detail">
首页的内容
</p>
{% endblock %}
首先第一行就定义了子模板继承的父模板,并且可以看到子模板实现了title这个block,并填充了自己的内容,再看head这个block,里面调用了super()这个函数,这个函数的目的是执行父模板中的代码,把父模板中的内容添加到子模板中,如身没有这一句,则父模板中处在head这个block中的代码将会被子模板中的代码给覆盖掉。
另外,模板中不能出现重名的block,如果一个地方需要用到另外一个block中的内容,可以使用self.blockname的方式进行引用
<title>
{% block title %}
这是标题
{% endblock %}
</title>
<h1>{{ self.title() }}</h1>
示例中h1标签重用了title这个block中的内容,子模版实现title这个block,h1标签也能拥有这个值。
另外,再子模版中,所有的文本标签和代码都要添加到从父模板中继承的block中。否则,这些文本和标签不会被渲染。
静态文件的配置
web应用中会出现大量的静态文件来使得网页更加生动美观。类似于CSS样式文件、JavaScript脚本文件、图片文件、字体文件等静态资源。在Jinja中加载静态文件非常简单,只需要通过url_for全局函数就可以实现
<link href='"{{ url_for('static',filename='about.css') }}">
url_for函数默认会在项目根目录下的static文件中寻找about.css文件,如果找到了,会生成一个相对于项目根目录下的/static/about.css路径。当然我们也可以把静态文件不放在static文件夹中,此时就需要具体指定了。
app= Flask(__name__,static_folder='c:xxx/static')
那么访问静态文件的时候,将会到/static这个文件夹下寻找