Flask框架Jinjia模板常用语法总结

2019-11-25 14:18:00

字体：大中小

来源：转载

供稿：网友

本文实例总结了Flask框架Jinjia模板常用语法。分享给大家供大家参考，具体如下：

1. 变量表示

{{ argv }}

2. 赋值操作

{% set links = [  ('home',url_for('.home')),  ('service',url_for('.service')),  ('about',url_for('.about')),] %}

3. if判断

{% if not loop.first %}|{% endif %}

4. for 循环

{% for label,link in links %}   {% if not loop.first %}|{% endif %}   <a href="{{ link }}" rel="external nofollow" >{{ label }}</a>{% endfor %}

5. 定义测试函数

上面 loop.first 就是一个测试函数，这个我们也可以自定义

定义是在Sample.py 里定义的，current_link是HTML中可使用测试函数名称（可选）

@app.template_test('current_link')def is_current_link(link):  return link == request.path

HTML中，使用例子

<body>{% set links = [  ('home',url_for('.home')),  ('service',url_for('.service')),  ('about',url_for('.about')),] %}<nav>  {% for label,link in links %}    {% if not loop.first %}|{% endif %}    <a href="{% if link is current_link %}#    {% else %}    {{ link }}    {% endif %}    ">{{ label }}</a>  {% endfor %}</nav></body>

6. 块block

Flask强大的地方就可以引用模板，而且非常方便。

这里不得不介绍block这个概念。

模板的文件一般放在templates文件夹下，我们这里新建一个HTML文件，存放模板，'base.html'

在这里面也，编排了整个页面的排版，里面会用到很多block的占位符。

每个block都代表一段html语句块，而这些块在哪里定义呢，可以在当前的base.html中定义，也可以在别的html中定义。反正要有一处定义，没有定义块只是没有效果而已

定义的时候，home.html 顶部必须说明继承关系(如果py文件链接的是home.html，但home.html引用了base.html的模板，就要说明)

{% extends 'base.html' %}

块的定义格式，endblock 后面块名可以省略，有时候加上会让结构更加明晰

{% block 块名 %}  块内容{% endblock (块名)%}

定义了块之后，base.html中对应的块，就会被这些块内容覆盖。

块的覆盖情况

有一种情况，base.html中定义了block B 块内容1，但是在home.html也定义block B 块内容2，注意这时会优先显示内容2，因为把内容1覆盖了。

理解起来，就是base.html是通用模板，我们可以直接引用过来，没有问题，但是也可以自定义块，修改通用模板的内容，达到我们想要的效果。

还有一种情况，我们既不想不覆盖通用模板的内容，又想在其基础上，增加一些东西，这也是可以的。

举个例子：在base.html中

<footer>  {% block footer %}  <p>Posted:Bikmin</p>    <p>Contact with:<a href="someone@example.com" rel="external nofollow" rel="external nofollow" >someone@example.com</a> </p>  {% endblock %}</footer>

如果我们不再自定义块，就会使用base.html通用模板的内容，效果如下

觉得这个模板还行，不想覆盖，还想在这个基础上再添加些东西，想要上面添加一条水平线作为分隔符，该怎么做呢

做法是，也是在home.html重新定义块，但是需要用到super()函数

{% block footer %}  <hr>  {{ super() }}{% endblock %}

{{ super() }} 就表示了通用模板里的内容

在一个项目HTML中，块被定义多次，是会被覆盖的。

有时候，我们想引用块的内容，又不想写一串很长的块内容，这时候可以用下面的语法，不管在哪个html文件里定义的都可以，只要有继承关系

{{ self.块名() }}

7. 包含页

如果有一些HTML代码是经常用到的固定的，为了避免整个HTML文档看起来很拥挤，内容嘈杂。

可以将这一部分的代码，保存为了一个HTML模板，然后要用的时候，再用

{% include 'includes/_head.html' %}

包含的方法引用过来，引号里是路径，includes是templates下的一个文件夹，这个看你放在哪里，就填哪里的路径了。

8. 宏macro

学了这么多，发现Flask中到处都是模板，仔细想想Python中的函数不也像是模板吗？只要输入参数，就可以实现特定的功能。

所以Jinjia里当然少不了。

宏的定义（举个例子）

下面定义一个<input/>的函数，通过做成宏，可以将一些参数修改成我们想要的默认值，然后调用的时候就像函数一样调用，很方便。

{# 定义宏 #}{% macro input(name,value='',type='text',size=20) %}  <input type="{{ type }}"    name="{{ name }}"    value="{{ value }}"    size="{{ size }}"/>{% endmacro %}

宏的调用

{{ input('username') }}{{ input('password',type='password') }}

宏的集合做成库

宏跟函数差不多，Python的函数可以封装在库里，那么是不是也可以将很多宏集合在一起（一个HTML中）,要用的时候像调用库函数一样import使用呢？

答案是当然可以的。这个做法还有一个好处，就是让我们的主HTML文件，内容更加简练。节省空间，可读性更强。

下面我们举例将一个macro放在'_macro.html'中

然后如何引入到我们的文件里呢

{% import '_macro.html' as ui %}

这里注意，必须要加 as 库名，不然我们引用函数的时候，都不知道从哪里来的函数

调用的方式也有点改变，如下

{{ ui.input('username') }}{{ ui.input('password',type='password') }}

是不是跟Python的使用函数一模一样？

小项目实战

#Sample.py

# coding:utf-8from flask import Flask,render_template,request,url_forapp = Flask(__name__)@app.route('/')def home():  return render_template('home.html',title_name = 'welcome')@app.route('/service')def service():  return 'service'@app.route('/about')def about():  return 'about'@app.template_test('current_link')def is_current_link(link):  return link == request.pathif __name__ == '__main__':  app.run(debug=True)

#home.html

{% extends 'base.html' %}{% import '_macro.html' as ui %}{% block title %}{{ title_name }}{% endblock %}{% block content %}{% set links = [  ('home',url_for('.home')),  ('service',url_for('.service')),  ('about',url_for('.about')),] %}<nav>  {% for label,link in links %}    {% if not loop.first %}|{% endif %}    <a href="{% if link is current_link %}#    {% else %}    {{ link }}    {% endif %}    ">{{ label }}</a>  {% endfor %}</nav>  <p>{{ self.title() }}</p>  {{ ui.input('username') }}  {{ ui.input('password',type='password') }}{% endblock content %}{% block footer %}  <hr>  {{ super() }}{% endblock %}

#base.html

<!DOCTYPE html><html lang="en"><head>  {% block head %}    {% include 'includes/_head.html' %}  {% endblock %}</head><body>  <header>{% block header %}{% endblock %}</header>  <div>{% block content %}<p>hello</p>{% endblock %}</div>  {% for item in items %}    <li>{% block loop_item scoped %}{{ item }}{% endblock %}</li>  {% endfor %}  <footer>    {% block footer %}    <p>Posted:Bikmin</p>      <p>Contact with:<a href="someone@example.com" rel="external nofollow" rel="external nofollow" >someone@example.com</a> </p>    {% endblock %}  </footer></body></html>

#_head.html

<meta charset="UTF-8"><link href="{{ url_for('static',filename='site.css') }}" rel="external nofollow" rel="stylesheet"><title>{% block title %}{% endblock %}</title>

#macro

{# 定义宏 #}{% macro input(name,value='',type='text',size=20) %}  <input type="{{ type }}"    name="{{ name }}"    value="{{ value }}"    size="{{ size }}"/>{% endmacro %}

运行项目