NavXp XML Skin Specification

NavXp uses XSLT to render skins. When you create your own skins, you'll be creating xsl files and you'll need to know the structure of the XML file used in the transformation. This is covered in this section.

Structure

  • <profile_items>
  • <info>
  • <theme_id> This is theme unique identifier; you usually use this identifier when developing multi-theme skins in order to differentiate CSS styles that apply for different themes
  • <icon_size> Determines which version of the icons this skin uses; possible values are 16|32|64; you usually use this node to set width and height attributes of the <img> tag that displays the icon
  • <show_icons> Tells if the current theme has been set to render icons; possible values are true|false
  • <show_alts> Tells if the current theme has been set to render alternative texts; possible values are true|false
  • <items> Collection of items to render
  • <item> This node appears N times, where N is the number of root items to render
  • <caption> What text to display
  • <url> Where does the link points to. This can be "javascript: void(0)" for disabled tabs
  • <linkDisabled> Tells if the link is disabled, meaning its url is set to "javascript: void(0)"; possible values are true|false
  • <isSelected> Tells if the current item is currently selected; this means that the active page is this item or one of it's children; possible values are true|false
  • <icon> This is the url of the icon to display; note that it already comes in the version specified by <icon_size>
  • <has_children> Tells if the current item has children; possible values are true|false
  • <items> This is a collection of children items, where each child item has the exact structure in terms of XML definition as a root node described above does

Samples


<profile_items>
<info>
<theme_id>Simple_Red_-_Gray</theme_id>
<icon_size>16</icon_size>
<show_icons>false<show_icons>
<show_alts>true<show_alts>
</info>
<items>
<item>
<caption>Home</caption>
<url>/Home.aspx</url>
<linkDisabled>false<linkDisabled>
<isSelected>true</isSelected>
<icon>/Portals/DesktopModules/NavXp/icons/user_16.png</icon>
<has_children>true</has_children>
<items>
...............................
</items>
</item>
<item>
...............................
</item>
...................................
</items>
</profile_items>
Comments