render_template() 方法可以渲染模板,你只要提供模板名称和你需要的参数作为参数传递给模板的变量就行了。
例子:template.py
from flask import render_template@app.route('/hello/')@app.route('/hello/')def hello(name=None): return render_template('hello.html', name=name)
文件结构如下:
/template.py/templates /hello.html
Flask 会在 templates 文件夹内寻找hello.html模板。
因此,如果你的应用是一个模块,那么模板文件夹(templates)应该在模块旁边;如果是一个包,那么就应该在包里面:
情形 1: 一个模块:
/application.py/templates /hello.html
情形 2: 一个包:(有 init .py)
/application /__init__.py /templates /hello.html
运行template.py
官网
开发者文档
模板包含 变量 或 表达式 ,这两者在模板求值的时候 会被替换为值 。模板中 还有标签,控制模板的逻辑。模板语法的大量灵感来自于 Django 和 Python 。
例子:
Hello from Flask {% if name %}Hello {{ name }}!
{% else %}Hello World!
{% endif %}
3行:如果name为真,则显示Hello + name参数
5行:否则显示hello world
7行:结束判断
多行
{# ... #}
单行
## 为行注释前缀
模板引擎不会对空白做处理,空白(空格、制表符、换行符 等等)都会原封不动返回。
在块(比如一个for 标签、一段注释或变量表达式)的开始或结束放置一个减号( - ),可以移除块前或块后的空白:标签和减号之间不能有空白
有效的:
{%- if foo -%}...{% endif %}
无效的:
{% - if foo - %}...{% endif %}
使用 # 把一个行标记为一个语句,下面的两段代码等价
# for item in seq
不会把它作为变量或块来处理。
最简单的方法是在变量分隔符中( {{ )使用变量表达式输出:
{{ '{{' }}
较大的段落使用raw:
{% raw %} {% for item in seq %}
Hello, {{ name }}!
特殊的占位符告诉模版引擎该值在渲染模版的时候要从数据提供者那里拿到该数据。
Jinja2可以识别所有变量的类型,甚至是一些复杂的数据类型,如lists,dic,objects.如:
A value from a dictionary: {{ mydict['key'] }}.
A value from a list: {{ mylist[3] }}.
A value from a list, with a variable index: {{ mylist[myintvar] }}.
A value from an object's method: {{ myobj.somemethod() }}.
变量上面也可以有你能访问的属性或元素。访问变量属性可以使用 . 或者 []
{{ foo.bar }}{{ foo['bar'] }}
变量可以被过滤器修改,通过管道|作为分隔符,过滤器放在后面
Hello, {{ name|capitalize }}
Filter名称 | 描述 |
---|---|
safe | 安全过滤器 |
capitalize | 值的第一个字符转换为大写,其余小写 |
lower | 值全部转化为小写 |
upper | 值全部转换为大写 |
title | 值中的每个单词大写 |
trim | 将中间的空格移除 |
striptags | 在渲染之前删除任何HTML标记 |
安全过滤器:
所有的判断函数
{% if loop.index is divisibleby 3 %}
Jinja2提供了几个控制流结构改变渲染模版的流。
{% for user in users %}
迭代像 dict 的容器
{% for key, value in my_dict.iteritems() %} {{ key|e }} {{ value|e }}{% endfor %}
include 语句用于包含一个模板,并在当前命名空间中返回那个文件的内容渲 染结果
模板继承可以使每个页面的特定元素(如页头,导航,页尾)保持一致。
用内容填充空的block是子模板的工作。 {% block %}告诉模板引擎子模板可以覆盖模板中的这些部分。
同一个模板中 {% block %} 的名名称必须唯一。
一个基础的模版:base.html
{% block head %}{% block title %}{% endblock %} - My Webpage {% endblock %} {% block content %}{% endblock %} {% block footer %} © Copyright 2008 by you. {% endblock %}
子模版:{% extend %} 标签告诉模板引擎这个模板“继承”另一个模板。 extends 标签应该是模板中的第一个 标签。
{% extends "base.html" %}{% block title %}Index{% endblock %}{% block head %} {{ super() }} {% endblock %}{% block content %}Index
Welcome on my awesome homepage.
{% endblock %}
重复使用块,渲染块的内容:使用 self.块的名称
{% block title %}{% endblock %} {{ self.title() }}
{% block body %}{% endblock %}
{% block sidebar %}Table Of Contents
... {{ super() }}{% endblock %}
Jinja2 允许你在块的结束标签中加入的名称来改善可读性:endblock 后面的名称一定与块名匹配。
{% block sidebar %} {% block inner_sidebar %} ... {% endblock inner_sidebar %}{% endblock sidebar %}
默认的块不允许访问块外作用域中的变量,下面的li输出为空,item 在块中是不可用的,其原因是,如果 块被子模板替换,变量在其块中可能是未定义的或未被传递到上下文。
{% for item in seq %}
在块声明中添加 scoped 修饰,就把块设定到作用域中:
{% for item in seq %}
bootstrap官网
bootstrap是客户端的模版,所以服务器不能直接调用它。服务器能够做的就是提供HTML response,根据bootstrap需要的html,css,js关联的组建。使用Flask-Bootstrap扩展来完成。
安装Flask-Bootstrap: pip install flask-bootstrap
初始化Bootstrap
Flask扩展的初始化一般都是在app实例创建的同时实行。
from flask.ext.bootstrap import Bootstrap# ...bootstrap = Bootstrap(app)
下面展示新的继承模版
{% extends "bootstrap/base.html" %}{% block title %}Flasky{% endblock %}{% block navbar %} Flasky
定义了三个block,title, navbar, 和content.在这个模版中navbar block定义了一个简单的导航bar使用bootstrap组建。