复选框

上次更新时间:2023年6月5日

描述

复选框字段创建可检查输入的列表。

屏幕截图

变更日志

  • 补充返回格式版本5.4.0中的设置。
  • 补充全部切换5.2.7版本中的设置。

设置

  • 选择
    选择值时显示的选项。在新行中输入每个选项(例如。红色). 为了更好地控制值和标签,可以使用冒号来指定这两者(例如。红色:红色).

  • 默认值
    首次编辑字段值时选择的默认值。只输入值,不输入标签。

  • 布局
    复选框输入的布局方向。从“垂直”或“水平”中选择。

  • 切换
    在前面添加一个复选框以打开/关闭所有输入。

  • 返回格式
    指定ACF函数返回的值格式。从“值”、“标签”或“两者”中选择。

  • 允许自定义
    附加一个按钮,允许在编辑字段值时添加自定义值。

  • 保存自定义
    允许将自定义值保存回字段的选项中。有关详细信息,请参阅注释。

模板使用情况

复选框字段返回选定选项的数组。

显示值

此示例演示如何在逗号分隔的列表中显示选定的值。

<p>颜色:<?php the_field(“颜色”);?></p>(第页)

在列表中显示值

此示例演示如何在无序列表中显示选定的值。

<?php(电话)$colors=获取字段('colors');如果($颜色):?><ul><?php foreach($colors作为$color):?><li><?php echo$color;?></li><?php endforeach;?></ul><?php-endif;?>

在列表中显示标签

此示例演示如何在以下情况下在无序列表中显示选定标签返回格式设置为价值.

<?php(电话)//加载字段设置和值。$field=获取字段对象(“颜色”);$colors=$field['value'];//显示标签。if($colors):?><ul><?php foreach($colors作为$color):?><li><?php echo$field['choices'][$color];?></li><?php endforeach;?></ul><?php-endif;?>

此示例演示如何在以下情况下在无序列表中显示选定标签返回格式设置为两者都有.

<?php(电话)$colors=获取字段('colors');如果($颜色):?><ul><?php foreach($colors作为$color):?><li><span class=“color-<?php echo$color['value'];?>”><?php echo$color['label'];?></span></li><?php endforeach;?></ul><?php-endif;?>

条件逻辑

此示例演示了如何检查字段值中是否选择了“红色”选项。

$colors=获取字段('colors');if($colors&&in_array('red',$colors)){//做点什么。}

查询帖子

这个例子演示了如何查询包含复选框字段“colors”并选中值“red”的帖子。由于复选框字段将其值保存为序列化数组,因此使用meta_query“LIKE”比较非常重要。

$posts=get_posts(数组(“meta_query”=>数组(阵列(“key”=>“colors”,'值'=>'“红色”',“比较”=>“喜欢”))));if($posts){//做点什么。}

笔记

保存自定义

如果使用本地JSON功能,保存到字段选项中的任何自定义值都不会在页面重新加载时显示。这是因为JSON文件不会被更新,并且会覆盖数据库中的任何字段设置。

相关的