Masters
A master provides consistent framing of a mashup’s contents (similar to the concept of a master page or template), and is commonly used for items that display throughout the mashup, such as logos, menus, and titles. For example, to display a company logo throughout your mashup, a master can be created to display the logo, so that no matter where the user is in the mashup, they will see the company logo in the same place. Masters are also commonly used for menus. In order to provide the same navigation options throughout a mashup, a menu is located in the same place throughout the mashup and contains the same options.
You can associate a master with a mashup by assigning the master property in the mashup properties. You can create different masters for different mashups, or one for all of your mashups.
Within a mashup, if you have a refresh service running, the master does not refresh.
 |
Always assign the master to any mashup so that a user is able to open it directly (for example, by accessing via https://<server>/Thingworx/Mashups/NameOfMashup).
|
The following table lists the Master mashup properties.
|
Property Name
|
Description
|
Base Type
|
Default Value
|
Bindable? (Y/N)
|
Localizable? (Y/N)
|
|---|---|---|---|---|---|
|
DisplayName
|
The display name of the mashup shown in the UI.
|
STRING
|
Mashup
|
N
|
Y
|
|
Description
|
A description of the mashup for documentation purposes.
|
STRING
|
N
|
Y
|
|
|
BGImageRepeat
|
Controls how the background image of the mashup is repeated. The options are: No Repeat, Repeat, Repeat Horizontally, Repeat Vertically.
|
STRING
|
No Repeat
|
N
|
N
|
|
BGImageSize
|
Controls the size of the background image. The options are: Auto, Contain, Cover.
|
STRING
|
Auto
|
N
|
N
|
|
CustomClass
|
The CSS class to apply to the top-level mashup container for custom CSS styling.
|
STRING
|
N
|
N
|
|
|
DefaultPageMashup
|
The mashup that is displayed by default when no other mashup is specified.
|
MASHUPNAME
|
N
|
N
|
|
|
DropShadow
|
If true, a drop shadow effect is applied to the mashup container.
|
BOOLEAN
|
False
|
N
|
N
|
|
Favicon
|
Sets the browser tab favicon, updating on mashup load or master change to enable branding and better context recognition.
|
IMAGELINK
|
N
|
N
|
|
|
LegacyFocus
|
A boolean that controls the focus behavior. If true, it uses the old focus style (a visible box). If false, the focus outline is typically only visible during keyboard navigation.
|
BOOLEAN
|
True - for new mashups
False - for existing mashups
|
N
|
N
|
|
Loaded
|
An event that fires when the mashup has finished loading all its components and data.
|
EVENT
|
n/a
|
Y
|
N
|
|
MinHeight
|
The minimum height of the mashup container in pixels.
|
NUMBER
|
0
|
N
|
N
|
|
ResetInputsToDefaultValue
|
An event that, when triggered, resets all input widgets within the mashup to their default values.
|
EVENT
|
n/a
|
Y
|
N
|
|
ResponsiveLayout
|
A boolean that enables or disables the responsive layout capabilities of the mashup, allowing it to adapt to different screen sizes.
|
BOOLEAN
|
false
|
N
|
N
|
|
ShowDataLoading
|
If true, a loading indicator (spinner) is shown automatically whenever a data service is executing.
|
BOOLEAN
|
true
|
N
|
N
|
|
Title
|
The title of the mashup that appears in the browser tab or window title bar.
|
STRING
|
N
|
Y
|
|
|
Visible
|
A boolean that controls the visibility of the entire mashup. If false, the mashup is hidden.
|
BOOLEAN
|
true
|
Y
|
N
|