HOWTO: Register a JSF Tag Library

Updated: March 18, 2024

JSF UI Deprecation
This requires to have the JSF UI addon installed on your server that is deprecated since Nuxeo Platform LTS 2019.
Please refer to the Web UI documentation.

When registering a new tag library for your application, you would usually declare the facelets taglib file in the web.xml configuration file.

As this parameter can only be declared once, and is already declared in the nuxeo base ui module, you cannot declare it using the Nuxeo deployment feature.

So you should declare your custom taglib by placing a file mylibary.taglib.xml in the META-INF folder of your custom jar: it will be registered automatically.

As a reminder, the tag library documentation file, mylibrary.tld, is usually placed in the same folder than the taglib file, but it is only used for documentation: it plays no role in the tags registration in the application.