My favorites | English | Sign in

Tag Reference

<gm:autoComplete/>

Like gm:text, the gm:autoComplete control displays a text element of a feed. When the user edits a gm:autoComplete control, a box appears below the control and attempts to complete the entry as the user types, based on other entries in the feed.

Must be contained by: gm:template.

Attribute Description
style Inline CSS for styling this tag.
class CSS class for styling this tag.
data Data source declaration. This can be the id of a data declaration, an RSS link, or a query expression (e.g., ${test}).
ref An XPath query to the element in the feed the module or control should operate on.
value XPath query to the values of suggestions in the data feed. Optional, defaults to "atom:title"
See an Example.

<gm:calendar/>

Displays a calendar widget. Dates that have entries associated with them are shown in bold. This tag looks for gd:when elements in the feed and uses the value of the startTime attribute for the date.

Must be contained by: gm:page.

Can contain: gm:handleEvent.

Attribute Description
id Unique identifier for the object.
style Inline CSS for styling this tag.
class CSS class for styling this tag.
data Data source declaration. This can be the id of a data declaration, an RSS link, or a query expression (for example, ${test}).
ref XPath query to the element in the feed to be displayed by the calendar widget.
See an Example.

<gm:checkbox/>

Creates a checkbox bound to the feed element assigned via an XPath statement.

Must be contained by: gm:template.

Attribute Description
style Inline CSS for styling this tag.
class CSS class for styling this tag.
ref An XPath query to the element in the feed the module or control should operate on.
readonly If true, control is always read-only.
default Default value for the tag. If the user doesn't edit the default value, it becomes the value of the tag.
See an Example.

<gm:container/>

Defines a set of sections that appear within a tabs tag.

Must be contained by: gm:page.

Can contain: gm:section.

Attribute Description
id Unique identifier for the object.
See an Example.

<gm:create/>

Displays a template for the user to type a new entry. This tag can only be used with write-enabled feeds.

Must be contained by: gm:template.

Attribute Description
label The text of the label on the create button.
style Inline CSS syntax used to style the object.
class CSS class used to style the object.
See an Example.

<gm:data/>

Declares a data source definition. Use this tag to define data inline.

Must be contained by: gm:page.

Attribute Description
id Unique identifier for the object.
data Data source declaration. This can be the id of a data declaration, an RSS link, or a query expression (for example, ${test}).
See an Example.

<gm:date/>

Creates a textbox bound to a date picker to allow users to easily select a date.

Note that if the date in the feed includes a time portion, that time portion is dropped. If you save a date object to a feed, a default time portion of Z00:00:00 is added to the date.

Must be contained by: gm:template.

Attribute Description
style Inline CSS for styling this tag.
class CSS class for styling this tag.
ref An XPath query to the element in the feed the module or control should operate on.
time If 'true', user can enter time along with date.
readonly If true, control is always read-only.
See an Example.

<gm:debug/>

Displays the content of a feed or feed element bound via a XPath statement.

Must be contained by: gm:template.

Attribute Description
style Inline CSS for styling this tag.
class CSS class for styling this tag.
ref An XPath query to the element in the feed the module or control should operate on.
See an Example.

<gm:editButtons/>

Displays an edit and delete button for each entry in a list.

Must be contained by: gm:template.

Attribute Description
text If true, text buttons will appear instead of image buttons.
style Inline CSS syntax used to style the object..
class CSS class used to style the object.
editonly If true, only the Edit button appears for editable entries (no Delete).
deleteonly If true, only the Delete button appears for editable entries (no Edit).
confirmdelete If set, clicking the Delete button displays a confirmation dialog.
See an Example.

<gm:filter/>

Display only certain entries in a feed, according to the given filtering criteria. See the filtering document for more information.

Must be contained by: gm:list.

Attribute Description
name Used for referring to this filter from the JavaScript API.
ref Allow only values specified by this feed reference.
value Allow only entries that contain this value.
min Allow only entries greater than or equal to this value.
max Allow only entries less than or equal to this value.
See an Example.

<gm:handleEvent/>

Specifies an object that listens for events, then performs an action when the event occurs.

Must be contained by: gm:list, gm:map, gm:search, gm:item, gm:calendar.

Attribute Description
src ID of the object that is being monitored for events. If not specified, the object containing the handleEvent is monitored.
event Event to listen for. Possible values: all, select, save, saveelement, cancel, delete, edit, load, refresh, repaint, create, onrefresh, submit, toggle. If not specified, listens for select event.
execute JavaScript to be executed when the event is detected. Can be inline code or a function name.
See an Example.

<gm:header/>

Used in a template to enable sorting of a column header.

Must be contained by: gm:template

Attribute Description
sort Name of the sorter specified by the name attribute of the gm:sort tag.
See an Example.

<gm:html/>

Displays the HTML content of a feed element bound via an XPath statement. The feed element must be either atom:title, atom:summary, or atom:content.

Must be contained by: gm:template.

Attribute Description
style Inline CSS for styling this tag.
class CSS class for styling this tag.
ref An XPath query to the element in the feed the module or control should operate on.
readonly If true, control is always read-only.
See an Example.

