\n\n独自のテンプレートタグやフィルタを指定するための最も一般的な場所は、Django のアプリケーションの内部です。それらが既存のアプリに関連するものである場合は、この場所にバンドルするのが最適です。それ以外の場合は、新しいアプリケーションに追加されてしまいます。Django のアプリケーションが INSTALLED_APPS
\nアプリケーションは、"models.py" や "views.py" などと同じレベルに "templatetags" ディレクトリを含むべきです。まだ存在していない場合は、ディレクトリが Python パッケージとして扱われるようにするため、"__init__.py" を忘れないでください。
\n\nカスタムタグやフィルタは templatetags
\n例えば、カスタムタグ/フィルタが poll_extras.py
\nText Copy
polls/\n __init__.py\n models.py\n templatetags/\n __init__.py\n poll_extras.py\n views.py\nそして、テンプレートでは次のように使います:
\nDjango template Copy
{% load poll_extras %} \nカスタムタグを含むアプリケーションは、{% load %} INSTALLED_APPS
\ntemplatetags {% load %}
\n有効なタグライブラリにするため、モジュールは、register template.Library
\nCode Copy
from django import template \n\nregister = template . Library () \nあるいは、テンプレートタグのモジュールは、DjangoTemplates 'libraries'
\n\n \n\n独自のフィルタは、1つか2つの引数を取るPythonの関数です:
\n\n例えば、フィルタ {{ var|foo:"bar" }} foo var "bar"
\nテンプレート言語は例外処理を提供しないので、テンプレートフィルタから生成された例外はすべてサーバーエラーとして公開されます。したがって、フィルタ関数は、返すべき妥当なフォールバック値がある場合には例外を発生させないようにする必要があります。テンプレートの明確なバグを表すインプットの場合、例外を発生させる方が、バグを隠すサイレントな失敗よりも適切でしょう。
\n以下はフィルタ定義の例です:
\nCode Copy
def cut ( value , arg ): \n """Removes all values of arg from the given string""" \n return value . replace ( arg , "" ) \nそして、以下はフィルタがどのように使われるかの例です:
\nDjango template Copy
{{ somevariable | cut :"0" }} \nほとんどのフィルタは引数を取りません。この場合、次のように関数の第2引数を省略してください:
\nCode Copy
def lower ( value ): # Only one argument. \n """Converts a string into all lowercase""" \n return value . lower () \n\n\n\n\ndjango.template.Library. filter ( ) Link to this definition # \n \n\nフィルタ定義を書き終わったら、Django のテンプレート言語で使用できるようにするため、Library
\nCode Copy
register . filter ( "cut" , cut ) \nregister . filter ( "lower" , lower ) \nLibrary.filter()
\n\nフィルタの名前 -- 文字列です。
編集用の関数 -- Python の関数です (文字列としての関数名ではありません)。
\n代わりに register.filter()
\nCode Copy
@register . filter ( name = "cut" ) \ndef cut ( value , arg ): \n return value . replace ( arg , "" ) \n\n\n@register . filter \ndef lower ( value ): \n return value . lower () \nname
\n最後に、register.filter() is_safe needs_autoescape expects_localtime フィルタと自動エスケープ フィルタとタイムゾーン
\n \n\n\n\n\ndjango.template.defaultfilters. stringfilter ( ) Link to this definition # \n \n\n第 1 引数として文字数を要求するだけのテンプレートフィルタを記述している場合、デコレータ stringfilter
\nCode Copy
from django import template \nfrom django.template.defaultfilters import stringfilter \n\nregister = template . Library () \n\n\n@register . filter \n@stringfilter \ndef lower ( value ): \n return value . lower () \nこれにより、このフィルタに整数を渡したとしても AttributeError lower()
\n \n\n独自のフィルタを作成する場合、フィルタがDjangoの自動エスケープの挙動とどのように関連するか考慮してください。2種類の文字列がテンプレートコードに渡されることに留意してください:
\n\nRaw strings はPythonのネイティブの文字列です。出力時に、自動エスケープが有効な場合はエスケープされ、それ以外の場合は変更されません。
Safe strings は出力時にさらなるエスケープがされないように安全とマークされた文字列です。必要なエスケープはすでに行われています。これらはクライアント側でそのまま解釈されることを目的とした生のHTMLを含む出力によく利用されます。
\n内部では、これらの文字列は SafeString
\nCode Copy
from django.utils.safestring import SafeString \n\nif isinstance ( value , SafeString ): \n # Do something with the "safe" string. \n ... \n \nテンプレートフィルタのコードは、次の2つの状況のいずれかに当てはまります:
\n\nフィルタが結果に新たにHTMLで安全でない文字 (< > ' " & is_safe True
\nCode Copy
@register . filter ( is_safe = True ) \ndef myfilter ( value ): \n return value \nこのフラグは、"安全"な文字列がフィルタに渡された場合、結果も依然として"安全"であることをDjangoに伝えます。そして、安全でない文字列が渡された場合、必要に応じてDjangoが自動的にエスケープします。
\nこの場合、"このフィルタは安全である ―― それはどんな非安全なHTMLも導入する可能性はない。" と考えて構いません。
\nis_safe SafeData str
\n例えば、任意の入力の末尾に文字列 xx is_safe
\nCode Copy
@register . filter ( is_safe = True ) \ndef add_xx ( value ): \n return " %s xx" % value \nこのフィルタが自動エスケープが有効なテンプレートで使用される場合、入力が既に"安全"としてマークされていない限り、Djangoは出力をエスケープします。
\nデフォルトでは is_safe False
\nフィルタが本当に安全な文字列を安全なまま残すかどうかを判断するときには注意してください。文字を 除去 している場合、不注意で結果の中に不均衡なHTMLタグやエンティティが残ってしまうかもしれません。例えば、入力から > <a> <a ; & &
\nフィルタを is_safe is_safe
\nまたは、フィルタのコードで必要なエスケープ処理を手動で行うこともできます。これは、結果に新しいHTMLマークアップを導入する場合に必要です。HTMLマークアップがさらにエスケープされないように、出力を安全としてマークしたい場合は、入力を自分で処理する必要があります。
\n出力を安全な文字列としてマークするには django.utils.safestring.mark_safe()
\nただし注意が必要です。出力を安全としてマークするだけでは不十分です。本当にそれが 安全である ことを確認する必要があり、行うべきことは自動エスケープが有効かどうかによって異なります。テンプレート作成者のために、自動エスケープがオンまたはオフのどちらのテンプレートでも操作できるフィルタを書くことが考えられます。
\nフィルタが現在の自動エスケープの状態を知るためには、フィルタ関数を登録する際に needs_autoescape True False autoescape True False autoescape True
\n例えば、文字列の最初の文字を強調するフィルタを書いてみましょう:
\nCode Copy
from django import template \nfrom django.utils.html import conditional_escape \nfrom django.utils.safestring import mark_safe \n\nregister = template . Library () \n\n\n@register . filter ( needs_autoescape = True ) \ndef initial_letter_filter ( text , autoescape = True ): \n first , other = text [ 0 ], text [ 1 :] \n if autoescape : \n esc = conditional_escape \n else : \n esc = lambda x : x \n result = "<strong> %s </strong> %s " % ( esc ( first ), esc ( other )) \n return mark_safe ( result ) \nneeds_autoescape autoescape autoescape django.utils.html.conditional_escape conditional_escape() escape() SafeData でない 入力のみをエスケープします。 SafeData conditional_escape()
\n最後に、上の例では、HTMLがさらにエスケープされることなくテンプレートに直接挿入されるように、結果を安全としてマークすることを忘れないでください。
\nこの場合、 is_safe is_safe
\n \n\n警告
\n組み込みのフィルタを再利用するときに XSS 脆弱性を回避する
\nDjango に組み込みのフィルタは、適切な自動エスケープを行い、クロスサイトスクリプティング（XSS）の脆弱性を回避するために、デフォルトで autoescape=True
\n古いバージョンの Django では、 autoescape None autoescape=True
\n例えば、 urlize linebreaksbr urlize_and_linebreaks
\nCode Copy
from django.template.defaultfilters import linebreaksbr , urlize \n\n\n@register . filter ( needs_autoescape = True ) \ndef urlize_and_linebreaks ( text , autoescape = True ): \n return linebreaksbr ( urlize ( text , autoescape = autoescape ), autoescape = autoescape ) \n次のように使います:
\nDjango template Copy
{{ comment | urlize_and_linebreaks }} \nこれは以下と同等です:
\nDjango template Copy
{{ comment | urlize | linebreaksbr }} \n \n \n\ndatetime expects_localtime True
\nCode Copy
@register . filter ( expects_localtime = True ) \ndef businesshours ( value ): \n try : \n return 9 <= value . hour < 17 \n except AttributeError : \n return "" \nこのフラグがセットされていると、フィルタの最初の引数がタイムゾーンを意識した datetime である場合、Django は テンプレートにおけるタイムゾーン変換ルール
\n \n \n\nタグはあらゆることができるため、フィルタより複雑です。Django は、ほとんどのタイプのタグを簡単に書けるように、多数のショートカットを提供しています。まず最初にこうしたショートカットを見てから、ショートカットでは機能が不足している場合にゼロからタグを書く方法を説明します。
\n\n\n\n\ndjango.template.Library. inclusion_tag ( ) Link to this definition # \n \n\nテンプレートタグのもう一つの一般的なタイプは、 別の テンプレートをレンダリングしてデータを表示するものです。例えば、 Django の admin インタフェースでは、カスタムテンプレートタグを使って、"add/change" フォームページの下にあるボタンを表示しています。これらのボタンはいつも同じように見えますが、編集中のオブジェクトによってリンク先が変わります -- なので、現在のオブジェクトの詳細で埋められた小さなテンプレートを使うのに最適なケースです。(admin の場合、これは submit_row
\nこの種のタグは "inclusion tag" と呼ばれます。
\nInclusion tag の書き方は例で示すのが一番わかりやすいでしょう。 チュートリアル Poll
\nDjango template Copy
{% show_results poll %} \n...そして出力は次のようになります:
\nHtml Copy
< ul > \n < li > First choice</ li > \n < li > Second choice</ li > \n < li > Third choice</ li > \n</ ul > \nまず、引数を受け取り、結果のデータの辞書を生成する関数を定義します。ここで重要なのは、辞書を返すだけでよく、それ以上複雑なものは必要ないということです。これは、テンプレートの断片のテンプレート・コンテキストとして使用されます。例:
\nCode Copy
def show_results ( poll ): \n choices = poll . choice_set . all () \n return { "choices" : choices } \n次に、タグの出力をレンダリングするためのテンプレートを作成します。このテンプレートはタグの固定機能であり、テンプレート設計者ではなく、タグ作成者が指定します。この例では、テンプレートはとても短いです:
\nDjango template Copy
< ul > \n{% for choice in choices %} \n < li > {{ choice }} </ li > \n{% endfor %} \n</ ul > \n次に、 Library inclusion_tag() results.html
\nCode Copy
# Here, register is a django.template.Library instance, as before \n@register . inclusion_tag ( "results.html" ) \ndef show_results ( poll ): ... \nあるいは、 django.template.Template
\nCode Copy
from django.template.loader import get_template \n\nt = get_template ( "results.html" ) \nregister . inclusion_tag ( t )( show_results ) \n…これは、関数を最初に作成する際に行います。
\n時に、 inclusion tag は多くの引数を要求することがあり、テンプレート作者が全ての引数を渡したり、引数の順番を覚えたりするのは面倒です。これを解決するために、 Django は inclusion tag に takes_context takes_context
\n例えば、メインページを指す home_link home_title
\nCode Copy
@register . inclusion_tag ( "link.html" , takes_context = True ) \ndef jump_link ( context ): \n return { \n "link" : context [ "home_link" ], \n "title" : context [ "home_title" ], \n } \n最初の引数は context しなければならない ことに注意してください。
\nこの register.inclusion_tag() takes_context=True link.html
\nDjango template Copy
Jump directly to < a href = " {{ link }} " > {{ title }} </ a > .\nそして、そのカスタムタグを使いたいときはいつでも、そのライブラリをロードして、引数なしで次のように呼び出します:
\nDjango template Copy
{% jump_link %} \ntakes_context=True
\ntakes_context False True inclusion_tag
\ninclusion_tag
\nCode Copy
@register . inclusion_tag ( "my_template.html" ) \ndef my_tag ( a , b , * args , ** kwargs ): \n warning = kwargs [ "warning" ] \n profile = kwargs [ "profile" ] \n ... \n return ... \nこのようにすることで、テンプレートからはスペースで区切られた変数をいくつでもテンプレートタグに渡すことができます。Pythonの文法と同じように、キーワード引数の値は等号（"=
\nDjango template Copy
{% my_tag 123 "abcd" book.title warning = message | lower profile = user.profile %} \n \n\n\n\nテンプレート・システムは、コンパイルとレンダリングの 2 段階のプロセスで動作します。カスタムテンプレートタグを定義するには、コンパイルの仕組みとレンダリングの仕組みを指定します。
\nDjango はテンプレートをコンパイルするとき、生のテンプレートテキストを "ノード" に分割します。各ノードは django.template.Node render() Node render() Node render()
\nこのように、カスタムテンプレートタグを定義するには、生のテンプレートタグを Node render()
\n \n\n\nテンプレートパーサーが見つけたそれぞれのテンプレートタグに対して、タグの内容とパーサーオブジェクト自身を使って Python 関数を呼び出します。この関数はタグの内容に基づいて Node
\n例えば、テンプレートタグの完全な実装である {% current_time %} strftime()
\nDjango template Copy
< p > The time is {% current_time "%Y-%m-%d %I:%M %p" %} .</ p > \nこの関数のパーサは、パラメータを取得して Node
\nCode Copy
from django import template \n\n\ndef do_current_time ( parser , token ): \n try : \n # split_contents() knows not to split quoted strings. \n tag_name , format_string = token . split_contents () \n except ValueError : \n raise template . TemplateSyntaxError ( \n " %r tag requires a single argument" % token . contents . split ()[ 0 ] \n ) \n if not ( format_string [ 0 ] == format_string [ - 1 ] and format_string [ 0 ] in ( '"' , "'" )): \n raise template . TemplateSyntaxError ( \n " %r tag's argument should be in quotes" % tag_name \n ) \n return CurrentTimeNode ( format_string [ 1 : - 1 ]) \nメモ:
\n\nparser
token.contents 'current_time "%Y-%m-%d %I:%M %p"'
token.split_contents() token.contents.split() すべての スペースで単純に分割してしまうため、それほど堅牢ではありません。常に token.split_contents()
この関数は構文エラーに対して django.template.TemplateSyntaxError
TemplateSyntaxError tag_name token.contents.split()[0]
この関数は、ノードがこのタグについて知る必要があるすべての情報を含む CurrentTimeNode "%Y-%m-%d %I:%M %p" format_string[1:-1]
構文解析は非常に低レベルです。Django の開発者は、 EBNF 文法などのテクニックを使って、この構文解析システムの上に小さなフレームワークを書く実験をしましたが、 その実験ではテンプレートエンジンが遅すぎました。 低レベルなのは、それが最速だからです。
\n \n\n\nカスタムタグを書く2つ目のステップは、 render() Node
\n上記の例の続きで、 CurrentTimeNode
\nCode Copy
import datetime \nfrom django import template \n\n\nclass CurrentTimeNode ( template . Node ): \n def __init__ ( self , format_string ): \n self . format_string = format_string \n\n def render ( self , context ): \n return datetime . datetime . now () . strftime ( self . format_string ) \nメモ:
\n\n__init__() do_current_time() format_string Node __init__()
render()
特に実運用環境では、 render() context.template.engine.debug True django.template.TemplateSyntaxError
\n最終的に、コンパイルとレンダリングを切り離すことで、効率的なテンプレートシステムが実現します。なぜなら、テンプレートは何度もパースされることなく、複数のコンテキストをレンダリングできるからです。
\n \n\nテンプレートタグからの出力は自動エスケープフィルタに自動的に通されることは ありません (上で説明した simple_tag()
\nテンプレートタグの render() mark_safe()
\nまた、テンプレートタグがサブレンダリングを行うために新しいコンテキストを作成する場合、auto-escape 属性に現在のコンテキストの値を指定します。 Context __init__ autoescape
\nCode Copy
from django.template import Context \n\n\ndef render ( self , context ): \n # ... \n new_context = Context ({ "var" : obj }, autoescape = context . autoescape ) \n # ... Do something with new_context ... \nこれはあまり一般的な状況ではありませんが、テンプレートを自分でレンダリングする場合に便利です。例えば:
\nCode Copy
def render ( self , context ): \n t = context . template . engine . get_template ( "small_fragment.html" ) \n return t . render ( Context ({ "var" : obj }, autoescape = context . autoescape )) \nもしこの例で、現在の context.autoescape Context 常に 自動的にエスケープされていたでしょう。これは、テンプレートタグが {% autoescape off %}
\n \n\nノードがパースされると、その render
\nテンプレートタグを常にスレッドセーフに保つため、ノード自体に状態情報を保存してはいけません。例えば、 Django にはレンダリングされる度に与えられた文字列のリストを循環させる cycle
\nDjango template Copy
{% for o in some_list %} \n < tr class = " {% cycle 'row1' 'row2' %} " > \n ...\n </ tr > \n{% endfor %} \nナイーブな CycleNode
\nCode Copy
import itertools \nfrom django import template \n\n\nclass CycleNode ( template . Node ): \n def __init__ ( self , cyclevars ): \n self . cycle_iter = itertools . cycle ( cyclevars ) \n\n def render ( self , context ): \n return next ( self . cycle_iter ) \nしかし、上のテンプレートコードを同時にレンダリングする2つのテンプレートがあるとします:
\n\nスレッド1が最初のループを実行し、 CycleNode.render()
スレッド2が最初のループを実行し、 CycleNode.render()
スレッド1が2回目のループを実行し、 CycleNode.render()
スレッド2が2回目のループを実行し、 CycleNode.render()
\nCycleNodeは反復していますが、グローバルに反復しています。スレッド1とスレッド2に関しては、常に同じ値を返しています。これは私たちが望んでいることではありません！
\nこの問題に対処するために、 Django は render_context render_context context render_context render Node
\nCycleNode render_context
\nCode Copy
class CycleNode ( template . Node ): \n def __init__ ( self , cyclevars ): \n self . cyclevars = cyclevars \n\n def render ( self , context ): \n if self not in context . render_context : \n context . render_context [ self ] = itertools . cycle ( self . cyclevars ) \n cycle_iter = context . render_context [ self ] \n return next ( cycle_iter ) \nNode CycleNode Node cyclevars render_context CycleNode render_context
\n\n注釈
\nself render_context CycleNode CycleNode render_context self render_context[self]
\n \n \n\n\n最後に、上記の カスタムテンプレートタグを書く Library
\nCode Copy
register . tag ( "current_time" , do_current_time ) \ntag()
\n\nテンプレート タグの名前の文字列。これを省略した場合は、コンパイル関数の名前が使用されます。
編集用の関数 -- Python の関数です (文字列としての関数名ではありません)。
\nフィルタ登録と同様に、これをデコレータとして使うこともできます。
\nCode Copy
@register . tag ( name = "current_time" ) \ndef do_current_time ( parser , token ): ... \n\n\n@register . tag \ndef shout ( parser , token ): ... \nname
\n \n\n\ntoken.split_contents()
\n前の例では現在時刻を文字列にフォーマットして文字列として返しましたが、オブジェクトから DateTimeField
\nDjango template Copy
< p > This post was last updated at {% format_time blog_entry.date_updated "%Y-%m-%d %I:%M %p" %} .</ p > \n最初に、token.split_contents()
\n\nタグ名 format_time
文字列 'blog_entry.date_updated'
フォーマット文字列 '"%Y-%m-%d %I:%M %p"' split_contents()
\nこれで、タグは次のようになります。
\nCode Copy
from django import template \n\n\ndef do_format_time ( parser , token ): \n try : \n # split_contents() knows not to split quoted strings. \n tag_name , date_to_be_formatted , format_string = token . split_contents () \n except ValueError : \n raise template . TemplateSyntaxError ( \n " %r tag requires exactly two arguments" % token . contents . split ()[ 0 ] \n ) \n if not ( format_string [ 0 ] == format_string [ - 1 ] and format_string [ 0 ] in ( '"' , "'" )): \n raise template . TemplateSyntaxError ( \n " %r tag's argument should be in quotes" % tag_name \n ) \n return FormatTimeNode ( date_to_be_formatted , format_string [ 1 : - 1 ]) \nblog_entry date_updated django.template Variable()
\nVariable variable.resolve(context)
\nCode Copy
class FormatTimeNode ( template . Node ): \n def __init__ ( self , date_to_be_formatted , format_string ): \n self . date_to_be_formatted = template . Variable ( date_to_be_formatted ) \n self . format_string = format_string \n\n def render ( self , context ): \n try : \n actual_date = self . date_to_be_formatted . resolve ( context ) \n return actual_date . strftime ( self . format_string ) \n except template . VariableDoesNotExist : \n return "" \nページの現在のコンテキスト内で渡された文字列が解決できない場合、変数を解決しようとすると VariableDoesNotExist
\n \n\n\n上記の例は値を出力します。一般に、テンプレートタグは値を出力する代わりに、テンプレート変数を設定するほうがより柔軟です。それにより、テンプレートの作者はテンプレートタグが作成した値を再利用できるようになります。
\nコンテキスト内に変数を設定するには、render() current_time CurrentTimeNode
\nCode Copy
import datetime \nfrom django import template \n\n\nclass CurrentTimeNode2 ( template . Node ): \n def __init__ ( self , format_string ): \n self . format_string = format_string \n\n def render ( self , context ): \n context [ "current_time" ] = datetime . datetime . now () . strftime ( self . format_string ) \n return "" \nrender() render() render()
\nこの新しいバージョンのタグの使い方はこちらです。
\nDjango template Copy
{% current_time "%Y-%m-%d %I:%M %p" %} < p > The time is {{ current_time }} .</ p > \n\nコンテキスト内の変数のスコープ
\nコンテキストに設定された変数は、その変数が割り当てられたテンプレートの同じ block
\n \nしかし、 CurrentTimeNode2 current_time {{ current_time }} {% current_time %}
\nDjango template Copy
{% current_time "%Y-%m-%d %I:%M %p" as my_current_time %} \n< p > The current time is {{ my_current_time }} .</ p > \nそのためには、コンパイル関数と Node
\nCode Copy
import re \n\n\nclass CurrentTimeNode3 ( template . Node ): \n def __init__ ( self , format_string , var_name ): \n self . format_string = format_string \n self . var_name = var_name \n\n def render ( self , context ): \n context [ self . var_name ] = datetime . datetime . now () . strftime ( self . format_string ) \n return "" \n\n\ndef do_current_time ( parser , token ): \n # This version uses a regular expression to parse tag contents. \n try : \n # Splitting by None == splitting by spaces. \n tag_name , arg = token . contents . split ( None , 1 ) \n except ValueError : \n raise template . TemplateSyntaxError ( \n " %r tag requires arguments" % token . contents . split ()[ 0 ] \n ) \n m = re . search ( r "(.*?) as (\\w+)" , arg ) \n if not m : \n raise template . TemplateSyntaxError ( " %r tag had invalid arguments" % tag_name ) \n format_string , var_name = m . groups () \n if not ( format_string [ 0 ] == format_string [ - 1 ] and format_string [ 0 ] in ( '"' , "'" )): \n raise template . TemplateSyntaxError ( \n " %r tag's argument should be in quotes" % tag_name \n ) \n return CurrentTimeNode3 ( format_string [ 1 : - 1 ], var_name ) \nここでの違いは、 do_current_time() CurrentTimeNode3
\n最後に、コンテキストを更新するカスタムテンプレートタグの簡単な構文が必要なだけなら、 simple_tag()
\n \n\n\nテンプレートタグは連動して動作します。例えば、標準の {% comment %} {% endcomment %} parser.parse()
\n以下は {% comment %}
\nCode Copy
def do_comment ( parser , token ): \n nodelist = parser . parse (( "endcomment" ,)) \n parser . delete_first_token () \n return CommentNode () \n\n\nclass CommentNode ( template . Node ): \n def render ( self , context ): \n return "" \n\n注釈
\n実際の {% comment %} {% comment %} {% endcomment %} parser.parse(('endcomment',)) parser.skip_past('endcomment') parser.delete_first_token()
\n \nparser.parse() django.template.NodeList Node
\n上の例 "nodelist = parser.parse(('endcomment',))" nodelist {% comment %} {% endcomment %} {% comment %} {% endcomment %}
\nparser.parse() {% endcomment %} parser.delete_first_token()
\nCommentNode.render() {% comment %} {% endcomment %}
\n \n\n\n先ほどの例では、 do_comment() {% comment %} {% endcomment %}
\n例えば、これはカスタムテンプレートタグ {% upper %} {% endupper %}
\n使い方:
\nDjango template Copy
{% upper %} This will appear in uppercase, {{ your_name }} .{% endupper %} \n上の例と同様に parser.parse() nodelist Node
\nCode Copy
def do_upper ( parser , token ): \n nodelist = parser . parse (( "endupper" ,)) \n parser . delete_first_token () \n return UpperNode ( nodelist ) \n\n\nclass UpperNode ( template . Node ): \n def __init__ ( self , nodelist ): \n self . nodelist = nodelist \n\n def render ( self , context ): \n output = self . nodelist . render ( context ) \n return output . upper () \nここで唯一の新しい概念は、UpperNode.render() self.nodelist.render(context)
\n複雑なレンダリングの追加の例としては、django/template/defaulttags.py 内の {% for %} django/template/smartif.py 内の {% if %}
\n \n ","rootId":"how-to-create-custom-template-tags-and-filters","toc":[{"title":"コードのレイアウト","anchor":"code-layout","children":[]},{"title":"独自のテンプレートフィルタを記述する","anchor":"writing-custom-template-filters","children":[{"title":"独自のフィルタを登録する","anchor":"registering-custom-filters","children":[]},{"title":"文字列を要するテンプレートフィルタ","anchor":"template-filters-that-expect-strings","children":[]},{"title":"フィルタと自動エスケープ","anchor":"filters-and-auto-escaping","children":[]},{"title":"フィルタとタイムゾーン","anchor":"filters-and-time-zones","children":[]}]},{"title":"独自のテンプレートタグを記述する","anchor":"writing-custom-template-tags","children":[{"title":"シンプルなタグ","anchor":"simple-tags","children":[]},{"title":"Inclusion tag (インクルージョン・タグ)","anchor":"inclusion-tags","children":[]},{"title":"高度なカスタムテンプレートタグ","anchor":"advanced-custom-template-tags","children":[]},{"title":"簡単な概要","anchor":"a-quick-overview","children":[]},{"title":"コンパイル関数の書き方","anchor":"writing-the-compilation-function","children":[]},{"title":"レンダラーの書き方","anchor":"writing-the-renderer","children":[]},{"title":"自動エスケープに関する注意点","anchor":"auto-escaping-considerations","children":[]},{"title":"スレッド安全性の考慮","anchor":"thread-safety-considerations","children":[]},{"title":"タグを登録する","anchor":"registering-the-tag","children":[]},{"title":"テンプレート変数をタグに渡す","anchor":"passing-template-variables-to-the-tag","children":[]},{"title":"コンテキスト内で変数を設定する","anchor":"setting-a-variable-in-the-context","children":[]},{"title":"他のブロックタグまでパースする","anchor":"parsing-until-another-block-tag","children":[]},{"title":"別のブロックタグまでのパースと内容の保存","anchor":"parsing-until-another-block-tag-and-saving-contents","children":[]}]}],"breadcrumbs":[{"docname":"howto/index","title":"「How-to」ガイド","url":"/ja/5.0/howto/"}],"prev":{"docname":"howto/custom-template-backend","title":"テンプレートのバックエンドをカスタマイズする","url":"/ja/5.0/howto/custom-template-backend/"},"next":{"docname":"howto/custom-file-storage","title":"カスタムのストレージクラスを書く","url":"/ja/5.0/howto/custom-file-storage/"},"formats":{"html":"/ja/5.0/howto/custom-template-tags/","markdown":"/ja/5.0/howto/custom-template-tags.md","json":"/ja/5.0/howto/custom-template-tags.json"},"source":"https://github.com/django/django/blob/stable/5.0.x/docs/howto/custom-template-tags.txt","official":"https://docs.djangoproject.com/ja/5.0/howto/custom-template-tags/","inVersions":["6.1","6.0","5.2","5.1","5.0","4.2","4.1","4.0","3.2","3.1","3.0","2.2","2.1","2.0","1.11","1.10","1.9"],"inLocales":["en","zh-hans","fr","ja","id","it","pt-br","ko","es","el","pl"]}