技术笔记:MAUI新生5.5

简介: 技术笔记:MAUI新生5.5

MAUI的Shell导航框架,也是以路由方式进行导航,并提供了两套导航方式,一是如前面章节所述的视觉层次结构,会自动建立导航路由,可以进行不同层次页面的导航切换;二是为页面手动注册路由,并执行代码导航。


一、注册路由


1、视觉层次结构页面的路由注册


在视觉层次结构中(Shell > FlyoutItem|TabBar > Tab > ShellContent),框架自动建立导航路由,可以直接进行导航切换。如果要通过代码导航到视觉层次页面,可以在定义视觉层次结构时,显示的定义路由,如:



[/span>Shell


......

[/span>FlyoutItem Route="animals"

[/span>Tab Title="Domestic" Route="domestic"

[/span>ShellContent


//代码效果参考:http://www.jhylw.com.cn/510735869.html

Title="Cats"

ContentTemplate="{DataTemplate view:Cats}"


Route="cats" />


[/span>ShellContent


Title="Dogs"


ContentTemplate="{DataTemplate view:Dogs}"


Route="dogs" />



[/span>ShellContent


Title="Monkeys"


ContentTemplate="{DataTemplate view:Monkeys}"


Route="monkeys" />


[/span>ShellContent


Title="Bears"


ContentTemplate="{DataTemplate view:Bears}"


Route="bears" />


[/span>ShellContent


Title="Elephants"


ContentTemplate="{DataTemplate view:Elephants}"


Route="elephants" />



[/span>ShellContent


Title="About"


ContentTemplate="{DataTemplate view:About}"


Route="about" />




animals


domestic


cats


dogs


monkeys


bears


elephants


about


2、非视觉层次结构页面的路由注册


MAUI中还有很多页面,没有在视觉层次结构中定义,这些页面需要进行手动注册路由,一般在AppShell后台代码的构造函数中进行。


public partial class AppShell : Shell


{


public AppShell()


{


InitializeComponent();


//注册非视觉层次页面路由,所有路由名称需保持唯一,它们是全局的


//当导航到视觉层次结构中的路由时,并不会创建导航堆栈;但导航到非视觉层次页面路由时,创建导航堆


Routing.RegisterRoute("dogdetail",typeof(DogDetail));


Routing.RegisterRoute("monkeydetail", typeof(MonkeyDetail));


//也可以将路由注册到不同的视觉层次结构上,可以实现跟踪当前路由层次,导航到不同的页面


//如下例中,都是导航到detail,但在dogs路由层次结构中时,将导航到DogDetail;反之,将导航到MonkeyDetail


Routing.RegisterRoute("dogs/detail", typeof(DogDetail));


Routing.RegisterRoute("monkeys/detail", typeof(MonkeyDetail));


}


}


二、执行导航


1、在视觉层次结构中,可以直接执行导航跳转。注:这些跳转页面,不会进入到导航堆栈中。


2、非视觉层次结构的页面,需要通过编程式导航来实现。


//下例为Monkeys页面,通过按钮点击事件进行导航


public partial class Monkeys : ContentPage


{


......


private async void Button_Clicked(object sender, EventArgs e)


{


//Shell.Current获得对当前Shell对象的引用,等效于((Shell)App.Current.MainPage)


//Shell对象包括了GoToAsync导航方法,以及CurrentItem、CurrentPage、CurrentState、BackButtonBehavior等属性


await Shell.Current.GoToAsync("dogdetail");


await ((Shell)App.Current.MainPage).GoToAsync("dogdetail");


await DisplayAlert("显示当前路由", Shell.Current.CurrentState.Location.ToString(), "OK");


}


}


3、绝对路由和相对路由


视觉层次结构的页面,可以通过绝对路径进行导航,如【Shell.Current.GoToAsync("//animals/domestic/dogs")】


非视觉层次结构的页面,可以通过相对路径进行导航,如【Shell.Current.GoToAsync("dogdetail")】


上下文导航。注册非视觉层次结构页面时,将路由注册到结构层次页面上,如Routing.RegisterRoute("monkeys/detail"...)。当在Monkeys页面中,导航到detail时,会匹配monkeys/detail。


向后导航。向后导航,【await Shell.Current.GoToAsync("..")】;向后导航与路由导航结合,【await Shell.Current.GoToAsync("../route")】;可以多次向后导航,【await Shell.Current.GoToAsync("../../route")】


关于路由导航,还有一些概念比较模糊,建议暂时按以上两种方式来导航


三、导航传参


1、传递参数。


1)方法一:查询字符串


//传递字符串:直接通过查询字符串传递参数


//传递一个字符串参数


await Shell.Current.GoToAsync("monkeydetail?name=sun");


//传递多个字符串参数


await Shell.Current.GoToAsync("monkeydetail?name=sun&sex=male");


//也可以使用内插值变量


string name = "sun"


await Shell.Current.GoToAsync($"monkeydetail?name={name}");


2)方法一:字典类型参数


//传递对象:通过GoToAsync方法的第二个参数,IDictionary字典类型对象传参


//传递一个对象


var p1 = new Person{Name="zs",Age=18};


var navigationParam = new Dictionary[span style="color: rgba(0, 0, 255, 1)">string, object

{


{ "person1", p1 }


};


await Shell.Current.GoToAsync($"persondetail", navigationParame);


//传递多个对象


var p1 = new Person{Name="zs",Age=18};


var p2 = new Person{Name="ls",Age=28};


var navigationParam = new Dictionary[span style="color: rgba(0, 0, 255, 1)">string, object

{


{ "person1", p1 }


{ "person2", p2 }


};


await Shell.Current.GoToAsync($"persondetail", navigationParame);


2、接收参数。


1)方法一:通过QueryProperty特性,接收路由参数


//QueryProperty特性


//QueryProperty特性的第一个参数为接收路由参数的属性,第一个参数为路由参数的键名


//通过查询参数传递的路由参数,会自动转为键值对形式


//注意接收路由参数的属性,必须是可观察属性(MVVM),触发PropertyChanged事件


【QueryProperty(nameof(Name), "name")】


【QueryProperty(nameof(Sex), "sex")】


public partial class MonkeyDetail : ContentPage


{


public MonkeyDetail()


{


InitializeComponent();


BindingContext = this; //将BindingContext设置为当前对象


}


//定义可观察属性Name来接收键名为name的路由参数


private string name;


public string Name


{


get { return name; }


set


{


name = value;


OnPropertyChanged();


}


}


//定义可观察属性Sex来接收键名为sex的路由参数


private string sex;


public string Sex


{


get { return sex; }


set


{


sex = value;


OnPropertyChanged();


}


}


}


//XAML文件中使用路由参数


[span style="color: rgba(0, 0, 0, 1)">ContentPage


......

[span style="color: rgba(0, 0, 0, 1)">Label


HorizontalOptions="Center"


Text="{Binding Name}"


VerticalOptions="Center" />


[span style="color: rgba(0, 0, 0, 1)">Label


HorizontalOptions="Center"


Text="{Binding Sex}"


VerticalOptions="Center" />


2)方法二:通过实现IQueryAttributable接口,接收路由参数(在ViewModel中使用)


//接收字符串路由参数


public class PersonDetailViewModel : IQueryAttributable, ObservableObject


{


【ObservableProperty】


private string name;


【ObservableProperty】


private string sex;


public void ApplyQueryAttributes(IDictionary[span style="color: rgba(0, 0, 255, 1)">string, object

{


name = HttpUtility.UrlDecode(query【"name"】.ToString());


sex = HttpUtility.UrlDecode(query【"sex"】.ToString());


}


}


//接收对象类型参数


public class PersonDetailViewModel : IQueryAttributable, INotifyPropertyChanged


{


【ObservableProperty】


private Person person;


public void ApplyQueryAttributes(IDictionary[span style="color: rgba(0, 0, 255, 1)">string, object

{


person = query【"p1"】 as Person;


}


...


}


四、路由守卫


1、全局守卫:类似于生命周期函数,Shell类提供OnNavigating(导航发生前)和OnNavigated(导航发生后)可重写方法,通过重写这两个方法,可以对导航进行控制,实现路由守卫的功能。OnNavigating和OnNavigated方法,在AppShell.xaml.cs中定义。


//OnNavigating和OnNavigated方法的常用属性和方法


public partial class AppShell : Shell


{


public AppShell()


{


InitializeComponent();


......


}


protected override void OnNavigating(ShellNavigatingEventArgs args)


{


base.OnNavigating(args);


ShellNavigationState current = args.Current;//当前页,可通过Location属性获取URL


ShellNavigationState target = args.Target; //目标页,可通过Location属性获取URL


ShellNavigationSource source = args.Source; //导航类型,枚举,包括Unknown/Push/Pop/PopToRoot/Insert/Remove/ShellItemChanged/ShellSectionChanged/ShellContentChanged


bool canCancle = args.CanCancel; //是否可以取消


bool canclled = args.Cancelled; //是否取消


args.Cancel(); //取消导航


//获取导航令牌,并完成导航


ShellNavigatingDeferral token = args.GetDeferral();


token.Complete();


}


protected override void OnNavigated(ShellNavigatedEventArgs args)


{


base.OnNavigated(args);


ShellNavigationState current = args.Current; //当前页


ShellNavigationState previous = args.Previous; //上一页


ShellNavigationSource source = args.Source; //导航类型


}


}


//案例一:取消各后导航


protected override void OnNavigating(ShellNavigatingEventArgs args)


{


base.OnNavigating(args);


if (args.Source == ShellNavigationSource.Pop)


{


args.Cancel();


}


}

相关文章
|
2月前
|
自然语言处理 监控 IDE
《吐血整理》-顶级程序员工具集(3)
《吐血整理》-顶级程序员工具集
|
2月前
|
Java 程序员 测试技术
《吐血整理》-顶级程序员工具集(2)
《吐血整理》-顶级程序员工具集
|
2月前
|
数据采集 安全 NoSQL
《吐血整理》-顶级程序员工具集(4)
《吐血整理》-顶级程序员工具集
|
2月前
|
前端开发 JavaScript 程序员
《吐血整理》-顶级程序员工具集(1)
《吐血整理》-顶级程序员工具集
|
3月前
|
算法 程序员
代码与禅意:技术修炼中的悟道之旅
【5月更文挑战第27天】在数字世界的繁复纹理中,编程不仅仅是一种职业技能,它更像是一场精神的修行。本文将探讨编程与禅宗之间的深层联系,透过技术实践揭示那些通常被忽视的哲学思考和内在成长。我们将一起走进代码的世界,探索如何通过技术的精进达到心灵的平静和智慧的提升。
|
3月前
|
机器人 程序员 C++
Scratch3.0——助力新进程序员理解程序(十三、音乐)
Scratch3.0——助力新进程序员理解程序(十三、音乐)
50 0
|
开发框架 前端开发 JavaScript
疯狂吐槽 MAUI 以及 MAUI 入坑知识点
窗口 窗口管理 如何限制一次只能打开一个程序 MAUI 程序安装模式 为 MAUI Blazor 设置语言 坑 ① 坑 ② 坑 ③ 配置 MAUI 项目使用管理员权限启动 问题背景 定制编译过程 MAUI 实现前后端分离开发 背景 先搞前端 创建 MAUI Blazor 项目 C# 自动化生成证书、本地安装证书、解决信任证书问题 背景 写代码 在 ASP.NET Core 中使用
1326 0
|
测试技术
微软产品组里的十一类人
导读:本文来自86pm.com,作者分享了关于微软产品的设计和开发人员的分类。那么微软究竟是如何划分的呢?且看内容如下: 第一种是产品规划人员。产品规划人员主要任务是调查,包括调查你的竞争对手,客户,以及其他市场需求。
1203 0
|
C# 数据库 Windows
艾伟_转载:基于.NET平台的Windows编程实战(一)——前言
本系列文章导航 基于.NET平台的Windows编程实战(一)——前言 基于.NET平台的Windows编程实战(二)—— 需求分析与数据库设计 基于.NET平台的Windows编程实战(四)—— 数据库操作类的编写 基于.NET平台的Windows编程实战(五)—— 问卷管理功能的实现 基于.NET平台的Windows编程实战(六)—— 题目管理功能的实现   前言:本系列文章是一个关于.NET Windows编程的入门实战教程。
1017 0
|
C# 数据库 Windows
艾伟:基于.NET平台的Windows编程实战(一)——前言
本系列文章导航 基于.NET平台的Windows编程实战(一)——前言 基于.NET平台的Windows编程实战(二)—— 需求分析与数据库设计 基于.NET平台的Windows编程实战(四)—— 数据库操作类的编写 基于.NET平台的Windows编程实战(五)—— 问卷管理功能的实现 基于.NET平台的Windows编程实战(六)—— 题目管理功能的实现   前言:本系列文章是一个关于.NET Windows编程的入门实战教程。
793 0