Mashup Builder > Widgets > Navigation Widget
  
Navigation Widget
The Navigation widget allows you to link to other Mashups from within a current Mashup, and pass in parameters to the new mashup if has bindable parameters. You can open in the current window (replace) or open a new window.
View the following video tutorial for more information: Navigation in ThingWorx: Using Menus, the Navigation Widget, Link Widget, and Contained Mashups.
* 
The Navigation widget includes Beta style theme support. Styles and common widget properties are not included in the table below.
Property Name
Description
Base Type
Default Value
Bindable? (Y/N)
Localizable? (Y/N)
CustomClass
User defined CSS class to apply to the top div of the widget. Multiple classes can be entered, separated by a space.
STRING
n/a
Y
N
Text
The text to be displayed on the Mashup page.
STRING
n/a
Y
Y
MashupName
Target Mashup to load.
MASHUPNAME
n/a
Y
N
TargetWindow
The target window to open the Mashup in:
New: opens a new window.
Replace: replaces the content in the current window.
Popup: opens in a popup window. Can be closed by clicking anywhere in the screen.
Modal Popup: opens in a popup window that must be closed within the popup.
Full Screen: Useful when developing mashups on an iPad to show a “popup” that looks like a screen transition. When the mashup is closed, it returns to the mashup without having to retrieve data again.
STRING
New
N
N
ShowCloseButton
If unchecked, the close button in the top right will not show, leaving the option to designate your own close button in the Mashup.
BOOLEAN
True
N
N
ClickOutsideToClose
If checked, clicking outside the popup will close the modal dialog.
BOOLEAN
False
N
N
PopupTitle
Allows you to put a title on Popup or Modal Popup, which also allows the popup to be dragged.
STRING
n/a
Y
Y
FixedPopupWidth
Allows you to specify a specific width for popups. Required for responsive widgets, but useful for static mashups. If the value is set too small for a static mashup, there will be scrollbars in the popup. Leave the value at 0 to have the popup auto-adjust to the size of the mashup.
NUMBER
0
Y
N
FixedPopupHeight
Allows you to specify a specific height for popups. Required for responsive widgets, but useful for static mashups. If the value is set too small for a static mashup, there will be scrollbars in the popup. Leave the value at 0 to have the popup auto-adjust to the size of the mashup.
NUMBER
0
Y
N
PopupScrolling
By default, scrollbars will only appear when needed, but you can turn them off completely and allow the content to overflow.
STRING
Auto
N
N
ShowMessageIfNo Mashup
Display a message to the user when they navigate without specifying a mashup.
BOOLEAN
False
N
N
MessagetoShow
The message to show to the user when navigation is requested but no mashup is selected.
STRING
n/a
Y
Y
Transparent
Allows your Navigation button to be invisible.
BOOLEAN
False
N
N
RoundedCorners
Button has rounded corners.
BOOLEAN
True
N
N
Alignment
Alignment of the Navigation button text (Left Aligned, Right Aligned, or Center Aligned).
STRING
Left Aligned
N
N
IconAlignment
The alignment of the icon (Left or Right)
STRING
Left
N
N
PopupClosed
Event. Allows you to trigger services when the launched Popup mashup is closed.
n/a
n/a
Y
N
Navigate
Service. Can be bound to any event trigger in the Mashup environment. This service executes the navigation process when called.
n/a
n/a
Y
N