wp_get_loading_optimization_attributes

パラメータ

• $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' );

フィルター

$wp_min_priority_img_pixels = apply_filters( 'wp_min_priority_img_pixels', $threshold );

アクション

ソースファイル