説明
array wp_get_loading_optimization_attributes( string $tag_name, array $attr, string $context )
ローディング関連の最適な属性を取得する。
パラメータ
- $tag_nameタグ名（'img'、'iframe'）を指定。
- $attr各属性を格納した連想配列を指定。
- $context使用場所を示すコンテキストを指定。
返り値
ローディング関連の最適な属性を格納した連想配列を返す。パラメータ$contentが'template'か、$tag_nameが'img'または'iframe'以外か、$attrに'width'および'height'キーがない場合は空の配列を返す。
注意
img要素やiframe要素向けにローディング関連の最適な属性を取得する際に使用する。
パラメータ$attrの'loading'キーに'lazy'が、'fetchpriority'キーに'high'の両方を格納されている場合、警告メッセージが表示される。
パラメータ$attrの'loading'、'fetchpriority'の値、呼び出された画像ファイル数、$context、特定アクションの実行中・実行後などが影響する。
$contextの内容により、'wp_min_priority_img_pixels'フィルターの返り値と$attr['width'] * $attr['height']が比較され、後者が大きい（以上）の場合はカウントを進める。そのカウントは wp_omit_loading_attr_threshold関数の返り値と比較され、fetchpriorityキー（値が'high'）を適用する際の条件の1つとなっている。
wp_lazy_loading_enabled関数がfalseの場合、本関数の返り値の連想配列から'loading'キーが取り除かれる。
使用例
- ローディング関連の最適な属性を取得する
$loading_attr = wp_get_loading_optimization_attributes( 'img', $attr, 'the_content' );
フィルター
[6.3.0]いくつかの条件下で'wp_min_priority_img_pixels'フィルターを呼び出す。パラメータ$thresholdには初期値50000が格納されている。$wp_min_priority_img_pixels = apply_filters( 'wp_min_priority_img_pixels', $threshold );アクション
直接実行するアクションはありません。ソースファイル
/wp-includes/media.php最終更新 : 2023年08月11日 17:31
関連
お勧め
カスタムフィールドで並び替え（2013年8月9日 更新）
WordPressでは複数の投稿記事を取得する際、並び順の指定を省略すると投稿日時の降順になる。並び順は、投稿日時だけでなく、更新日時、投稿名、記事タイトル、コメント数のほか、カスタムフィールドも指定できる。
タイトルのみをキーワード検索する（2014年4月3日 更新）
WordPressのキーワード検索は、投稿タイトルと本文のどちらかに指定したキーワードが含まれているかを調べるわけだが、時々タイトルだけとか、逆に本文だけ検索したいケースがある。
開発環境（Windows 8）にimagickを入れる（2012年12月23日 更新）
WordPress 3.5のイメージエディタ（WP_Image_Editor）は、GDだけでなく、imagick（ImageMagick）にも対応している。そんなわけでWindows 8の開発環境にimagickをインストールしてみた。ページを表示する直前の前処理にtemplate_redirectアクションを（2013年4月13日 更新）
リクエストに応じてページを表示する直前の準備として何かしらの処理を行っておきたいケースがある。そんな時、テーマの各テンプレートファイルの先頭部分に処理内容をずらずらと記述していませんか。Slightly troublesome permalink：プラグイン作ってみました（2021年4月20日 更新）
カテゴリーを含んだパーマリンクを設定している場合、複数のカテゴリーを指定した投稿記事のパーマリンクのURLに目的のカテゴリーとは異なるカテゴリーが適用された経験はないだろうか。このプラグインは、パーマリンクに適用されるカテゴリーをコントロールし、希望通りのパーマリンクを設定します。