<ux-window>
The <ux-window> element can be used anywhere within a map. If more than one <ux-window> element in a map has the same @name attribute, the first window specification in document order with that @name attribute is used.
Content models
See appendix for information about this element in OASIS document type shells.
Inheritance
- map/ux-window
Example
In this example, a window with a name of "csh" is defined in the map. The window name is later referenced by the @ux-windowref attribute on the <resourceid> element.
<map title="Widget Help">
<topicmeta>
<ux-window id="fg23" name="csh" top="10" left="20" height="400" width="500"
features="status=yes,toolbar=no,menubar=no,location=no" relative="yes"
full-screen="no" />
</topicmeta>
<topicref href="file_ops.dita" type="concept">
<topicref href="saving.dita" type="task" />
<topicref href="deleting.dita" type="task" />
<topicref href="editing.dita" type="task">
<topicmeta>
<resourceid id="ab43" appname="ua"
appid="5432" ux-context-string="idh_fileedit" ux-windowref="csh" />
</topicmeta>
</topicref>
</topicref>
</map>
In this example, different window specifications are defined for tablet and desktop presentation:
<map title="Puggles Help">
<topicmeta>
<ux-window id="p76" name="ux-tablet" top="5%" left="5%" height="90%" width="90%"
features="status=no,toolbar=no,menubar=no,location=no" relative="no"
full-screen="no" />
<ux-window id="p80" name="ux-desktop" top="5%" left="55%" height="60%" width="40%"
features="status=yes,toolbar=no,menubar=no,location=yes" relative="no"
full-screen="no" />
</topicmeta>
<topicref href="c_puggles_intro.dita" type="concept">
<!-- ... -->
</topicref>
</map>
Attributes
The following attributes are available on this element: ID attribute group, Metadata attribute group, Debug attribute group, @class (Not for use by authors), and the attributes defined below.
- @name (REQUIRED)
- The value used to refer to this window definition.
- @top
- The top position of the target help window, whether relative to the calling window or to the entire display. The value of this attribute is a real number optionally followed by a unit of measure from the set of pc, pt, px, in, cm, mm, em (picas, points, pixels, inches, centimeters, millimeters, and ems respectively). The default unit is px (pixels).
- @left
- The left position of the target help window, whether relative to the calling window or to the entire display. The value of this attribute is a real number optionally followed by a unit of measure from the set of pc, pt, px, in, cm, mm, em (picas, points, pixels, inches, centimeters, millimeters, and ems respectively). The default unit is px (pixels).
- @height
- The height of the window. The value of this attribute is a real number optionally followed by a unit of measure from the set of pc, pt, px, in, cm, mm, em (picas, points, pixels, inches, centimeters, millimeters, and ems respectively). The default unit is px (pixels).
- @width
- The width of the window. The value of this attribute is a real number optionally followed by a unit of measure from the set of pc, pt, px, in, cm, mm, em (picas, points, pixels, inches, centimeters, millimeters, and ems respectively). The default unit is px (pixels).
- @on-top
- Indicates whether the initial z-order of the target help window is on top of all windows on the desktop. Allowable values are: "yes", "no", and -dita-use-conref-target. The default value is "no".
- @features
- A list of other features (size, position, scrollbars, etc.) of the window. Each feature name and value can not contain any blank space, and each feature name and value is separated by a comma or other delimiter character.
- @relative
- Indicates whether the window dimensions are relative to the calling window or the
entire target display. The default value is "no". Allowable values are:
- no
- The window dimensions specified on this element are absolute positions (not relative to the calling window).
- yes
- The window dimensions specified on this element are relative to the calling window.
- -dita-use-conref-target
- See Using the -dita-use-conref-target value for more information.
- @full-screen
- Indicates whether the window is initially displayed in a maximized state. Allowable values are: "yes", "no", and -dita-use-conref-target. The default value is "no".