READONLY() │ WP 4.9.0

Функция readonly() была признана устаревшей начиная с версии 5.9.0. Она больше не поддерживается и может быть удалена в будущих релизах. Вместо неё используйте функцию wp_readonly(), которая была введена в версии 5.9.0.

Эта функция выводит атрибут HTML readonly.

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

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

Важно!

Эта функция устарела и не может быть использована в PHP версий 8.1 и выше.

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

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

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

Вот как выглядит синтаксис функции:

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

• $readonly_value (mixed) (обязательный): Первое значение для сравнения.
• $current (mixed): Второе значение для сравнения (если оно не просто true).
  • По умолчанию: true
• $display (true|false): Указывает, нужно ли выводить строку или просто вернуть её.
  • По умолчанию: true

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

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

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

 />

Примечания

• Используйте wp_readonly() вместо этой устаревшей функции.

Изменения

• С версии 4.9.0 — Функция была введена.
• С версии 5.9.0 — Функция устарела. Используйте wp_readonly(), введённую в 5.9.0.

Код функции readonly

Вот как выглядит код функции readonly:

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

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

Вот некоторые связанные функции, которые могут быть полезны:

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

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