Follow Techotopia on Twitter

On-line Guides
All Guides
eBook Store
iOS / Android
Linux for Beginners
Office Productivity
Linux Installation
Linux Security
Linux Utilities
Linux Virtualization
Linux Kernel
System/Network Admin
Scripting Languages
Development Tools
Web Development
GUI Toolkits/Desktop
Mail Systems
Eclipse Documentation

How To Guides
General System Admin
Linux Security
Linux Filesystems
Web Servers
Graphics & Desktop
PC Hardware
Problem Solutions
Privacy Policy




Eclipse JavaServer Faces Tooling Development Guide
Previous Page Home Next Page

Providing Design-Time Tag Metadata


This document provides an overview of what is required to provide "design-time" ("DT") metadata for JSP tags. DT metadata is consumed by the DT tag conversion / decoration framework to produce close-to-runtime visuals in the Web Page Editor.

This note assumes the following user knowledge:
  • How to create plugin projects
  • How to declare dependencies in plugin projects
  • How to use extension points
  • How to package and deploy plugins

Setup Steps

The following setup steps are described in more details in the sections that follow:
  1. Create a Plug-in Project
  2. Specify plug-in's dependencies
  3. Configure "standardMetaDataFiles" extension point
  4. Create DT metadata XML file

Create a Plug-in Project

A plug-in project is required to use the "standardMetaDataFiles" extension point and to contain the DT metadata file.
  1. Select menu items, "File" > "New" > "Project..."
  2. Select "Plug-in Project" and click "Next >"
  3. Provide a reasonable value for "Project name" and click "Next >"
  4. Provide reasonable values for "Plug-in Properties"
  5. Uncheck "This plug-in will make contributions to the UI"
  6. Click "Finish"

Specify Plug-in's Dependencies

  1. Open the new project's "META-INF/MANIFEST.MF" file in the "Plug-in Manifest Editor"
  2. Select the "Dependencies" tab
  3. Add "org.eclipse.jst.jsf.common" under "Required Plug-ins"

Configure "standardMetaDataFiles" Extension Point

  1. Open the new project's "META-INF/MANIFEST.MF" file in the "Plug-in Manifest Editor"
  2. Select the "Extensions" tab
  3. Add "org.eclipse.jst.jsf.common.standardMetaDataFiles" under "All Extensions"
  4. Right-click the new extension and select "New" > "standardMetaDataFile"
  5. Select "(standardMetaDataFile)"
  6. Under "Extension Element Details", set appropriate values:
    1. For "uri", value should match the URI value as set in the tag library
    2. The "location" value is a plugin-relative path and filename (file has not been created yet - value entered will be required in subsequent steps)
    3. No value is required for "locator" (leave blank)
Extension Details

Create DT Metadata XML File

  1. Create necessary folder(s) and file, to match value specified for "location" of the "standardMetaDataFile" (e.g. "metadata/jsf_tomahawk_dti.xml")

Writing the DT Metadata

Document Node

Copy the following XML into the DT metadata file as a starting point:

<?xml version="1.0" encoding="UTF-8"?>
<md:metadatamodel xmlns:xsi=""

Note that the "id" attribute of the document node matches the "uri" as specified previously in the plug-in manifest.

Entity (Tag) Node

Insert the following XML inside the previously created document node:

	<entity id="inputText" type="tag">
		<trait id="dt-info">
			<value xsi:type="dti:DTInfo">
					<operation id="CreateElementOperation">
						<parameter value="input"/>
					<operation id="CopyAllAttributesOperation"/>
					<operation id="RenameAttributeOperation">
						<parameter value="styleClass"/>
						<parameter value="class"/>
					<operation id="CreateAttributeOperation">
						<parameter value="type"/>
						<parameter value="text"/>
				<tag-decorate-info id="vpd-decorate-design"
				<tag-decorate-info id="vpd-decorate-preview">
					<resolve-attribute-value attributeName="value"/>
Note the following:
  • The "entity" node's "id" attribute specifies the name of the tag for which metadata is being provided (in this example, "inputText")
  • The "entity" node must have a "type" attribute with the value "tag"
  • The "trait" node must have an "id" attribute with the value "dt-info"
  • The "value" node must have an "xsi:type" attribute with the value "dti:DTInfo"
  • A single DT metadata file will typically contain one "entity" node per tag for which metadata is being provided - generally there will be one such file per tag library

Child Nodes

The child nodes specify the tag conversion and decoration operations that will be performed to translate the source JSP node into HTML that is rendered in the Web Page Editor. Full discussion of the operations available is outside the scope of this document. The listings above serve to demonstrate the form of the metadata.

(Suggested study materials for interested readers are the metadata files located in the "org.eclipse.jst.pagedesigner.jsf.ui" plug-in, which provide the metadata for JSF core and JSF HTML tag libraries.)


  Published under the terms of the Eclipse Public License Version 1.0 ("EPL") Design by Interspire