<gm:image/>

Displays the image content of a feed element bound via an XPath statement.

Must be contained by: gm:template.

Attribute Description
ref An XPath query to an HREF element in the feed that links to the image.
width The width of the image.
height The height of the image.
mode If both dimensions are specified, how the image is adjusted to the bounding box. Can be fit (default), or fill.
style Inline CSS for styling this tag.
class CSS class for styling this tag.
See an Example.

<gm:item/>

Declares an item module. Item modules allows users to input information that is saved as an item in a feed. You can also use an item module to display an individual item of a feed.

Must be contained by: gm:page.

Can contain: gm:handleEvent.

Attribute Description
id Unique identifier for the object.
style Inline CSS for styling this tag.
class CSS class for styling this tag.
data Data source declaration. This can be the id of a data declaration or a query expression (e.g., ${test}). The feed must be writable.
template Template declaration used to lay out and style the form. This can be the id of a user defined template, or one of the built-in values simple, base, debug.
create If true, this element will be used to add a new item to the feed.
See an Example.

<gm:labels/>

Specifies a location for label annotations in a template.

Must be contained by: gm:template.

Attribute Description
readonly If true, control is always read-only.
See an Example.

<gm:link/>

Creates a link using an element in the data source.

Must be contained by: gm:template.

Attribute Description
label The label display for the link.
labelref An XPath query to the element in the feed that should be displayed as the label of the link. If no element exists then the value of the label attribute is used
img Href of an image to use for the link (instead of a label).
style Inline CSS for styling this tag.
class CSS class for styling this tag.
ref An XPath query to the element in the feed the module or control should operate on.
readonly If true, control is always read-only.
See an Example.

<gm:list/>

Declares a list module. The list module is used to display a collection of entries. The source of those entries is specified by the data attribute. The list has a default template you can override by declaring a template object and referencing that template object in the list tag.

Must be contained by: gm:page.

Can contain: gm:handleEvent, gm:filter.

Attribute Description
id Unique identifier for the object.
style Inline CSS for styling this tag.
class CSS class for styling this tag.
data Data source declaration. This can be the id of a data declaration, an RSS link, or a query expression (e.g., ${test}).
template References a template declaration used to layout and style the list. This can be the id of a user defined template, or one of the built-in values simple, task, blog, base, contact, default, debug, articlelist
pagesize Number of visible entries to display per page. The default number is 10.
selection Set to false to disable selection within this list. It is true by default.
onselect Names a function that will be called when a list entry is selected.
sort Name of the default sorter of the list. A gm:sort tag must be present as a child of the list to enable sorting.
See an Example.

<gm:map/>

Declares a map module.

Must be contained by: gm:page.

Can contain: gm:handleEvent.

Attribute Description
id Unique identifier for the object.
width Sets the width of the map.
height Sets the height of the map.
style Inline CSS for styling this tag.
class CSS class for styling this tag.
data Data source declaration. This can be the id of a data declaration, an RSS link, or a query expression (e.g., ${test}).
latref XPath query to the lat element in an entry in the feed. Map is centered on this latitude.
lngref XPath query to the long element in an entry in the feed. Map is centered on this longitude.
geolocationref Reference to an entry containing an address that is not geocoded. GME will geocode the address automatically.
infotemplate References a template declaration used to layout and style infobubble attached to markers on the map. This is the id of a user defined template.
lat Map is centered on the point at this latitude.
lng Map is centered on the point at this longitude.
zoom Initial zoom level for map. 0 is fully zoomed out; 19 is fully zoomed in.
control Type of map navigation control to show. Can be none, small (default) or large.
maptypes Show the map type switcher (Map/Satellite/Hybrid). Can be true or false (default).
create Show the button to create new pins (the button will only shows up if the bound feed is writable). Can be true or false (default).
See an Example.

<gm:number/>

Displays the numeric content of a feed element bound via a XPath statement.

Must be contained by: gm:template.

Attribute Description
style Inline CSS for styling this tag.
class CSS class for styling this tag.
ref An XPath query to the element in the feed the module or control should operate on.
readonly If true, control is always read-only.
default Default value for the tag. If the user doesn't edit the default value, it becomes the value of the tag.
See an Example.

<gm:option/>

Displays a list of options in a gm:select control. The text content of the tag serves as the label for the option.

Must be contained by: gm:select.

Attribute Description
value Value of the option. This attribute is optional. The value is same as the label by default.
selected If 'true', this option is selected by default.
See an Example.

<gm:page/>

<gm:page> is the outermost tag for every GME application, containing all other tags. The title attribute is required. You can use HTML, CSS, and JavaScript tags (along with GME tags) in your application.

This tag can contain: gm:tabs, gm:container, gm:template, gm:list, gm:map, gm:data, gm:calendar, gm:item, gm:search.

Attribute Description
title Application's display name.
css URL of a CSS file used by this application.
class CSS class for styling this tag.
onload JavaScript function called when the application loads.
onunload JavaScript function called when the application window is closed or the user signs out.
authenticate If true, user must sign in to a Google Account to use this application.
gadget If true, page can be deployed as a Google Gadget.
See an Example.

