acf_get_view()


WordPress関数acf_get_view()は、acf/viewsディレクトリ内にあるテンプレート、または指定したファイルを読み込んで表示するために使用されます。

シンタックス

acf_get_view( string $view, array $args = [] );

引数の説明:

  • $view (string) — 読み込むテンプレートファイルの名前またはパス。
  • $args (array) — テンプレートに渡すデータの連想配列。デフォルトは空の配列。

例 1: 基本的なテンプレートの読み込み

以下の例は、acf/views/example-view.phpテンプレートを読み込みます。

<?php acf_get_view( 'example-view' ); ?>

例 2: 引数を使用したテンプレートの表示

引数を渡してテンプレート内で使用する方法。

<?php 
$args = ['title' => 'カスタムタイトル', 'content' => 'カスタムコンテンツ'];
acf_get_view( 'example-view', $args ); 
?>

例 3: フルパスを指定したテンプレートの読み込み

フルパスを指定してカスタムテンプレートを読み込む例。

<?php acf_get_view( get_template_directory() . '/my-custom-template.php' ); ?>

例 4: 条件付きでテンプレートを表示

特定の条件に基づいてテンプレートを表示する例。

<?php 
if ( is_user_logged_in() ) {
    acf_get_view( 'logged-in-view' );
} else {
    acf_get_view( 'guest-view' );
}
?>

例 5: 繰り返し内でのテンプレート表示

ループ内でテンプレートを繰り返し表示する例。

<?php 
$data = [
    ['name' => '太郎', 'age' => 25],
    ['name' => '花子', 'age' => 30]
];

foreach ( $data as $person ) {
    acf_get_view( 'person-template', $person );
}
?>

注意事項

  • $view引数には正しいパスまたはテンプレート名を指定してください。
  • セキュリティ上の理由から、ユーザー入力を直接ファイルパスとして使用しないでください。