Working with Widgets > Common Widget Properties, Services, and Events
  
Common Widget Properties, Services, and Events
The following tables list properties, services, and events that are common among multiple widget.
* 
If the widget property you are looking for is not in the table, see the help topic associated with that particular widgets.
Property Name
JavaScript
Type
Description
Alignment
imageAlign
string
The horizontal alignment of a widget.
* 
The options available in the drop-down menu vary by widget.
Background Color
backgroundColor
string
The color of the background for the widget.
This field supports RGB color, hexadecimal colors, or color names.
Class
class
string
The class assigned to the widget. Each widget can be assigned a class that you can write custom CSS rules for.
Content Wrap
wrap
string
The placement of widgets inside a Grid Layout or Repeater widget when screen size of a device changes. If this is set to not wrap, the widgets are displayed in a single line.
* 
In most cases, leaving it wrapped by default is recommended to preserve functionality.
Data
data
infotable
A binding target for data.
Deselected
Triggered when the item is deselected.
Disabled
disabled
boolean
Disables clicking of the widget and changes the state.
Friendly Name
friendlyName
string
The name of the widget in the project tree.
Height
height
number
Height of the widget. Enter a number followed by either % or px.
Justification
justification
string
Alignment of a widget. Select one of the following from the drop-down list:
Start
End
Center
Even Space Between
Even Space Around
Label
label
string
Label that is displayed on the widget.
List
list
object
A binding target for data. Typically, you bind All Items from a service to this property.
Margin
margin
string
Similar to the padding property, it defines the space around a widget or item. This property is a direct translation to CSS. Enter a number followed by one of the supported formats (for example, 10px):
px
%
in
mm
cm
ex
em
pt
pc
Multi-Select
multiselect
boolean
Allows you to select multiple items in the widget.
Padding
padding
string
The padding around the widget. Enter a number followed by one of the supported formats (for example, 10px):
px
%
in
mm
cm
ex
em
pt
pc
Placeholder
placeholder
string
Placeholder text that appears in the widget.
Studio ID
widgetName
string
Each widget is assigned a unique ID attribute at runtime, but can be edited.
Text
text
string
Text that appears in the widget.
Value
value
string
Value of the widget.
Visible
visible
boolean
Sets the visibility of the widget at runtime. This is selected by default.
Width
width
number
Sets the width of the widget. Enter a number followed by either % or px.
X-axis Field
labelsField
string
The data that displays for the X-axis of a chart. Manually enter the field name. For example, type “name.”
Y-axis Field
valuesField
string
The data that displays for the Y-axis of a chart. Manually enter the field name. For example, type “user.”
Service
JavaScript
Description
Update Chart
updateChart
Bindable service that can be used to update the chart.
Event
JavaScript
Description
Click
click
Drag the Click event to another view in the tree to navigate to that view on click, or you can drag it to a service which is fired on click. Click the JS icon next to the Click event to enter an expression.
ItemClick
itemclick
Drag and drop the ItemClick property onto a view in the project tree so that when an item in the list or repeater is clicked, it navigates to the view that it was bound to. For example, if you bind the ItemClick property of a List widget to a Detail view, when an item in the list, the Detail page opens.
Pressed
pressed
Triggered when the widget is pressed.
Selected
selected
Triggered when the widget or item is selected.
Unpressed
unpressed
Triggered when the widget is unpressed.
Value Changed
change
Triggered when the value changes.