Использование основных тегов

Теги, включённые в базовую библиотеку тегов JavaServer Faces, используются для выполнения основных действий, которые не выполняются тегами HTML.

Таблица 10-8 перечисляет основные теги обработки событий.

Таблица 10-8 Основные теги обработки событий

Тег

Функция

f:actionListener

Добавляет слушатель действия в родительский компонент

f:phaseListener

Добавляет PhaseListener на страницу

f:setPropertyActionListener

Регистрирует слушателя специальных действий, единственная цель которого — передать значение в Managed-бин при отправке формы

f:valueChangeListener

Добавляет слушатель изменения значения в родительский компонент

Таблица 10-9 перечисляет основные теги преобразования данных.

Таблица 10-9 Основные теги конвертации данных

Тег

Функция

f:converter

Добавляет произвольный конвертер в родительский компонент

f:convertDateTime

Добавляет объект DateTimeConverter в родительский компонент

f:convertNumber

Добавляет объект NumberConverter в родительский компонент

Таблица 10-10 перечисляет основные теги фасетов.

Таблица 10-10 Основные теги фасетов

Тег

Функция

f:facet

Добавляет вложенный компонент, имеющий особое отношение к тегу включения

f:metadata

Регистрирует facet в родительском компоненте

Таблица 10-11 перечисляет основные теги, которые представляют элементы в списке.

Таблица 10-11 Основные теги, которые представляют элементы в списке

Тег

Функция

f:selectItem

Представляет один элемент в списке элементов

f:selectItems

Представляет набор элементов

Таблица 10-12 перечисляет основные теги валидаторов.

Таблица 10-12 Основные теги валидаторов

Тег

Функция

f:validateDoubleRange

Добавляет DoubleRangeValidator к компоненту

f:validateLength

Добавляет LengthValidator к компоненту

f:validateLongRange

Добавляет LongRangeValidator к компоненту

f:validator

Добавляет кастомный валидатор к компоненту

f:validateRegEx

Добавляет RegExValidator к компоненту

f:validateBean

Делегирует валидацию локального значения BeanValidator-у

f:validateRequired

Обеспечивает наличие значения в компоненте

Таблица 10-13 перечисляет основные теги, которые попадают в другие категории.

Таблица 10-13 Остальные основные теги

Категория тегов

Тег

Функция

Конфигурация атрибута

f:attribute

Добавляет настраиваемые атрибуты в родительский компонент

Локализация

f:loadBundle

Задаёт ResourceBundle, который отображается как Map

Подстановка параметров

f:param

Подставляет параметры в объект MessageFormat и добавляет пары имя-значение в строку запроса URL

Ajax

f:ajax

Связывает действие Ajax с одним компонентом или группой компонентов в зависимости от размещения тега

Событие

f:event

Позволяет установить ComponentSystemEventListener на компонент

Веб-сокеты

f:websocket

Позволяет передавать серверные сообщения всем сокетам, содержащим то же имя канала.

Эти теги используются совместно с тегами компонентов и описаны в других разделах данного учебника.

Таблица 10-14 перечисляет разделы, в которых разъясняется, как использовать некоторые из тегов.

Таблица 10-14. Где разъясняются теги

Теги

Где объясняется

Теги обработки событий

Регистрация слушателей в компонентах

Теги конвертации данных

Использование стандартных конвертеров

f:facet

Использование таблицы Data-Bound и Управление расположением компонентов с помощью тегов h:panelGrid и h:panelGroup

f:loadBundle

Настройка bundle-ресурса

f:metadata

Использование параметров представления для настройки URL для закладок

f:param

Отображение форматированного сообщения тегом h:outputFormat

f:selectItem and f:selectItems

Использование тегов f:selectItem и f:selectItems

Теги валидаторов

Использование стандартных валидаторов

f:ajax

Глава 13 «Использование Ajax с JavaServer Faces»

f:websocket

Глава 17 «Использование веб-сокетов с JavaServer Faces»