The snippet element is the top-level element for a snippet. It contains a summary and a content section. If a snippet has both summary and content, the summary section is shown on the Yahoo! home page, and a 'more' link is automatically displayed below it which takes the user to a full-page view of the information which is contained in the extended section. The summary element is required, while the extended element is not. A section is a top-level container of a page. There must be at least one section in every page. Sections are comprised of modules and controls. The header or label of the first section becomes the page's header. The section-module-submodule hierarchy is designed to be very strictly nested. A module is a basic building block of a widget or snippet. It is used to group like pieces of data into one container. It also typically has a header, which can be expressed as either a simple label, or a header, which allows you to do more expressive layout. The section-module-submodule hierarchy is designed to be very strictly nested. A submodule is just like a module, only it cannot contain other modules or submodules. The section-module-submodule hierarchy is designed to be very strictly nested. Headers are used for sections, modules, and submodules. The card layout allows 0..2 images and 1..n blocks. It lays out the first image to the left and any second image to the right. The blocks are laid out top-to-bottom in the center. The simple layout allows an optional image and 1 block. It lays out the image on the left and the block immediately to its right. You should use a 'small' image for this type of layout. The goto element is used to add items to the Options menu (in Yahoo! Go). Under XHTML, the goto items are displayed in a section at the bottom of the page as a series of links. The label element is used by many of the controls as their label. For example, it serves as the title of a trigger (button), or as the name of an item in a select or select1 control. The option element is used to build a contextual options menu that can be accessed by the user either by the left-soft key on Yahoo! Go, or as a series of links in XHTML. For example, you might have options that related to an email you are currently viewing for commands such as 'reply' or even 'compose'. You can put option elements in many different places, and the most appropriate options will be displayed in the menu. For example, in an email application 'compose' might be in the top-level of a section element, whereas 'reply' or 'delete' might be an option inside a placard. When the placard is selected, the options inside of the item are added to the options menu. This makes it behave like a contextual menu in Mac OS or Windows. The option element is also used by the goto menu. The block element is much like the paragraph element of HTML. It is a container for inline content. InnerContent represents those things that can live in any container (basically, controls). The hr element displays a horizontal rule. There are several classes you can use with it: "solid", "dotted", and "none". "none" just displays a blank line. You can use that for a small spacer if desired. The item element is used in select and select1 controls. The input element is a simple one-line text input box. The image-list type is a generic control which shows a given list of images, each of which can have an action associated with it when clicked. It currently tries to show one row of as many images the current device's screen width can accomodate. There is no guarantee that each image you include will be rendered on screen. It is typically used as a preview of a photostream, etc. You can specify a link to jump to for a 'more' link. The navigation-bar element is used primarily as a paging control. In its simplest form, it could be used as a more button. If you want to use it to navigate between multiple pages, you can specify both the next and prev elements. If you desire some sort of 'back' link, you can supply the back element. If you supply an element, but do not supply any actions, the element will be displayed inactive (grayed out). You can use this technique if you are at the first or last page, for example. The placard element is probably the most commonly used element. It allows you to specify text and icons in various different pre-defined layouts. It supports a class of "link" which will give the placard a right-pointing arrow over on the right. The layout-items type is used as a container of those items needed for a layout for a placard or a header. It allows any number of image or block elements. The interpretation of those elements is up to the layout type of the placard. The rating element allows you to specify a rating and an optional number of reviews that the rating is an average of. Currently it uses a fixed 5-star rating scale. The secret element is a simple one-line edit field that obscures the user's input. It is used for passwords. The select element allows the user to select one or more items from the list of items presented. Currently, the only presentation type supported for this element is 'checkboxes'. The select1 element allows the user to select only one item from the list of items presented. Currently, the presentation types supported for this element are 'popop' and 'radio-group'. The submit element is much like a trigger and is generally displayed as a simple button. It's purpose is to submit the current form data as specified by the submission element. The textarea element is a multi-line input area. The trigger element is essentially a button. It can also be represented as just a piece of text by using the 'minimal' appearance. The size attribute is used to specify the size of the image canvas your image will be drawn into. In general the image resource you specify should be at the size that is appropriate for the current screen at the current size. The image cannot be drawn outside the canvas bounds. The fill-style attribute tells the engine how to fit images that are not the same size as the canvas size you are using as specified by 'size'. There are three options: crop (the default), fit, and fill. Crop just centers the image onto the canvas and crops it. Fit scales the image so that the entire image fits into the canvas. Fill scales the image so that the entire canvas is filled by the image. Any part of the image that might extend past the canvas after stretching is cropped. See the reference manual for examples of each. The resource attribute specifies the URI of the image. Relative URIs are considered relative to a widget's submission package. For example, "warp.jpg" would reference a file of the same name inside your widget's resources/images/<screensixe> directory.