链接
任何具有多个路由的程序都需要可以连接不同页面的链接,例如导航条。
在模板中直接编写简单路由的 URL
链接不难,但对于包含可变部分的动态路由,在模板
中构建正确的 URL
就很困难。而且,直接编写 URL
会对代码中定义的路由产生不必要的
依赖关系。如果重新定义路由,模板中的链接可能会失效。
为了避免这些问题,Flask
提供了 url_for()
辅助函数,它可以使用程序URL 映射中保存
的信息生成 URL
。
url_for()
函数最简单的用法是以视图函数名(或者app.add_url_route()
定义路由时使用
的端点名)作为参数,返回对应的URL。
例如:程序中调用 url_for('index')
得到的结果是 /
。调用 url_for('index', _external=True)
返回的则是绝对地址,比如 http://localhost:5000/
。
使用url_for() 生成动态地址时, 将动态部分作为关键字参数传入。例如,url_for('user', name='john', _external=True)
的返回结果是 http://localhost:5000/user/john
。传入 url_for()
的关键字参数不仅限于动态路由中的参数。函数能将任何额外参数添加到查询字符串中。例如,url_for('index', page=2)
的返回结果是 /?page=2
。
静态文件
Web 程序不是仅由 Python
代码和模板组成。大多数程序还会使用静态文件,例如 HTML 代码中引用的图片、JavaScript
源码文件和 CSS
。
对静态文件的引用被当成一个特殊的路由,即 /static/<filename>
。例如,调用 url_for('static', filename='css/styles.css', _external=True)
得到的结果是 http://localhost:5000/static/css/styles.css
。
默认设置下,Flask
在程序根目录中名为 static
的子目录中寻找静态文件。如果需要,可在 static
文件夹中使用子文件夹存放文件。服务器收到前面那个URL 后,会生成一个响应,包含文件系统中static/css/styles.css
文件的内容。
示例1 展示了如何在程序的基模板中放置 favicon.ico
图标。这个图标会显示在浏览器的地址栏中。
示例1 templates/base.html
定义收藏夹图标
{% block head %}
{{ super() }}
<link rel="shortcut icon" href="{{ url_for('static', filename = 'favicon.ico') }}"
type="image/x-icon">
<link rel="icon" href="{{ url_for('static', filename = 'favicon.ico') }}"
type="image/x-icon">
{% endblock %}
图标的声明会插入 head
块的末尾。注意如何使用 super()
保留基模板中定义的块的原始内容。