Provides an overview of the namespace for frame description.
This chapter provides an overview of the namespace for the frame description, and its elements and attributes.
Provides an overview of the namespace for frame description.
The namespace that provides the capability of creating frames.
The namespace's URI reference of the frame description is http://xmlns.xfytec.com/frames. In the following discussion, use the namespace prefix "frames:" in order to describe the elements of the frame description.
Also, we use the following namespaces and their prefixes in the descriptions below.
xvcd: as the namespace prefix. For more information, see the VC Core Reference.
This section provides a discussion about elements, attributes, and events defined in the namespace for the frame description.
The elements and attributes used for the frame structure's description in the namespace for frame description are listed below.
frames:frames ElementInvolves describing the entire frame structure.
id
Gives an element a unique identifier. It can be an ID value.
If omitted, an attribute value is not assumed to be set.
width
The attribute that sets the width of the entire frame structure. The value must be a number with unit. The same unit as CSS is available.
If omitted, an attribute value is not assumed to be set.
height
The attribute that sets the height of the entire frame structure. The value must be a number with unit. The same unit as CSS is available.
If omitted, an attribute value is not assumed to be set.
show-border
Specifies whether borders between frames are displayed. It can be one of the following values:
0, or no
1, or yes
If omitted, no is assumed to be set.
The frames:frames element can contain the following elements.
frames:head Element frames:row Element
frames:column Element
frames:frame Element
frames:head ElementUsed to define a document header as meta information, which uses a frame structure to express the document.
No attributes for the element.
The frames:head element can contain the following elements.
frames:title Element
frames:title ElementDescribes a header of a document that is described using a frame structure.
No attributes for the element.
In the frames:title element, it describes a document header in PCDATA string, which is described using a frame structure.
frames:row ElementDefines a row of a frame. Multiple columns and frames can be included. Places them from the left to the right direction.
id
Gives an element a unique identifier. It can be an ID value.
If omitted, an attribute value is not assumed to be set.
cols
Specifies the frame width. Specifies the width of each frame to be placed with strings delimited by a single-byte comma(,).
If omitted, the attribute value is not assumed to be set.
show-border
Specifies whether borders between frames are displayed. It can be one of the following values:
0, or no
1, or yes
If omitted, the parent frame's setting may be inherited. In the beginning frame, the initial value is no.
border-width
Specifies the border width. This can be an integer value greater than 0.
If omitted, the parent frame's setting may be inherited. In the beginning frame, the initial value is 2.
border-color
Specifies the border color. Describes the attribute in the same way as the color for CSS is specified.
If omitted, rgb( 236, 233, 216 ) is assumed to be set.
Within frames:row element, you can repeat one or more times to describe the combination of the following elements:
frames:column Element
frames:frame Element
frames:column ElementDefines a column of a frame. Multiple rows or frames can be included. Places them from the above to the below direction.
id
Gives an element a unique identifier. It can be an ID value.
Optional. If omitted, an attribute value is not assumed to be set.
rows
Specifies the frame height. Specifies the height of each frame to be placed with strings delimited by a single-byte comma(,).
If omitted, the attribute value is not assumed to be set.
show-border
Specifies whether borders between frames are displayed. It can be one of the following values:
0, or no
1, or yes
If omitted, the parent frame's setting may be inherited. In the beginning frame, the initial value is no.
border-width
Specifies the border width. This can be an integer value greater than 0.
If omitted, the parent frame's setting may be inherited. In the beginning frame, the initial value is 2.
border-color
Specifies the border color. Describes the attribute in the same way as the color for CSS is specified.
If omitted, rgb( 236, 233, 216 ) is assumed to be set.
Within the frames:column element, you can repeat one or more times to describe the combination of the following elements:
frames:row Element frames:frame Element frames:frame ElementDefines a of a frame. Defines the frame display status and the document to be displayed in a frame.
id
Gives an element a unique identifier. It can be an ID value.
If omitted, an attribute value is not assumed to be set.
source
Specifies the document to be displayed in a frame. It can be URI.
If other document is specified in source attribute, you can replace the document in a frame by specifying it as target frame for link functions such as html:a element. If source attribute is omitted and the element content is displayed in a frame, the frame cannot be target frame for link function.
If omitted, the content described within this element may be set as a frame content.
scrolling
Sets the display status of a frame scroll bar. It can be one of the following values:
yes
no
auto
If omitted, auto is assumed to be set.
show-border
Specifies whether borders between frames are displayed. It can be one of the following values:
0, or no
1, or yes
If omitted, the parent frame's setting may be inherited. In the beginning frame, the initial value is no.
border-color
Specifies the border color. Describes the attribute in the same way as the color for CSS is specified.
If omitted, rgb( 236, 233, 216 ) is assumed to be set.
margin-top
Specifies the document to be displayed in a frame and the top margin between frames in pixels. This can be an integer value greater than 0. This attribute may be enabled if an HTML document is displayed in the frame and the margin of the HTML document is not specified.
If omitted, the attribute may depend on the HTML document within a frame.
margin-right
Specifies the document to be displayed in a frame and the right margin between frames in pixels. This can be an integer value greater than 0. This attribute may be enabled if an HTML document is displayed in the frame and the margin of the HTML document is not specified.
If omitted, the attribute may depend on the HTML document within a frame.
margin-bottom
Specifies the document to be displayed in a frame and the bottom margin between frames in pixels. This can be an integer value greater than 0. This attribute may be enabled if an HTML document is displayed in the frame and the margin of the HTML document is not specified.
If omitted, the attribute may depend on the HTML document within a frame.
margin-left
Specifies the document to be displayed in a frame and the left margin between frames in pixels. This can be an integer value greater than 0. This attribute may be enabled if an HTML document is displayed in the frame and the margin of the HTML document is not specified.
If omitted, the attribute may depend on the HTML document within a frame.
no-resize
Specifies whether the frame size can be changed using the mouse. It can be a true/false value. If true is specified, you cannot change the frame size. If false is specified, you can change the frame size. However, when the frame of the border tangent to the one you want to change the size of specified that the size cannot be changed, you cannot change the size for the frame.
If omitted, false is assumed to be set.
A document of the frame content can be specified within frames:frame element. If a document is specified within the source attribute, the document specified within the source attribute is displayed as the content.
The event elements defined in the frame description namespace are listed below. You don't write an event element to describe your XVCD. Describes the event elements with platform.
frames:document-changed eventframes: If a frame element is created as the destination of VC, this event is issued when the document displayed in the frame is changed.
url (mandatory)
Indicates the modified document's location. It can be a URL string.
The frames:document-changed element is empty.
frames:column-width-changed eventframes: If a row element is created as the destination of VC, this event element is issued when the width of the frame is changed.
cols (mandatory)
Indicates the width of the frame after it is changed. Describes the width of each frame with strings delimited by a comma(,).
The frames:column-width-changed element is empty.
frames:row-height-changed eventframes: If a column element is created as the destination of VC, this event element is issued when the height of the frame is changed.
rows (mandatory)
Indicates the height of the frame after it is changed. Describes the height of each frame with strings delimited by a comma(,).
The frames:row-height-changed element is empty.