2020-06-28 / 1375阅 / 悠然
返回特定字段的设置。
每个字段包含许多设置,例如标签,名称和类型。此功能可用于将这些设置与字段值一起作为数组加载。
get_field_object($selector, [$post_id = false], [$format_value = true], [$load_value = true]);
$selector
(字符串) (必填) 字段名称或字段键。$post_id
(混合) (可选) 保存值的帖子ID。默认为当前帖子。$format_value
(布尔) (可选) 是否应用格式化逻辑。默认为true。$load_value
(布尔) (可选) 是否加载字段的值。默认为true。(数组)此函数将返回一个类似于以下内容的数组。请注意,每个字段都包含唯一的设置。
array(
'ID' => 0,
'key' => '',
'label' => '',
'name' => '',
'prefix' => '',
'type' => 'text',
'value' => null,
'menu_order' => 0,
'instructions' => '',
'required' => 0,
'id' => '',
'class' => '',
'conditional_logic' => 0,
'parent' => 0,
'wrapper' => array(
'width' => '',
'class' => '',
'id' => ''
)
);
本示例说明如何加载字段并显示其标签和值。
<?php
$field = get_field_object('my_field');
?>
<p><?php echo $field['label']; ?>: <?php echo $field['value']; ?></p>
本示例说明如何从ID = 123的帖子中加载字段并显示其标签和值。
<?php
$field = get_field_object('my_field', 123);
?>
<p><?php echo $field['label']; ?>: <?php echo $field['value']; ?></p>
在某些情况下,可能有必要通过字段的键来加载字段,例如尚未保存值时。本示例说明如何使用其键加载字段。
<?php
$field = get_field_object('field_123456');
?>
一些字段类型存储其他数据,例如“选择”字段。此示例显示如何遍历“选择”字段的选择并将其显示在列表中。
<?php $field = get_field_object('my_select'); if( $field['choices'] ): ?> <ul> <?php foreach( $field['choices'] as $value => $label ): ?> <li><?php echo $label; ?></li> <?php endforeach; ?> </ul> <?php endif; ?>