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

説明

基本構文

wp_is_mobile(): bool

引数

引数はありません。

戻り値

モバイルなら true。

使い方（サンプル）

if ( wp_is_mobile() ) {
	// モバイル向けの処理
}

注意点

• ユーザーエージェントによる簡易判定です。ページキャッシュを使っていると、判定結果が混在する恐れがあります。
• レイアウトの切り替えには、CSSのメディアクエリが推奨です。

実務での使いどころ

• スマートフォン・タブレットだけに、別の表示を出すとき（サーバー側の判定）。

よくあるミスと対処

• ユーザーエージェントでの判定のため、正確ではない。レイアウトの切り替えには、CSSのメディアクエリを使う。
• タブレットも、true になる場合がある。
• ページキャッシュされるページで使い、他の端末のキャッシュが、表示される。

NG例

if ( wp_is_mobile() ) {
	// レイアウトの切り替えを、PHPで行っている
}

OK例

/* CSS */
@media (max-width: 768px) {
	.sidebar { display: none; }
}

使い分け早見表

関連項目

is_admin()、wp_is_json_request()

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