disabled()
Порівнює два передані значення, і якщо вони збігаються, виводить текст disabled='disabled'– атрибут для введення поля HTML-форми.
Функцію прийнято використовувати всередині input і textarea полів HTML-форми.
Це одна з 4 функцій помічників для форм: readonly() .
Атрибут disabled – Блокує доступ та зміну поля форми. Воно в такому випадку відображається сірим і недоступним для активації користувача. Крім того, таке поле не може отримати фокус шляхом натискання клавіші Tab, мишею або іншим способом. Проте такий стан поля можна змінювати за допомогою скриптів. Заблоковане значення в полі не передається на сервер.
Хуків немає.
Повертає
Строку. Виводить на екран рядок disabled='disabled'при збігу двох перших параметрів або нічого не виводить. Якщо вказати третій параметр $echo в 0 (false), результат буде повернено для обробки.
Використання
<?php disabled( $disabled, $current, $echo ); ?>
-
$disabled
(рядок/число/логічний) (обов’язковий) - Перше значення, яке слід порівняти з другим.
-
$current
(рядок/число/логічний) -
Друге значення, яке слід порівняти з першим.
Типово: true -
$echo
(логічний) -
Виводити на екран (true) або повертати для обробки (false).
Типово: true
Приклади
#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() disabled WP 6.0.2
function disabled( $disabled, $current = true, $echo = true ) {
return __checked_selected_helper( $disabled, $current, $echo, 'disabled' );
}