# 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