如何在JSP自定义标签中使用class、style等全局HTML属性？

嘿，这个问题我当初第一次折腾JSP自定义标签时也踩过坑！直接加style属性报错完全合理，毕竟TLD里没声明，但其实有几种优雅的方式解决这个需求，不用一个个去堆全局属性声明：

方法1：直接在TLD中声明常用全局属性 #

如果只需要支持少数几个属性（比如style、class），最简单的方式就是在标签的TLD文件里逐个声明它们。比如：

<tag>
  <name>SomeCustomTag</name>
  <tag-class>com.example.SomeCustomTagHandler</tag-class>
  <body-content>JSP</body-content>
  <!-- 声明style属性 -->
  <attribute>
    <name>style</name>
    <rtexprvalue>true</rtexprvalue> <!-- 允许使用EL表达式赋值 -->
    <description>HTML全局样式属性</description>
  </attribute>
  <!-- 声明class属性 -->
  <attribute>
    <name>class</name>
    <rtexprvalue>true</rtexprvalue>
    <description>HTML全局类属性</description>
  </attribute>
</tag>

然后在你的标签处理器类里添加对应的setter方法（比如setStyle(String style)、setClass(String clazz)），最后在输出HTML元素时把这些属性拼接上去就行。

这种方法适合属性需求少的场景，但如果要支持id、title、data-*这类大量全局属性，就太繁琐了。

方法2：使用动态属性（Dynamic Attributes）（推荐） #

JSP 2.0及以上支持动态属性，允许标签接受未在TLD中声明的属性，完美解决全局属性的批量支持问题，步骤如下：

步骤1：让标签处理器实现DynamicAttributes接口 #

修改你的标签处理器类，实现javax.servlet.jsp.tagext.DynamicAttributes，并实现setDynamicAttribute方法来存储这些动态属性：

public class SomeCustomTagHandler extends TagSupport implements DynamicAttributes {
    // 存储动态属性的容器
    private Map<String, Object> dynamicAttributes = new HashMap<>();

    @Override
    public void setDynamicAttribute(String uri, String localName, Object value) throws JspException {
        dynamicAttributes.put(localName, value);
    }

    @Override
    public int doStartTag() throws JspException {
        JspWriter out = pageContext.getOut();
        try {
            // 示例：输出一个div元素，你可以换成自己的目标HTML标签
            out.print("<div");
            // 遍历动态属性，逐个输出到元素上
            for (Map.Entry<String, Object> entry : dynamicAttributes.entrySet()) {
                String attrName = entry.getKey();
                String attrValue = String.valueOf(entry.getValue());
                // 务必转义属性值，防止XSS攻击
                out.print(" " + attrName + "=\"" + StringEscapeUtils.escapeHtml4(attrValue) + "\"");
            }
            out.print(">");
        } catch (IOException e) {
            throw new JspException("输出标签内容失败", e);
        }
        return EVAL_BODY_INCLUDE;
    }

    @Override
    public int doEndTag() throws JspException {
        try {
            pageContext.getOut().print("</div>");
        } catch (IOException e) {
            throw new JspException("输出标签结束内容失败", e);
        }
        return EVAL_PAGE;
    }

    // 重置属性，避免线程安全问题
    @Override
    public void release() {
        super.release();
        dynamicAttributes.clear();
    }
}

步骤2：在TLD中启用动态属性 #

在标签的TLD配置里添加<dynamic-attributes>true</dynamic-attributes>：

<tag>
  <name>SomeCustomTag</name>
  <tag-class>com.example.SomeCustomTagHandler</tag-class>
  <body-content>JSP</body-content>
  <!-- 开启动态属性支持 -->
  <dynamic-attributes>true</dynamic-attributes>
</tag>

步骤3：在JSP中自由使用 #

现在你就可以直接在自定义标签上添加任何HTML全局属性了：

<my:SomeCustomTag style="color: red; font-size: 16px;" class="custom-class" id="my-tag" title="这是自定义标签">
  标签内容
</my:SomeCustomTag>

方法3：如果使用JSP Tag Files（标签文件） #

如果你是用.tag文件来编写自定义标签，同样支持动态属性。只需要在tag文件顶部声明dynamic-attributes，然后遍历属性输出：

<%@ tag dynamic-attributes="attrs" %>
<div
  <%-- 遍历所有动态属性并输出 --%>
  <c:forEach var="attr" items="${attrs}">
    ${attr.key}="${fn:escapeXml(attr.value)}" 
  </c:forEach>
>
  <jsp:doBody/>
</div>

注意事项 #

• 动态属性的名称要符合HTML规范，避免和标签已声明的属性冲突；
• 一定要对属性值进行HTML转义（比如用Apache Commons Lang的StringEscapeUtils或者JSTL的fn:escapeXml），防止XSS攻击；
• 如果你的标签输出的不是HTML元素，那动态属性可能没意义，按需使用即可。

内容的提问来源于stack exchange，提问作者DanielBK