Unity Scopes API
|
The following widget types are recognized by Unity:
audio
video
image
gallery
header
actions
progress
text
rating-input
reviews
The audio widget displays a list of tracks with play/pause controls.
List of attributes:
tracks
A composite attribute containing an array of tuples, where each tuple has up to four fields: title
(mandatory string), subtitle
(optional string), source
(mandatory URI), and length
(optional integer specifying the track length in seconds)You can construct composite attributes with unity::scopes::VariantBuilder:
The video widget displays a still from a video and allows playing the video.
List of attributes:
source
A URI pointing to the video screenshot
A URI pointing to a screenshot of the video (optional)The image widget displays a single image.
List of attributes:
source
A URI pointing to the image zoomable
A boolean specifying whether the image is zoomable (default: false
)The gallery widget displays a set of images.
List of attributes:
sources
An array of image URIsThe header widget displays basic infomation about the result.
List of attributes:
title
A string specifying the title subtitle
A string specifying the subtitle mascot
A URI specifying the mascot emblem
A URI specifying the emblemThe actions widget displays one or more buttons.
List of attributes:
actions
A composite attribute containing an array of tuples, where each tuple has at least these fields: id
(a mandatory string that is passed to unity::scopes::ScopeBase::activate_preview_action()), label
(mandatory string), and icon
(optional URI).You can construct composite attributes with unity::scopes::VariantBuilder:
The progress widget displays the progress of an action, such as download progress.
On completion, the scope receives a preview action activation with the id "finished"
or "failed"
, depending on the outcome of the operation.
List of attributes:
source
A tuple with keys understood by a progress providerA text widget can be used for text of any length (without formatting).
List of attributes:
title
Optional string text
A string containing the textThe rating-input widget allows users to rate content. It consists of two types of widget: a star-based rating and an input field for the user to enter his/her review. It is possible to hide each widget as well as to require them to be filled in.
When a user presses the "Send" button, the scope receives a preview action activation with the id "rated"
.
List of attributes:
rating-label
String for the star-based rating (default: "Rate this") review-label
String for the review input (default: "Add a review") submit-label
String for the confirmation button (default: "Send") rating-icon-empty
URI for an empty rating icon rating-icon-full
URI for a full rating icon visible
String specifying which of the two widgets are visible ("rating"
, "review"
or default:"both"
) required
String specifying which of the two widgets are required to be filled in ("rating"
, "review"
or default:"both"
)The reviews widget is used to display previously-rated content.
List of attributes:
rating-icon-empty
URI for an empty rating icon rating-icon-half
URI for an half-full rating icon rating-icon-full
URI for a full rating icon reviews
A composite attribute containing an array of tuples, where each tuple has up to three fields: rating
(optional integer specifying the number of stars), author
(mandatory string) and review
(optional string).You can construct composite attributes with unity::scopes::VariantBuilder: