WP_READONLY() │ WP 5.9.0

Функция WP_READONLY() выводит HTML-атрибут readonly, который используется для блокировки редактирования поля формы.

Описание функции

Функция сравнивает два переданных аргумента и, если они идентичны, добавляет атрибут readonly к элементу формы.

Используемая функция

• __checked_selected_helper() — вспомогательная функция, используемая в процессе.

Хуки

Не использует хуки.

Возврат значения

Функция возвращает строку — HTML-атрибут или пустую строку, если атрибут не добавляется.

Синтаксис

wp_readonly( $readonly_value, $current, $display );

Параметры

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

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

Пример 1: Добавление атрибута readonly

Предположим, что у нас есть переменная $is_readonly, и если она равна true, мы хотим отобразить атрибут readonly для поля ввода:

    ...
     />
    ...

Пример 2: Условное добавление атрибута readonly

Допустим, вы хотите добавить значение readonly к полю, если текущий пользователь не может редактировать запись с ID 25:

 name='myname' value='Значение' />

Пример 3: Дополнительные примеры

$is_readonly = true;
wp_readonly( $is_readonly ); // выведет readonly='readonly'

$is_readonly = false;
wp_readonly( $is_readonly ); // не выведет ничего

$readonly = wp_readonly( '1', true, false );
var_dump( $readonly ); // => строка(20) " readonly='readonly'"

Изменения

• С версии 5.9.0 — функция была введена и доступна для использования.

Код функции

Функция wp_readonly выглядит так:

function wp_readonly( $readonly_value, $current = true, $display = true ) {
    return __checked_selected_helper( $readonly_value, $current, $display, 'readonly' );
}

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

Существует несколько других функций, которые могут быть полезны при работе с формами в WordPress:

• checked() — устанавливает атрибут checked для элементов формы.
• disabled() — устанавливает атрибут disabled для элементов формы.
• form_option() — облегчает работу с опциями форм.
• selected() — устанавливает атрибут selected для элементов форм.
• wp_referer_field() — генерирует скрытое поле для проверки перенаправления.

Теперь вы знаете, как использовать функцию wp_readonly() в WordPress. Эта функция позволит вам легко управлять атрибутом readonly для ваших форм!