Python开发入门与实战4-模板页面

时间 2019-11-25

原文原文链接

4.Django基于模板页面

在前一章中，HTML是直接被硬编码在 Python views.py代码中，以下：html

from django.http import HttpResponse

import datetime

 

def hello(request):

      return HttpResponse("Hello world")

 

def current_datetime(request):

    now =   datetime.datetime.now()

    html   = "<html><body>It is now %s.</body></html>"   % now

    return   HttpResponse(html)

　　在实际的项目开发中，站点页面设计的修改每每比底层 Python 代码的修改要频繁得多，若是每次对页面设计所进行的任何改变都必须对底层Python 代码进行相应的修改，是很难知足实际的项目开发须要的。所以， Django开发了一套模板系统 (Template System)来实现将页面的设计和Python的代码分离开的开发模式，本章节咱们只经过简单的实例来讲明模板系统如何运用，具体的模板系统的语法和原理，请参考《The Django Book》网站。数据库

　　Django模板是一个文本，用于分离文档的表现形式和内容。模板定义了占位符以及各类用于规范文档该如何显示的各部分基本逻辑（模板标签）。模板一般用于产生HTML，可是Django的模板也能够产生任何基于文本格式的文档。django

4.1.如何使用模板系统

在Python代码中使用Django模板的最基本方式以下：windows

能够用原始的模板代码字符串建立一个 Template 对象，一样Django也支持用指定模板文件路径的方式来建立 Template 对象;
调用模板对象的render方法，而且传入一套变量context。它将返回一个基于模板的展示字符串，模板中的变量和标签会被context值替换。

>>> from django import template

>>> t = template.Template('My name is {{ name   }}.')

>>> c = template.Context({'name': 'Haozi'})

>>> print t.render(c)

My name is Haozi.

>>> c = template.Context({'name': 'Wuch'})

>>> print t.render(c)

My name is Wuch.

4.1.1. 建立模板对象

　　建立一个 Template 对象的方法就是直接实例化它。 Template 类就在 django.template 模块中，构造函数接受一个“原始模板代码”做为参数。框架

4.1.2. 模板渲染

　　一旦建立一个 Template 对象，就能够用 context 来传递数据给它。一个context是一系列变量和它们值的集合。函数

>>> from django.template import Context, Template

>>> t = Template('My name is {{ name }}.')

>>> c = Context({'name': 'Stephane'})

>>> t.render(c)

u'My name is Stephane.'

　　须要注意的是，t.render(c)返回值是一个Unicode对象，不是普通的字符串。你能够经过字符串前的u来区分。在Django框架中，会一直使用Unicode字符串对象而不是普通的字符串。网站

4.1.3. 字典和Contexts

　　Python的字典数据类型就是关键字和它们值的一个映射，Context 和字典很相似。context变量名必须由英文字符开始（A-Z或a-z）并能够包含数字字符、下划线和小数点。编码

　　Context在Django里是 Context 类，她的构造函数带有一个可选的参数：一个字典映射变量和它们的值。调用 Template 对象的 render() 方法时，传递context来填充模板参数的值。spa

4.1.4. 同一模板，多个上下文

　　一旦有了模板对象，咱们能够经过它渲染多个context来得到不一样的动态页面效果，例如：设计

>>> from django.template import Template, Context

>>> t = Template('Hello, {{ name }}')

>>> print t.render(Context({'name': 'John'}))

Hello, John

>>> print t.render(Context({'name': 'Julie'}))

Hello, Julie

>>> print t.render(Context({'name': 'Pat'}))

Hello, Pat

4.2. 在视图中使用模板

如今咱们使用模板技术来建立视图。从新打开咱们在前一章在 mysite.views 中建立的 current_datetime 视图：

from django.http import HttpResponse

import datetime

 

def current_datetime(request):

      now = datetime.datetime.now()

      html = "<html><body>It is now   %s.</body></html>" % now

      return HttpResponse(html)

　　依据用 Django 模板系统把该视图修改成以下代码：

from   django.template import Template, Context

from django.http   import HttpResponse

import datetime

 

