説明
bool wp_style_add_data( string $handle, string $key, mixed $value )
スクリプト（CSSファイル）にメタ情報を追加する。
パラメータ
- $handleスクリプト名を指定。
- $keyメタ情報のキー名（'conditional'、'rtl'、'suffix'、'alt'、title'、'path'の何れか）を指定。
- $valueメタ情報の値を指定。
返り値
メタ情報を追加できた場合はtrueを、追加できなかった場合はfalseを返す。注意
wp_enqueue_style関数で登録したスクリプト（CSSファイル）に対してメタ情報を追加する。
パラメータ$keyに'conditional'を指定した場合は、パラメタ$valueの値をメタ情報のif文になる。以下は新テーマTwenty Thirteenの例。
<!--[if lt IE 9]>
<link rel='stylesheet' id='twentythirteen-ie-css' href='http://localhost/wp-content/themes/twentythirteen/css/ie.css?ver=2013-07-18' type='text/css' media='all' />
<![endif]-->
使用例
- スクリプト'mytheme-ie'に'lt IE 9'のメタ情報を追加する。
<?php wp_enqueue_style( 'mytheme-ie', get_template_directory_uri() . '/css/ie.css', array(), '1.00' ); wp_style_add_data( 'mytheme-ie', 'conditional', 'lt IE 9' ); ?>
[5.8.0]パラメータ$keyに'path'が追加され、$valueには追加情報ファイルの絶対パスまたは相対パスを指定する。
フィルター
直接実行するフィルターはありません。アクション
直接実行するアクションはありません。ソースファイル
/wp-includes/functions.wp-styles.php最終更新 : 2021年07月27日 14:31
関連
お勧め
投稿情報を連想配列で参照する（2018年5月27日 更新）
投稿情報は、タイトルや本文、投稿日時といったいくつかのデータが含んでおり、多くの場合オブジェクトになっている。これを連想配列で扱いたい場合はキャストして型変換することが多かった。基本的にはキャストで問題ないのだが、ふと目に留まったto_arrayメソッドが興味深かったのでメモとして残しておく。
WordPressのコーディングスタンダードとPSR-2がかみ合わない（2018年5月27日 更新）
先日パソコンのストレージを換装して開発環境を再構築。エディタのEclipseは「Neon（4.6）」から「Oxygen（4.7）」へ切り替わった。コードを書き始めるとそこはかとなく違和感があり、調べていくとPHPの「Code Style（Formatter）」が「PSR-2」に設定されていることが原因だった。
続テーマを変更せずにWebフォントを使ってみた（2022年2月8日 更新）
先日投稿した「テーマを変更せずにWebフォントを使ってみた」では、テーマ「Twenty Twenty One」でWebフォントを使うことができた。その後、ほかのテーマで試したところ、そのままではWebフォントを使うことができなかった。今回は、それらのテーマの対応について紹介する。
ブロックエディターで現在の「ロケール」を取得した時のメモ（2024年8月10日 更新）
ブロックエディター向けのプラグインで日本語固有の機能を実装する際、現在のロケール（言語）を取得したい。ブロックエディターの編集時、投稿を編集しているユーザーの言語が優先され、それをどうやって取得するかを「ChatGPT」に聞いてみたのだが。。。
スマートフォン向けの振り分けを自前で行う（2012年1月23日 更新）
PC向けのサイトをスマートフォン対応する場合、WPtouchやktai styleに代表されるスマートフォン対応のテンプレート切り替えプラグインを使用するのが一般的。そういったプラグインはテンプレート切り替え以外の機能も備えており、そういった機能は必ずしも必要ではない。そんなわけで、ここでは超シンプルなスマートフォン向けのテンプレート切り替えを実現する方法を紹介する。