YAML Reference: dialogs.yml

Author(s):
Manuela Hutter
Last updated:
2010-11-19

This is a reference for all YAML elements used to create Opera's dialog UI.
If you want to know more about YAML in general and how it is used, see the YAML Introduction.

Toplevel

Key Value Required?
"definitions" see Definitions no*
"dialogs" see Dialogs yes

Definitions

The structure within this element can be altered and expanded. Currently, definitions are sorted by type. This structure was chosen so it would be possible to write validation (e.g. using Kwalify) for the file, in case that was needed.

Key Value Required?
"widgets" map with string keys and Widget values no*
"buttons" map with string keys and Button values no*
"button_strips" map with string keys and Button Strip values no*

Dialogs

Elements are of type Dialog.

Dialog

Generic Values

Key Value Required?
"title" locale string no
"name" string yes
"content" see Widget yes
"button_strip" see Button Strip yes

'Dialog'

Key Value Required?
"type" "Dialog" yes

'AlertDialog'

Key Value Required?
"type" "AlertDialog" yes
"skin_image" string. typical values:
  • "Dialog Error"
  • "Dialog Info"
  • "Dialog Question"
  • "Dialog Warning"
yes

Widget

Generic Values

Key Value Required?
"name" string no**
"minimum-width" widget size no
"minimum-height" widget size no
"nominal-width" widget size no
"nominal-height" widget size no
"preferred-width" widget size no
"preferred-height" widget size no

Generic Widgets

Selectable

Inherits generic widget values.

Key Value Required?
"content" see Widget yes
"inline_content" see Widget yes

Widget State

Key Value Required?
"string" locale string yes
"skin_image" string yes
"action_string"/"action" Action yes
"data" integer yes

Layout Widgets

'GridLayout'

Inherits generic widget values.

Key Value Required?
"type" "GridLayout" yes
"vcenter" boolean no
"template" Grid Row Layout no
"elements" sequence of Grid Row Layouts no**
"colspan" number no

'StackLayout'

Inherits generic widget values.

Key Value Required?
"type" "StackLayout" yes
"vcenter" boolean no
"elements" sequence of Widgets no**

Content Widgets

'Address'

Inherits generic widget values.

Key Value Required?
"type" "Address" yes

'Bookmarks'

Inherits generic widget values.

Key Value Required?
"type" "Bookmarks" yes

'Browser'

Inherits generic widget values.

Key Value Required?
"type" "Browser" yes

'Button'

Inherits generic widget values.

Key Value Required?
"type" "Button" yes
"skin-border-image" string no
"skin-foreground-image" string no
"button-style" "toolbar-image"/"toolbar-text" no

'ButtonSet'

Inherits generic widget values.

Key Value Required?
"type" "ButtonSet" yes

'ButtonStrip'

Inherits generic widget values.

Key Value Required?
"type" "ButtonStrip" yes

'Checkbox'

Inherits from Selectable

Key Value Required?
"type" "Checkbox" yes

'ComposeEdit'

Inherits generic widget values.

Key Value Required?
"type" "ComposeEdit" yes

'Contacts'

Inherits generic widget values.

Key Value Required?
"type" "Contacts" yes

'Dropdown'

Inherits generic widget values.

Key Value Required?
"type" "Dropdown" yes
"ghost-string" locale string no

'Edit'

Inherits generic widget values.

Key Value Required?
"type" "Edit" yes
"password" boolean no
"ghost-string" locale string no

'Expand'

Inherits generic widget values.

Key Value Required?
"type" "Expand" yes

'Filechooser'

Inherits generic widget values.

Key Value Required?
"type" "Filechooser" yes

'FindTextBar'

Inherits generic widget values.

Key Value Required?
"type" "FindTextBar" yes

'Folderchooser'

Inherits generic widget values.

Key Value Required?
"type" "Folderchooser" yes

'Group'

Inherits generic widget values.

Key Value Required?
"type" "Group" yes

'GroupBox'

Inherits generic widget values.