def   current_datetime(request):

    now = datetime.datetime.now()

    t =   Template("<html><body>It is now {{ current_date   }}.</body></html>")

    html = t.render(Context({'current_date':   now}))

    return HttpResponse(html)

　　如今咱们虽然使用了模板系统，但并未真正的实现数据与表现的分离，模板仍然嵌入在Python代码里。下面咱们在改进一下代码，将模板置于一个单独的文件中，并在视图中加载模板文件来最终解决表现与数据分开的问题。

4.3. 模板加载

　　Django 为咱们提供了一种使用方便且功能强大的 API ，用于从磁盘中加载模板。要使用此模板加载API，首先咱们需将模板的存放位置告诉框架，在settings.py中配置模板文件的保存路径。打开mysite settings.py配置文件，找到TEMPLATE_DIRS设置项，加上文档模板的保存路径。

　　告诉 Django 加载模板时，在哪里查找模板。选择一个目录用于存放模板并将其添加到 TEMPLATE_DIRS 中，本例子中咱们在mysite目录下建立子目录templates来放置模板文件，配置TEMPLATE_DIRS可使用绝对路径来进行配置（即从文件系统根目录开始的目录路径）。

TEMPLATE_DIRS = (

    # Put strings   here, like "/home/html/django_templates" or   "C:/www/django/templates".

    # Always use   forward slashes, even on Windows.

# Don't forget to use absolute   paths, not relative paths.

'C:\My Files\Python   Projects\mysite\templates',

)

　　下面咱们是使用Python 代码这一点来构建动态的TEMPLATE_DIRS路劲的内容，代码以下：

import os.path

 

TEMPLATE_DIRS = (

     # Put strings here, like   "/home/html/django_templates" or   "C:/www/django/templates".

    # Always use forward slashes, even on   Windows.

#   Don't forget to use absolute paths, not relative paths.

 

    os.path.join(os.path.dirname(__file__),   'templates').replace('\\','/'),

)

　　这段代码使用了Python 内部变量 __file__ ，该变量被自动设置为settings.py 文件所在的目录，而后由os.path.join 这个方法将这目录与 templates 进行链接。在windows下，它会智能地选择正确的后向斜杠”“进行链接，而不是前向斜杠”/”。

　　接下来修改视图代码，框架使用 Django 模板加载功能来返回 current_datetime 视图：

from django.template.loader import   get_template

from django.template import Context

from django.http import HttpResponse

import datetime

 

def current_datetime(request):

    now = datetime.datetime.now()

    t = get_template('current_datetime.html')

    html = t.render(Context({'current_date':   now}))

    return HttpResponse(html)

　　同时，在模板目录中建立包括如下模板代码 current_datetime.html 文件：

<html><body>It is now {{ current_date   }}.</body></html>

这样以下图，是模板直接在IE中浏览的效果。

注意：模板的目录结构，不然没法正常加载模板，mytime URL最后的访问效果以下图：

4.4.使用render_to_response()函数

　　咱们已经告诉你如何载入一个模板文件，而后用 Context渲染它，最后返回这个处理好的HttpResponse对象给用户。同时，Django提供了一个更方便简单的函数，让咱们一次性地载入某个模板文件并渲染它，最后直接做为HttpResponse返回。

　　该快捷方式就是位于 django.shortcuts 模块中名为 render_to_response() 的函数。下面代码就是使用 render_to_response() 从新编写过的 current_datetime 范例。

from django.shortcuts import   render_to_response

import datetime

 

def current_datetime(request):

    now   = datetime.datetime.now()

      return render_to_response('current_datetime.html', {'current_date':   now})

　　render_to_response() 的第一个参数必须是要使用的模板名称。第二个参数是为该模板建立 Context 时所使用的字典。

4.5. 小结

　　本章咱们简要阐述了Django动态网页，以及如何经过加载模板文件来实现动态网页。关于Django模板的语法规则，还支持包含、继承等复杂的关系，进一步详细的模板语法请你们参考Django开发手册。

　　下一章咱们将介绍Django是如何访问数据库的内容——模型。