ホームページ バックエンド開発 Python チュートリアル Python の Flask フレームワークの標準テンプレート エンジンである Jinja2 の使用に関するチュートリアル

Python の Flask フレームワークの標準テンプレート エンジンである Jinja2 の使用に関するチュートリアル

Aug 04, 2016 am 08:55 AM
flask jinja2 python

Jinja2 には Python 2.4 以降が必要です。
インストール
Jinja をフォローするにはさまざまな方法があり、ニーズに応じてさまざまなフォロー方法を選択できます。
easy_install または pip を使用します:

リーリー
これら 2 つのツールは、Web サイトから Jinja を自動的にダウンロードし、Python ディレクトリの site-packages ディレクトリにインストールします。
tarball からインストール:
リーリー

基本的なAPIの使用法
Jinja でテンプレートを作成する最も簡単な方法は、Template を使用することです。ただし、この使用法は実際のアプリケーションでは推奨されません。

リーリー
この例では、テンプレート コンテンツとして文字列を使用して Template インスタンスを作成し、パラメータとして「name='World'」を指定して「render メソッド」を呼び出し、コンテンツ内の 'name' を「World」に置き換えて、最後にレンダリングされた文字列 - 「u'Hello World!」

区切り文字には 2 種類あります。 {% raw %}{% ... %}{% endraw %} および {% raw %}{{ ... }}{% endraw %}。前者は for ループや代入などのステートメントを実行するために使用され、後者は式の結果をテンプレートに出力するために使用されます。

テンプレートを整理する方法
それでは、テンプレートはどのようにアプリケーションに適合するのでしょうか? Flask に注目している方は、Flask が非常に柔軟で、コンテンツに特別な制限を課していないことに気づいたかもしれません。テンプレートも例外ではありません。また、通常は、何かを配置するための推奨される場所 (テンプレートなど) があることに気づくかもしれません。テンプレートの場合、その場所はパッケージ ディレクトリ内にあります。

リーリー
テンプレート ディレクトリの構造はルーティング構造と平行しています。ルート myapp.com/admin/analytics の場合、テンプレートは templates/admin/analytics.html です。ディレクトリには、直接レンダリングされない追加のテンプレートがいくつかあります。 layout.html ファイルは、他のテンプレートを継承するためのものです。

継承
バットマンのバックストーリーと同様に、よく整理されたテンプレート ディレクトリは継承に大きく依存しています。親テンプレートは通常、すべての子テンプレートが継承できる共通の構造を定義します。この例では、layout.html が親テンプレートで、他の .html ファイルが子テンプレートです。
通常、アプリケーションと Web サイトのあらゆる部分の一般的なレイアウトを定義するトップレベルのlayout.htmlがあります。上記のディレクトリを見ると、トップレベルの myapp/templates/layout.html に加えて、myapp/templates/profile/layout.html および myapp/templates/admin/layout.html が表示されます。最後の 2 つのファイルは、最初のファイルを継承して変更します。

リーリー
子テンプレートでは、親テンプレートを拡張し、これらのブロックのコンテンツを定義できます。


リーリー
super() 関数を使用すると、親ブロックのコンテンツをレンダリングできます。


