disabled() │ WP 3.0.0

Сравнивает два переданных значения, и если они совпадают, выводит текст disabled='disabled' — атрибут для input поля HTML-формы.

Функцию принято использовать внутри input и textarea полей HTML-формы.

Это одна из 4 функций помощников для форм: checked(), disabled(), selected(), readonly().

Атрибут disabled - Блокирует доступ и изменение поля формы. Оно в таком случае отображается серым и недоступным для активации пользователем. Кроме того, такое поле не может получить фокус путем нажатия на клавишу Tab, мышью или другим способом. Тем не менее, такое состояние поля можно менять с помощью скриптов. Заблокированное в поле значение не передается на сервер.

Хуков нет.

Возвращает

Строку. Выводит на экран строку disabled='disabled' при совпадении двух первых параметров или ничего не выводит. Если указать третий параметр $echo в 0 (false), то результат будет возвращен для обработки.

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

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

disabled( $disabled, $current, $display );
$disabled(строка/число/логический) (обязательный)
Первое значение, которое нужно сравнить со вторым.
$current(строка/число/логический)
Второе значение, которое нужно сравнить с первым.
По умолчанию: true
$display(логический)
Выводить на экран (true) или возвращать для обработки (false).
По умолчанию: true

Примеры

0

#1 Демонстрация использования disabled

Допустим у нас есть группа radio полей формы. Одно из полей уже задействовано в опциях и логично, чтобы это поле не возможно было выбрать. В этом случае этому полю нужно добавить атрибут disabled. Этот пример показывает как сделать это удобно с помощью disabled().

Предположим, что в текущий момент значение поля option равно "red":

<input type="radio" name="option" value="red" <?php disabled( $_POST['option'], 'red' ) ?> > Красный 
<input type="radio" name="option" value="green" <?php disabled( $_POST['option'], 'green' ) ?> > Зеленый 
<input type="radio" name="option" value="blue" <?php disabled( $_POST['option'], 'blue' ) ?> > Синий

Получим

<input type="radio" name="option" value="red" disabled='disabled' > Красный 
<input type="radio" name="option" value="green"> Зеленый 
<input type="radio" name="option" value="blue"> Синий

Список изменений

С версии 3.0.0 Введена.

Код disabled() WP 6.7.1

wp-includes/general-template.php 
function disabled( $disabled, $current = true, $display = true ) {
	return __checked_selected_helper( $disabled, $current, $display, 'disabled' );
}

form (функции формы)

Вспомогательные