Функция DISABLED() │ WP 3.0.0

Функция disabled() сравнивает два значения. Если они совпадают, она выводит disabled='disabled' — атрибут для элемента ввода в форме.

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

Функция disabled() — одна из четырех вспомогательных функций для форм, наряду с checked(), selected() и readonly().

Примечание: Нет хуков.

Возвращаемое значение

Функция возвращает строку:

• Выводит disabled='disabled', если сравниваемые значения совпадают.
• Если третий параметр установлен в false (по умолчанию true), функция вернет либо строку disabled='disabled', либо пустую строку.

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

disabled( $disabled, $current, $display );

• $disabled (mixed) (обязательный) — одно из значений для сравнения.
• $current (mixed) — другое значение для сравнения, если оно не просто true. По умолчанию: true.
• $display (bool) — определяет, нужно ли выводить строку или просто вернуть ее. По умолчанию: true.

Примеры

Пример использования

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

 > Красный
 > Зеленый
 > Синий

Результат

Если, например, у нас выбрано значение "красный", то HTML-код будет выглядеть так:

 Красный
 Зеленый
 Синий

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

• С версии 3.0.0 — функция была введена.

Код функции DISABLED

function disabled( $disabled, $current = true, $display = true ) {
    return __checked_selected_helper( $disabled, $current, $display, 'disabled' );
}

Связанные функции

Эта функция связана с другими функциями работы с формами в WordPress:

• checked()
• form_option()
• selected()
• wp_readonly()
• wp_referer_field()

Эти функции могут помочь в управлении статусом ввода в формах.