Navigation
 |
This function replaces the Navigation widget. To create the same functionality, bind the Clicked property of a Button widget to the function.
|
The Navigation function is a non-visual widget that you can use to navigate between mashups within your application. To open the specified target mashup, bind an event to the Navigate service. You can bind events from other functions, such as the True property of the Validator function. This enables you to define JavaScript expressions that control navigation in your mashup. You can also pass parameter values between mashups if the target mashup contains bindable parameters.
Function Options
You can configure the following options when creating or modifying a navigation function.
|
Option
|
Description
|
|---|---|
|
Description
|
Sets a description for the function.
|
|
Target Mashup
|
Specifies the name of the mashup to redirect to.
|
|
Target Window Type
|
Sets the target window type to one of the following options:
• New—In a new window.
• Replace—In the current window.
• Popup—In a pop-up window.
• ModalPopup—In a pop-up window that can only be closed from within the pop-up.
• Full Screen—In full screen mode.
|
|
Missing Mashup Message
|
Specifies a message to display when the target mashup is not available.
|
|
Pop-up Title
|
Specifies a title for the pop-up window.
|
|
Pop-up Width
|
Sets the width of the pop-up window.
|
|
Pop-up Height
|
Sets the height of the pop-up window.
|
|
Reload On Replace
|
Reloads the browser window when the current mashup is replaced by a new mashup.
|
|
Close Button
|
Displays a close button in the pop-up window.
|
|
Click Outside To Close
|
Closes the pop-up when the user clicks an area outside the window.
|
|
Pop-up Scrollbar
|
Adds scroll bars to the pop-up window.
|
Creating a Navigation Function
1. On the Functions panel, click 
. The New Function dialog opens.
. The New Function dialog opens.2. Select Navigation from the drop down list.
3. Enter a name for the function, and then click Next.
4. Under Target Mashup, enter a mashup to navigate to.
5. Modify the options as required.
6. Click Done.
The Navigation function is added to the Functions panel.
Target Mashup Parameters
The navigation function enables you to pass values from the current mashup to parameters in the target mashup. When you select a target mashup, its parameters are displayed under Mashup Default Values in the options dialog for the Navigation function. You can specify a default value for each parameter:
The parameters of the target Mashup are also listed under the Navigation function. The default value is overwritten when you bind a property to a mashup parameter.
Function Properties
The Navigation function contains the following properties.
Property | Description | Base Type | Default Value | Bindable? (Y/N) | Localizable? (Y/N) |
|---|---|---|---|---|---|
Navigate | A service that redirects users to the selected mashup. | n/a | n/a | Y | N |
MissingMashupMessage | Sets a message to show when the destination mashup is not available. | STRING | n/a | Y | Y |
PopupTitle | Sets the title of the pop-up window. | STRING | n/a | Y | Y |
PopupWidth | Sets a fixed width for the pop-up window. | NUMBER | n/a | Y | N |
PopupHeight | Sets a fixed height for the pop-up window. | NUMBER | n/a | Y | N |
WindowClosed | An event that triggers when the pop-up window is closed. | n/a | n/a | Y | N |