Стандартный тип поля Joomla XML - Note

Тип поля Note в Joomla XML предназначен для вывода статического текста внутри форм: заголовков разделов, пояснений, подсказок и предупреждений. Поле не создаёт элементов ввода, не сохраняет данные в базу и не требует обработки в коде компонентов — оно работает исключительно для информирования пользователя. Корректно отображается в административной панели и на фронтенде.

Joomla 3.x Joomla 4.x Joomla 5.x Joomla 6.x

Атрибуты поля

Ниже приведены основные атрибуты, поддерживаемые типом поля . Используйте их внутри тега <field> вашего XML-манифеста.

Атрибут	Тип	Описание
`type`	string	Обязательно. Должно быть равно «note». Определяет тип поля и его поведение.
`name`	string	Обязательно. Уникальный системный идентификатор поля. Используется только для внутренней разметки формы, данные не сохраняются в базу.
`label`	string	Заголовок заметки, видимый пользователю. Может быть языковой константой (например, COM_EXAMPLE_NOTE_LABEL).
`description`	string	Основной текст заметки. В Joomla 3 отображался как подсказка при наведении на заголовок, в Joomla 4/5/6 выводится сразу как обычный текст внутри блока.
`class`	string	CSS-классы для стилизации блока. Для цветных уведомлений используйте стандартные классы: alert alert-info (синий), alert alert-warning (жёлтый), alert alert-danger (красный), alert alert-success (зелёный).
`heading`	string	HTML-тег для заголовка. Допустимые значения: h1, h2, h3, h4, h5, h6 или none (без заголовка). По умолчанию h4. Работает стабильно в Joomla 4 и выше.
`showlabel`	boolean	Показывать ли заголовок (label). Значения: true (по умолчанию) или false. При false выводится только текст описания.
`close`	boolean	Добавляет кнопку закрытия (крестик) к блоку уведомления. Значения: true или false. Работает только в Joomla 4 и выше на базе Bootstrap 5.
`hidden`	boolean	Скрывает поле при загрузке формы. Значения: true или false. Часто используется вместе с атрибутом showon для условного показа.
`showon`	string	Правило условного отображения. Поле показывается только при выполнении условий других полей формы. Пример: showon="field_name:value" (показать, когда поле field_name равно value).
`layout`	string	Путь к переопределяемому шаблону отрисовки. Позволяет изменить HTML-структуру заметки без правки ядра. Поддерживается начиная с Joomla 3.7.

Визуальные примеры

Ниже представлены скриншоты отображения поля в разных версиях Joomla и темах административной панели.

Joomla 3 Isis

Поле типа Note с разными вариантами в настройках Joomla 3.x (шаблон админки Isis)

Классический вид поля в шаблоне Isis.

Joomla 4 / 5 / 6 Cassiopeia (Светлая)

Визуальное отображение поля Note с разными вариантами в Joomla 4/5/6 - светлая тема админки Cassiopeia

Современный дизайн Cassiopeia. Светлая тема.

Joomla 4 / 5 / 6 Cassiopeia (Темная)

Визуальное отображение поля Note с разными вариантами в Joomla 4/5/6 - темная тема админки Cassiopeia

Темная тема админки. Контрастный текст и темный фон.

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

Добавьте этот код внутрь секции fieldset вашего XML-файла формы. Атрибут type="note" выводит статический текст в интерфейсе, не создавая элементов ввода и не участвуя в сохранении данных.

<!-- 1. Обычная текстовая заметка (без оформления) -->
<field name="note_default" type="note"
       label="Примечание"
       description="Это обычная текстовая заметка без дополнительного оформления." />
<!-- Выводится простой текст без фона и рамок. Подходит для общих пояснений внутри формы. -->

<!-- 2. Информационная заметка (синий/голубой) -->
<field name="note_info" type="note"
       label="Справка"
       description="Здесь размещается дополнительная информация или подсказка по настройке."
       class="alert alert-info" />
<!-- Стандартный информационный блок. В J3 рендерится через Bootstrap 2/3, в J4+ — через Bootstrap 5. -->

<!-- 3. Предупредительная заметка (жёлтый/оранжевый) -->
<field name="note_warning" type="note"
       label="Внимание"
       description="Перед сохранением проверьте, что все обязательные параметры указаны верно и соответствуют требованиям системы."
       class="alert alert-warning" />
<!-- Используется для привлечения внимания к важным нюансам или ограничениям. -->

<!-- 4. Критическое уведомление (красный) -->
<field name="note_danger" type="note"
       label="Ошибка"
       description="Данная функция недоступна в текущей конфигурации. Обратитесь к администратору или проверьте настройки окружения."
       class="alert alert-danger" />
<!-- Для выделения критических ограничений. В Joomla 4+ автоматически получает ARIA-атрибуты для доступности. -->

<!-- 5. Подтверждение или успешный статус (зелёный) -->
<field name="note_success" type="note"
       label="Успешно"
       description="Все параметры проверены и полностью соответствуют требованиям. Можно продолжать работу."
       class="alert alert-success" />
<!-- Статический индикатор состояния. Не заменяет системные flash-сообщения, а остаётся в форме постоянно. -->

Получение значения в PHP

Поле note предназначено исключительно для вывода информации в интерфейсе. При отправке формы браузер не передаёт его значение на сервер, поэтому в программном коде компонента оно не требует никакой обработки.

<?php
/*
 * Поле type="note" не отправляется на сервер при сохранении формы.
 * Оно не хранит данные, не проверяется и не очищается системой.
 * В программном коде компонентов обработка этого поля не требуется.
 * Достаточно указать его в XML-файле формы — Joomla покажет текст
 * в интерфейсе и не будет учитывать поле при записи данных.
 */
?>

Ядро Joomla самостоятельно пропускает заметки при фильтрации и записи данных. Добавление к ним правил проверки или попытка прочитать значение из запроса не имеет смысла и может вызвать ошибки валидации.

Совет: не добавляйте к полю правила проверки и фильтрации в XML, иначе форма не откроется или вернёт ошибку; весь текст выносите в языковые файлы — это упростит поддержку и перевод без правки разметки; а для условного показа используйте стандартный атрибут showon, так как ручное скрытие через стили или скрипты нарушает доступность и часто сбрасывается после обновлений системы.