Python Flask模块 - 码农教程

模块是一个包含响应文本的文件，其中包含占用位变量表示的动态部分，其具体值只在请求的上下文中才知道。使用真实值替换变量，再返回最终得到的响应字符串，这一过程称为渲染。为了渲染模块，Flask使用一个名为Jinja2的强大模板引擎。

一、Jinja2模板引擎

形式最简单的Jinja2模板就是一个包含响应文本的文件。

<h1>Hello,World!</h1>
<h1>Hello,{{name}}!</h1>

1、渲染模板

默认情况下，Flask在程序文件夹中的templates子文件夹中寻找模板。在下一个hello.py版本中，要把前面定义的模板保存在templates文件夹中，并分别命名为index.html和user.html。

#!/usr/bin/env python

from flask import Flask,render_template
app = Flask(__name__)

@app.route('/')
def index():
    return render_template('index.html')

@app.route('/user/<name>')
def user(name):
    return render_template('user.html',name=name)

if __name__ == '__main__':
    app.run()

Flask提供的render_template函数把Jinja模块引擎集成到了程序中。

2、变量

模板中使用的{{name}}结构表示一个变量，它是一种特殊的占位符，告诉模板引擎这个位置的值从渲染模板时使用的数据中获取。

Jinja2能识别所有类型的变量，甚至是一些复杂的类型，例如列表、字典和对象。在模板中使用变量的一些实例如下

<p>a value from a dictionary: {{ mydict['key'] }}</p>
<p>a value from a list:{{ mylist[3] }}</p>
<p>a value from a list,with a varliable index:{{ mylist[myintavr] }}</p>
<p>a value from a objects method:{{ myobj.somemethod() }}</p>

Jinja2变量过滤器

过滤器名	说明
safe	、渲染时不转义
capitalize	把值得首字母转换成大写，其他字母转换成小写
lower	把值转换成小写形式
upper	把值转换成大写形式
title	把值中每个单词的首字母都转换成大写
trim	把值的首位空格去掉
striptags	渲染之前把值中所有HTML标签都删除

3、控制结构

在模板中使用条件控制语句：

{% if user %}
    Hello,{{ user }}!
{% else %}
    Hello,Stranger!
{% endif %}

<ul>
    {% for commet in commets %}
        <li>{{ commet }}</li>
    {% end for %}
</ul>

Jinja2还支持宏，类似于Python代码中的函数。例如：

{% macro render_commet(commet) %}
    <li>{{ commet }}</li>
{% endmacro %}

<ul>
    {% for commet in commets %}
        {{ render_commet(commet) }}
    {% endfor %}
</ul>

为了重复使用宏，我们可以将其保存在单独的文件中，然后在需要使用的模板中导入：

{% import 'macros.html' as macros %}
<ul>
    {% for commet in commets %}
        {{ macros.render_commet(commet) }}
    {% endfor %}
</ul>

另一种重复使用代码的强大方式是模板继承，它类似于Python代码中的类继承。首先创建一个名为base.html的基模板：

<html>
<head>
    {% block head %}
    <title>{% block title %}{% endblock %} - My Application</title>
    {% endblock %}
</head>
<body>
    {% block body %}
    {% endblock %}
</body>
</html>

二、使用Flask-Bootstrap集成Twitter Bootstrp

Bootstrap是客户端架构，因此不会直接涉及服务器。服务器要做的知识提供引用了Bootstrap层叠样式表（CSS）和Javascript文件的HTML响应，并在HTML/CSS和Javascript代码中实例化所需组件。这些操作最理想的执行场所就是模板。

#初始化 Flask-bootstrap

from flask.ext.bootstrap import Bootstrap
#...
bootstrap = Bootstrap(app)

初始化Flask-Bootstrap之后，就可以在程序中使用一个包含所有Bootstrap文件的基模板。

{% extends "bootstrap/base.html" %}

{% block title %}Flasky{% endblock %}

{% block navbar %}
<div class="navbar navbar-inverse" role="navigation">
    <div class="container">
        <div class="navbar-header">
            <button type="button" class="navbar-toggle"
            data-toggle="collapse" data-target=".navbar-collapse">
                <span class="sr-only">Toggle navigation</span>
                <span class="icon-bar"></span>
                <span class="icon-bar"></span>
                <span class="icon-bar"></span>
            </button>
            <a class="navbar-brand" href="/">Flasky</a>
        </div>
        <div class="navbar-collapse collapse">
            <ul class="nav navbar-nav">
                <li><a href="/">Home</a></li>
            </ul>
        </div>
    </div>
</div>
{% endblock %}

{% block content %}
<div class="container">
    <div class="page-header">
        <h1>Hello,{{ name }}!</h1>
    </div>
</div>
{% endblock %}

三、自定义错误界面

#自定义错误界面

#!/usr/bin/env python

from flask import Flask,render_template
app = Flask(__name__)

@app.errorhandler(404)
def page_not_found(e):
    return render_template('404.html'),404

@app.errorhandler(500)
def internal_server_error(e):
    return render_template('500.html'),500

if __name__ == '__main__':
    app.run()

四：链接

Flask提供url_for()辅助函数，它可以使用程序URL映射中保存的信息生成URL。

url_for()函数最简单的用法是以视图函数名（或者app.add_url_route()定义路由时使用的端点名）作为参数，返回对应的URL。

使用url_for()生成动态地址时，将动态部分作为关键字参数传入。例如，url_for('user',name='john',_external=True)

五、静态文件

默认设置下，Flask在程序根目录中名为static的子目录中寻找静态文件。如果需要，可在static文件夹中使用子文件夹存放文件。

#定义收藏夹图标
{% block head %}
{{ super() }}
<link rel="shortcut icon" href="{{ url_for('static',filename='favicon.ico') }}"
    type="image/x-icon">
<link rel="icon" href="{{ url_for('static',filename='favicon.ico') }}"
    type="image/x-icon">
{% endblock %}

六、使用Flask-Moment本地化日期和时间

Flask-Moment是一个Flask程序扩展，能把moment.js集成到Jinja2模板中。

#初始化Flask-Moment
from flask.ext.moment import Moment
moment = Moment(app)

#引入moment.js库
{% block scripts %}
{{ super() }}
{{ moment.include_moment() }}
{% endblock %}

#!/usr/bin/env python

from flask import Flask,render_template
app = Flask(__name__)

from datetime import datetime
from flask_moment import Moment

moment = Moment(app)
@app.route('/')
def index():
    return render_template('index.html',
                           current_time=datetime.utcnow())

if __name__ == '__main__':
    app.run()