Navigate

<< 点击显示目录 >>

主页  mappView帮助助手 > mapp View帮助信息 > 工程 > 事件和行动 > 行动 > Client actions >

Navigate

这个动作会切换到另一个页面。

目标属性

Attribute

Value

描述

xsi:type

clientSystem.Action

 

方法属性

Attribute

Data type or value

说明

xsi:type

clientSystem.Action.Navigate

 

pageId

PageReference

应该被打开的页面的ID

行为

执行此方法将定义的页面加载到根容器中。请注意,该页面是在最高层加载的,不能随便加载到任何区域。由于这个原因,这个方法不适合于嵌套的页面!

在事件处理程序的动作序列中,Navigate动作必须配置在序列的最后(除了动作 LoadContentInArea,它也可以在Navigate之后调用)。

当执行Navigate动作时,如果超出发现事件绑定的范围,事件绑定可能被禁用。例如,如果一个widget事件被绑定到动作 "Navigate "上,这就可能发生。在这种情况下,不允许在 "导航 "动作之后执行其他动作。这同样适用于与 "导航 "动作的并行执行。如果同一个事件绑定的Navigate动作被调用,例如通过多次点击按钮(例如通过按钮点击事件),应用程序必须确保第一次执行的Navigate动作已经完全完成。系统不会对该导航操作进行缓冲;第二个导航操作会被系统拒绝,并创建一个相应的记录仪条目。如果在有结论的Navigate动作的动作序列中没有考虑到这一点,同一事件绑定的先前执行的动作之间可能会出现不一致的情况。需要注意的是,系统变量::SYSTEM:clientSystem.currentPageId的变化(ValueChanged)并不能保证某项内容的小部件可以在新页面上被访问。但是,此时允许再次调用Navigate动作。通过事件绑定访问新加载内容的部件,只能从相应内容的ContentLoaded事件中进行。

例子

切换到ID为 "mainpage "的页面。

<Target xsi:type="clientSystem.Action">
    <Method xsi:type="clientSystem.Action.Navigate" pageId="mainpage" />
</Target>

 

 

使用案例

Navigating on keystroke