the_ID() の使い方｜説明・引数・注意点

説明

基本構文

the_ID(): void

引数

引数はありません。

戻り値

戻り値はありません（出力します）。

使い方（サンプル）

// ループ内で使用
the_ID();

注意点

• 値を変数に入れるときは get_the_ID() を使います。
• id="post-ID" のように、HTMLの属性値に使うことが多い関数です。

実務での使いどころ

• HTMLの id 属性に、投稿IDを付けるとき（id="post-<?php the_ID(); ?>"）。
• ループの中で、投稿IDを出力するとき。

よくあるミスと対処

• 値として使いたいのに、これを使っている。the_ID() は出力するだけ。値は get_the_ID() を使う。
• ループの外で呼び、何も出力されない。

NG例

$id = the_ID(); // 値は返らず、出力されるだけ

OK例

$id = get_the_ID();

使い分け早見表

関連項目

get_the_ID()、post_class()

公式リファレンス：the_ID() | Function | WordPress Developer Resources