Skinning HowTo/XUI Other Widgets

These are the XML elements and parameters used to define the floaters, panels, and so forth, that make up the viewer user interface. They are used by the XUI files in the \skins\default\xui folders. See Skinning HowTo/Basics for an explanation of how these are used.

Common parameters

The most common parameters are described here and are just listed under the elements that use them.

name

Required. The XML name of this element. The name must be unique to the floater you are editing.

• IMPORTANT: As noted above, do not re-name XML elements, even for localization. Many of the element names are looked up by the viewer. If the viewer cannot find an element name it expects, it will crash.

String: name="input_first_name"

width

Required. The width of the element, in pixels.

For text, this defines the visible text as well as the clickable area. If the width of a text element is not sufficient to hold the text, the text will be truncated. This is most likely what you will widen when localizing the viewer.

For most other elements, this describes the dimensions of an element, such as a button, icon, panel, text_area, etc.

• Tip: See the bounding boxes of all XML elements in the viewer: Advanced menu > UI > Debug Views.

Integer: width="140"

height

Required. The height of the element, in pixels.

For text, this defines the visible text as well as the clickable area. If the height of a text element is not sufficient to hold the text, the text will be truncated. This is most likely what you will lengthen when localizing the viewer.

For most other elements, this describes the dimensions of an element, such as a button, icon, panel, text_area, etc.

Integer: height="24"

left

Optional. Sets the position in the x dimension of the element's left edge relative to the container's left edge. Positive and negative values are accepted. A negative value will set the position relative to the right edge of the container.

Integer: left="6"

right

Optional. Sets the position in the x dimension of the element's right edge relative to the container's left edge. Positive and negative values are accepted. A negative value will set the position relative to the right edge of the container. Best used to align something to the right.

• For example, given a floater with a width of 500 and a button we wish to right align in the floater, we can set the right to 490 -- this puts the right edge of the button 10 pixels away from the right border of the floater.

Integer: right="6"

left_delta

Optional. (use instead of left) Sets the position in the x dimension of the element's left edge relative to the previous element, or, for the first widget, the left edge of the container. Positive and negative values are accepted. Best used to left-align the current element with the previous element.

• For example, given Button B with a width of 100, a previous Button A with a width of 50 and a distance between elements of 6, we would set the left_delta to -106, putting the left edge of Button B 106 pixels to the left of Button A. We use a negative number to move left, and a positive number to move right.

Integer: left_delta="-106"

right_delta

Optional. (use instead of right) Sets the position in the x dimension of the element's right edge relative to the previous element, or, for the first widget, the left edge of the container. Positive and negative values are accepted. Best used to right-align the current element with the previous element.

• For example, given Button B with a width of 100, a previous Button A with a width of 50 and a distance between elements of 6, we would set the right_delta to 106, putting the left edge of Button B 106 pixels to the left of Button A.

Integer: left_delta="106"

bottom

Optional. Sets the position in the y dimension of the element's bottom edge relative to the container. Positive and negative values are accepted. For example, given a floater with a height of 300 and a title 20 pixels tall and we want , we can set the bottom to (NEED TO DO MATH, LOL) -- putting the bottom edge of the title 40 pixels away from the top border of the floater.

Integer: bottom="(NEED TO DO MATH, LOL)"

follows

Optional. Sets which edge(s) an element follows when the containing element is resized. Specifying all edges results in an element that can dynamically resize itself with its container.

Values: left, top, right, bottom. String multiple values together using pipes.

The following example sets an element to follow both the left and the top, such as a floater's title may be designed: String: follows="left|top"

font

