デフォルト表示

{{ user.first_name|default:"" }} {{ user.first_name|default:"" }}

• 変数が存在しない場合、あるいは変数の値が None, '', 0, False, [] などの場合に指定した文字列を表示する

文字列長を表示

{{ user.username|length }}

エスケープの無効化

{{ book.description|safe }}

• XSS 対策として自動でエスケープしてくれる <, >, ', ", & をエスケープしない

• 変数の内容が安全だとわかっている場合のみ利用すること

日時フォーマット

{{ user.last_login|date:"Y-m-d H:i:s" }}

改行タグの変換

{{ book.description|linebreaksbr }}

• \n を <br> に変換してくれる

• 便利だな...

リンク変換

{{ book.description|urlize }}

• URL と メールアドレスの部分だけをアンカータグで囲んでクリック可能なリンクに変換してくれる

• しゅごいな...

文字の切り詰め

{{ book.description|truncatechars_html:5 }}

• 指定した文字数まで切り詰めて ... をくっつけてくれる

• HTML タグを考慮して省略後の文字にきちんと閉じタグをつけてくれる

• うええ...

if

{% if user.is_superuser %}
  システム管理者です。
{% elif user.is_staff %}
  スタッフです。
{% else %}
  一般ユーザーだよ。
{% endif %}

{# フィルタと組み合わせることもできる #}
{% if user.username|length < 3 %}
  ユーザー名が短かすぎます。
{%  endif %}

for

{% for book in book_list %}
  {{ book.title }}

  {# for ループ内で使える変数 #}
  {{ forloop.counter }}     {# 現在のループカウンタ番号 ( 1 から順にカウント ) #}
  {{ forloop.counter0 }}    {# 現在のループカウンタ番号 ( 0 から順にカウント ) #}
  {{ forloop.revcounter }}  {# 現在のループカウンタ値 ( 1 から順に、末尾からカウント) #}
  {{ forloop.revcounter0 }} {# 現在のループカウンタ値 ( 0 から順に、末尾からカウント) #}
  {{ forloop.first }}       {# 最初のループであれば True #}
  {{ forloop.last }}        {# 最後のループであれば True #}
  {{ forloop.parentloop }}  {# 入れ子のループであるとき、現在のループを囲んでいる 1 つ上のループを表します。 #}

{%  empty %}
  本ない
{%  endfor %}

テンプレートの継承

• 親テンプレート parent.html

  {% block sample %}Hello {% endblock %}
  

• 子テンプレート child.html

  {% extends "parent.html" %}
  {% block sample %}{{ block.super }World! {% endblock %}
  {# block.super: 親テンプレートのブロック内部の値をそのまま保持した変数 #}
  

外部テンプレートの読み込み

{% include "_message.html" %}

• ヘッダーフッターなど部品化したテンプレートを別のテンプレートから読み込む場合など

静的ファイルの配信 URL 取得

{# 利用する前に機能をロードしておく #}
{% load static %}
{% static "images/logo.png" %}
{% static "shop/images/no-image.png" %}

• 静的ファイルの配信 URL を取得するためのタグ

• Django デフォルトで使える組み込みタグではないのでロードが必要

• extends している場合、継承元で load していても自身のテンプレートでは有効にならないので、 つど load する必要がある

url

{# URL 逆引き #}
{% url "index" %}
{% url "accounts:login" %}
{% url "shop:detail" book.id %}
{% url "shop:detail" book_id=book.id %}

自動エスケープ制御

{% autoescape off %}
  自動エスケープがオフになる範囲
{% endautoescape %}