【Django】テンプレート：タグとは（タグ一覧・使い方）

if, elif, else：条件分岐

ifタグ、elifタグ、elseタグを組み合わせて利用することで、条件による分岐処理をおこなえます。

ifタグはフィルターを利用することができます。フィルターを組み合わせて利用することで応用が利くようになります。

for：ループ

開始タグ{% for … %}と終了タグ{% endfor %}の間に記述されたプログラムをループさせます。

forループは以下のようにリストの各要素にアクセスして、リストの要素数だけループを回します。

{% for book in books %}
    {{  book.title  }}
    {{  book.price  }}
{% endfor %}

forタグによるループのより詳しい解説は以下記事をご参照ください。

【Django】テンプレートタグ：forタグによるループの利用方法

extends, block, include：テンプレートの継承

テンプレートでは全ページで共通する部分を共通テンプレートにまとめます。これにより各ページで共通部分を何度も書く必要がなくなります。

これを「テンプレートの継承」と呼びます。

このテンプレートの継承で利用されるタグが「extendsタグ」、「blockタグ」、「includeタグ」です。

テンプレートの継承について詳しくは以下記事をご参照ください。

【django】テンプレートの継承：block・extends・includeによる共通化

comment：コメント

説明文などのコードとは無関係のコメントを無視させたい場合はcommentタグを利用します。

load：カスタムテンプレートタグの読み込み

loadタグはカスタムテンプレートタグの読み込みをおこないます。

基本的にはテンプレートの先頭に記述します。また共有テンプレート（継承元のテンプレート）に記述していた場合でも、自身のテンプレートに記述する必要があります。

staticタグを利用する場合は、必ずloadタグで読み込んでおく必要があります。

static：静的ファイルのURL取得

staticタグは静的ファイルのURL取得に使用されます。静的ファイルとは画像やCSS、Javascriptなどのことです。

テンプレート内で画像を表示する場合は次のように使用します。

<img src="{% static "app/image.jpg" %}" alt="image">

すでに述べていますが、staticタグを利用するにはloadタグでstaticを読み込んでいる必要があります。

{% load static %}

url：URLの逆引き

urlタグはURLconf（urls.py）に記述されたURLパターン名からURLを逆引きします。

URLパターン名とはURLconfの中でnameで指定された名前です。

path("<int: id>/", views.detail, name="detail")

# この場合urlタグは次のように記載

{% url ‘detail’ id=1 %}

引数には上記のようにURLパターンにパスコンバータや正規表現が含まれている場合に引数に値を指定しURLパターンがマッチするようにします。

csrf_token：CSRF対策

Djangoでフォームを利用した際は必ずcsrf_tokenタグを使用します。

{% csrf_token %}

CSRF（Cross Site Request Forgeries）対策として必ずフォーム内にcsrf_tokenタグを入れるようにしましょう。

now：現在の日時

nowタグは指定したフォーマット文字列に従って現在の日時を表示します。

{% now フォーマット文字列 %}