Elementary introduction

Win

This is the basic window widget. It handles all setup and the glue of the windowing system (if any) and the canvas abstraction. It also provides sub-windows (Inwin's) inside the window intended for quick popups of information that may normally use a separate window, but you don't want to here.

Bg

Background handling. As elementary does support transparent (shaped or translucent if you have a compositor) windows, the window background is actually a separate widget you can put in a window if you want a background. This gives you a standard theme defined background OR allows you to also put in a custom image for a window background too.

Icon

A standard icon that may be provided by the theme (delete, edit, arrows etc.) or a custom file (PNG, JPG, EDJE etc.) used for an icon. The Icon may scale or not and of course... support alpha channels.

Box

A box packing widget. Pack into a horizontal or vertical box.

Button

A push-button. Press it and run some function. It can contain a simple label and icon object.

Scroller

This allows the contents to be scrolled around. By default it has "finger scrolling" working with momentum, given that the focus of Elementary is gadgets.

Label

Display text, with simple html-like markup. The theme of course can invent new markup tags and style them any way it likes.

Toggle

Looks very iPhone-like - a toggle button you have to drag left/right like a real sliding toggle-switch to toggle between 2 states.

Frame

Holds some content and has a title. Looks like a "frame", but supports styles so multiple frames are available.

Table

arranges widgets in a table where items can also span multiple columns or rows - even overlap (and then be raised or lowered accordingly to adjust stacking if they do overlap).

Clock

For displaying time and setting it.

Layout

This takes a standard Edje design file and wraps it very thinly in a widget and handles swallowing widgets into swallow regions in the Edje object, allowing Edje to be used as a design and layout tool.

 

Hover

This makes a widget hover over another (tracking its location and size wherever it goes). This is a core that is meant for popping up temporary things over something else. It supports multiple styles and is used in other widgets.

Entry

For entering text in a single or multiple lined way, passwords, copy and paste, etc.

Notepad

A higher level widget that puts together a scroller, entry and some other code to read and write text files. This automatically will load a text file and put it in the notepad, and save it whenever it is modified back to that file. Makes writign a notepad app a breeze.

Anchorview

For viewing text that has anchors (links) in the markup within a scrollable region, and for popping up menus (using Hover) when the anchors are clicked (really handy for doing quick displays of test like messages and having names, numbers and URL's hilighted and ready to click to access)

Anchorblock

Same as Anchorview, but just not scrollable. Intended for putting inside something more complex

Bubble

A lot like the Frame widget, but with a title, note and icon region. Can support multiple directions from which the "speech bubble" comes from. Intended for displaying messages (short ones) to look like some form of speech.

Photo

For displaying the photo of a person (contact). Simple yet with a very specific purpose.

Hoversel

Much like a combobox - when you press the button a list of options slides open to select from - with icons and labels for all. When one is selected it goes away again (or when somewhere else is pressed it is canceled).

Toolbar

For listing a selection of items in a list within a "bar", each item having an icon and label. This is more or less intended for use when selecting different modes - much like a tab widget, but this is just the bar piece.

List

A vertical list of items. Intended for smallish lists (maybe 100 or 200 items at most - the more you have the slower it will get). It can include arbitrary widgets packed to the left/right of a label as well as optionally compress the text of the label to fit the list width. Also includes the scroller for making it scrollable. Supports single and multiple selections.

Carousel

Not finished yet. Will be a carousel-like selector.

Slider

A slider bar to select a value along a range with 4 directions supported, value indicator, unit indicator, icon and label.

Genlist

Not finished yet. Generic list. More work to use that List, but able to hold many more items with much more flexible layouts etc.