RWT Themes

Identifier:

org.eclipse.rap.ui.themes

Since:

RAP 1.0

Description:

This extension point is used to register custom RWT themes. An RWT theme is used to customize the look and feel of applications built with the Rich Ajax Platform. To create a custom theme, a theme definition file must be provided. A theme definition file is a .property file that defines custom values for a number of theming keys. The valid keys are listed and described in the file theme-template.properties in the source folder of the RWT plugin (org.eclipse.rap.rwt). This file also serves as a template for theme definition files.

Configuration Markup:

<!ELEMENT extension (theme+)>

<!ATTLIST extension

point CDATA #REQUIRED

id CDATA #IMPLIED

name CDATA #IMPLIED>

point - a fully qualified identifier of the target extension point
id - an optional identifier of the extension instance
name - an optional name of the extension instance

<!ELEMENT theme EMPTY>

<!ATTLIST theme

id CDATA #REQUIRED

name CDATA #IMPLIED

file CDATA #REQUIRED>

id - a unique name that will be used to identify this theme
name - an optional name for the theme (currently not used)
file - a relative path of a .properties file that contains the theme definitions

Examples:

The following is an example of a theme extension definition:


   <extension point="org.eclipse.rap.ui.themes">
      <theme
            id="my.application.aquablue"
            name="Aqua Blue Theme"
            file="aqua-blue.properties" />
   </extension>

Supplied Implementation:

A template for valid theme files can be found in the src/ directory of the RWT plug-in (org.eclipse.rap.rwt). The file is called theme-template.properties. The RAP demo plugin org.eclipse.rap.demo contains an example of a theme extension.

Copyright (c) 2007 Innoopract Informationssysteme GmbH.
All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html