wp_get_global_styles()


WordPressのwp_get_global_styles()関数は、テーマやブロックエディタで定義されたグローバルスタイルを取得するために使用されます。この関数は、カスタムプロパティやスタイル設定を取得するのに役立ちます。

構文

wp_get_global_styles( array $path = array(), array $context = array() );

引数の説明:

  • $path (array) — 取得したいスタイルのパスを指定します。デフォルトは空の配列です。
  • $context (array) — スタイルを取得するためのコンテキストを指定します。デフォルトは空の配列です。

例1: 基本的なグローバルスタイルの取得

この例では、グローバルスタイルを取得します。

$styles = wp_get_global_styles();

例2: 特定のスタイルパスの取得

この例では、特定のスタイルパスを指定してスタイルを取得します。

$styles = wp_get_global_styles( array( 'color', 'background' ) );

例3: カスタムコンテキストでのスタイル取得

この例では、カスタムコンテキストを指定してスタイルを取得します。

$styles = wp_get_global_styles( array(), array( 'theme' => 'my_custom_theme' ) );

例4: ブロックエディタのスタイル取得

この例では、ブロックエディタのスタイルを取得します。

$styles = wp_get_global_styles( array( 'blocks', 'core/paragraph' ) );

例5: カスタムプロパティの取得

この例では、カスタムプロパティを取得します。

$styles = wp_get_global_styles( array( 'custom', '--wp--custom--color' ) );

例6: テーマのスタイル取得

この例では、テーマのスタイルを取得します。

$styles = wp_get_global_styles( array( 'theme' ) );

例7: スタイルのデバッグ

この例では、取得したスタイルをデバッグ表示します。

print_r( wp_get_global_styles() );

注意点

  • この関数はWordPress 5.9以降で利用可能です。
  • スタイルの取得に失敗した場合、空の配列が返されることがあります。
  • カスタムコンテキストを使用する場合、テーマやプラグインが適切に設定されていることを確認してください。

関連機能: