get_intermediate_image_sizes() の使い方|説明・引数・注意点

説明

get_intermediate_image_sizes() は、登録されているすべての画像サイズ名を返す関数です。

基本構文

get_intermediate_image_sizes(): string[]

引数

引数はありません。

戻り値

サイズ名の配列。

使い方(サンプル)

$sizes = get_intermediate_image_sizes();

注意点

  • 標準の thumbnail、medium、large に加え、独自サイズも含まれます。

実務での使いどころ

  • 登録されている画像サイズの、名前の一覧を取得するとき。
  • サイズ選択の、プルダウンを作るとき。

よくあるミスと対処

  • サイズ名の配列だけが返る。幅や高さは、含まれない。
  • 追加の処理より前に呼び、一覧に出てこない。

NG例

$sizes = get_intermediate_image_sizes();
echo $sizes['card']['width']; // 名前の配列で、幅は含まれない

OK例

$sizes = get_intermediate_image_sizes();
foreach ( $sizes as $name ) {
	echo esc_html( $name );
}

使い分け早見表

やりたいこと 使うもの
登録されているサイズ名を取得 get_intermediate_image_sizes()
サイズを追加 add_image_size()
サイズを削除 remove_image_size()

関連項目

add_image_size()、wp_get_attachment_image_src()

公式リファレンス:get_intermediate_image_sizes() | Function | WordPress Developer Resources

コメント

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