模板
模板是包含静态数据和动态数据占位符的文件。模板使用指定的数据生成最终的文档。 Flask 使用 Jinja 模板库来渲染模板。
在教程的应用中会使用模板来渲染显示在用户浏览器中的 。在 Flask 中, Jinja 被配置为 自动转义 HTML 模板中的任何数据。即渲染用户的输入是安全的。 任何用户输入的可能出现歧意的字符,如 <
和 >
,会被 转义 ,替换为 安全 的值。这些值在浏览器中看起来一样,但是没有副作用。
Jinja 看上去并且运行地很像 Python 。 Jinja 语句与模板中的静态数据通过特定的 分界符分隔。 任何位于 {{
和 }}
这间的东西是一个会输出到最终文档的静态式。 {%
和 %}
之间的东西表示流程控制语句,如 if
和 for
。与 Python 不同,代码块使用分界符分隔,而不是使用缩进分隔。因为代码块内的 静态文本可以会改变缩进。
应用中的每一个页面主体不同,但是基本布局是相同的。每个模板会 扩展 同一个 基础模板并重载相应的小节,而不是重写整个 HTML 结构。
g 在模板中自动可用。 根据 g.user
是否被设置(在 load_logged_in_user
中进行),要么显示 用户名和注销连接,要么显示注册和登录连接。 也是自动可用的,可用于生成视图的 URL ,而不用手动来指定。
模板中定义三个块,这些块会被其他模板重载。
{% block title %}
会改变显示在浏览器标签和窗口中的标题。{% block content %}
是每个页面的具体内容,如登录表单或者博客帖子。
其他模板直接放在 templates
文件夹内。为了更好地管理文件,属于某个蓝图 的模板会被放在与蓝图同名的文件夹内。
flaskr/templates/auth/register.html
一个实用的模式是把 放在 {% block header %}
内部。 这里不但可以设置 title
块,还可以把其值作为 header
块的内容, 一举两得。
input
标记使用了 required
属性。这是告诉浏览器这些字段是必填的。 如果用户使用不支持这个属性的旧版浏览器或者不是浏览器的东西创建的请求, 那么你还是要在视图中验证输入数据。总是在服务端中完全验证数据,即使客户端 已经做了一些验证,这一点非常重要。
本模板除了标题和提交按钮外与注册模板相同。
flaskr/templates/auth/login.html
现在验证模板已写好,你可以注册一个用户了。 请确定服务器还在运行(如果没有请使用 flask run
),然后 访问 http://127.0.0.1:5000/auth/register 。
在不填写表单的情况,尝试点击 “Register” 按钮,浏览器会显示出错信息。尝试在 register.html
中删除 required
属性后再次点击 “Register” 按钮。 页面会重载并显示来自于视图中的 的出错信息,而不是浏览器显示 出错信息。
下面请阅读 静态文件 。