std:ui:panel
Panels are a standardised way of displaying information and links as part of your plugin UI.
Each panel is composed of panel elements which build up the UI.
While you can use these templates directly, the O.ui.panel()
builder and the Action Panel standard plugin standard plugin are often more convenient ways to use them, especially when the UI is composed from functionality provided by multiple cooperating plugins.
There are several different styles of panel, each of which take a common view but ignore properties which are not relevant. std:ui:panel
is the default style, intended for use in the sidebar.
These view render a single panel. Using O.ui.panel()
or the Action Panel standard plugin allows you to display more than one panel at once.
Top level view
key elements
An array of panel element views. See below for properties.
key title
Where supported by the template, a title to be displayed above the panel.
key highlight
Where supported by the template, this property specifies an additional level of highlighting for this panel. Values are:
"primary" |
Primary importance |
"secondary" |
Secondary importance |
Panel element views
The default style, std:ui:panel
, supports the vast majority of these properties, but the alternative styles will only support a few. All properties are optional.
key label
The main text for the panel element.
key href
The link for the panel element.
key indicator
An indicator to draw the user’s attention to this panel element. Values are:
"standard" |
Non-specific indicator |
"primary" |
Primary, or usual, next action |
"secondary" |
Secondary action, less likely to be taken |
"terminal" |
An action will which terminate a process |
"primary-forward" |
Primary, moving process forward |
"secondary-forward" |
Secondary, moving process forward |
"primary-back" |
Primary, moving process back |
"secondary-back" |
Secondary, moving process back |
"forward" |
Move process forward |
"back" |
Move process back |
key title
A title for this panel element.
key heading
A heading element. Don’t include a label
if you’re using this property.
key disabled
true
to show a disabled panel element.
key light
true
to style the panel element less prominently.
key innerLink
An additional link, as an object containing href
and label
properties.
key innerText
Additional explanatory text.
key value
A value of a statistic.
key icon
An icon description of the icon to display on this panel element.
Additional panel styles
std:ui:panel:links
std:ui:panel:menu
std:ui:panel:statistics
std:ui:panel:tiles