Key Value Required?
"type" "GroupBox" yes

'HelpTooltip'

Inherits generic widget values.

Key Value Required?
"type" "HelpTooltip" yes

'History'

Inherits generic widget values.

Key Value Required?
"type" "History" yes

'Icon'

Inherits generic widget values.

Key Value Required?
"type" "Icon" yes

'Label'

Inherits generic widget values.

Key Value Required?
"type" "Label" yes
"wrap" boolean no

'Links'

Inherits generic widget values.

Key Value Required?
"type" "Links" yes

'Listbox'

Inherits generic widget values.

Key Value Required?
"type" "Listbox" yes

'MultilineEdit'

Inherits generic widget values.

Key Value Required?
"type" "MultilineEdit" yes

'MultilineLabel'

Inherits generic widget values.

Key Value Required?
"type" "MultilineLabel" yes

'Notes'

Inherits generic widget values.

Key Value Required?
"type" "Notes" yes

'NumberEdit'

Inherits generic widget values.

Key Value Required?
"type" "NumberEdit" yes

'Personalbar'

Inherits generic widget values.

Key Value Required?
"type" "Personalbar" yes

'Progress'

Inherits generic widget values.

Key Value Required?
"type" "Progress" yes

'ProgressField'

Inherits generic widget values.

Key Value Required?
"type" "ProgressField" yes

'Quickfind'

Inherits generic widget values.

Key Value Required?
"type" "Quickfind" yes

'Radiobutton'

Inherits from Selectable

Key Value Required?
"type" "Radiobutton" yes

'RichTextEditor'

Inherits generic widget values.

Key Value Required?
"type" "RichTextEditor" yes

'Scrollbar'

Inherits generic widget values.

Key Value Required?
"type" "Scrollbar" yes

'ScrollContainer'

Inherits generic widget values.

Key Value Required?
"type" "ScrollContainer" yes
"content" see Widget yes

'Search'

Inherits generic widget values.

Key Value Required?
"type" "Search" yes

'SearchEdit'

Inherits generic widget values.

Key Value Required?
"type" "SearchEdit" yes

'Separator'

Inherits generic widget values.

Key Value Required?
"type" "Separator" yes

'SkinElement'

Inherits generic widget values.

Key Value Required?
"type" "SkinElement" yes
"skin-image" string yes
"content" see Widget yes

'Slider'

Inherits generic widget values.

Key Value Required?
"type" "Slider" yes

'Splitter'

Inherits generic widget values.

Key Value Required?
"type" "Splitter" yes

'Status'

Inherits generic widget values.

Key Value Required?
"type" "Status" yes

'Tabs'

Inherits generic widget values.

Key Value Required?
"type" "Tabs" yes
"elements" sequence of Tabs yes
Tab

Inherits generic widget values.

Key Value Required?
"type" "Tab" no
"title" locale string no**

'ToggleButton'

Inherits generic widget values.

Key Value Required?
"type" "ToggleButton" yes

'Toolbar'

Inherits generic widget values.

Key Value Required?
"type" "Toolbar" yes

'Treeview'

Inherits generic widget values.

Key Value Required?
"type" "Treeview" yes

'TrustAndSecurity Button'

Inherits generic widget values.

Key Value Required?
"type" "TrustAndSecurity Button" yes

'UniteServicesView'

Inherits generic widget values.

Key Value Required?
"type" "UniteServicesView" yes

'WebImage'

Inherits generic widget values.

Key Value Required?
"type" "WebImage" yes

'Widgets'

Inherits generic widget values.

Key Value Required?
"type" "Widgets" yes

'Workspace'

Inherits generic widget values.

Key Value Required?
"type" "Workspace" yes

'Zoom'

Inherits generic widget values.

Key Value Required?
"type" "Zoom" yes

'ZoomMenuButton'

Inherits generic widget values.

Key Value Required?
"type" "ZoomMenuButton" yes

'ZoomSlider'

Inherits generic widget values.

Key Value Required?
"type" "ZoomSlider" yes

Data Types

Widget size