7.3.1 tag指令
7.3.1 tag指令语法格式
tag指令和JSP页面中的page指令类似。以下是它的使用语法：
1 | <%@ tag attribute1="value1" attribute2="value2" ... %> |
tag指令的属性
下表中列出了tag指令的全部属性，这些属性都是非必须的。
| 属性 | 描述 |
|---|---|
display-name |
在XML工具中显示的名称。默认值是不包含后缀的tag file名 |
body-content |
指定标签body的类型，body-content属性值有empty、tagdependent、scriptless，默认值是scriptless |
dynamic-attributes |
指定tag file动态属性的名称。当dynamicattributes值被设定时，会产生一个Map来存放这些动态属性的名称和对应的值 |
small-icon |
指定一个图片路径，用于在XML工具上显示小图标。一般不会用到 |
large-icon |
指定一个图片路径，用于在XML工具上显示大图标。一般也不会用到 |
description |
标签的描述信息 |
example |
标签使用实例的描述 |
language |
tag file中使用的脚本语言类型。当前版本的JSP中，该值必须设为“java” |
import |
用于导入一个java类型，和JSP页面中的import相同 |
pageEncoding |
指定tag file使用的编码格式，可以使用“CHARSET”中的值。和JSP页面中的pageEncoding相同 |
除了import属性，其他所有的属性在一个tag指令或一个tag file中都只能出现一次。例如，以下的tag file就是无效的，因为body-content属性在同一个tag file中出现了多次：
1 | <%@ tag display-name="first tag file" body-content="scriptless"%> |
下面是一个有效的tag指令，尽管import属性出现了两次，但这是被允许的：
1 | <%@ tag import="java.util.ArrayList" import="java.util.Iterator" %> |
同理，下面的tag指令也是有效的：
1 | <%@ tag body-content="empty" import="java.util.Enumeration" %> |