美文网首页
第三章--模版

第三章--模版

作者: 汤汤汤汤汤雪林 | 来源:发表于2017-02-19 15:25 被阅读0次

    模伴是一个包含响应文本的文件,其中包含用占位变量表示的动态部分,具体值只有在请求的上下文(request)中才能获取。
    处理模板时,使用真实变量替换占位变量,再返回最终得到的响应字符串(文件),这一过程称为渲染,Flask使用了Jinjia2这一强大的模板引擎进行渲染操作。

    一、Jinjia2 模版引擎

    1、渲染模板

    # user.html
    <h1>Hello , {{ name }}  </h1>
    

    默认情况下,flask在程序根目录下的templates文件夹中寻找模板。

    from flask import Flask, render_template
    # flask提供的render_template函数将Jinjia2模版引擎集成到程序中
    ···
    @app.route('/user/<name>'
    def user(name):
        return render_template('user.html', name=name)
    

    上述代码展示了render_template如何将动态变量传给模板并进行渲染
    render_template函数接收多个参数,但第一个参数必须为模板文件名称,后续为表示动态变量的键值对。

    2、变量

    在模板中使用"{{ name }}",双大括号结构表示一个变量,是模板特有的占位符,用以告诉模板引擎这个位置从渲染模板时使用的数据中获取。

    Jinjia2能识别所有类型的变量,包含复杂的(列表,字典,对象)。

    # 复杂类型示例
    {{ dict['key'] }}
    {{ list[3] }}
    {{ obj.somemethod() }}
    

    并且Jinjia2支持使用过滤器修改变量,过滤器名添加在变量名之后,用竖线隔开。

    {{ name | capitalize }}
    

    完整的过滤器列表

    3、控制结构

    Jinjia2提供了多种控制结构用来改变模板的渲染流程。

    {% if user %}
        hello, {{ user }}
    {% else %}
        hello, Stranger!
    {% endif %}    #控制语句结束后必须使用 {% end+if/for...%}关闭
    
    <ul>
        {% for comment in comments %}
            <li>{{ comment }}</li>
        {% endfor  %}
    </ul>
    

    模板继承

    {% extends "base.html" %}
    {% block title %}
    Index      #为父模板的title标签添加内容
    {% endblock %}
    {% block head%}
      {{ super() }}    #获取父模版head标签内的内容
    {% endblock %}
    

    二、Flask-Bootstrap

    Bootstrap是Twitter开发的一个客户端开源框架,并不会直接设计服务器内容。
    服务器需要做的是提供引用了Bootstrap CSS和JS文件的HTML响应,并在HTML、CSS和JS中实例化所需组件,这些操作最理想的执行场所就是模板。

    pip install flask-bootstrap    #安装
    from flask.ext.bootstrap import Bootstrap    #引入
    #···
    bootstrap = Bootstrap(app)  #初始化
    

    使用extends指令从flask-bootstrap中导入bootstrap/base.html,从而实现模板继承。
    该基模版提供了一个网页框架,引入Bootstrap所需的所有CSS、JS文件。
    如果需要对已有内容的模版添加新内容,必须使用Jinjia2提供的super()函数

    {% block scripts %}
    {{ super() }}
    <script type="text/javascript" src="my-script.js"></script>
    {% endblock %}
    

    三、自定义错误页面

    为指定错误代码自定义错误处理程序

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

    需要编写404.html模版,继承base.html,并将head元素改为相应的错误信息。
    为了避免过多的代码重复以及将错误信息展示在合适的页面,编写handle.html模板,继承自bootstrap/base.html,将导航条及其他基本框架必备信息写入,再新建404.html继承handle.html模板。

    {% extends "handle.html" %}
    {% block title %}Page Not Found {% endblock %}
    {% block page_content %} <h1>Not Found</h1>{% endblock %}
    

    四、链接

    任何具有多个路由的程序都需要可以连接不同页面的链接(例:导航条)
    flask提供了url_for()辅助函数,可以使程序URL映射中保存的信息生成URL。
    url_for()最简单的用法是以视图函数名作为参数,返回对应的URL。
    使用url_for()生成动态地址时,将动态部分作为关键字参数传入。
    传入url_for()的关键字参数不仅限于动态路由中的参数,函数能将任何额外的参数添加到查询字符串中,例:url_for('index', page=2) = /?page=2

    五、静态文件

    静态文件作为Web程序的重要组成部分(CSS、JavaScript、图片等)
    默认设置下,flask会在程序根目录中名为static的子目录中寻找静态文件。

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

    pip install flask-moment
    from flask.ext.moment import Moment
    moment = Moment(app)
    

    当Web程序服务器不同地区和国家的用户时,日期显示是个非常关键的问题,一般来说要根据用户本地的时区来提供给用户本地化的时间。
    flask-moment 是使用javascript开发的优秀客户端开源代码库,它可以在浏览器中渲染日期和时间。

    {% block scripts %}
    {{ super() }}
    {{ moment.include_moment() }}
    {% endblock %}
    

    将时间变量传给模板进行渲染

    #视图函数
    from datetime import datetime
    @app.route('/')
    def index():
        return render_template('index.html', current_time=datetime.utcnow())
    #模板
    <p>That was {{ moment(current_time).format('LLL')  }}</p>
    <p>That was {{ moment(current_time).fromNow(refresh=True) }}</p>
    

    format('LLL')根据客户端电脑中的时区和区域设置渲染日期和时间,参数决定了渲染的方式,‘L’到‘LLL’分别对应不同的复杂度。
    fromNow()渲染相对时间戳,而且会随着时间推移自动刷新显示的时间,最开始显示为"a few seconds ago",逐步变成"a minute ago"。

    相关文章

      网友评论

          本文标题:第三章--模版

          本文链接:https://www.haomeiwen.com/subject/spqjwttx.html