Спецификация Java Server Pages 1.2

       

JSP.2.10.2 Директива taglib


Набор значащих тэгов, интерпретируемых JSP-контейнером, может быть расширен “tag library/библиотекой тэгов”. Директива taglib на JSP-странице объявляет, что данная страница использует библиотеку тэгов, уникально идентифицирует библиотеку тэгов, используя URI, и ассоциирует префикс тэгов, который служит для отличения использования акций в этой библиотеке. Если реализация JSP-контейнера не может локализовать описание библиотеки тэгов, должна возникать фатальная ошибка трансляции. Фатальная ошибка трансляции возникнет также, если директива taglib появится после акций, использующих данный префикс.

Библиотека тэгов может включать метод проверки корректности использования JSP-страницей функциональности библиотеки тэгов. См. более конкретные детали в . Также см. замечания по реализации в .

Примеры

В следующем примере библиотека тэгов вводится и становится доступной данной странице путём использования префикса super; никакие другие библиотеки тэгов не должны вводиться на данной странице, используя этот префикс. В данном конкретном случае мы принимаем, что библиотека тэгов включает тип элемента doMagic, который используется на странице.

<%@ taglib uri=”http://www.mycorp/supertags” prefix=”super” />

...

<super:doMagic>

...

</super:doMagic>

Синтаксис

<%@ taglib uri=”tagLibraryURI” prefix=”tagPrefix” %>

где атрибуты:
 

Таблица JSP.2-1

uri Спецификация абсолютного или относительного URI, который уникально идентифицирует дескриптор библиотеки тэгов, ассоциированной с данным префиксом.

URI используется для локализации описания библиотеки тэгов, как указано в .

tagPrefix Определяет строку prefix в конструкции <prefix>:<tagname>, которая используется для отличения специальной акции, например, <myPrefix:myTag>.

Использование префиксов, начинающихся с jsp:, jspx:, java:, javax:, servlet:, sun: и sunw:, зарезервировано.

Префикс обязан следовать соглашению об именовании, специфицированному в спецификации пространств имён XML.

Пустые префиксы в данной версии спецификации не допускаются.

Фатальная ошибка трансляции возникнет, если транслятор JSP-страницы обнаруживает тэг с именем prefix: Name,

использующий префикс, введённый директивой taglib, и если Name не распознаётся соответствующей библиотекой тэгов.



Содержание раздела