A la Carte: Widget reference
From Spot Specific Documentation
Overview
This page provides a point of reference for the widget types available in Spot Specific Apps a la Carte.
Buttons
Standard button
This type of button will be rendered as a native button on 'Native' screen and as a plain button on the 'Styled' screen. The text entered in the 'Title' field will be the button's text.
Standard buttons are ideal for simple interactions bringing the user from one screen to another, since they have a consistent appearance.
Image button
Used to link two screens together. A selectable image defines its appearance on device.
Image buttons perform the same function as standard buttons (to link screens), but appear as an image. Using image buttons means that buttons can fit in with a custom theme or appearance.
Tip For best results, use images in PNG format with alpha (transparency) channels. This will allow each image to display cleanly over coloured or patterned backgrounds.
Custom button
Trigger any event, script or link using custom code. A selectable image defines its appearance on device.
Custom buttons look identical to standard buttons, but instead of causing the application to navigate to another screen, they allow custom code or interactions to be invoked.
This type of button will be rendered as a native button on 'Native' screen and as a plain button on the 'Styled' screen. The text entered in the 'Title' field will be the button's text.
Custom image button
Trigger any event, script or link using custom code. A selectable image defines its appearance on device.
Custom image buttons look identical to image buttons (i.e., they appear as an image), but instead of causing the application to navigate to another screen, they allow custom code or interactions to be invoked.
Tip For best results, use images in PNG format with alpha (transparency) channels. This will allow each image to display cleanly over coloured or patterned backgrounds.
Video player with button
Play a locally-stored video. Button has native appearance on device.
These widgets look identical to standard buttons, but instead of causing the application to navigate to another screen, they play a pre-selected video full screen. After the video is finished playing, the application will return the user to the screen on which the button is located.
Video player with image button
Plays a locally-stored video full-screen. A selectable image defines the button's appearance on device.
These widgets look identical to image buttons (i.e., they appear as an image), but instead of causing the application to navigate to another screen, they play a pre-selected video full screen. After the video is finished playing, the application will return the user to the screen on which the button is located.
Tip For best results, use images in PNG format with alpha (transparency) channels. This will allow each image to display cleanly over coloured or patterned backgrounds.
Audio player with button
Play a locally-stored audio clip. Button has native appearance on device.
These widgets look identical to standard buttons, but instead of causing the application to navigate to another screen, they play a pre-selected audio asset. The widget will continue to play the audio regardless of the which screen is currently active in the application, until it reaches the end of the audio file or is stopped by a button or script.
Audio player with image button
Play a locally-stored audio clip. A selectable image defines the button's appearance on device.
These widgets look identical to image buttons (i.e., they appear as an image), but instead of causing the application to navigate to another screen, they play a pre-selected audio asset. The widget will continue to play the audio regardless of the which screen is currently active in the application, until it reaches the end of the audio file or is stopped by a button or script.
Tip For best results, use images in PNG format with alpha (transparency) channels. This will allow each image to display cleanly over coloured or patterned backgrounds.
YouTube video player with button
Play a YouTube video full-screen. Button has native appearance on device.
These widgets look identical to standard buttons, but instead of causing the application to navigate to another screen, they play a pre-selected YouTube video full screen. After the video is finished playing, the application will return the user to the screen on which the button is located.
YouTube video player with image button
Play a YouTube video full-screen. Button has native appearance on device.
These widgets look identical to image buttons (i.e., they appear as an image), but instead of causing the application to navigate to another screen, they play a pre-selected YouTube video full screen. After the video is finished playing, the application will return the user to the screen on which the button is located.
Tip For best results, use images in PNG format with alpha (transparency) channels. This will allow each image to display cleanly over coloured or patterned backgrounds.
Twitter custom tweet button
These widgets look identical to standard buttons, but instead of causing the application to navigate to another screen, they display a pop-up window allowing users to send a pre-defined tweet using their own account.
Twitter custom tweet button with image
Allows users to send a pre-defined tweet using their own accounts. A selectable image defines its appearance.
These widgets look identical to image buttons (i.e., they appear as an image), but instead of causing the application to navigate to another screen, they display a pop-up window allowing users to send a pre-defined tweet using their own account.
Tip For best results, use images in PNG format with alpha (transparency) channels. This will allow each image to display cleanly over coloured or patterned backgrounds.
Twitter follow button
Include a button allowing users to follow a pre-set Twitter account. Button has native appearance on device.
These widgets look identical to standard buttons, but instead of causing the application to navigate to another screen, they display a pop-up window allowing users to follow a pre-defined Twitter account using their own account.
Twitter follow button with image
Include a button allowing users to follow a pre-set Twitter account. A selectable image defines its appearance.
These widgets look identical to image buttons (i.e., they appear as an image), but instead of causing the application to navigate to another screen, they display a pop-up window allowing users to follow a pre-defined Twitter account using their own account.
Image widgets
Image
Embed an image.
Allows a selected image asset to be displayed on screen. Non-interactive.
Code widgets
Custom widget
Embed custom code in your app.
Includes 512KB of raw space for you to enter any plain text or script or references you wish to include. Ideal for snippets of in-line script or HTML which will be executed inline in the application screen stack.
Attached HTML or text
Include blocks of custom HTML to be rendered on screen from a file asset.
Embeds the content from a selected HTML file asset in the screen. This widget is identical in behaviour to the 'Inline text or HTML' widget, except that its content comes from an attached asset rather than being input directly into the screen. As a result, it is well suited to HTML blocks which are used repeatedly.
Text and other items contained in this widget can be styled using either a 'custom widget' containing CSS, or by using a custom feature to set the style for the whole application.
Text widgets
Inline HTML or text
Include blocks of text or HTML to be rendered on-screen. Text is entered directly into the widget.
Embeds the content from a form on the screen. This widget is identical in behaviour to the 'Attached custom HTML' widget, except that its content comes from directly entered text input rather than an attached asset. As a result, it is well suited to HTML blocks which are unique and only used once.
Text and other items contained in this widget can be styled using either a 'custom feature' containing CSS, or by using a custom feature to set the style for the whole application.
See the Styling text page for usage and examples.
Markdown text markup
A text widget that adds Markdown formatted text to your screen.
Markdown is a light weight mark-up language, ideal for quickly and cleanly marking up text.
See the Styling text page for usage and examples, and the official Markdown site for full language reference.
Feed widgets
Google Calendar
Embed the content from a Google Calendar feed. Links to day, month and event views.
To use this widget, a URL to an public XML feed for a Google Calendar is required. To find a calendar's public XML feed, please refer to this page in Google Calendar's help site.
For more information, see the detailed notes for this widget.
RSS Feed
Embed the items from an RSS feed in your app.
Dynamically embeds the items from an RSS feed in a Spot Specific app screen. Can be customised in appearance and behaviour.
For more information, see the detailed notes for this widget.
Podcast
Play an external podcast (in MP3 format) in your app.
Dynamically embeds the items from a podcast in a Spot Specific app screen. Can be customised in appearance and behaviour.
For more information, see the detailed notes for this widget.
Embed the tweets of a particular user.
The Twitter widget allows you to dynamically embed the recent tweets, re tweets and replies from a specified twitter user. Can be customised in appearance and behaviour.
For more information, see the detailed notes for this widget.
Search widgets
Twitter search
Embed the results of a Twitter search.
Allows the results of a Twitter search to be dynamically embedded in a screen. Searches for hash tags (#), '@' replies, as well as for free text, are possible. Can be customised in appearance and behaviour.
Other widgets
Slideshow widget
An image-based slide show with animations and customisable actions.
For more information, see the detailed notes for this widget.
