tornado_模板

模板配置

在Application中配置模板文件和静态文件路径

app = Application(
    templates_path = 'templates',
    static_path = 'static'
)

简单示例

class MainHandler(tornado.web.RequestHandler):
    def get(self):
        self.render('test.html')

    def post(self):
        username = self.get_argument('name', '')
        self.render('templates.html',
            username=username
        )

<!DOCTYPE html>
<html lang='en'>
    <head>
        <meta charset='UTF-8'>
        <title>Templates</title>
    </head>

    <body>
            欢迎 {{ username }} 登录
    </body>
</html>

模板符号

{{ expression }}
任何 python 表达式，或者是一个变量

例如：{{ time.ctime() }}

{% directives %}
一些模板指令

例如：

for 循环
{% for i in urllist %}
{{ i }}
{% end %}

if语句
{% if 1 %}
......
{% else %}
......
{% end %}

while循环
{% set a = 0 %}
{% while a < 8 %}
{{ a }}
{% set a += 1 %}
{% end %}

{# #}
注释

{{! {%! {#!
显示源代码
会在页面打印模板符号，并且不会执行模板符号里面的代码

模板转义

在模板文件中默认是开启转义的，当我们有需求让转义不生效时，就需要用到模板的转义

{% raw atga %}
局部取消转义
如果我们只想让某一个变量或者某一部分取消转义时，此时需要用到我们的局部取消转义

{% autoescape None %}
模板取消转义
如果想让当前整个模板文件取消转义，那么我们需要在模板一开始的地方加入此行

autoescape=None
全局取消转义
如果我们想让所有的模板文件都取消转义，那么我们需要在Application里面配置此参数项

{{ escape(atga) }}
局部开启转义
当我们全局取消转义时，如果某一变量或某一部分需要开启转义，此时需要用到局部开启转义

静态文件的引入

如果我们想在模板文件中引入我们的图片等静态文件，那么我们需要用到静态文件的引入
在文章的一开始我们已经配置好了静态文件引入的路径，那么接下来我们可以直接从此路径在模板中引入静态文件(static_path='static')

href="static/images/1.jpg"
href="{{ static_url('images/1.jpg') }}"

模板继承

# HTML文件，如果我们想拿一个父模板让子模板去使用
{% extends ./templates.html %}  # 继承自哪个模板

{% block name %}  # 首先在父模板中声明要修改的部分，然后取个名字
{% end %}
# 如果在子模板里面想修改对应额内容，那我们就用block块包起来，里面写我们要修改的部分就可以了

{% include ./templates_login.html %}  # 导入部分功能，被导入的模板文件中不包含block块

函数跟类导入

1.通过render传参

# 自带或者第三方库的导入
import time
self.render('extends.html',
            time=time,
)

{{ time.ctime() }}  # 在模板文件中直接执行

自定义函数导入

def haha(self):
    pass

self.render('04-extends.html',
            haha=self.haha,
)

{{ haha() }}  # 在模板文件中直接执行

自定义类的导入

class Aaa:
    def func(self):
        pass
        
        
self.render('04-extends.html',
            aaa=AAA,
)

{{ aaa().func() }}  # 在模板文件中直接调用

2.直接在模板文件里面导入

{% import time %}
{{ time.ctime() }}

{% from util.mod_file import sum %}

ui_methods/ui_modules

当我们定义的函数或者类被多个模板多次使用的时候，如果我们按照之前的方法，那么需要每一个文件中都要导入一次，所以我们可以把自定义的函数或者类抽离成单独的文件然后全局导入，这样当我们在模板中使用的时候可以直接使用，无需再次导入。

新建一个ui_methods文件，用来存放我们的自定义函数

def add(self):
    pass

新建一个ui_modules文件，用来存放我们的自定义类

from tornado.web import UIModule  # 自定义类必须要继承自UIModule类

class TestModule(UIModule):
    def render(self):  # 在ui_modules里面，重写render，这个类才会被执行
        self.render_string('in_out.html')  # 返回一个页面用render_string方法
    
    def javascript_files(self):
        """如果有js文件引入，则重写此方法"""
        return None
        
    def css_files(self):
        """如果有css文件引入，则重写此方法"""
        return None

当做完以上步骤之后，在主文件里面导入
import util.ui_methods
import util.ui_modules

配置参数项
Application(
ui_methods=util.ui_methods,
ui_modules=util.ui_modules,
)

  • 在模板中使用
{{ add() }}  # ui_methods
{% module TestModule() %}  # ui_modules

补充语法

apply

可以让函数的执行作用于一段代码

linkify

会自动识别URL添加a标签，在使用时注意模板的转义

{% from util.mod_file import upper%}
{{ upper('hello world') }}

{% apply upper %}
    hello world
{% end %}
###########分割线###########
{{ linkify('百度：https://www.baidu.com') }}  # 自动加a标签，识别url

{% raw linkify('百度：https://www.baidu.com') %}  # 注意模板的转义

推荐阅读更多精彩内容