“导航”函数非可视小组件，可用于在应用程序内的混搭之间进行导航。要打开指定的目标混搭，请将事件绑定到 Navigate 服务。您可以绑定其他函数的事件，例如“验证器”函数的 True 属性。这样可以定义混搭中用于控制导航的 JavaScript 表达式。如果目标混搭包含可绑定参数，则还可以在混搭之间传递参数值。

在 ThingWorx 9.3 或更高版本中，您可以使用函数从远程服务器发送和检索数据。由于安全方面的原因，Web 浏览器通常会阻止与其他域中的远程服务器进行连接。但是，当目标窗口类型设置为“弹窗”或“模态弹窗”时，您仍可以使用导航功能向远程服务器发送和检索请求。使用函数 Result 属性检索服务器中的数据，并将其绑定到混搭中的小组件、函数或数据服务。

函数选项

您可以在创建或修改导航函数时配置以下选项。

选项	说明
说明	设置函数的说明。
“目标混搭”	指定要重定向到的混搭的名称。
“目标窗口类型”	将目标窗口类型设置为以下选项之一： • “新建”- 在新窗口中。 • “替换”- 在当前窗口中。 • “弹窗”- 在弹出窗口中。 • “模态弹窗”- 在只能从弹窗中关闭的弹出窗口中。 • “全屏”- 在全屏模式下。
“缺少混搭消息”	指定当目标混搭不可用时显示的消息。
“弹出窗口标题”	指定弹出窗口的标题。
“弹窗宽度”	设置弹出窗口的宽度。
“弹窗高度”	设置弹出窗口的高度。
“包括旧版高度增加”	控制是否将弹出窗口的高度增加 21 像素。此选项适用于在 ThingWorx 9.3.3 或更早版本中创建的函数。要禁用高度增加，请将此属性设置为 false。在 ThingWorx 9.3.4 或更高版本中新建函数时，实际值将用于设置弹窗高度。
“替换时重新加载”	将当前混搭替换为新混搭时，重新加载浏览器窗口。
“关闭按钮”	显示弹出窗口中的关闭按钮。
“单击外部关闭”	当用户单击弹出窗口外部时，关闭弹窗。
“弹窗滚动栏”	将滚动条添加到弹出窗口中。
“重定向至”	设置要导航到的目标的类型。您可以将目标设置为“混搭”或 URL。
URL	将用户重定向至的 URL。
URL 目标类型	用于指定目标 URL 的打开方式。可以在新窗口、当前窗口、弹出式菜单或模态弹窗中打开 URL。要发送或检索数据，必须在弹窗或模态弹窗中打开目标 URL。
显示弹窗阻止消息	当浏览器阻止弹窗时，会显示一条警告消息。
弹窗阻止消息	设置弹窗被阻止时显示的消息。

创建导航函数

1. 在“函数”面板中，单击

。“新建函数”对话框随即打开。

2. 从下拉列表中选择“导航”。

3. 输入函数名称，然后单击“下一步”。

4. 在“目标混搭”下，输入要导航到的混搭。

5. 根据需要修改选项。

6. 单击“完成”。

“导航”函数即会添加到“函数”面板中。

目标混搭参数

通过导航函数，您可以将当前混搭中的值传递给目标混搭中的参数。选择目标混搭时，其参数将显示在“导航”函数中选项对话框的“混搭默认值”下。您可以为每个参数指定默认值：

目标混搭的参数也会在“导航”函数下列出。将属性绑定到混搭参数时，会覆盖默认值。

函数属性

属性	说明	基本类型	默认值	是否可绑定? (Y/N)	是否可本地化? (Y/N)
Navigate	用于将用户重定向到指定混搭或 URL 的服务。	不适用	不适用	Y	N
MissingMashupMessage	设置当目标混搭不可用时显示的消息。	STRING	不适用	Y	Y
PopupBlockedMessage	设置弹出窗口被阻止时显示的消息。	STRING	不适用	Y	Y
PopupTitle	设置弹出窗口的标题。	STRING	不适用	Y	Y
PopupWidth	设置弹出窗口的固定宽度。	NUMBER	不适用	Y	N
PopupHeight	设置弹出窗口的固定高度。	NUMBER	不适用	Y	N
Result	从弹出窗口返回的数据表单。	STRING	不适用	Y	Y
URL		STRING	不适用	Y	N
URLTargetType	控制 URL 目标窗口的打开方式。支持的值为 "New"、"Replace"、"Popup" 和 "ModalPopup"。用于发送和检索数据的 URL 必须在弹窗或模态弹窗中打开。	STRING	不可用	Y	N

函数事件

属性	说明	基本类型	默认值	是否可绑定? (Y/N)	是否可本地化? (Y/N)
WindowClosed	在弹出窗口关闭时触发的事件。	不适用	不适用	Y	N
PopupDone	弹出窗口关闭并提交数据时触发的事件。	不适用	不适用	Y	不适用
PopupCanceled	弹出窗口关闭后提交数据前触发的事件。	不适用	不适用	Y	不适用
PopupBlocked	浏览器阻止弹出窗口时触发的事件。	不适用	不适用	Y	不适用

这对您有帮助吗?