wp_register_font_collection()


WordPressのwp_register_font_collection()関数は、フォントコレクションを登録するために使用されます。フォントコレクションは、複数のフォントをまとめたもので、テーマやプラグインで使用することができます。

構文

wp_register_font_collection( string $slug, array $args );

引数の説明:

  • $slug(string) — フォントコレクションのスラッグ。一意である必要があります。
  • $args(array) — フォントコレクションの設定を含む配列。以下のキーを持つことができます:
    • name(string) — フォントコレクションの名前。
    • fonts(array) — フォントの配列。各フォントは、font-familyやsrcなどのプロパティを持ちます。

例1: 基本的なフォントコレクションの登録

これは、シンプルなフォントコレクションを登録する例です。

wp_register_font_collection( 'my-font-collection', array( 'name' => 'My Font Collection', 'fonts' => array( array( 'font-family' => 'Open Sans', 'src' => 'https://example.com/fonts/open-sans.woff2' ) ) ) );

例2: 複数のフォントを含むコレクション

複数のフォントを一つのコレクションに登録する例です。

wp_register_font_collection( 'multi-font-collection', array( 'name' => 'Multi Font Collection', 'fonts' => array( array( 'font-family' => 'Roboto', 'src' => 'https://example.com/fonts/roboto.woff2' ), array( 'font-family' => 'Lato', 'src' => 'https://example.com/fonts/lato.woff2' ) ) ) );

例3: テーマ内でのフォントコレクションの登録

テーマのfunctions.phpでフォントコレクションを登録する例です。

add_action( 'after_setup_theme', function() { wp_register_font_collection( 'theme-fonts', array( 'name' => 'Theme Fonts', 'fonts' => array( array( 'font-family' => 'Merriweather', 'src' => get_template_directory_uri() . '/fonts/merriweather.woff2' ) ) ) ); } );

例4: プラグイン内でのフォントコレクションの登録

プラグインでフォントコレクションを登録する例です。

add_action( 'init', function() { wp_register_font_collection( 'plugin-fonts', array( 'name' => 'Plugin Fonts', 'fonts' => array( array( 'font-family' => 'Oswald', 'src' => plugins_url( 'fonts/oswald.woff2', __FILE__ ) ) ) ) ); } );

例5: フォントコレクションの上書き

既存のフォントコレクションを上書きする例です。

wp_register_font_collection( 'existing-slug', array( 'name' => 'Updated Collection', 'fonts' => array( array( 'font-family' => 'Raleway', 'src' => 'https://example.com/fonts/raleway.woff2' ) ) ) );

例6: フォントコレクションの削除

登録されたフォントコレクションを削除する例です。

wp_deregister_font_collection( 'my-font-collection' );

例7: フォントコレクションの取得

登録されたフォントコレクションを取得する例です。

$collection = wp_get_font_collection( 'my-font-collection' );

例8: すべてのフォントコレクションの取得

すべての登録されたフォントコレクションを取得する例です。

$collections = wp_get_font_collections();

注意点

  • フォントコレクションのスラッグは一意である必要があります。
  • フォントのsrcには、有効なURLまたはパスを指定する必要があります。

関連機能：