説明
パラメータ
- $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
関連
お勧め
自動生成される抜粋からテーブルブロックの内容を除外する(2022年4月6日 更新)
標準テーマである「Twenty Twenty-Two」や「Twenty Twenty-One」では、トップページやアーカイブページにおいて投稿情報を表示する際、その抜粋を使っている。とある投稿にテーブルブロックを入れた際、トップページに表示された抜粋には各セルの内容が列挙され、ちょっとモヤモヤした。
Post-tag automaton:プラグイン作ってみました(2012年12月24日 更新)
みなさんは投稿をポストする際に投稿タグを付け忘れたことはないでしょうか。このプラグインは、投稿をポストする際にタイトルと記事に投稿タグが含まれていないか調べ、含まれていた場合はその投稿タグを追加します。ダッシュボードのフィードボックスをカスタマイズ(2011年7月8日 更新)
管理者ページのトップページ「ダッシュボード」には、「WordPress 開発者ブログ」と「WordPress フォーラム」という2つのフィードボックスが表示されている。自分のような開発者には有益な情報をもたらしているが、一般の方には必要のない情報かもしれない。今回はこのフィードボックスをカスタマイズする方法を紹介する(管理者権限)。投稿一覧に「投稿フォーマット」フィルターが追加される(2019年4月12日 更新)
WordPress 5.2 Beta2(以降5.2Beta2)のソースコードを眺めていると、投稿一覧ページのフィルター機能に「投稿フォーマット」(select要素)が追加されていた。
さくらのVPSでKUSANAGI#2(2018年5月27日 更新)
今回は「前回」の続き。さくらのVPS(メモリー2GB SSDプラン)でパフォーマンスをApacheのabコマンドで確認してみた。はてさて、うたい文句通りのパフォーマンスは発揮するのだろうか。