1
1

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

More than 3 years have passed since last update.

【Django】Build web apps ~4章:Templates・Static filesとサイト設計~

Last updated at Posted at 2020-02-25

Templates

~~ヾ(^∇^)こんにちは~

以前の記事にDjangoウェブサイトアプリのモデルとデータベースについて勉強できましたね
続いて今日はウェブサイトのテンプレートを学びに行こうと思います

HTMLを動的に生成する必要である為、最も一般的なアプローチはテンプレートに依存しています
テンプレートには目的のHTML出力の静的部分と動的コンテンツの挿入方法を説明する特別な構文が含まれています

テンプレートを使うDjangoプロジェクトは1つ又は複数のテンプレートエンジンで構成できます
DjangoにはDjangoテンプレート言語(DTL)と一般的な代替Jinja2の組み込みバックエンドが付属しています

テンプレートエンジンのサポート

Djangoで使用されるすべてのテンプレートエンジンの設定を含むリストはsetting.pyにてデフォルトTEMPLATES変数で構成されます。
image.png

簡単にテンプレート使ってみよう

まず、アプリケーション内にtemplatesフォルダ(固定名)を作成してここにてテンプレートファイルを準備しておきます

templates
myproject
├── myproject
├── myapp
├── manage.py
└── templates
    └── food
        ├── index.py
        └── detail.py

index.html

image.png
ここまで静的部分のみがあるテンプレートを作成しました、次はテンプレートを使うviews.pyを修正します
ポイントはrenderメソッドです

views.py

food/views.py
from django.shortcuts import render
from django.http import HttpResponse
from .models import Item

# Create your views here.
# index.html
def index(req):
    template_name = "food/index.html";
    context = {}
    return render(req, template_name, context)

renderメソッドを読んでDjangoはtemplatesフォルダにtemplate_nameを探して見つかったファイルにcontextをアプローチした後テンプレートを表すという流れの処理です。
image.png

Contextをアプローチする方法とは

context変数の値を編集します

food/views.py
from django.shortcuts import render
from django.http import HttpResponse
from .models import Item

# Create your views here.
# index.html
def index(req):
    template_name = "food/index.html";
    context = {
        'title': 'Index',
        'item_list': Item.objects.all()
    }
    return render(req, template_name, context)