<gm:pager/>

Displays paging links for lists with multiple pages of data.

Must be contained by: gm:template.

Attribute Description
compact If true, smaller version of gm:pager is displayed.
See an Example.

<gm:param/>

Specify a search parameter for the search module.

Must be contained by: gm:search.

Attribute Description
name The name of the parameter that will be used in the module
value The value associated with the name or the parameter

See an Example.

<gm:rating/>

Displays the rating content of a feed element bound via a XPath statement.

Must be contained by: gm:template.

Attribute Description
style Specify CSS style rules for the object.
class Specify a CSS class for the object.
ref An XPath query to the element in the feed the module or control should operate on.
See an Example.

<gm:search/>

Declares a search module. The search module is used to search over a data object.

Must be contained by: gm:page.

Can contain: gm:handleEvent, gm:param.

Attribute Description
id Unique identifier for the object.
style Inline CSS for styling this tag.
class CSS class for styling this tag.
data Data source declaration. This can be the id of a data declaration, an RSS link, or a query expression (e.g., ${test}).
ref An XPath query to the element in the feed the module or control should operate on.
param Sets which query parameter that the input from the search module will be bound to.
See an Example.

<gm:section/>

Defines a group of modules that appear in a tab within a gm:tabs tag.

Must be contained by: gm:container.

Attribute Description
id Unique identifier for the object.
title Section title; used as title of the tab defined by the section.
See an Example.

<gm:select/>

Creates a drop-down menu containing either a fixed set of static options or a set of options corresponding to entries in a specified feed.

Must be contained by: gm:template.

Attribute Description
ref An XPath query to the feed element used to store the selected option's value.
data Data source declaration. This can be the id of a data declaration, an RSS link, or a query expression (e.g. ${test}). Used to create a dynamic drop-down menu whose options correspond to entries in the feed specified here.
labelref An XPath query to the feed element whose text contents should be displayed in the drop-down menu; defaults to atom:title. Useful only when specifying a dynamic source using the data attribute; when building a static menu, use <gm:option> tags instead.
valueref An XPath query to the feed element whose text contents should be assigned to the value attribute of the generated options; defaults to the element specified in the labelref attribute, if any. Useful only when specifying a dynamic source using the data attribute; when building a static menu, use <gm:option> tags instead.
See an Example.

<gm:sort/>

Specifies a sort order for a list.

Must be contained by: gm:list.

Attribute Description
ref An XPath query to the element in the feed the module or control should sort on.
name The name of the sorter.
reverse If 'true', the sort will be reversed (ascending) by default.
type If 'number', the list will be sorted numerically.
See an Example.

<gm:subscribe/>

Creates a subscribe link and image for any feed used in the data attribute of the tag. Only works on unauthenticated public feeds.

Must be contained by: gm:page.

Attribute Description
data Data source declaration. This can be the id of a data declaration, an RSS link, or a query expression (e.g., ${app}/items).
label Label for the link. Defaults to 'Subscribe'.
See an Example.

<gm:tabs/>

Creates a set of tabs in your application.

Tabs are styled to appear properly at the top of the container. For tabs that appear at the left, right, or bottom of the container, place the tabs at the location you want (using a table, for example), then use class="gm-section-tabs-left", class="gm-section-tabs-right", or class="gm-section-tabs-bottom" to style the tabs for their location.

Must be contained by: gm:page.

Attribute Description
target ID of a container tag. Each tab is a section within the container.
See an Example.

<gm:template/>

Declares a template definition. HTML layout and controls are placed in templates to display data from a feed.

Must be contained by: gm:page.

Can contain: gm:create, gm:editButtons, gm:pager, gm:toggle, gm:text, gm:textarea, gm:autoComplete, gm:date, gm:debug, gm:html, gm:image, gm:link, gm:number, gm:video, gm:checkbox, gm:rating.

Attribute Description
id Unique identifier for the object.
See an Example.

<gm:text/>

Displays the text content of a feed element bound via an XPath statement.

Must be contained by: gm:template.

Attribute Description
style Inline CSS for styling this tag.
class CSS class for styling this tag.
ref An XPath query to the element in the feed the module or control should operate on.
default Default value for the tag. If the user doesn't edit the default value, it becomes the value of the tag.
See an Example.

<gm:textarea/>

Displays the text content of a feed element bound via an XPath statement in a textarea.

Must be contained by: gm:template.

Attribute Description
style Inline CSS for styling this tag.
class CSS class for styling this tag.
ref An XPath query to the element in the feed the module or control should operate on.
readonly If true, control is always read-only.
See an Example.

<gm:toggle/>

Toggles the display of another tag when placed around that tag. The element to be toggled must have the "gm-toggled" class attribute assigned to it.

Must be contained by: gm:template.

Attribute Description
(none)  
See an Example.

<gm:video/>

Displays the video content of a feed element bound via a XPath statement.

Must be contained by: gm:template.

Attribute Description
style Inline CSS for styling this tag.
class CSS class for styling this tag.
ref An XPath query to the element in the feed the module or control should operate on.
See an Example.