マクロを作成する
繰り返し発生するコード スニペットをマクロに抽象化することで、テンプレートで DRY (Don'tRepeat Yourself) 原則を遵守できます。アプリケーションでナビゲーション用の HTML を操作している場合は、「アクティブ」リンクにクラス (class="active") を与える必要があります。マクロがなければ、各リンクをチェックしてアクティブなリンクを見つけるための if ... else ステートメントを大量に作成する必要があります。
マクロはコードをモジュール化する方法を提供し、関数のように機能します。マクロを使用してアクティブなリンクをマークする方法を見てみましょう。

リーリー
このテンプレートで今行う必要があるのは、未定義マクロ nav_link を呼び出し、それに 2 つのパラメーター (ターゲット エンドポイント (ターゲット ビューの関数名など) と表示するテキスト) を渡すことだけです。

import ステートメントでコンテキストを指定していることに気づくかもしれません。 Jinja のコンテキストは、Python コードから render_template() 関数と Jinja 環境コンテキストに渡されるパラメータで構成されます。テンプレートの場合、これらの変数はテンプレートのレンダリング時に使用できます。
render_template("index.html", color="red") などの一部の変数は明らかに私たちによって渡されますが、Flask によってコンテキストに自動的に組み込まれる変数や関数もいくつかあります。 gとセッション。 {% raw %}{% from ... import ... with context %}{% endraw %} と言うと、これらの変数がマクロでも使用できることを Jinja に伝えます。
次に、テンプレートで使用される nav_link マクロを定義します。

リーリー
これで、myapp/templates/macros.html にマクロが定義されました。このマクロでは、Flask のリクエスト オブジェクト (Jinja コンテキストでデフォルトで利用可能) を使用して、nav_link で渡されたルートのエンドポイントが現在のリクエストであるかどうかを確認します。そうであれば、現在のページにいるので、そのページをアクティブとしてマークします。

import y from x ステートメントは、x への相対パスを受け取ります。テンプレートが myapp/templates/user/blog.html の場合、「../macros.html」からを使用して nav_link をインポートできます。

自定义过滤器
Jinja 过滤器是一个函数,它能够在 {% raw %}{{ ... }}{% endraw %} 中用于处理一个表达式的结果。在表达式结果输出到模板之前它就被调用。

<h2>{{ article.title|title }}</h2>
ログイン後にコピー

在这段代码中,title 过滤器接收 article.title 作为参数并且返回一个过滤后的标题,接着过滤后的标题将会输出到模板中。这就像 UNIX 的“管道化”一个程序到另一个程序的输出。
有很多像 title 一样的内置过滤器。请参阅 Jinja 文档中的 完整列表。
我们可以在我们的 Jinja 模板中定义自己的过滤器供使用。举例来说,我们将会实现一个简单 caps 过滤器用来大写一个字符串中所有的字母。
Jinja 已经有一个 upper 过滤器来做这样的事情,并且还有一个 capitalize 过滤器,它能用来大写第一个字母,小写其余的字母。这些也能处理 unicode 转换,但是我们会继续我们的示例,让大家目前能够知道如何自定义过滤器。
我们要在 myapp/util/filters.py 中定义我们的过滤器。这里给出一个 util 包,它里面有各种各样的模块。

# myapp/util/filters.py
from .. import app
@app.template_filter()
def caps(text):
  """Convert a string to all caps."""
  return text.uppercase()
ログイン後にコピー

在这段代码中我们使用 @app.template_filter() 装饰器注册我们的函数成一个 Jinja 过滤器。默认的过滤器名称就是函数的名称,但是你可以传入一个参数到装饰器中来改变它。

@app.template_filter('make_caps')
def caps(text):
  """Convert a string to all caps."""
  return text.uppercase()
ログイン後にコピー

现在我们可以在模板中调用 make_caps 而不是 {% raw %}caps:{{ "hello world!"|make_caps }}{% endraw %}。
为了要让我们的过滤器在模板中可用的话,我们只需要在我们的顶层 \\_init.py\\_ 的中导入它。

# myapp/__init__.py
# Make sure app has been initialized first to prevent circular imports.
from .util import filters
ログイン後にコピー

このウェブサイトの声明
この記事の内容はネチズンが自主的に寄稿したものであり、著作権は原著者に帰属します。このサイトは、それに相当する法的責任を負いません。盗作または侵害の疑いのあるコンテンツを見つけた場合は、admin@php.cn までご連絡ください。

ホットAIツール

Undresser.AI Undress

Undresser.AI Undress

リアルなヌード写真を作成する AI 搭載アプリ

AI Clothes Remover

AI Clothes Remover

写真から衣服を削除するオンライン AI ツール。

Undress AI Tool

Undress AI Tool

脱衣画像を無料で

Clothoff.io

Clothoff.io

AI衣類リムーバー

AI Hentai Generator

AI Hentai Generator

AIヘンタイを無料で生成します。

ホットツール

メモ帳++7.3.1

メモ帳++7.3.1

使いやすく無料のコードエディター

SublimeText3 中国語版

SublimeText3 中国語版

中国語版、とても使いやすい

ゼンドスタジオ 13.0.1

ゼンドスタジオ 13.0.1

強力な PHP 統合開発環境

ドリームウィーバー CS6

ドリームウィーバー CS6

ビジュアル Web 開発ツール

SublimeText3 Mac版

SublimeText3 Mac版

神レベルのコード編集ソフト(SublimeText3)

LinuxターミナルでPythonバージョンを表示するときに発生する権限の問題を解決する方法は? LinuxターミナルでPythonバージョンを表示するときに発生する権限の問題を解決する方法は? Apr 01, 2025 pm 05:09 PM

LinuxターミナルでPythonバージョンを表示する際の許可の問題の解決策PythonターミナルでPythonバージョンを表示しようとするとき、Pythonを入力してください...

あるデータフレームの列全体を、Python内の異なる構造を持つ別のデータフレームに効率的にコピーする方法は? あるデータフレームの列全体を、Python内の異なる構造を持つ別のデータフレームに効率的にコピーする方法は? Apr 01, 2025 pm 11:15 PM

PythonのPandasライブラリを使用する場合、異なる構造を持つ2つのデータフレーム間で列全体をコピーする方法は一般的な問題です。 2つのデータがあるとします...

Python hourglassグラフ図面:可変未定義エラーを避ける方法は? Python hourglassグラフ図面:可変未定義エラーを避ける方法は? Apr 01, 2025 pm 06:27 PM

Python:Hourglassグラフィック図面と入力検証この記事では、Python NoviceがHourglass Graphic Drawingプログラムで遭遇する可変定義の問題を解決します。コード...

Pythonクロスプラットフォームデスクトップアプリケーション開発:どのGUIライブラリが最適ですか? Pythonクロスプラットフォームデスクトップアプリケーション開発:どのGUIライブラリが最適ですか? Apr 01, 2025 pm 05:24 PM

Pythonクロスプラットフォームデスクトップアプリケーション開発ライブラリの選択多くのPython開発者は、WindowsシステムとLinuxシステムの両方で実行できるデスクトップアプリケーションを開発したいと考えています...

GoogleとAWSはパブリックピピイメージソースを提供していますか? GoogleとAWSはパブリックピピイメージソースを提供していますか? Apr 01, 2025 pm 05:15 PM

多くの開発者はPypi(PythonPackageIndex)に依存しています...

Pythonで大規模な製品データセットを効率的にカウントしてソートするにはどうすればよいですか? Pythonで大規模な製品データセットを効率的にカウントしてソートするにはどうすればよいですか? Apr 01, 2025 pm 08:03 PM

データの変換と統計:大規模なデータセットの効率的な処理この記事では、製品情報を含むデータリストを別の含有しているものに変換する方法を詳細に紹介します...

Pythonの高解像度画像の処理を最適化して、正確な白い円形領域を見つける方法は? Pythonの高解像度画像の処理を最適化して、正確な白い円形領域を見つける方法は? Apr 01, 2025 pm 06:12 PM

白い領域を見つけるためにPythonで高解像度の画像を処理する方法は? 9000x7000ピクセルの高解像度画像の処理、2つの写真を正確に見つける方法...

PythonでFTPサーバーに接続するときにエンコードのファイル名の問題を解決する方法は? PythonでFTPサーバーに接続するときにエンコードのファイル名の問題を解決する方法は? Apr 01, 2025 pm 06:21 PM

Pythonを使用してFTPサーバーに接続する場合、指定されたディレクトリでファイルを取得してダウンロードする際に、特にFTPサーバーのテキストをダウンロードする際に問題が発生する可能性があります。

See all articles