wp_get_loading_optimization_attributes

説明

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



お勧め

ブロックエディターの色設定を変えてみる(2019年12月11日 更新)

バージョン5.3で機能強化されたブロックエディター。対応を考えて新テーマ「Twenty Twenty」のソースコードを眺めていく。

「姓」の後に「名」を(2013年11月6日 更新)

WordPressのユーザー情報設定ページでは、「名(First name)」の後に「姓(Last name)」を入力するようになっている。日本向けのユーザー登録できるサイトの場合、この並び順はちょっと違和感があるので、「姓」「名」の順に入力できるようにした。

ホームディレクトリから過去のファイルを削除する(2013年1月27日 更新)

WordPressで構築したサイトのホームディレクトリには、現在使われていないファイルが残っている時がある。3.5.1もリリースされたことだし、これを機にホームディレクトリを整理整頓した。

Login rebuilder 2.6.5の新機能紹介(2021年3月8日 更新)

今回追加したものは、管理者のダッシュボードに表示されるログウィジェットの日時について任意の書式を設定する機能である。これまで日時の書式はサイト設定を利用していたが、ログの日時については揃えた方が見やすいと思ったので、今回の機能で対応することにしました。

投稿情報を連想配列で参照する(2018年5月27日 更新)

投稿情報は、タイトルや本文、投稿日時といったいくつかのデータが含んでおり、多くの場合オブジェクトになっている。これを連想配列で扱いたい場合はキャストして型変換することが多かった。基本的にはキャストで問題ないのだが、ふと目に留まったto_arrayメソッドが興味深かったのでメモとして残しておく。