About Custom Icons

Sometimes style customization (i.e., custom style definitions) is insufficient when creating a custom look and feel. Another form of customization you can implement is custom icons.

By default, a custom look and feel inherits its icons from the parent look and feel. Not all parent icons are customizable. See the UIX Customization Reference for a list of customizable icons.

To override a customizable icon (e.g., error icon), add a custom icon by using a <icon> element in the <icons> section of the look and feel configuration file . You can add one or more <icon> elements in the<icons> section. Each <icon> element contains a single child element, which must be of a supported icon element type.

ADF UIX supports the following types of custom icons and the corresponding icon element types:

image - For image icons. There are four types of image icon elements:
- <config-image> element - Use with image icons registered with a URI that is relative to the URI defined by the images-directory configuration property.
- <context-image> element - Use with image icons registered with a URI that is relative to the servlet context path.
- <resource-image> element - Use with image icons packaged inside a JAR file and loaded directly from the class path.
- <uri-image> element - Use with image icons registered with a full URI.
text - For text-based icons. There is one text icon element:
- <text> element - Use to replace a parent icon with text.
null - For null icons. There is one null icon element:
- <null> element - Use to replace a parent icon with nothing, i.e., no icon should be rendered.
instance - For Java Icon instances. There is one instance icon element:
- <instance> element - Use with Java Icon instances that are directly instantiated or retrieved from a static function.