Tab Sheet Description Reference

This chapter provides a discussion of an overview of the namespace for the tab sheet description, and its elements and attributes.

1. Overview

Provides an overview of the tab sheet description namespace.

1.1. Features and Usage

Namespace for using a tab sheet in the xfy technology user agent.

1.2. Namespace URI Reference

The namespace's URI reference of the tab sheet description is http://xmlns.xfytec.com/tab. In the following discussion, use the namespace prefix "tab:" in order to describe the elements of the tab sheet description.

Also, we use the following namespaces and their prefixes in the descriptions below.

  • VC Core
    We use xvcd: as the namespace prefix. For more information, see the VC Core Reference.

2. Elements, Attributes and Events Defined within the Tab Sheet Description's Namespace

This section provides a discussion about elements, attributes, and events defined in the namespace for the tab sheet description.

2.1. Tab Sheet Description

Elements and attributes used to use a tab sheet in tab sheet description's namespace are as follows:

tab:tabs Element

Includes the whole tab sheet to use.

Attribute:
class

Used to set CSS class name. Specify by permitted strings as a CSS class name.

If omitted, class name is not assumed to be set.

style

Set a style sheet applied to the whole area of tab sheet. Use CSS as a style sheet language.

If omitted, standard style xfy technology user agent is applied.

select-index

Set a initial sheet to activate. Specify index value assigned with the integer starting from 1 in the defined order of tab sheets.

If omitted, 1 is assumed to be set.

placement

Set position where the tab is placed. This can be described in one of the following strings.

top
Places a tab at the top.
bottom
Places a tab at the bottom.
left
Places a tab at the left.
right
Places a tab at the right.

If omitted, top is assumed to be set.

layout

Sets how to place a tab sheet when tabs do not fit in a row (or a column). Describes how to place with the following string:

scroll
Shows all tabs by scrolling tab display area. A scroll button is displayed in the tab display area. The tabs scroll one by one by clicking on the scroll button.
wrap
Sets the tab display area to multiple lines (or columns) and wraps to display all tabs. Tabs are arranged in defined order from near side of the sheet.

If omitted, scroll is assumed to be set.

Content:

The tab:tabs element contains the following elements:

  • tab:head Element
    Only one element can be specified, if needed. Optional.
  • tab:tab Element
    At least one element needs to be specified. Of one or more elements, as many elements as needed can be specified.

tab:title Element

Sets the title of the whole tab sheet.

Attribute:

No attributes for the element.

Content:

Specify the title of the whole tab sheet by PCDATA string in tab:head element.

tab:style Element

Describes the style sheet used in the tab sheet.

Attribute:
type

Describe the style sheet language to use.

If omitted, text/css is assumed to be set.

Content:

In tab:style element, specify the style sheet described by style sheet language specified by type attribute by PCDATA string.

CSS dynamic pseudo class available in tab:tab element

You can specify the following CSS dynamic pseudo class for tab:tab element when describing style sheet:

tab:hover pseudo class
Specify the style when the pointer appears over the tab.
tab:active pseudo class
Specify the style when the tab sheet is active.

tab:tab Element

Used to define one tab sheet. Define the XML document for one tab sheet in this element.

Attribute:
class

Used to set CSS class name. Specify by permitted strings as a CSS class name.

If omitted, class name is not assumed to be set.

title

Set the title of the tabs. It can be PCDATA string.

If omitted, default string is used as tab title.

icon

Specifies the icon to be displayed in the tab. Specify by URI reference to icon data.

If omitted, URI reference is assumed not to be set, so icon is not displayed in the tab.

source

Set URI reference to external XML document to be placed in the tab sheet.

If omitted, reference is not assumed to be set.

style

Set a style sheet applied to the tab sheet. Use CSS as a style sheet language.

If omitted, standard style xfy technology user agent is applied.

Content:

In tab:tab element, specify vertex element of XML document to be described in the tab sheet. If the content and source attribute are set at the same time, the external XML document specified in the source attribute takes precedence.

2.2. Events

The event elements defined in the tab sheet description namespace are listed below. You don't write an event element to describe your XVCD. Describes the event elements with platform.

tab:selected Event

Issued to the selected tab sheet when the tab sheet is selected by user.

Attribute:

No attributes for the element.

Content:

The tab:selected element is empty.