Sextant.XamForms 2.12.162

Sextant

<p align="left"><img src="https://github.com/reactiveui/styleguide/blob/master/logo_sextant/vertical.png?raw=true" alt="Sextant" height="180px"></p>

一个基于 ReactiveUI 的视图模型导航库

Sextant 由 nice and simple MVVM 框架 Xamvvm 的一个分支开发而来，它具有优秀的导航系统。问题是，我只是想使用简单的导航系统，结合 ReactiveUI，而不需要 MVVM 框架中附带的所有功能。此外，我还想让它更加“Reactive 亲和”。

然后出现了一个疯狂的Rodney Littles，以及他的一个实现，即这个惊人的帖子，作者是Kent

Sextant 处于一个非常初期的阶段，并且正在不断变化，因此请对我们的使用保持耐心...因为我们可能会出错。

这个库只不过是我“站在巨人的肩膀上”：Kent 是这个项目的原创和真正创造者，我基本上就是复制粘贴了 😃 Geoffrey Huntley 维护 ReactiveUI。

NuGet 安装

在您的 Forms 项目和 ViewModels 项目上安装 nuget 包。

GitHub

预发布版本包可在 https://nuget.pkg.github.com/reactiveui/index.json 获取。

NuGet

平台	Sextant 包	NuGet
UWP	Sextant
Xamarin.Forms	Sextant.XamForms
Xamarin.Forms	Sextant.Plugins.Popup
Xamarin.iOS	Sextant
Avalonia	Sextant.Avalonia

目标平台版本

验证您拥有目标平台的最低版本（例如，Android，iOS，Tizen）。

注册组件

视图

2.0 版本增加了针对 IMutableDependencyResolver 的新扩展方法，允许您将 IViewFor 注册到视图模型。

Locator
    .CurrentMutable
    .RegisterNavigationView(() => new NavigationView(RxApp.MainThreadScheduler, RxApp.TaskpoolScheduler, ViewLocator.Current))
    .RegisterParameterViewStackService()
    .RegisterViewForNavigation(() => new PassPage(), () => new PassViewModel())
    .RegisterViewForNavigation(() => new ReceivedPage(), () => new ReceivedViewModel());

设置初始页面

Locator
    .Current
    .GetService<IParameterViewStackService>()
    .PushPage<PassViewModel>()
    .Subscribe();

MainPage = Locator.Current.GetNavigationView("NavigationView");

使用导航服务

之后，您只需要在您的视图模型中调用其中的一个方法即可。

/// <summary>
/// Pops the <see cref="IPageViewModel"/> off the stack.
/// </summary>
/// <param name="animate">if set to <c>true</c> [animate].</param>
/// <returns></returns>
IObservable<Unit> PopModal(bool animate = true);

/// <summary>
/// Pops the <see cref="IPageViewModel"/> off the stack.
/// </summary>
/// <param name="animate">if set to <c>true</c> [animate].</param>
/// <returns></returns>
IObservable<Unit> PopPage(bool animate = true);

/// <summary>
/// Pushes the <see cref="IPageViewModel"/> onto the stack.
/// </summary>
/// <param name="modal">The modal.</param>
/// <param name="contract">The contract.</param>
/// <returns></returns>
IObservable<Unit> PushModal(IPageViewModel modal, string contract = null);

/// <summary>
/// Pushes the <see cref="IPageViewModel"/> onto the stack.
/// </summary>
/// <param name="page">The page.</param>
/// <param name="contract">The contract.</param>
/// <param name="resetStack">if set to <c>true</c> [reset stack].</param>
/// <param name="animate">if set to <c>true</c> [animate].</param>
/// <returns></returns>
IObservable<Unit> PushPage(IPageViewModel page, string contract = null, bool resetStack = false, bool animate = true);

示例

public class ViewModel
{
    private readonly IViewStackServicen _viewStackService; // or IParameterViewStackServicen

    public ViewModel(IViewStackServicen viewStackService)
    {
        _viewStackService = viewStackService;

        OpenModal = ReactiveCommand
            // FirstModalViewModel must implement IViewModel or INavigable
            .CreateFromObservable(() => viewStackService.PushModal<FirstModalViewModel>(),
                outputScheduler: RxApp.MainThreadScheduler);
    }

    public ReactiveCommand<Unit, Unit> OpenModal { get; }
}

传递参数

2.0 版本增加了在导航时传递参数的支持。

示例

public class ViewModel
{
    private readonly IParameterViewStackServicen _viewStackService;

    public ViewModel(IParameterViewStackServicen viewStackService)
    {
        _viewStackService = viewStackService;

        Navigate = ReactiveCommand
            // NavigableViewModel must implement INavigable
            .CreateFromObservable(() => viewStackService.PushModal<NavigableViewModel>(new NavigationParameter { { "parameter", parameter } }),
                outputScheduler: RxApp.MainThreadScheduler);
    }

    public ReactiveCommand<Unit, Unit> Navigate { get; }
}

该 INavigable 接口公开了可订阅的视图模型生命周期方法。这些方法解包您的参数对象。实现此接口允许您在导航期间为视图模型分配值。

public class NavigableViewModel : INavigable
{
        public string? _parameter;

        public IObservable<Unit> WhenNavigatedFrom(INavigationParameter parameter)
        {
            return Observable.Return(Unit.Default)
        }

        public IObservable<Unit> WhenNavigatedTo(INavigationParameter parameter)
        {
            parameter.TryGetValue("parameter", out _parameter);
            return Observable.Return(Unit.Default);
        }

        public IObservable<Unit> WhenNavigatingTo(INavigationParameter parameter)
        {
            return Observable.Return(Unit.Default);
        }
}

示例

• 示例
• 导航参数示例

贡献

Sextant 在 OSI 批准的开源许可证下开发，使其可以免费使用和分发，即使用于商业用途。我们喜欢参与这个项目的人，我们希望你也加入我们，尤其是如果你刚开始或者以前从未为开源项目做出过贡献。

因此，为了你，亲爱的想要加入我们的人——这是您可以支持我们的方式

• 在 StackOverflow 上回答问题
• 传授知识和教导新一代的开发者
• 提交您认为合适的或缺少的文档更新。
• 向代码库做出贡献。