Поле «Радиокнопка» в ACF: настройки и примеры

Описание

Поле «Радиокнопка» создает список элементов для выбора.

Скриншоты

Поле «Радиокнопка», позволяющее выбрать вариант или варианты — Интерфейс поля «Радиокнопка»

Список настроек, отображаемых при создании поля «Радиокнопка» — Настройки поля «Радиокнопка»

История изменений

Настройка Return Format добавлена в версии 5.4.0.
Настройка Allow Null добавлена в версии 5.3.8.
Настройки Other и «Save Other» добавлены в версии 4.1.7.

Настройки

Choices
Варианты, отображаемые при выборе значения. Введите каждый вариант с новой строки (например, Red). Чтобы отдельно указать значение и подпись, используйте двоеточие (например, red : Red).
Allow Null
Позволяет отменить выбор ранее выбранного значения.
Other
Добавляет текстовое поле, позволяющее ввести произвольное значение.
Save Other
Позволяет добавлять произвольные значения к вариантам поля. Подробнее см. в разделе «Примечания».
Default Value
Задает значение, выбранное по умолчанию при первом редактировании значения поля. Введите только значение, но не подпись.
Layout
Ориентация элементов радиокнопки. Выберите «Vertical» или «Horizontal».
Return Format
Задает формат значения, возвращаемого функциями ACF. Доступны варианты Value, Label или Both (array).

Использование в шаблоне

Вывод одного выбранного значения

В этом примере показано, как вывести выбранное значение.

<p>Цвет: <?php the_field('color'); ?></p>

Вывод значения и подписи

В этом примере показано, как получить выбранные значение и подпись без использования настройки Format value.

<?php
$field = get_field_object('color');
$value = $field['value'];
$label = $field['choices'][ $value ];

?>
<p>Цвет: <span class="color-<?php echo esc_attr($value); ?>"><?php echo esc_html($label); ?></span></p>

Настройка Format value

В этом примере показано, как получить выбранные значение и подпись с помощью настройки Format value (установлено значение Both).

<?php
$color = get_field('color');
?>
<p>Цвет: <span class="color-<?php echo esc_attr($color['value']); ?>"><?php echo esc_html($color['label']); ?></span></p>

Условие

В этом примере показано, как использовать выбранное значение для выполнения действия по условию.

<?php 

if( get_field('color') == 'red' ) {
    // Выполнить действие.
}

Запрос записей

В этом примере показано, как получить записи, для которых в поле «Радиокнопка» с именем «color» выбрано значение «red».

<?php

$posts = get_posts( array(
    'meta_query' => array(
        array(
            'key'   => 'color',
            'value' => 'red',
        )
    )
) );

if( $posts ) {
    // Выполнить действие.
}

Примечания

Save other

При использовании функции local JSON произвольные значения, сохраненные в вариантах поля, не будут отображаться после перезагрузки страницы. Это происходит потому, что JSON-файл не обновляется и переопределяет все настройки поля, найденные в базе данных.

Обновлено: 30.09.2026

Радиокнопка