8. Prism导航
1. 背景
导航是为了实现不同界面的切换,是一种组织系统功能的方式。提供两种导航,一是基于View切换,二是基于ViewModel状态。
2. 基于View切换的导航
最常用导航方式。在该种导航中首先需要定义一个域(Region),然后注册所有需要的View。通过切换不同视图,可以实现导航。下面具体阐述:
2.1 定义域
一般使用ContentControl,ItemControl以及二者的子类定义域,同时为域命名,代码如下:
<ContentControl Grid.Row="1" Grid.ColumnSpan="2"
prism:RegionManager.RegionName="ContentRegion"/>
2.2 注册View
我们需要在DI容器中注册需要的View,如果直接使用DI容器的注册方法,注册的View只能够作为普通类使用。Prism提供各种容器的扩展方法RegisterTypeForNavigation,使用此方法注册后就可以实现导航,以Unity容器为例:
_unityContainer.RegisterTypeForNavigation<CalendarView>();
2.3 导航
类RegionManager提供方法RequestNavigate用于导航,有两种方式进行导航。
2.3.1 URI导航
用户只需调用该方法就可以实现导航,如下:
_regionManager.RequestNavigate("ContentRegion", calendarViewUri);
第一个参数是目标域名称,第二参数calendarViewUri是一个Uri类型的对象,该对象名称是需要导向View的名称。对象实例化方法是:
private static Uri calendarViewUri = new Uri("CalendarView", UriKind.Relative);
导航时还可以向目标View传递参数,同时也可以设置回调函数。
2.3.2 名字导航
可以直接将View名称传入方法RequestNavigate,
_regionManager.RequestNavigate("ContentRegion", "CalendarView");
使用这种方法好处是你可以导航至任意模块的View,前提是:
- 已使用RegisterTypeForNavigation注册View;
- View名或其别名需要在所有模块中唯一。
2.4 传递数据
这里涉及两个问题:
- 当前view如何传入数据?
- 目标view如何解析数据?
对于问题一,RequestNavigate方法提供方法重载,允许我们传入数据。传入的数据类型是NavigationParameters,这是一个IEnumerable类型,使用add方法添加参数,key-value形式。示例如下:
using Prism.Regions;
private readonly IRegionManager _regionManager;
//...
NavigationParameters para = new NavigationParameters();
para.Add("name", "ZZL");
_regionManager.RequestNavigate("ContentRegion", "HelloView", para);
对于问题二,还需要继续细分,目标view如何感知传递来的数据,知道以后又如何解析?Prism框架提供接口INavigationAware,与View对应的ViewModel只需实现接口就可以自动感知。该接口包含三个方法:
IsNavigationTarget
函数签名:
bool IsNavigationTarget(NavigationContext navigationContext);
指定当前View是否是导航目标,返回值为TRUE则导航至该View实例。如果不是则返回FALSE,RegionManager创建目标View的新实例。
OnNavigatedFrom
函数签名:
void OnNavigatedFrom(NavigationContext navigationContext);
从当前View离开时调用。
OnNavigatedTo
函数签名:
void OnNavigatedTo(NavigationContext navigationContext);
导航至该View时调用。一般如果重新进入View需要刷新或重置页面时,逻辑均需写在该方法中。传入参数navigationContext有一个属性Parameters,类型为NavigationParameters。迭代读取该属性就可以解析数据。示例如下:
using Prism.Mvvm;
using Prism.Regions;
namespace ModuleA.ViewModels
{
public class ViewAViewModel : BindableBase, INavigationAware
{
private string _name;
public string Name
{
get { return _name; }
set
{
SetProperty(ref _name, value);
}
}
public ViewAViewModel()
{
}
public void OnNavigatedTo(NavigationContext navigationContext)
{
NavigationParameters p = navigationContext.Parameters;
foreach (var item in p)
{
if(item.Key == "name")
Name = (string)item.Value;
}
}
public bool IsNavigationTarget(NavigationContext navigationContext)
{
return true;
}
public void OnNavigatedFrom(NavigationContext navigationContext)
{
}
}
}
三个方法的调用顺序是OnNavigatedFrom,IsNavigationTarget,OnNavigatedTo。
2.5 确认和取消导航
对于重要情况,有时需要提供确认导航功能。接口INavigationAware虽提供数据传递功能,方法IsNavigationTarget标明是否是导航目标,但是不能取消导航,
Prism提供INavigationAware的扩展接口IConfirmNavigationRequest,该接口提供一个额外方法ConfirmNavigationRequest实现确认导航机制。
public void ConfirmNavigationRequest(NavigationContext navigationContext, Action<bool> continuationCallback)
{
bool result = true;
if (MessageBox.Show("Do you to navigate?", "Navigate?", MessageBoxButton.YesNo) == MessageBoxResult.No)
result = false;
continuationCallback(result);
}
2.6 用后即焚
默认情况下所有已导航View实例一直保存在Region中,直至程序结束。而有些View在软件运行时使用频率低,这时就希望如果不使用该View时就将View实例销毁。Prism提供接口IRegionMemberLifetime实现“用后即焚”,该接口提供方法KeepAlive属性,如果返回FALSE,当View实例不显示时,就将该View的实例从Region中移除。下次需要使用则重新实例化View。
3. 基于状态的导航
在此类导航中,UI的更新是基于ViewModel状态变化以及用户交互。此类导航适用于:
- View需要以不同样式或者格式显示同一数据
- View需要基于View Model状态改变样式或者布局
- View需要初始化有限的模态交互或非模态交互。
此类导航不适用于:
- UI需要为用户显示不同数据;
- UI需要执行不同任务。
8. Prism导航的更多相关文章
- Prism 的 TabControl 导航
基于Prism 7.1 最近工作中可能会用到TabControl所以作为小菜的我提前预习了一下,结果并没有我想的那么简单,于是乎 各种网上查,本来用wpf的人就不多 prism 的可查的资料就更少的可 ...
- Prism 4 文档 ---第8章 导航
作为同用户具有丰富的交互的客户端应用程序,它的用户界面(UI)将会持续不断的更新来反映用户工作的当前的任务和数据.用户界面可以进行一段时间相当大的变化作为用户交互的应用程序中完成各种任务.通过 ...
- Prism for WPF 搭建一个简单的模块化开发框架(六)隐藏菜单、导航
原文:Prism for WPF 搭建一个简单的模块化开发框架(六)隐藏菜单.导航 这个实际上是在聊天之前做的,一起写了,也不分先后了 看一下效果图,上面是模块主导航,左侧是模块内菜单,现在加一下隐藏 ...
- 从PRISM开始学WPF(八)导航Navigation-更新至Prism7.1
原文:从PRISM开始学WPF(八)导航Navigation-更新至Prism7.1 0x6Navigation [7.1updated] Navigation 在wpf中并没有变化 Basic Na ...
- 从PRISM开始学WPF(八)导航Navigation?
原文:从PRISM开始学WPF(八)导航Navigation? 0x6Navigation Basic Navigation Prism中的Navigation提供了一种类似导航的功能,他可以根据用户 ...
- Xamarin.Forms + Prism,整理页面导航跳转流程
3个Page,Page1 -> Page2 -> Page3 -> Page2 -> Page1. PageViewModel实现接口:INavigatingAware, IN ...
- Silverlight项目笔记4:初识Prism以及IoC
1.Prism Prism是由微软Patterns & Practices团队开发的针对WPF和Silverlight的MVVM框架. Prism的几个关键点: (1)启动器类UnityBoo ...
- Prism简介
Prism是由微软Patterns & Practices团队开发的项目,目的在于帮助开发人员构建松散耦合的.更灵活.更易于维护并且更易于测试的WPF应用或是Silverlight应用以及Wi ...
- MVVMLight Toolkit在Windows Phone中的使用扩展之一:在ViewModel中实现导航,并传递参数
MVVMLight是MVVM开发模式在Windows Phone平台下的一个开发框架,关于MVVMLight的基础使用,已经有人写的很好了,可以参照:MVVM.MVVMLight.MVVMLight ...
随机推荐
- 【题解】[SDOI2010]捉迷藏
题目链接:https://www.luogu.com.cn/problem/P2479 题目大意:求平面\(n\)个点中,到其它\(n-1\)个点的曼哈顿距离最大和最小距离之差最小的点,求出这个这个距 ...
- Flutter 1.22 正式发布
支持iOS 14和Android 11,新的i18n和l10n支持,可用于生产的Google Maps和WebView插件,新的App Size工具等等! 作者:Chris Sells 原文:http ...
- 推荐Java字节码解析工具classpy
Classpy Classpy is a GUI tool for investigating Java class file, Lua binary chunk, Wasm binary code, ...
- Elasticsearch(4):映射
ES中的映射(mapping)是用于定义索引中文档以及文档中的字段如何被存储和索引(动词)的一种机制,例如,通过映射我们可以进行如下的这些定义: 索引文档中,哪些字符型字段应该被当做全文本类型: ...
- 基于Python的接口自动化实战-基础篇之读写配置文件
引言 在编写接口自动化测试脚本时,有时我们需要在代码中定义变量并给变量固定的赋值.为了统一管理和操作这些固定的变量,咱们一般会将这些固定的变量以一定规则配置到指定的配置文件中,后续需要用到这些变量和变 ...
- Verilog基础入门——简单的语句块编写(一)
[题干] [代码] module top_module ( input in, output out ); assign out = ~in; endmodule 简单的实现一个非门
- 扫描仪扫描文件处理-Python批量处理
多进程处理扫描出来的图片,参见: https://github.com/barrer/scan-helper bug问题反馈github提Issues
- javascript arcgis 取区域中心点
javascript arcgis 取区域中心点 //graphic是绘制完多边形之后返回的对象 //获得多边形的中心点坐标 var centerPoint=graphic.geometry.getE ...
- day73:drf:drf视图相关类&路由Routers&创建虚拟环境
目录 1.APIView 2.GenericAPIView:通用视图类 3.5个视图扩展类:ListModelMixin,CreateModelMixin,RetrieveModelMixin,Upd ...
- python的deque(双向)队列详解
首先 python的队列有很多种 Python标准库中包含了四种队列,分别是queue.Queue / asyncio.Queue / multiprocessing.Queue / collecti ...