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

※本サイトにはプロモーション・広告が含まれています。

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

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

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

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

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

  • __str__メソッドとは?
  • __str__メソッドの書き方
  • __str__メソッドの実例

✔YouTube解説動画

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

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

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

運営者プロフィール

運営者プロフィールアイコン

現在はIT企業のプロダクトマネージャーとして、個人向け/社内向けシステムなど、複数のシステム開発・運営に携わっています。

Webサイト構築やECサイトの開発経験に加えて、PythonなどのプログラミングやSalesforceなどのクラウドアプリケーションに関する幅広い知識・経験を活かして「プログラミング初心者がスムーズに学べるサイト」を目指しています。

Githubでは、趣味で作成したアプリなどを公開しています。

https://github.com/Yulikepython/

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

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

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

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

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

__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ファイルを表示する方法についてまずは解説していきます

タイトルとURLをコピーしました