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



お勧め

meta_compare_key使ってみた(2019年3月19日 更新)

ブロックエディターの登場により、標準のカスタムフィールドを使う機会はかなり減った気がする。そんな中、5.1.0で追加されたのが、カスタムフィールド名(メタキー)に含まれる文字列を指定する'meta_compare_key'キーだ。

WP_List_Tableクラスの「一括操作」フォームを使ってみた(2018年5月27日 更新)

今回は「WP_List_Tableクラスを使ってみた」の続き。投稿一覧やプラグインページなどにある「一括操作」(Bulkアクション)フォーム対応に関するメモである。

テーマから投稿画像のサイズを指定する(2012年3月15日 更新)

投稿記事に挿入する画像サイズは、サムネイル(150×150)、中サイズ(300×300)、大サイズ(1024×1024)がデフォルトだが、テーマによっては別のサイズを指定したい場合はある。基本的には、「設定」-「メディア」の「メディア設定」ページで指定できるが、テーマ内のfunctions.phpで設定しておくとちょっと便利かもしれない。

ログインページを変える(2014年9月12日 更新)

WordPressの標準的な不正ログイン対策としては、ログインIDは'admin'を避けるパスワードはユニークで長くする、場合によってはアクセスできるIPアドレスを制限する、といった具合だろう。これらの他に何かできないものだろうかと、ちょっと考えてみた。

新規投稿時の本文プレースホルダーテキストを変える(2021年9月9日 更新)

ブロックエディターに影響を与えるフィルターは多数存在する。今回紹介するフィルターはその1つで、新規投稿時の本文ブロックのプレースホルダーテキストを変更するものだ。