Optional. Sets which size and style of the application font to use. The default is SansSerifSmall for text elements and SansSerif for controls (such as check_box and button.

Values: SansSerifSmall, SansSerif, SansSerifBig, SansSerifBold, Monospace

String: font="SansSerifSmall"

Widgets With No Parameters

fonts

Can contain font and font_size.

file

Used by font and os.

defaultlabel

Used by mimetypes.

defaultwidget

Used by mimetypes.

defaultimpl

Used by mimetypes.

default_type

Used by widgetset.

allow_resize

Used by widgetset.

allow_looping

USed by widgetset.

widgettype

Used by scheme and mimetype.

impl

Used by mimetype.

notifications

Can contain global, notification, and template.

unique

Used by notification. Can contain context.

role_actions

Can contain action_set.

strings

Can contain string.

teleport_messages

Can contain message_set.

XUI Text Parameters

---

fonts

---

Can contain font and font_size.

font_size parameters

---

Used by fonts.

font parameters

---

Used by fonts. Can contain file and os.

font_style

Optional.

os parameters

---

Used by font. Can contain file.

file

---

Used by font and os.

---

---

---

defaultlabel

---

Used by mimetypes.

defaultwidget

---

Used by mimetypes.

defaultimpl

---

Used by mimetypes.

scheme parameters

---

Used by mimetypes. Can contain label and widgettype.

widgetset parameters

---

Used by mimetypes. Can contain allow_looping, allow_resize, default_type, icon, label, playtip, and tooltip.

mimetype parameters

---

Used by mimetypes. Can contain impl, label, and widgettype.

menu

Optional.

impl

---

Used by mimetype.

widgettype

---

Used by scheme and mimetype.

label parameters

---

Used by widgetset, scheme, mimetype.

allow_resize

---

Used by widgetset.

allow_looping

---

Used by widgetset.

default_type

---

Used by widgetset.

playtip parameters

---

Used by widgetset.

tooltip parameters

---

Used by widgetset.

icon parameters

---

Used by floater, panel, layout_stack, layout_panel, multi_floater, and widgetset.

image_name

Required. Specifies the name of the image to load for this icon.

String: image_name="myicon.png"

bottom

Optional.

bottom_delta

Optional.

top

Optional.

left

Optional.

left_delta

Optional.

right

Optional.

follows

Optional.

name

Optional.

color

Optional.

enabled

Optional.

height

Optional.

width

Optional.

mouse_opaque

Optional.

bg_alpha_color

Optional.

border

Optional.

scale_image

Optional.

auto_resize

Optional.

visible

Optional.

label

Optional.

tool_tip

Optional.

---

---

notifications

---

Can contain global, notification, and template.

global parameters

---

Used by notifications.

template parameters

---

Used by notifications. Can contain form.

notification parameters

---

Used by notifications. Can contain form, unique, url, and usetemplate.

functor

Optional.

label

Optional.

priority

Optional.

sound

Optional.

duration

Optional.

form parameters

---

Used by template and notification. Can contain button, ignore, and input.

name

Optional.

ignore parameters

---

Used by form.

name

Optional.

save_option

Optional.

input parameters

---

Used by form.

button parameters

---

Used by floater, panel, layout_stack, layout_panel, and form.

scale_image

Optional. Specifies whether to scale the button art as its container/floater is resized. As of 1.18.x, all button art has this property set to true where the button size is not equal to 32x128.

Boolean: scale_image="true"

label

Optional. Label is the text on the button's face. Without a specified label (and no image_overlay declared), your button will be labeled "Button". String: label="Click Me!"

label_selected

Optional. Label is the text on the button's face when pressed into an 'on' state. Your button will inherit the label if you omit this property. String: label_selected="I've been clicked."

font

(under construction)

font_style

Optional. Styles the text. Allows multiple style selections. As of 1.18.x, the style options are:

• normal: Apply the default styles of the selected font. (For example, SansSerifBold has a default bold style applied to it.)
• bold: Bolds the text.
• italic: Italicizes the text.
• underline: Underlines the text.
• drop_shadow: Old-style 1px offset of black under the text.
• drop_shadow_soft: New-style 3px offset of blurred shadow under the text.

String: font_style="bold|underline|drop_shadow_soft"

halign

Optional. Controls horizontal alignment of label on button face. Options are "left", "center" and "right".

image_unselected

Optional. Overrides the default button art for the unselected/up and enabled button state. Art must be located in the ..\skins\textures directory within the Second Life application folder (on a Mac, this is inside the package at Contents/MacOS/Resources/skins/textures). Art must also be named in textures.xml with an assigned UUID. By default, the button art is stretched to fit the specified button size.

String: image_unselected="btn_square_32x128.tga"

image_selected

Optional. Overrides the default button art for the selected/down button state. Art must be located in the ..\skins\[SKIN]\textures directory within the Second Life application folder (on a Mac, this is inside the package at Contents/MacOS/Resources/skins/textures). By default, the button art is stretched to fit the specified button size.

String: image_selected="btn_square-down_32x128.tga"

image_hover_selected

Optional. Overrides the default button art for the selected/down and mouseover/hover button state. Art must be located in the ..\skins\textures directory within the Second Life application folder (on a Mac, this is inside the package at Contents/MacOS/Resources/skins/[SKIN]/textures). Art must also be named in textures.xml with an assigned UUID. By default, the button art is stretched to fit the specified button size.

String: image_unselected="btn_square-down-hover_32x128.tga"

image_hover_unselected

Optional. Overrides the default button art for the unselected/up and mouseover/hover button state. Art must be located in the ..\skins\[SKIN]\textures directory within the Second Life application folder (on a Mac, this is inside the package at Contents/MacOS/Resources/skins/[SKIN]/textures). Art must also be named in textures.xml with an assigned UUID. By default, the button art is stretched to fit the specified button size.

String: image_unselected="btn_square-up-hover_32x128.tga"

image_disabled

Optional. Overrides the default button art for the disabled button state. Art must be located in the ..\skins\textures directory within the Second Life application folder (on a Mac, this is inside the package at Contents/MacOS/Resources/skins/[SKIN]/textures). Art must also be named in textures.xml with an assigned UUID. By default, the button art is stretched to fit the specified button size.

String: image_unselected="btn_square-disabled_32x128.tga"

image_disabled_selected

Optional. Overrides the default button art for the disabled and selected/down button state. Art must be located in the ..\skins\[SKIN]\textures directory within the Second Life application folder (on a Mac, this is inside the package at Contents/MacOS/Resources/skins/textures). Art must also be named in textures.xml with an assigned UUID. By default, the button art is stretched to fit the specified button size.

String: image_unselected="btn_square-down-disabled_32x128.tga"

image_overlay

Optional. Applies an overlay image to the button. The button art will be sized to fit. As of 1.18.x, these icons should be 16 pixels high at maximum on a standard height 24px button to minimize scaling artifacts. Can be used with or without text. Art must be located in the ..\skins\[SKIN]\textures directory within the Second Life application folder (on a Mac, this is inside the package at Contents/MacOS/Resources/skins/[SKIN]/textures). Art must also be named in textures.xml with an assigned UUID. See image_overlay_alignment for alignment options.

String: image_overlay="icn_media-play_16.tga"

image_overlay_alignment

Optional. Sets the alignment of the image_overlay icon.

Values:

• left: left-aligns the art on the button. This standard is used for new button art with text in the Dazzle branch.
• right: right-aligns the the art on the button.
• center: centers the art on the button. This standard is used for new button art without text in the Dazzle branch.

String: image_overlay_alignment="left"

toggle

Optional. Determines whether the button is a toggle button or not. The Fly/Stop Flying button is a toggle button, for example.

Boolean: toggle="false"

bottom

Optional.

bottom_delta

Optional.

left

Optional.

left_delta

Optional.

right

Optional.

enabled

Optional.

follows

Optional.

height

Optional.

width

Optional.

mouse_opaque

Optional.

tool_tip

Optional.

visible

Optional.

tab_group

Optional.

pad_right

Optional.

hidden

Optional.

tab_stop

Optional.

help_url

Optional.

sound_flags

Optional.

auto_resize

Optional.

user_resize

Optional.

valign

Optional.

default

Optional.

index

Optional.

text

Optional.

ignore

Optional.

control_name

Optional.

label_width

Optional.

image

Optional.

url parameters

---

Used by notification.

usetemplate parameters

---

Used by notification.

notext

Optional.

canceltext

Optional.

ignoretext

Optional.

unique

---

Used by notification.

context parameters

---

Used by unique.

---

---

role_actions

---

Can contain action_set.

action_set parameters

---

Used by role_actions. Can contain action.

action parameters

---

Used by action_set.

---

---

strings

---

Can contain string.

string parameters

---

Used by floater, panel, multi_floater, and strings.

word_wrap

Optional.

---

---

teleport_messages

---

Can contain message_set.

message_set parameters

---

Used by teleport_messages. Can contain message.

message parameters

---

Used by message_set.

---

---

XUI Containers Parameters

floater parameters

---

Used by tab_container.

can_close

Optional.

can_drag_on_left

Optional.

can_minimize

Optional.

height

Optional.

width

Optional.

max_height

Optional.

min_height

Optional.

min_width

Optional.

rect_control

Optional.

title

Optional.

bottom

Optional.

left

Optional.

can_tear_off

Optional.

enabled

Optional.

mouse_opaque

Optional.

control_name

Optional.

follows

Optional.

border

Optional.

default_tab_group

Optional.

label

Optional.

border_drop_shadow_visible

Optional.

border_visible

Optional.

border_style

Optional.

border_thickness

Optional.

border_bevel

Optional.

bevel_style

Optional.

short_title

Optional.

sound_flags

Optional.

multi_floater parameters

---

Can contain icon, string, tab_container, and panel.

min_height

Optional.

min_width

Optional.

bottom

Optional.

left

Optional.

enabled

Optional.

follows

Optional.

mouse_opaque

Optional.

title_bar

Optional.

panel parameters

---

Used by floater, tab_container, layout_panel, multi_floater, and recursively by other panels.

border

Optional.

bottom

Optional.

bottom_delta

Optional.

top

Optional.

left

Optional.

left_delta

Optional.

right

Optional.

enabled

Optional.

follows

Optional.

height

Optional.

width

Optional.

label

Optional.

mouse_opaque

Optional.

name

Optional.

background_opaque

Optional.

background_visible

Optional.

bevel_style

Optional.

bg_alpha_color

Optional.

bg_opaque_color

Optional.

can_resize

Optional.

filename

Optional.

tab_group

Optional.

default_tab_group

Optional.

placeholder

Optional.

border_drop_shadow_visible

Optional.

border_visible

Optional.

border_style

Optional.

border_thickness

Optional.

border_color

Optional.

tool_tip

Optional.

title

Optional.

auto_resize

Optional.

user_resize

Optional.

use_bounding_rect

Optional.

bg_visible

Optional.

can_close

Optional.

can_minimize

Optional.

left_in_finder

Optional.

select

Optional.

visible

Optional.

layout_panel parameters

---

Used by layout_stack. Can contain button, check_box, combo_box, icon, layout_stack, line_editor, panel, progress_bar, scroll_list, text, text_editor, and web_browser.

border

Optional.

bottom

Optional.

left

Optional.

top_delta

Optional.

default_tab_group

Optional.

height

Optional.

min_height

Optional.

min_width

Optional.

auto_resize

Optional.

can_resize

Optional.

user_resize

Optional.

filename

Optional.

visible

Optional.

follows

Optional.

background_visible

Optional.

mouse_opaque

Optional.

use_bounding_rect

Optional.

layout_stack parameters

---

Used by floater, panel, and layout_panel. Can contain button, flyout_button, icon, layout_panel, and scroll_list.

border

Optional.

top

Optional.

right

Optional.

height

Optional.

min_height

Optional.

width

Optional.

min_width

Optional.

orientation

Optional.

tab_group

Optional.

border_size

Optional.

mouse_opaque

Optional.

use_bounding_rect

Optional.

tab_container parameters

---

Used by floater, panel, and multi_floater. Can contain inventory_panel, panel, and floater.

enabled

Optional.

follows

Optional.

height

Optional.

right

Optional.

top

Optional.

bottom

Optional.

bottom_delta

Optional.

mouse_opaque

Optional.

width

Optional.

tab_width

Optional.

tab_min_width

Optional.

tab_max_width

Optional.

border

Optional.

tab_group

Optional.

hide_tabs

Optional.

XUI Menus Parameters

menu_bar parameters

---

Used by floater and panel. Can contain menu.

enabled

Optional.

tear_off

Optional.

menu parameters

---

Used by menu_bar and recursively by other menus. Can contain menu, menu_item_call, menu_item_check, menu_item_separator, and tearoff_menu.

bottom_delta

Optional.

bottom

Optional.

left

Optional.

drop_shadow

Optional.

height

Optional.

width

Optional.

label

Optional.

tear_off

Optional.

enabled

Optional.

color

Optional.

create_jump_keys

Optional.

visible

Optional.

hidden

Optional.

pie_menu parameters

---

Used recursively by other pie_menus. Can contain pie_menu.

label

Optional.

enabled

Optional.

tearoff_menu parameters

---

Used by menu.

menu_item_check parameters

---

Used by menu. Can contain on_check, on_click, and on_enable.

bottom_delta

Optional.

bottom

Optional.

control_name

Optional.

enabled

Optional.

shortcut

Optional.

menu_item_separator parameters

---

Used by menu and pie_menu.

bottom_delta

Optional.

bottom

Optional.

left

Optional.

height

Optional.

width

Optional.

label

Optional.

mouse_opaque

Optional.

name

Optional.

enabled

Optional.

menu_item_call parameters

---

Used by menu and pie_menu. Can contain on_click, on_enable, and on_visible.

bottom_delta

Optional.

bottom

Optional.

left

Optional.

height

Optional.

width

Optional.

mouse_opaque

Optional.

enabled

Optional.

shortcut

Optional.

useMacCtrl

Optional.

visible

Optional.

hidden

Optional.

on_check parameters

---

Used by menu_item_check.

function

Optional.

userdata

Optional.

control

Optional.

on_click parameters

---

Used by menu_item_call and menu_item_check.

filter

Optional.

name

Optional.

on_visible parameters

---

Used by menu_item_call.

on_enable parameters

---

Used by menu_item_call and menu_item_check.

userdata

Optional.

name

Optional.

XUI Widgets Parameters

button parameters

---

Used by floater, panel, layout_stack, layout_panel, and form.

scale_image

Optional. Specifies whether to scale the button art as its container/floater is resized. As of 1.18.x, all button art has this property set to true where the button size is not equal to 32x128.

Boolean: scale_image="true"

label

Optional. Label is the text on the button's face. Without a specified label (and no image_overlay declared), your button will be labeled "Button". String: label="Click Me!"

label_selected

Optional. Label is the text on the button's face when pressed into an 'on' state. Your button will inherit the label if you omit this property. String: label_selected="I've been clicked."

font

(under construction)

font_style

Optional. Styles the text. Allows multiple style selections. As of 1.18.x, the style options are:

• normal: Apply the default styles of the selected font. (For example, SansSerifBold has a default bold style applied to it.)
• bold: Bolds the text.
• italic: Italicizes the text.
• underline: Underlines the text.
• drop_shadow: Old-style 1px offset of black under the text.
• drop_shadow_soft: New-style 3px offset of blurred shadow under the text.

String: font_style="bold|underline|drop_shadow_soft"

halign

Optional. Controls horizontal alignment of label on button face. Options are "left", "center" and "right".

image_unselected

Optional. Overrides the default button art for the unselected/up and enabled button state. Art must be located in the ..\skins\textures directory within the Second Life application folder (on a Mac, this is inside the package at Contents/MacOS/Resources/skins/textures). Art must also be named in textures.xml with an assigned UUID. By default, the button art is stretched to fit the specified button size.

String: image_unselected="btn_square_32x128.tga"

image_selected

Optional. Overrides the default button art for the selected/down button state. Art must be located in the ..\skins\[SKIN]\textures directory within the Second Life application folder (on a Mac, this is inside the package at Contents/MacOS/Resources/skins/textures). By default, the button art is stretched to fit the specified button size.

String: image_selected="btn_square-down_32x128.tga"

image_hover_selected

Optional. Overrides the default button art for the selected/down and mouseover/hover button state. Art must be located in the ..\skins\textures directory within the Second Life application folder (on a Mac, this is inside the package at Contents/MacOS/Resources/skins/[SKIN]/textures). Art must also be named in textures.xml with an assigned UUID. By default, the button art is stretched to fit the specified button size.

String: image_unselected="btn_square-down-hover_32x128.tga"

image_hover_unselected

Optional. Overrides the default button art for the unselected/up and mouseover/hover button state. Art must be located in the ..\skins\[SKIN]\textures directory within the Second Life application folder (on a Mac, this is inside the package at Contents/MacOS/Resources/skins/[SKIN]/textures). Art must also be named in textures.xml with an assigned UUID. By default, the button art is stretched to fit the specified button size.

String: image_unselected="btn_square-up-hover_32x128.tga"

image_disabled

Optional. Overrides the default button art for the disabled button state. Art must be located in the ..\skins\textures directory within the Second Life application folder (on a Mac, this is inside the package at Contents/MacOS/Resources/skins/[SKIN]/textures). Art must also be named in textures.xml with an assigned UUID. By default, the button art is stretched to fit the specified button size.

String: image_unselected="btn_square-disabled_32x128.tga"

image_disabled_selected

Optional. Overrides the default button art for the disabled and selected/down button state. Art must be located in the ..\skins\[SKIN]\textures directory within the Second Life application folder (on a Mac, this is inside the package at Contents/MacOS/Resources/skins/textures). Art must also be named in textures.xml with an assigned UUID. By default, the button art is stretched to fit the specified button size.

String: image_unselected="btn_square-down-disabled_32x128.tga"

image_overlay

Optional. Applies an overlay image to the button. The button art will be sized to fit. As of 1.18.x, these icons should be 16 pixels high at maximum on a standard height 24px button to minimize scaling artifacts. Can be used with or without text. Art must be located in the ..\skins\[SKIN]\textures directory within the Second Life application folder (on a Mac, this is inside the package at Contents/MacOS/Resources/skins/[SKIN]/textures). Art must also be named in textures.xml with an assigned UUID. See image_overlay_alignment for alignment options.

String: image_overlay="icn_media-play_16.tga"

image_overlay_alignment

Optional. Sets the alignment of the image_overlay icon.

Values:

• left: left-aligns the art on the button. This standard is used for new button art with text in the Dazzle branch.
• right: right-aligns the the art on the button.
• center: centers the art on the button. This standard is used for new button art without text in the Dazzle branch.

String: image_overlay_alignment="left"

toggle

Optional. Determines whether the button is a toggle button or not. The Fly/Stop Flying button is a toggle button, for example.

Boolean: toggle="false"

bottom

Optional.

bottom_delta

Optional.

left

Optional.

left_delta

Optional.

right

Optional.

enabled

Optional.

follows

Optional.

height

Optional.

width

Optional.

mouse_opaque

Optional.

tool_tip

Optional.

visible

Optional.

tab_group

Optional.

pad_right

Optional.

hidden

Optional.

tab_stop

Optional.

help_url

Optional.

sound_flags

Optional.

auto_resize

Optional.

user_resize

Optional.

valign

Optional.

default

Optional.

index

Optional.

text

Optional.

ignore

Optional.

control_name

Optional.

label_width

Optional.

image

Optional.

check_box parameters

---

Used by floater, panel, and layout_panel.

bottom

Optional.

bottom_delta

Optional.

left

Optional.

left_delta

Optional.

right

Optional.

enabled

Optional.

follows

Optional.

font

Optional.

height

Optional.

width

Optional.

initial_value

Optional.

label

Optional.

mouse_opaque

Optional.

radio_style

Optional.

tool_tip

Optional.

tab_stop

Optional.

control_name

Optional.

visible

Optional.

tab_group

Optional.

halign

Optional.

border_drop_shadow_visible

Optional.

hidden

Optional.

max_length

Optional.

color_swatch parameters

---

Used by floater and panel.

border_color

Optional.

bottom

Optional.

bottom_delta

Optional.

left

Optional.

left_delta

Optional.

color

Optional.

mouse_opaque

Optional.

tool_tip

Optional.

visible

Optional.

control_name

Optional.

enabled

Optional.

floater parameters

---

Used by tab_container.

can_close

Optional.

can_drag_on_left

Optional.

can_minimize

Optional.

height

Optional.

width

Optional.

max_height

Optional.

min_height

Optional.

min_width

Optional.

rect_control

Optional.

title

Optional.

bottom

Optional.

left

Optional.

can_tear_off

Optional.

enabled

Optional.

mouse_opaque

Optional.

control_name

Optional.

follows

Optional.

border

Optional.

default_tab_group

Optional.

label

Optional.

border_drop_shadow_visible

Optional.

border_visible

Optional.

border_style

Optional.

border_thickness

Optional.

border_bevel

Optional.

bevel_style

Optional.

short_title

Optional.

sound_flags

Optional.

multi_floater parameters

---

Can contain icon, string, tab_container, and panel.

min_height

Optional.

min_width

Optional.

bottom

Optional.

left

Optional.

enabled

Optional.

follows

Optional.

mouse_opaque

Optional.

title_bar

Optional.

panel parameters

---

Used by floater, tab_container, layout_panel, multi_floater, and recursively by other panels.

border

Optional.

bottom

Optional.

bottom_delta

Optional.

top

Optional.

left

Optional.

left_delta

Optional.

right

Optional.

enabled

Optional.

follows

Optional.

height

Optional.

width

Optional.

label

Optional.

mouse_opaque

Optional.

name

Optional.

background_opaque

Optional.

background_visible

Optional.

bevel_style

Optional.

bg_alpha_color

Optional.

bg_opaque_color

Optional.

can_resize

Optional.

filename

Optional.

tab_group

Optional.

default_tab_group

Optional.

placeholder

Optional.

border_drop_shadow_visible

Optional.

border_visible

Optional.

border_style

Optional.

border_thickness

Optional.

border_color

Optional.

tool_tip

Optional.

title

Optional.

auto_resize

Optional.

user_resize

Optional.

use_bounding_rect

Optional.

bg_visible

Optional.

can_close

Optional.

can_minimize

Optional.

left_in_finder

Optional.

select

Optional.

visible

Optional.

menu parameters

---

Used by menu_bar and recursively by other menus. Can contain menu, menu_item_call, menu_item_check, menu_item_separator, and tearoff_menu.

bottom_delta

Optional.

bottom

Optional.

left

Optional.

drop_shadow

Optional.

height

Optional.

width

Optional.

label

Optional.

tear_off

Optional.

enabled

Optional.

color

Optional.

create_jump_keys

Optional.

visible

Optional.

hidden

Optional.

menu_bar parameters

---

Used by floater and panel. Can contain menu.

enabled

Optional.

tear_off

Optional.

pie_menu parameters

---

Used recursively by other pie_menus. Can contain pie_menu.

label

Optional.

enabled

Optional.

---

icon parameters

---

Used by floater, panel, layout_stack, layout_panel, multi_floater, and widgetset.

image_name

Required. Specifies the name of the image to load for this icon.

String: image_name="myicon.png"

bottom

Optional.

bottom_delta

Optional.

top

Optional.

left

Optional.

left_delta

Optional.

right

Optional.

follows

Optional.

name

Optional.

color

Optional.

enabled

Optional.

height

Optional.

width

Optional.

mouse_opaque

Optional.

bg_alpha_color

Optional.

border

Optional.

scale_image

Optional.

auto_resize

Optional.

visible

Optional.

label

Optional.

tool_tip

Optional.

button parameters

---

Used by floater, panel, layout_stack, layout_panel, and form.

scale_image

Optional. Specifies whether to scale the button art as its container/floater is resized. As of 1.18.x, all button art has this property set to true where the button size is not equal to 32x128.

Boolean: scale_image="true"

label

Optional. Label is the text on the button's face. Without a specified label (and no image_overlay declared), your button will be labeled "Button". String: label="Click Me!"

label_selected

Optional. Label is the text on the button's face when pressed into an 'on' state. Your button will inherit the label if you omit this property. String: label_selected="I've been clicked."

font

(under construction)

font_style

Optional. Styles the text. Allows multiple style selections. As of 1.18.x, the style options are:

• normal: Apply the default styles of the selected font. (For example, SansSerifBold has a default bold style applied to it.)
• bold: Bolds the text.
• italic: Italicizes the text.
• underline: Underlines the text.
• drop_shadow: Old-style 1px offset of black under the text.
• drop_shadow_soft: New-style 3px offset of blurred shadow under the text.

String: font_style="bold|underline|drop_shadow_soft"

halign

Optional. Controls horizontal alignment of label on button face. Options are "left", "center" and "right".

image_unselected

Optional. Overrides the default button art for the unselected/up and enabled button state. Art must be located in the ..\skins\textures directory within the Second Life application folder (on a Mac, this is inside the package at Contents/MacOS/Resources/skins/textures). Art must also be named in textures.xml with an assigned UUID. By default, the button art is stretched to fit the specified button size.

String: image_unselected="btn_square_32x128.tga"

image_selected

Optional. Overrides the default button art for the selected/down button state. Art must be located in the ..\skins\[SKIN]\textures directory within the Second Life application folder (on a Mac, this is inside the package at Contents/MacOS/Resources/skins/textures). By default, the button art is stretched to fit the specified button size.

String: image_selected="btn_square-down_32x128.tga"

image_hover_selected

Optional. Overrides the default button art for the selected/down and mouseover/hover button state. Art must be located in the ..\skins\textures directory within the Second Life application folder (on a Mac, this is inside the package at Contents/MacOS/Resources/skins/[SKIN]/textures). Art must also be named in textures.xml with an assigned UUID. By default, the button art is stretched to fit the specified button size.

String: image_unselected="btn_square-down-hover_32x128.tga"

image_hover_unselected

Optional. Overrides the default button art for the unselected/up and mouseover/hover button state. Art must be located in the ..\skins\[SKIN]\textures directory within the Second Life application folder (on a Mac, this is inside the package at Contents/MacOS/Resources/skins/[SKIN]/textures). Art must also be named in textures.xml with an assigned UUID. By default, the button art is stretched to fit the specified button size.

String: image_unselected="btn_square-up-hover_32x128.tga"

image_disabled

Optional. Overrides the default button art for the disabled button state. Art must be located in the ..\skins\textures directory within the Second Life application folder (on a Mac, this is inside the package at Contents/MacOS/Resources/skins/[SKIN]/textures). Art must also be named in textures.xml with an assigned UUID. By default, the button art is stretched to fit the specified button size.

String: image_unselected="btn_square-disabled_32x128.tga"

image_disabled_selected

Optional. Overrides the default button art for the disabled and selected/down button state. Art must be located in the ..\skins\[SKIN]\textures directory within the Second Life application folder (on a Mac, this is inside the package at Contents/MacOS/Resources/skins/textures). Art must also be named in textures.xml with an assigned UUID. By default, the button art is stretched to fit the specified button size.

String: image_unselected="btn_square-down-disabled_32x128.tga"

image_overlay

Optional. Applies an overlay image to the button. The button art will be sized to fit. As of 1.18.x, these icons should be 16 pixels high at maximum on a standard height 24px button to minimize scaling artifacts. Can be used with or without text. Art must be located in the ..\skins\[SKIN]\textures directory within the Second Life application folder (on a Mac, this is inside the package at Contents/MacOS/Resources/skins/[SKIN]/textures). Art must also be named in textures.xml with an assigned UUID. See image_overlay_alignment for alignment options.

String: image_overlay="icn_media-play_16.tga"

image_overlay_alignment

Optional. Sets the alignment of the image_overlay icon.

Values:

• left: left-aligns the art on the button. This standard is used for new button art with text in the Dazzle branch.
• right: right-aligns the the art on the button.
• center: centers the art on the button. This standard is used for new button art without text in the Dazzle branch.

String: image_overlay_alignment="left"

toggle

Optional. Determines whether the button is a toggle button or not. The Fly/Stop Flying button is a toggle button, for example.

Boolean: toggle="false"

bottom

Optional.

bottom_delta

Optional.

left

Optional.

left_delta

Optional.

right

Optional.

enabled

Optional.

follows

Optional.

height

Optional.

width

Optional.

mouse_opaque

Optional.

tool_tip

Optional.

visible

Optional.

tab_group

Optional.

pad_right

Optional.

hidden

Optional.

tab_stop

Optional.

help_url

Optional.

sound_flags

Optional.

auto_resize

Optional.

user_resize

Optional.

valign

Optional.

default

Optional.

index

Optional.

text

Optional.

ignore

Optional.

control_name

Optional.

label_width

Optional.

image

Optional.

text_editor parameters

---

Used by floater, panel, and layout_panel. <text_editor> creates a multi-line text box

max_length

Optional.

embedded_items

Optional.

font

Optional.

word_wrap

Optional.

hide_scrollbar

Optional.

cursor_color

Optional.

text_color

Optional.

text_readonly_color

Optional.

bg_readonly_color

Optional.

bg_writeable_color

Optional.

bg_focus_color

Optional.

bottom

Optional.

bottom_delta

Optional.

left

Optional.

left_delta

Optional.

right

Optional.

top

Optional.

follows

Optional.

height

Optional.

width

Optional.

max_length

Optional.

mouse_opaque

Optional.

type

Optional.

bevel_style

Optional.

border_style

Optional.

border_thickness

Optional.

enabled

Optional.

handle_edit_keys_directly

Optional.

select_all_on_focus_received

Optional.

select_on_focus

Optional.

length

Optional.

track_bottom

Optional.

ignore_tab

Optional.

border_drop_shadow_visible

Optional.

border_visible

Optional.

show_line_numbers

Optional.

allow_html

Optional.

hide_border

Optional.

tab_stop

Optional.

is_unicode

Optional.

bg_visible

Optional.

drop_shadow_visible

Optional.

h_pad

Optional.

v_pad

Optional.

halign

Optional.

background_visible

Optional.

text_wrap

Optional.

line_editor parameters

---

Used by floater, panel, and layout_panel. <line_editor> creates a single line text box

label

Optional.

max_length

Optional.

font

Optional.

bevel_style

Optional.

• none
• in
• out
• bright
• line
• texture

border_style

Optional.

border_thickness

Optional.

select_on_focus

Optional.

select_all_focus_received

Optional.

handle_edit_keys_directly

Optional.

cursor_color

Optional.

text_color

Optional.

text_readonly_color

Optional.

bg_readonly_color

Optional.

bg_writeable_color

Optional.

bg_focus_color

Optional.

bottom

Optional.

left

Optional.

right

Optional.

enabled

Optional.

follows

Optional.

handle_edit_keys_directly

Optional.

width

Optional.

mouse_opaque

Optional.

bottom_delta

Optional.

tool_tip

Optional.

left_delta

Optional.

tab_group

Optional.

commit_on_focus_lost

Optional.

hidden

Optional.

is_unicode

Optional.

increment

Optional.

initial_val

Optional.

max_val

Optional.

min_val

Optional.

visible

Optional.

bg_visible

Optional.

border_drop_shadow_visible

Optional.

border_visible

Optional.

drop_shadow_visible

Optional.

h_pad

Optional.

halign

Optional.

prevalidate

Optional.

v_pad

Optional.

word_wrap

Optional.

control_name

Optional.

layout_panel parameters

---

Used by layout_stack. Can contain button, check_box, combo_box, icon, layout_stack, line_editor, panel, progress_bar, scroll_list, text, text_editor, and web_browser.

border

Optional.

bottom

Optional.

left

Optional.

top_delta

Optional.

default_tab_group

Optional.

height

Optional.

min_height

Optional.

min_width

Optional.

auto_resize

Optional.

can_resize

Optional.

user_resize

Optional.

filename

Optional.

visible

Optional.

follows

Optional.

background_visible

Optional.

mouse_opaque

Optional.

use_bounding_rect

Optional.

layout_stack parameters

---

Used by floater, panel, and layout_panel. Can contain button, flyout_button, icon, layout_panel, and scroll_list.

border

Optional.

top

Optional.

right

Optional.

height

Optional.

min_height

Optional.

width

Optional.

min_width

Optional.

orientation

Optional.

tab_group

Optional.

border_size

Optional.

mouse_opaque

Optional.

use_bounding_rect

Optional.

string parameters

---

Used by floater, panel, multi_floater, and strings.

word_wrap

Optional.

tab_container parameters

---

Used by floater, panel, and multi_floater. Can contain inventory_panel, panel, and floater.

enabled

Optional.

follows

Optional.

height

Optional.

right

Optional.

top

Optional.

bottom

Optional.

bottom_delta

Optional.

mouse_opaque

Optional.

width

Optional.

tab_width

Optional.

tab_min_width

Optional.

tab_max_width

Optional.

border

Optional.

tab_group

Optional.

hide_tabs

Optional.

text parameters

---

Used by floater, panel, and layout_panel.

type

Optional.

length

Optional.

width

Optional.

height

Optional.

bg_visible

Optional.

border_drop_shadow_visible

Optional.

drop_shadow_visible

Optional.

border_visible

Optional.

bottom

Optional.

bottom_delta

Optional.

top

Optional.

left

Optional.

left_delta

Optional.

right

Optional.

enabled

Optional.

follows

Optional.

font

Optional.

h_pad

Optional.

halign

Optional.

v_pad

Optional.

valign

Optional.

mouse_opaque

Optional.

name

Optional.

visible

Optional.

hidden

Optional.

tool_tip

Optional.

tab_stop

Optional.

initial_value

Optional.

label

Optional.

radio_style

Optional.

word_wrap

Optional.

control_name

Optional.

font_size

Optional.

font_style

Optional.

font-style

Optional.

bevel_style

Optional.

border_style

Optional.

border_thickness

Optional.

is_unicode

Optional.

max_length

Optional.

hover

Optional.

hover_cursor

Optional.

hover_color

Optional.

text_color

Optional.

align

Optional.

text_wrap

Optional.

text_enabled_color

Optional.

allow_html

Optional.

bg_readonly_color

Optional.

embedded_items

Optional.

hide_border

Optional.

hide_scrollbar

Optional.

line_spacing

Optional.

disabled_color

Optional.

message parameters

---

Used by message_set.

message_set parameters

---

Used by teleport_messages. Can contain message.

action parameters

---

Used by action_set.

action_set parameters

---

Used by role_actions. Can contain action.

progress_bar parameters

---

Used by layout_panel.

slider_bar parameters

---

Used by panel.

locate parameters

---

Used by panel.

context parameters

---

Used by unique.

input parameters

---

Used by form.

form parameters

---

Used by template and notification. Can contain button, ignore, and input.

name

Optional.

url parameters

---

Used by notification.

usetemplate parameters

---

Used by notification.

notext

Optional.

canceltext

Optional.

ignoretext

Optional.

notification parameters

---

Used by notifications. Can contain form, unique, url, and usetemplate.

functor

Optional.

label

Optional.

priority

Optional.

sound

Optional.

duration

Optional.

ignore parameters

---

Used by form.

name

Optional.

save_option

Optional.

template parameters

---

Used by notifications. Can contain form.

global parameters

---

Used by notifications.

mimetype parameters

---

Used by mimetypes. Can contain impl, label, and widgettype.

menu

Optional.

scheme parameters

---

Used by mimetypes. Can contain label and widgettype.

playtip parameters

---

Used by widgetset.

tooltip parameters

---

Used by widgetset.

label parameters

---

Used by widgetset, scheme, mimetype.

widgetset parameters

---

Used by mimetypes. Can contain allow_looping, allow_resize, default_type, icon, label, playtip, and tooltip.

menu_item_check parameters

---

Used by menu. Can contain on_check, on_click, and on_enable.

bottom_delta

Optional.

bottom

Optional.

control_name

Optional.

enabled

Optional.

shortcut

Optional.

menu_item_separator parameters

---

Used by menu and pie_menu.

bottom_delta

Optional.

bottom

Optional.

left

Optional.

height

Optional.

width

Optional.

label

Optional.

mouse_opaque

Optional.

name

Optional.

enabled

Optional.

menu_item_call parameters

---

Used by menu and pie_menu. Can contain on_click, on_enable, and on_visible.

bottom_delta

Optional.

bottom

Optional.

left

Optional.

height

Optional.

width

Optional.

mouse_opaque

Optional.

enabled

Optional.

shortcut

Optional.

useMacCtrl

Optional.

visible

Optional.

hidden

Optional.

on_click parameters

---

Used by menu_item_call and menu_item_check.

filter

Optional.

name

Optional.

on_check parameters

---

Used by menu_item_check.

function

Optional.

userdata

Optional.

control

Optional.

on_visible parameters

---

Used by menu_item_call.

on_enable parameters

---

Used by menu_item_call and menu_item_check.

userdata

Optional.

name

Optional.

tearoff_menu parameters

---

Used by menu.

os parameters

---

Used by font. Can contain file.

joystick_turn parameters

---

Used by floater.

joystick_slide parameters

---

Used by floater.

search_editor parameters

---

Used by floater.

label

Optional.

enabled

Optional.

name_editor parameters

---

Used by panel.

bg_readonly_color

Optional.

text_readonly_color

Optional.

enabled

Optional.

is_unicode

Optional.

web_browser parameters

---

Used by floater, panel, and layout_panel.

top

Optional.

right

Optional.

font

Optional.

border_visible

Optional.

width

Optional.

height

Optional.

caret_color

Optional.

start_url

Optional.

embedded_items

Optional.

max_length

Optional.

mouse_opaque

Optional.

word_wrap

Optional.

ignore_ui_scale

Optional.

view_border parameters

---

Used by panel.

bevel_style

Optional.

border_thickness

Optional.

bottom_delta

Optional.

bottom

Optional.

left_delta

Optional.

left

Optional.

right

Optional.

mouse_opaque

Optional.

name

Optional.

blevel_style

Optional.

border

Optional.

multi_slider parameters

---

Used by panel.

draw_track

Optional.

use_triangle

Optional.

scroll_container parameters

---

Used by floater.

color_swatch parameters

---

Used by floater and panel.

border_color

Optional.

bottom

Optional.

bottom_delta

Optional.

left

Optional.

left_delta

Optional.

color

Optional.

mouse_opaque

Optional.

tool_tip

Optional.

visible

Optional.

control_name

Optional.

enabled

Optional.

radio_item parameters

---

Used by radio_group.

type

Optional.

length

Optional.

width

Optional.

bottom

Optional.

bottom_delta

Optional.

left

Optional.

left_delta

Optional.

follows

Optional.

mouse_opaque

Optional.

radio_group parameters

---

Used by floater and panel. Can contain radio_item.

bottom

Optional.

bottom_delta

Optional.

left

Optional.

left_delta

Optional.

right

Optional.

control_name

Optional.

draw_border

Optional.

width

Optional.

mouse_opaque

Optional.

tool_tip

Optional.

label

Optional.

text_disabled_color

Optional.

enabled

Optional.

visible

Optional.

enabled

Optional.

tool_tip

Optional.

flyout_button_item parameters

---

Used by flyout_button.

flyout_button parameters

---

Used by floater, panel, and layout_stack. Can contain flyout_button_item.

bottom

Optional.

bottom_delta

Optional.

left

Optional.

left_delta

Optional.

halign

Optional.

label_selected

Optional.

list_position

Optional.

mouse_opaque

Optional.

font

Optional.

auto_resize

Optional.

user_resize

Optional.

enabled

Optional.

inventory_panel parameters

---

Used by floater, panel, and tab_container.

bottom

Optional.

bottom_delta

Optional.

left

Optional.

left_delta

Optional.

label

Optional.

enabled

Optional.

slider parameters

---

Used by floater and panel.

bottom_delta

Optional.

bottom

Optional.

left_delta

Optional.

left

Optional.

right

Optional.

follows

Optional.

width

Optional.

initial_val

Optional.

label

Optional.

label_width

Optional.

show_text

Optional.

control_name

Optional.

decimal_digits

Optional.

can_edit_text

Optional.

enabled

Optional.

mouse_opaque

Optional.

value

Optional.

tool_tip

Optional.

volume

Optional.

edit_text

Optional.

pad parameters

---

Used by floater and panel.

width

Optional.

bottom

Optional.

left

Optional.

volume_slider parameters

---

Used by floater and panel.

bottom

Optional.

bottom_delta

Optional.

left

Optional.

left_delta

Optional.

follows

Optional.

mouse_opaque

Optional.

hidden

Optional.

enabled

Optional.

tool_tip

Optional.

control_name

Optional.

spinner parameters

---

Used by floater and panel.

bottom

Optional.

bottom_delta

Optional.

left

Optional.

left_delta

Optional.

right_delta

Optional.

decimal_digits

Optional.

enabled

Optional.

follows

Optional.

halign

Optional.

height

Optional.

width

Optional.

increment

Optional.

initial_val

Optional.

min_val

Optional.

tool_tip

Optional.

label

Optional.

label_width

Optional.

mouse_opaque

Optional.

control_name

Optional.

can_edit_text

Optional.

visible

Optional.

allow_text_entry

Optional.

text_enabled_color

Optional.

text_disabled_color

Optional.

bg_visible

Optional.

border_drop_shadow_visible

Optional.

border_visible

Optional.

drop_shadow_visible

Optional.

font

Optional.

h_pad

Optional.

v_pad

Optional.

texture_picker parameters

---

Used by floater and panel.

allow_no_texture

Optional.

bottom

Optional.

bottom_delta

Optional.

left

Optional.

left_delta

Optional.

right

Optional.

can_apply_immediately

Optional.

default_image_name

Optional.

enabled

Optional.

follows

Optional.

label

Optional.

mouse_opaque

Optional.

tool_tip

Optional.

visible

Optional.

combo_item parameters

---

Used by combo_box.

value

Optional.

type

Optional.

length

Optional.

enabled

Optional.

combo_box parameters

---

Used by floater, panel, and layout_panel. Can contain combo_item.

allow_text_entry

Optional.

bottom

Optional.

bottom_delta

Optional.

left

Optional.

left_delta

Optional.

right

Optional.

enabled

Optional.

follows

Optional.

width

Optional.

length

Optional.

max_chars

Optional.

mouse_opaque

Optional.

visible

Optional.

tool_tip

Optional.

label

Optional.

tab_group

Optional.

control_name

Optional.

font

Optional.

initial_value

Optional.

halign

Optional.

max_length

Optional.

bg_readonly_color

Optional.

text_readonly_color

Optional.

column parameters

---

Used by name_list and scroll_list.

label

Optional.

sort

Optional.

width

Optional.

dynamicwidth

Optional.

relwidth

Optional.

image

Optional.

tool_tip

Optional.

user_resize

Optional.

scroll_list parameters

---

Used by floater, panel, layout_stack, and layout_panel. Can contain column.

bottom

Optional.

bottom_delta

Optional.

top

Optional.

right

Optional.

can_resize

Optional.

column_padding

Optional.

column_widths

Optional.

draw_heading

Optional.

draw_stripes

Optional.

draw_border

Optional.

follows

Optional.

multi_select

Optional.

search_column

Optional.

sort_column

Optional.

background_visible

Optional.

height

Optional.

width

Optional.

mouse_opaque

Optional.

enabled

Optional.

tab_group

Optional.

bg_selected_color

Optional.

fg_disable_color

Optional.

fg_selected_color

Optional.

fg_unselected_color

Optional.

tool_tip

Optional.

font

Optional.

heading_font

Optional.

heading_height

Optional.

allow_calling_card_drop

Optional.

tab_stop

Optional.

user_resize

Optional.

sort_ascending

Optional.

name_list parameters

---

Used by floater and panel. Can contain column.

allow_calling_card_drop

Optional.

background_visible

Optional.

bottom

Optional.

bottom_delta

Optional.

left

Optional.

left_delta

Optional.

column_padding

Optional.

draw_border

Optional.

draw_heading

Optional.

draw_stripes

Optional.

enabled

Optional.

follows

Optional.

mouse_opaque

Optional.

name_column_index

Optional.

heading_font

Optional.

heading_height

Optional.

tool_tip

Optional.

bg_selected_color

Optional.

fg_selected_color

Optional.

fg_disable_color

Optional.

fg_unselected_color

Optional.

background_opaque

Optional.

bg_alpha_color

Optional.

bg_opaque_color

Optional.

check_box parameters

---

Used by floater, panel, and layout_panel.

bottom

Optional.

bottom_delta

Optional.

left

Optional.

left_delta

Optional.

right

Optional.

enabled

Optional.

follows

Optional.

font

Optional.

height

Optional.

width

Optional.

initial_value

Optional.

label

Optional.

mouse_opaque

Optional.

radio_style

Optional.

tool_tip

Optional.

tab_stop

Optional.

control_name

Optional.

visible

Optional.

tab_group

Optional.

halign

Optional.

border_drop_shadow_visible

Optional.

hidden

Optional.

max_length

Optional.