Menu
  • 注册
  • 函数 函数 关注:0 内容:41

    [基础] the_field()

  • 查看作者
  • 打赏作者
  • 拉黑名单
    • 3举人
      超级会员
      博主

      [基础] the_field()

      描述

      显示指定字段的值。

      直观而强大,这个函数可以用来输出任何位置的任何字段的值。请注意此函数与下方代码功能相同。

      echo get_field();

      参数

      the_field($selector, [$post_id], [$format_value]);
      • $selector (string) (必须) 字段名或字段键

      • $post_id (mixed) (可选) 保存了值的文章 ID,默认为当前文章

      • $format_value (bool) (可选) 是否进行格式化,默认为 true

      返回值

      (array | false) 一个值的数组或如果没有字段则返回 false

      例子

      显示当前文章的值

      下方的例子展示了如何显示当前文章中名为“text_field”字段的值。

      <h2><?php the_field('text_field'); ?></h2>

      显示指定文章的值

      下方的示例展示了如何显示 ID = 123 的文章中“text_field”字段的值。

      <h2><?php the_field('text_field', 123); ?></h2>

      检查值是否存在

      下方的例子展示了如何在显示一个值之前检查它是否存在。

      <?php if( get_field('text_field') ): ?>
          <h2><?php the_field('text_field'); ?></h2>
      <?php endif; ?>

      从不同的对象中获取值

      下方的示例显示了各种有效的 $post_id 值,它们指定了值的保存位置。

      $post_id = false;           // current post
      $post_id = 123;             // post ID = 123
      $post_id = "user_123";      // user ID = 123
      $post_id = "term_123";      // term ID = 123
      $post_id = "category_123";  // same as above
      $post_id = "option";        // options page
      $post_id = "options";       // same as above
      
      the_field( 'my_field', $post_id );

      请登录之后再进行评论

      登录