テンプレートを編集します
Djangoテンプレート言語と利用します、詳しくは[「Django template language」]
(https://docs.djangoproject.com/en/3.0/ref/templates/language/)を参考してね
image.png
注意、
目的なページにcontextオブジェクトのキーを呼びます。又は各テンプレートに同じblock名を2つ以上持つとは行きません

異常
<!-- block content1 -->
{% block content %}
...
{% endblock %}

<!-- block content2 -->
{% block content %}
...
{% endblock %}
正常
<!-- block head -->
{% block head %}
...
{% endblock %}

<!-- block content -->
{% block content %}
...
{% endblock %}

image.png

detail.html

ほぼ同じルールでdetail.htmlファイルを編集しましょ
動く順番は、index.htmlにて対象なitemを選らんでitemの詳しく情報を持つdetail.htmlが表せます
このでHTMLの知識が必要ですので準備しておいてね
それではやろう

:information_desk_person_tone2:index.htmlを編集します
image.png
こういう風に同じdetail.htmlファイルを呼びますが異なるdetail.html URLがあり、item_idにようって情報が自動的に変るというテンプレートエンジンの特徴です
URLは http://localhost:8000/food/[item_id]/
覚えてますか2章にページを呼び出すのを解説しますたが忘れたら「2章:ViewsとURL Patterns」を参考してね

:information_desk_person_tone2:urls.pyを編集します

food/urls.py
from . import views
from django.urls import path

urlpatterns = [
    # index.html
    path('', views.index, name='index'),
    # 
    path('item/', views.item, name='item'),
    # detail.html
    path('<int:item_id>/', views.detail, name='detail')
]

:information_desk_person_tone2:views.pyを編集します

food/views.py
from django.shortcuts import render
from django.http import HttpResponse
from .models import Item

# detail.html
def detail(req, item_id):
    template_name = "food/detail.html"
    context = {
        'item': Item.objects.get(pk=item_id)
    }
    return render(req, template_name, context)

:information_desk_person_tone2:detail.htmlを編集します
image.png

結果を見よう
image.png

URLsにあるNameとApp_name

Nameを使います

food/urls.py
urlpatterns = [
    # detail.html
    path('<int:item_id>/', views.detail, name='detail')
]

index.htmlを修正します
image.png
{% url 'name' variable %}

App_nameを使います

food/urls.py
app_name = 'food'
urlpatterns = [
    # detail.html
    path('<int:item_id>/', views.detail, name='detail')
]

index.htmlを修正します
image.png
{% url 'app_name:name' variable %}

Staticファイル

Staticファイルとは

Webサイトは通常にimage、js、cssなどの追加ファイルを提供する必要があります。Djangoでは、これらのファイルを「静的ファイル」と呼びます

Staticファイルの管理を支援するを確認します
settings.pyファイルにあるINSTALLED_APPS変数の値はdjango.contrib.staticfilesがあります
image.png

StaticファイルへディレクトリーURLを確認します
settings.pyファイルにあるSTATIC_URL変数の値は/static/があります
image.png
つまり、静的ファイルはstaticフォルダに置くべきです

Staticファイルの利用方法

以下のようにstaticファイルを準備しておきましょ

static
myproject
├── myproject
├── myapp
├── manage.py
├── templates
└── static
    └── myapp
        └── css
            └── body.css
body.css
body {
    background-color: rgb(198, 233, 235);
}

Staticファイルを呼び出します
テンプレートに指定するstaticファイルのULRを作成します
{% static "static fileのULR" %}

テンプレート
{% load static %}
<link rel="stylesheet" href="{% static "/food/css/body.css" %}"/>

結果を確認します
image.png
staticファイルを利用するテンプレートが作成されましたよね
最も分かればManaging static filesサイトをご参考下さい

サイトをデザインします

ページの構成

簡単なページにはを3つに分割されています

page.html
page.html
├── head
├── body
└── footer

で、共通部分を別のページを置いて各ページにそのページを購入するというイメージです

templates
templates
└── food
    ├── base.html  # (head・footer部分があり)
    └── page.html  # (body部分のみ)

実際はどういう風に構成しますか、以下のように御覧ください

共通ページの仕組み

base.html
{% load static %}
<!DOCTYPE html>
<html lang="en">
<head>
<!-- ヘッダーのコンテンツはここに記述します -->
</head>

{% block body %}
{% endblock %}

<footer>
<!-- フッターのコンテンツはここに記述します -->
</footer>
</html>

各ページの仕組み

page.html
{% extends 'food/base.html' %}
<body>
    {% block body %}
    <!-- ボディのコンテンツはここに記述します -->
    {% endblock %}
</body>

{% extends 'template fileのURL' %}

では、試してみよう~

Bootstrapを使おう

サイトは綺麗で早く作れるため、フロントエンドフレームワークを使いましょ~
この記事はBootstrapフレームワークを使って行ないます
BootstrapをダウンロードするページにてBootstrapCDNのダウンロードはCSSとJSダウンロードリンクをコピーします

BootstrapCDN
<link rel="stylesheet" 
href="https://stackpath.bootstrapcdn.com/bootstrap/4.4.1/css/bootstrap.min.css" 
integrity="sha384-Vkoo8x4CGsO3+Hhxv8T/Q5PaXtkKtu6ug5TOeNV6gBiFeWPGFN9MuhOf23Q9Ifjh" 
crossorigin="anonymous">
<script src="https://stackpath.bootstrapcdn.com/bootstrap/4.4.1/js/bootstrap.min.js" 
integrity="sha384-wfSDF2E50Y2D1uUdj0O3uMBJnjuUD4Ih7YwaYd1iqfktj0Uod8GCExl3Og8ifwB6" 
crossorigin="anonymous"></script>

コピーしたリンクはbaseテンプレートファイルにペーストします
image.png
これからBootstrapさんを提供するCSSとJSファイルを利用できます

Base.htmlを作成

headタグにてNavコンポネントを作成します
image.png

各ページを編集します

index.html
image.png

detail.html
image.png

結果を確認します
indexページ
image.png

detailページ
image.png

お疲れ様です

此処まで御覧いただきまして有難うございます

参考サイト
[・Django template language]
(https://docs.djangoproject.com/en/3.0/ref/templates/language/)
・Django support for template engines
・Jinja2

関連記事
・【Django】Build web apps ~3章:Modelsとデータベース~
・【Django】Build web apps ~5章:Forms~
・【Django】Build web apps ~使ったコマンド~

1
1
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
1
1

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?