サイトアイコン ITC Media

【実例付】Djangoの__str__メソッドの書き方を徹底解説

(最終更新月:2021年12月)

✔当記事は以下のような方に向けて書かれています

「アドミンページの保存データ一覧が見にくい!」

「__str__メソッドって聞いたことあるけど、何なのかよくわからない!」

✔当記事を通じてお伝えすること

✔YouTube解説動画

当記事の内容は動画を見ながら進めると、約15分程度で完了します。

動画ならではの情報も解説しているので、記事と一緒にご覧ください。

動画の概要欄には、単元ごとのコードを紹介しているgithubページも載せています。

筆者プロフィール

【現職】プロダクトマネージャー

【副業】ブログ(月間20万PV)/YouTube/Web・アプリ制作

「プログラミング × ライティング × 営業」の経験を活かし、30後半からのIT系職へシフト。現在はプロダクトマネージャーとして、さまざまな関係者の間に入り奮闘してます。当サイトでは、実際に手を動かせるWebアプリの開発を通じて、プログラミングはもちろん、IT職に必要な情報を提供していきます。

【当ブログで紹介しているサイト】

当サイトチュートリアルで作成したデモ版日報アプリ

Django × Reactで開発したツール系Webアプリ

✔人に見せても恥ずかしくないコードを書こう

「リーダブルコード」は、わかりやすく良いコードの定義を教えてくれる本です。

  • 見るからにきれいなコードの書き方
  • コードの分割方法
  • 変数や関数の命名規則

エンジニアのスタンダートとすべき基準を一から解説しています。

何回も読むのに値する本なので、ぜひ手にとって読んでみてください。

__str__メソッドとは?

保存したオブジェクトに名前をつける

役割だと覚えておきましょう

__str__メソッドを使わないと、

どれがどの日報かわかりません

__str__メソッドを記述すると、

など自由に名前をつけることができます(この場合は「タイトル」をそのまま名前としています)

次章で書き方を解説します

__str__メソッドの書き方

書き方はとてもカンタン!

モデルクラス内で、

def __str__(self):
    return "付けたい名前"

となります

例えば

def __str__(self):
    return "新しい日報です"

とすると、

とすることができます

ただしこれでは、「名前を付ける」という意味では上手くいってません

次章で実際の例をご覧頂き参考にして頂ければと思います

開発中の日報アプリでは、下記の通りとします

class NippoModel(models.Model):
    title = ...
    ....

    def __str__(self):
        return self.title

ブラウザでアクセスすると、

となります

ポイントとしては、モデルクラスのフィールド名を使う場合、

self.フィールド名

と必ず引数で受け取った「self」をつけるようにしましょう

まとめ

__str__メソッドの役割は、

それぞれのオブジェクトに名前をつける

ことです

書き方で気を付けることは、

フィールド名の前に「self」をつける

ことです

しっかりとポイントを押さえればとてもカンタン!

お好きな名前を付けて次へ進みましょう!

さて、次の記事では、いよいよ一般ユーザー向けのページ作りを始めていきます

Pythonをベースとした.pyファイルとこれから作る.htmlファイルを連動して、HTMLファイルを表示する方法についてまずは解説していきます

モバイルバージョンを終了