Nautil 开发文档
返回： 唐霜 ｜ 书

Nautil 开发文档

Nautil 是一款强大的基于 react 的跨平台业务系统前端 MVC 框架。

前言

MVC 是 Nautil 的核心理念。区【版权所有】唐霜 www.tangshuang.net本文版权归作者所有，未经授权不得转载。别于其他前端框架，Nautil 强调前端【本文受版权保护】【本文首发于唐霜的博客】分层：数据层、表现层、逻辑层。用 Nau【本文首发于唐霜的博客】著作权归作者所有，禁止商业用途转载。til 开发，需要抱着强烈的分层思想进行著作权归作者所有，禁止商业用途转载。著作权归作者所有，禁止商业用途转载。开发，从而能够让我们的项目代码实现高内聚【原创内容，转载请注明出处】【版权所有，侵权必究】低耦合，以便我们在长期迭代中，即使升级 原创内容，盗版必究。原创内容，盗版必究。react 的版本，也仍然能使我们最早的【版权所有，侵权必究】本文版权归作者所有，未经授权不得转载。设计符合当下的业务需求。在 Nautil【本文受版权保护】本文版权归作者所有，未经授权不得转载。 中，你会用到 Model, Contr未经授权，禁止复制转载。【访问 www.tangshuang.net 获取更多精彩内容】oller, Component, Se【关注微信公众号：wwwtangshuangnet】【版权所有】唐霜 www.tangshuang.netrvice 去构建一套 MVC 的开发模【原创不易，请尊重版权】【作者：唐霜】式。当你只是完成简单的 UI 开发时，你未经授权，禁止复制转载。本文作者：唐霜，转载请注明出处。只会用到 Component。但是当你需【本文首发于唐霜的博客】著作权归作者所有，禁止商业用途转载。要灵活的处理用户输入与操作交互时，你就需本文版权归作者所有，未经授权不得转载。本文作者：唐霜，转载请注明出处。要引入 Controller 来整合 C【版权所有】唐霜 www.tangshuang.net本文作者：唐霜，转载请注明出处。omponent 和状态管理、事件管理等原创内容，盗版必究。【本文受版权保护】。而当你需要对业务对象进行更好的数据控制本文作者：唐霜，转载请注明出处。【版权所有】唐霜 www.tangshuang.net时，你就需要再引入 Model，用以创建转载请注明出处：www.tangshuang.net【版权所有】唐霜 www.tangshuang.net领域模型，以理清楚业务实体与应用系统的联【原创内容，转载请注明出处】转载请注明出处：www.tangshuang.net系。最后，如果你需要从应用整体层面处理好【本文受版权保护】本文作者：唐霜，转载请注明出处。数据流或业务流，你就会借助 Servic著作权归作者所有，禁止商业用途转载。【未经授权禁止转载】e 来处理系统层面的控制。传统的 rea未经授权，禁止复制转载。著作权归作者所有，禁止商业用途转载。ct 应用开发基本上全部集中在视图层开发【版权所有】唐霜 www.tangshuang.net【原创不易，请尊重版权】，也就是只有 Component 的体系【版权所有，侵权必究】【本文首发于唐霜的博客】，而 Nautil 整合了业务系统的行业著作权归作者所有，禁止商业用途转载。著作权归作者所有，禁止商业用途转载。共性，完善了 Controller, M本文作者：唐霜，转载请注明出处。本文版权归作者所有，未经授权不得转载。odel, Service 的体系，是一【版权所有】唐霜 www.tangshuang.net本文作者：唐霜，转载请注明出处。个完备的 MVC 体系。

【原创不易，请尊重版权】【本文受版权保护】原创内容，盗版必究。【版权所有】唐霜 www.tangshuang.net

基于 react 的应用开发非常灵活，是【本文首发于唐霜的博客】【原创内容，转载请注明出处】现代前端开发的利器。然而，由于 reac本文版权归作者所有，未经授权不得转载。本文版权归作者所有，未经授权不得转载。t 仅仅是一个 UI 库，它不提供框架级【版权所有】唐霜 www.tangshuang.net【转载请注明来源】别的解决方案，所以当你使用它开发应用时，【作者：唐霜】【原创内容，转载请注明出处】非常麻烦。虽然有一个庞大的生态支持 re著作权归作者所有，禁止商业用途转载。【访问 www.tangshuang.net 获取更多精彩内容】act 成为一个应用开发的基础，但是由于【版权所有】唐霜 www.tangshuang.net【原创不易，请尊重版权】太过复杂，导致实际开发中，各种解决方案杂未经授权，禁止复制转载。【版权所有】唐霜 www.tangshuang.net糅到一起，使得应用非常庞大臃肿，且不好维著作权归作者所有，禁止商业用途转载。【关注微信公众号：wwwtangshuangnet】护，依赖的变化也给后期应用维护提升了成本【访问 www.tangshuang.net 获取更多精彩内容】【作者：唐霜】。特别是 redux，虽然是基于非常优秀著作权归作者所有，禁止商业用途转载。著作权归作者所有，禁止商业用途转载。的思想开发，却由于太过复杂的样板，在实际【作者：唐霜】原创内容，盗版必究。应用中不仅不能带来开发的便捷性，而且会增本文版权归作者所有，未经授权不得转载。【原创内容，转载请注明出处】加代码体积。

未经授权，禁止复制转载。未经授权，禁止复制转载。转载请注明出处：www.tangshuang.net

而 Nautil 是一个新的工程性框架，未经授权，禁止复制转载。【本文受版权保护】她主要要解决的是，抛弃在生态中挑选的纠结【关注微信公众号：wwwtangshuangnet】【本文首发于唐霜的博客】过程，向开发者提供一揽子工程思路解决方案未经授权，禁止复制转载。本文版权归作者所有，未经授权不得转载。。它虽然基于 react，但是并没有一味【本文受版权保护】本文作者：唐霜，转载请注明出处。的去迎合 react 社区，它独树一帜，未经授权，禁止复制转载。本文版权归作者所有，未经授权不得转载。提出自己的 MVC 模式、状态管理、数据转载请注明出处：www.tangshuang.net【原创不易，请尊重版权】管理、观察者模式响应等等，通过这些新的东【访问 www.tangshuang.net 获取更多精彩内容】【本文受版权保护】西，再结合 react 的优秀之处，它完【作者：唐霜】本文版权归作者所有，未经授权不得转载。美的实现了新一代框架应该具备的特性。基于本文作者：唐霜，转载请注明出处。转载请注明出处：www.tangshuang.net更多的选择，Nautil 打破原有的 r未经授权，禁止复制转载。原创内容，盗版必究。eact 范式，融入我们认为更有利于开发【版权所有】唐霜 www.tangshuang.net本文作者：唐霜，转载请注明出处。者快速开发的新方法。我们不应该拘泥于编程转载请注明出处：www.tangshuang.net【访问 www.tangshuang.net 获取更多精彩内容】范式，应该尝试打破范式之争，勇于尝试。

【本文受版权保护】【未经授权禁止转载】【版权所有】唐霜 www.tangshuang.net

Nautil 这个单词取自 Nautil原创内容，盗版必究。转载请注明出处：www.tangshuang.netus 的前面部分。Nautilus（鹦鹉【原创不易，请尊重版权】本文版权归作者所有，未经授权不得转载。螺）是一种海洋生物，有数亿年的进化历程，本文版权归作者所有，未经授权不得转载。转载请注明出处：www.tangshuang.net被成为海洋中的“活化石”。鹦鹉螺身上藏着【版权所有】唐霜 www.tangshuang.net【版权所有】唐霜 www.tangshuang.net非常多令人不可思议的秘密。鹦鹉螺外壳切面【本文首发于唐霜的博客】原创内容，盗版必究。所呈现优美的螺线，暗含了斐波拉契数列，而【关注微信公众号：wwwtangshuangnet】【版权所有】唐霜 www.tangshuang.net斐波拉契数列的两项间比值也是无限接近黄金原创内容，盗版必究。【版权所有，侵权必究】分割数。Nautil 希望在前端开发领域本文作者：唐霜，转载请注明出处。原创内容，盗版必究。打破传统开发思维，创立独特的开发方式。

本文作者：唐霜，转载请注明出处。本文作者：唐霜，转载请注明出处。本文版权归作者所有，未经授权不得转载。转载请注明出处：www.tangshuang.net

安装

本章详细阐述你准备使用 Nautil 前【本文受版权保护】【版权所有】唐霜 www.tangshuang.net的准备工作。

著作权归作者所有，禁止商业用途转载。【原创不易，请尊重版权】

兼容性

Nautil 不支持 IE8 及以下版本，因为它使用了 IE【未经授权禁止转载】本文版权归作者所有，未经授权不得转载。8 无法模拟的 ECMAScript 特【关注微信公众号：wwwtangshuangnet】转载请注明出处：www.tangshuang.net性（例如 Proxy）。

【本文首发于唐霜的博客】【作者：唐霜】【版权所有，侵权必究】

当前版本

最新稳定版本：v0.29
著作权归作者所有，禁止商业用途转载。 稳定版本对应分支：master
【作者：唐霜】 开发中分支：dev

【原创不易，请尊重版权】本文版权归作者所有，未经授权不得转载。本文版权归作者所有，未经授权不得转载。【作者：唐霜】

NPM

npm i nautil

起步

本章开始详细讲解 Nautil 的使用。

【本文受版权保护】【作者：唐霜】【访问 www.tangshuang.net 获取更多精彩内容】

你是怎样的开发者？

Nautil 的开发有一定的门槛，作为前【版权所有】唐霜 www.tangshuang.net【本文首发于唐霜的博客】端开发者，我们希望你可以使用 Nauti【版权所有】唐霜 www.tangshuang.net著作权归作者所有，禁止商业用途转载。l 完成自己的应用开发，但是，我们也不希本文版权归作者所有，未经授权不得转载。本文作者：唐霜，转载请注明出处。望你在基础能力不足的情况下，勉强的去使用【访问 www.tangshuang.net 获取更多精彩内容】【版权所有】唐霜 www.tangshuang.net它。Nautil 需要开发者拥有以下基础【未经授权禁止转载】本文作者：唐霜，转载请注明出处。能力：

【本文首发于唐霜的博客】【转载请注明来源】转载请注明出处：www.tangshuang.net

适用场景

我们做开发，应该选择适合的语言、适合的工【原创不易，请尊重版权】【访问 www.tangshuang.net 获取更多精彩内容】具，对于简单 web 需求，使用 jQu【访问 www.tangshuang.net 获取更多精彩内容】【作者：唐霜】ery 和一个样式库就可以马上开始撸，但原创内容，盗版必究。【版权所有】唐霜 www.tangshuang.net是对于工程应用级别的项目，则需要较为完备本文作者：唐霜，转载请注明出处。著作权归作者所有，禁止商业用途转载。的体系。如果你面对如下项目，那么选择 N未经授权，禁止复制转载。著作权归作者所有，禁止商业用途转载。autil 将会令你事半功倍：

原创内容，盗版必究。【未经授权禁止转载】原创内容，盗版必究。【转载请注明来源】

为什么选择 Nautil？

当你打算写一个项目的时候，如果你选择 r【本文受版权保护】未经授权，禁止复制转载。eact 来写，你会特别麻烦，你需要在市转载请注明出处：www.tangshuang.net本文作者：唐霜，转载请注明出处。面上选择、学习一大堆生态链库，让你特别烦【版权所有】唐霜 www.tangshuang.net未经授权，禁止复制转载。躁。而这只是第一步，接下来，你需要配置编【原创不易，请尊重版权】未经授权，禁止复制转载。译环境，也是烦得不得了。最后，你还要忍受【转载请注明来源】【本文首发于唐霜的博客】 react 默认的数据流行为。Naut【版权所有】唐霜 www.tangshuang.net【未经授权禁止转载】il 的目标，就是让开发者学习的少，但是【转载请注明来源】【版权所有，侵权必究】又可以随心所欲。

原创内容，盗版必究。【关注微信公众号：wwwtangshuangnet】著作权归作者所有，禁止商业用途转载。

我提供了一揽子的解决方案，不需要开发者自转载请注明出处：www.tangshuang.net【关注微信公众号：wwwtangshuangnet】己去选择（虽然你可以自己去选择）：

【版权所有，侵权必究】【未经授权禁止转载】

这些东西都是你所需要的，但是很抱歉，它们【本文首发于唐霜的博客】本文版权归作者所有，未经授权不得转载。都不是 react 生态里面最流行的，然本文作者：唐霜，转载请注明出处。【版权所有，侵权必究】而，它们一定是最方便的。我并不觉得使用 【转载请注明来源】【原创内容，转载请注明出处】redux 有多酷，相反，我觉得它太麻烦【本文首发于唐霜的博客】【关注微信公众号：wwwtangshuangnet】了，虽然它确实很酷，但是对于开发者而言，【本文首发于唐霜的博客】转载请注明出处：www.tangshuang.net写那么多和写应用本身无关的代码逻辑，以及未经授权，禁止复制转载。著作权归作者所有，禁止商业用途转载。所衍生出来的问题，让人很烦恼。最后，我内【原创内容，转载请注明出处】【版权所有】唐霜 www.tangshuang.net置了一个极其简单的 Store 来使用，【版权所有，侵权必究】转载请注明出处：www.tangshuang.net下文会有详细的介绍。

本文版权归作者所有，未经授权不得转载。转载请注明出处：www.tangshuang.net

Nautil 的核心理念就是“为应用开发【作者：唐霜】【原创不易，请尊重版权】设计最简单的工程性解决方案”，而非为技术【访问 www.tangshuang.net 获取更多精彩内容】【版权所有，侵权必究】而设计。包括 react 官方本身，很多【版权所有，侵权必究】【版权所有】唐霜 www.tangshuang.net人都在一套被虚拟出来的技术体系中炫技，但本文版权归作者所有，未经授权不得转载。【转载请注明来源】是本质上，如果没有 react 本身所产【本文首发于唐霜的博客】本文版权归作者所有，未经授权不得转载。生的一系列问题，也就没有这些炫技的机会。【本文首发于唐霜的博客】【版权所有】唐霜 www.tangshuang.net这些自嗨中，似乎忘却了，使用框架的目的最【原创内容，转载请注明出处】【关注微信公众号：wwwtangshuangnet】核心最重要的是做应用开发。如何做好应用开本文作者：唐霜，转载请注明出处。转载请注明出处：www.tangshuang.net发？简单，易懂。这两个单词，是我近来最喜欢的词。而 Na【版权所有】唐霜 www.tangshuang.net转载请注明出处：www.tangshuang.netutil 除了在一开始要理解“观察者模式【本文首发于唐霜的博客】【转载请注明来源】”的核心之外，一切都很简单。

【本文首发于唐霜的博客】【转载请注明来源】

观察者模式

观察者模式（Observer Patte【转载请注明来源】【作者：唐霜】rn），定义对象间的一种一对多依赖关系，【版权所有】唐霜 www.tangshuang.net未经授权，禁止复制转载。使得每当一个对象状态发生改变时，其相关依【原创不易，请尊重版权】原创内容，盗版必究。赖对象皆得到通知并被自动更新。在编程意义【版权所有】唐霜 www.tangshuang.net转载请注明出处：www.tangshuang.net上，首先有两个对象，一个对象被称为观察者原创内容，盗版必究。转载请注明出处：www.tangshuang.net，另一个对象被称为被观察者。观察者（例如【未经授权禁止转载】【原创不易，请尊重版权】 O）将自己的一个方法（例如 O.dis【版权所有】唐霜 www.tangshuang.net本文作者：唐霜，转载请注明出处。patch）交给被观察者（例如 T）暂时【关注微信公众号：wwwtangshuangnet】【本文首发于唐霜的博客】保管，这个过程被称为“订阅”。当被观察者【访问 www.tangshuang.net 获取更多精彩内容】著作权归作者所有，禁止商业用途转载。对应的部分发生变化时，会调用该方法（T 本文版权归作者所有，未经授权不得转载。【原创内容，转载请注明出处】调用 O.dispatch），这个过程被【本文首发于唐霜的博客】【关注微信公众号：wwwtangshuangnet】称为“分发”或“发布”。此时，该方法会使【原创内容，转载请注明出处】【转载请注明来源】观察者随之发生变化（O.dispatch原创内容，盗版必究。【未经授权禁止转载】 会修改 O 的内部状态，从而让 O 发本文版权归作者所有，未经授权不得转载。【版权所有】唐霜 www.tangshuang.net生变化）。

【原创内容，转载请注明出处】原创内容，盗版必究。转载请注明出处：www.tangshuang.net【关注微信公众号：wwwtangshuangnet】

观察者模式是整个 Nautil 的核心理转载请注明出处：www.tangshuang.net【未经授权禁止转载】念，开发者必须掌握这一概念，才不至于在 【本文受版权保护】【关注微信公众号：wwwtangshuangnet】Nautil 的开发中迷路。

原创内容，盗版必究。【本文受版权保护】

为什么这么说？我们先来看下，具体在 Na原创内容，盗版必究。本文作者：唐霜，转载请注明出处。util 中如何发挥观察者模式的作用：

未经授权，禁止复制转载。转载请注明出处：www.tangshuang.net未经授权，禁止复制转载。【版权所有】唐霜 www.tangshuang.net 
import { React, Component, Text, observe, inject, pipe } from 'nautil'
import store from './store'

export class ObservedComponent extends Component {
  render() {
    const { state } = this.attrs
    return (
      <Text>{state.age}</Text>
    )
  }
}

export default pipe([
  observe(store), // 对 store 进行观察，当 store 中的 state 发生变化时，触发组件更新渲染
  inject('state', store.state), // 将 store.state 以 'state' 作为名字注入到组件的 props 中
])(ObservedComponent)

这是最便捷的在 Nautil 中使用观察【版权所有】唐霜 www.tangshuang.net【关注微信公众号：wwwtangshuangnet】者模式的方法之一。observe 指令通转载请注明出处：www.tangshuang.net原创内容，盗版必究。过识别 store，自动对其进行观察，并【关注微信公众号：wwwtangshuangnet】【版权所有】唐霜 www.tangshuang.net在 store 发生变化时更新组件。有了【原创不易，请尊重版权】【作者：唐霜】这个利器，store 可以与其他组件共享著作权归作者所有，禁止商业用途转载。著作权归作者所有，禁止商业用途转载。，在其他组件中更新 store 也会触发转载请注明出处：www.tangshuang.net【访问 www.tangshuang.net 获取更多精彩内容】 ObservedComponent 的【版权所有，侵权必究】【版权所有，侵权必究】更新。

【作者：唐霜】转载请注明出处：www.tangshuang.net

我们通过订阅一个被观察对象的变动，来触发【版权所有】唐霜 www.tangshuang.net未经授权，禁止复制转载。整个页面的变化，没有变动，就不会有界面的著作权归作者所有，禁止商业用途转载。【本文首发于唐霜的博客】变化。因此，如果不理解观察者模式，无法在【关注微信公众号：wwwtangshuangnet】原创内容，盗版必究。 Nautil 中编程。其实这非常好理解【版权所有】唐霜 www.tangshuang.net【原创不易，请尊重版权】，通过变动触发变动，这不是很好理解吗？通著作权归作者所有，禁止商业用途转载。【原创不易，请尊重版权】常的，我们通过订阅某些容器里面的数据的变【未经授权禁止转载】【关注微信公众号：wwwtangshuangnet】动，来触发变动。但是如何触发变动这个过程原创内容，盗版必究。原创内容，盗版必究。你不用关心，你只需要调用 Observe原创内容，盗版必究。本文作者：唐霜，转载请注明出处。r 组件或使用 observe 指令就可本文作者：唐霜，转载请注明出处。本文作者：唐霜，转载请注明出处。以完成这个过程，而不需要关心它是怎么实现原创内容，盗版必究。著作权归作者所有，禁止商业用途转载。的。

转载请注明出处：www.tangshuang.net未经授权，禁止复制转载。著作权归作者所有，禁止商业用途转载。【作者：唐霜】

Store 和 State

状态（State）是用于控制组件 UI 【转载请注明来源】【原创内容，转载请注明出处】界面的对象型数据。一旦一个组件的状态是某未经授权，禁止复制转载。著作权归作者所有，禁止商业用途转载。个值，那么它对应的 UI 界面就是确定的未经授权，禁止复制转载。【原创不易，请尊重版权】。Nautil 提供的 State 和 【转载请注明来源】原创内容，盗版必究。vue.js 中的数据更新方式相似，直接【本文首发于唐霜的博客】本文版权归作者所有，未经授权不得转载。修改对象属性，就会触发 Store 进行未经授权，禁止复制转载。本文作者：唐霜，转载请注明出处。响应。

【版权所有】唐霜 www.tangshuang.net本文版权归作者所有，未经授权不得转载。

仓库（Store）是用于保存 State转载请注明出处：www.tangshuang.net本文作者：唐霜，转载请注明出处。 的容器。一个 Store 内只保管一份【作者：唐霜】【本文首发于唐霜的博客】 State，同时，Store 提供了一【版权所有，侵权必究】转载请注明出处：www.tangshuang.net些接口，用于更新数据、获取数据、监听数据【转载请注明来源】未经授权，禁止复制转载。变化。

【版权所有】唐霜 www.tangshuang.net转载请注明出处：www.tangshuang.net著作权归作者所有，禁止商业用途转载。转载请注明出处：www.tangshuang.net

我们来看下，在 Nautil 中具体如何【本文首发于唐霜的博客】【版权所有，侵权必究】使用类似 vue 中的直接修改 stat【本文首发于唐霜的博客】【版权所有】唐霜 www.tangshuang.nete：

转载请注明出处：www.tangshuang.net本文版权归作者所有，未经授权不得转载。【未经授权禁止转载】 
import { Component } from 'nautil'

class MyComponent extends Component {
  state = {
    name: 'tom',
    age: 10,
  }

  render() {
    return (
      <div>
        <span>{this.state.name}: {this.state.age}</span>
        <button onClick={() => this.$state.age ++}>grow</button> {/* 注意，这里使用 this.$state 而非 this.state */}
      </div>
    )
  }
}

Nautil 仍然遵循了 react 所【未经授权禁止转载】【作者：唐霜】提出的 immutable 数据流的理念著作权归作者所有，禁止商业用途转载。著作权归作者所有，禁止商业用途转载。，在 Nautil 中的视图编程（Com【原创内容，转载请注明出处】本文版权归作者所有，未经授权不得转载。ponent, Store）都遵循这一理本文作者：唐霜，转载请注明出处。原创内容，盗版必究。念，直接修改 state 是不被允许的，本文作者：唐霜，转载请注明出处。【原创不易，请尊重版权】但是通过 this.$state 却可以著作权归作者所有，禁止商业用途转载。原创内容，盗版必究。像 vue 中一样，直接操作 state本文作者：唐霜，转载请注明出处。本文版权归作者所有，未经授权不得转载。（内部使用了 Proxy 进行代理，实际本文版权归作者所有，未经授权不得转载。【访问 www.tangshuang.net 获取更多精彩内容】产生的仍然是 immutable 的 s【本文受版权保护】【版权所有，侵权必究】tate）。

原创内容，盗版必究。【版权所有，侵权必究】

接下来，我们看下同样的理念在 Store【本文受版权保护】【原创不易，请尊重版权】 中的运用：

本文作者：唐霜，转载请注明出处。未经授权，禁止复制转载。【原创内容，转载请注明出处】 
import { React, Store, inject } from 'nautil'

const store = new Store({
  name: 'tomy',
  age: 10,
})

export function FuncComponent() {
  return (
    <div>
      <span>{store.state.name}: {store.state.age}</span>
      <button onClick={() => store.dispatch(state => state.age ++)}>age ++</button>
  )
}
export default obseve(store)(FuncComponent)

上面的代码并非最佳实践，但它说明了如何去【版权所有，侵权必究】本文版权归作者所有，未经授权不得转载。使用一个具有响应式效果的 Store。结【版权所有】唐霜 www.tangshuang.net【本文受版权保护】合上一节“观察者模式”中的演示代码，本例【作者：唐霜】【未经授权禁止转载】中执行 state.age ++ 时，会更新 store 中的 stat转载请注明出处：www.tangshuang.net【访问 www.tangshuang.net 获取更多精彩内容】e。而 ObservedComponen【本文受版权保护】【版权所有】唐霜 www.tangshuang.nett 会因为 store 的变化而更新渲染本文作者：唐霜，转载请注明出处。本文作者：唐霜，转载请注明出处。，所以，FuncComponent 中的【原创不易，请尊重版权】著作权归作者所有，禁止商业用途转载。按钮通过这种方式，实现了更新 Obser本文版权归作者所有，未经授权不得转载。转载请注明出处：www.tangshuang.netvedComponent。

【本文受版权保护】【访问 www.tangshuang.net 获取更多精彩内容】

另外，redux 中整个应用只有一个 s原创内容，盗版必究。【访问 www.tangshuang.net 获取更多精彩内容】tore，这个 store 实际上被作为【作者：唐霜】【关注微信公众号：wwwtangshuangnet】 redux 这个包内部的一部分。它的思本文作者：唐霜，转载请注明出处。【版权所有】唐霜 www.tangshuang.net想局限于一个 web 应用中只会有一个 【本文受版权保护】转载请注明出处：www.tangshuang.netreact 应用。但实际上，我们可能在一【原创内容，转载请注明出处】【本文受版权保护】个 web 应用中同时运行多个 reac【原创不易，请尊重版权】【未经授权禁止转载】t 应用。Nautil 的 Store 未经授权，禁止复制转载。【作者：唐霜】不限制个数，当然，为了同一管理，我们也建【原创不易，请尊重版权】【本文受版权保护】议开发者，对于一个应用而言，只创建 1-【本文首发于唐霜的博客】【关注微信公众号：wwwtangshuangnet】3 个 Store，方便你更好的对整个应【本文受版权保护】未经授权，禁止复制转载。用的总体状态进行观察。

本文版权归作者所有，未经授权不得转载。原创内容，盗版必究。【版权所有，侵权必究】【访问 www.tangshuang.net 获取更多精彩内容】

响应式

Nautil 应用基于观察者模式实现数据【转载请注明来源】本文作者：唐霜，转载请注明出处。变化带来的界面响应。虽然 Nautil 【本文受版权保护】【版权所有】唐霜 www.tangshuang.net支持 react 的 setState 【作者：唐霜】本文作者：唐霜，转载请注明出处。方法，但是我们并不这么推荐，因为我们不提本文版权归作者所有，未经授权不得转载。著作权归作者所有，禁止商业用途转载。倡一个组件内内置自己的 state，而应【访问 www.tangshuang.net 获取更多精彩内容】【未经授权禁止转载】该更多的考虑使用外部数据来驱动组件本身的【版权所有】唐霜 www.tangshuang.net本文作者：唐霜，转载请注明出处。渲染。

【版权所有，侵权必究】本文版权归作者所有，未经授权不得转载。未经授权，禁止复制转载。【本文首发于唐霜的博客】

Nautil 依然遵循单向数据流模式（但【关注微信公众号：wwwtangshuangnet】未经授权，禁止复制转载。同时支持双向数据流），但是在组件内更新外【原创不易，请尊重版权】本文作者：唐霜，转载请注明出处。部传入的数据时稍有不同。传统 react原创内容，盗版必究。【未经授权禁止转载】 组件更新外部通过 props 传入的数【版权所有】唐霜 www.tangshuang.net未经授权，禁止复制转载。据时，需要通过一个 onClick 这样原创内容，盗版必究。本文作者：唐霜，转载请注明出处。的回调函数将更新信号返回给组件的外部，再【本文受版权保护】本文版权归作者所有，未经授权不得转载。由外部来更新数据后，将更新后的数据通过 【版权所有】唐霜 www.tangshuang.net【版权所有】唐霜 www.tangshuang.netprops 再次传入。虽然这样做逻辑上没原创内容，盗版必究。【原创不易，请尊重版权】有问题，保证了数据干净和组件干净。但是，【访问 www.tangshuang.net 获取更多精彩内容】本文版权归作者所有，未经授权不得转载。这样的写法，开发体验实在是太差了。

【版权所有，侵权必究】著作权归作者所有，禁止商业用途转载。

出于改善这种开发体验的目的。Nautil未经授权，禁止复制转载。本文作者：唐霜，转载请注明出处。 借鉴了 mobx 的观察者模式思路。我【版权所有，侵权必究】【本文首发于唐霜的博客】们在组件内更新 props 传入的对象时【版权所有】唐霜 www.tangshuang.net【原创内容，转载请注明出处】，直接修改该对象的某个属性即可。上述的回【版权所有】唐霜 www.tangshuang.net【作者：唐霜】调再传入过程，通过观察者模式和 stor【作者：唐霜】著作权归作者所有，禁止商业用途转载。e 的内部管道完成。如果你熟悉 redu【原创不易，请尊重版权】【转载请注明来源】x 的话，一定知道 react-redu著作权归作者所有，禁止商业用途转载。著作权归作者所有，禁止商业用途转载。x 的 connect 函数，Nauti【关注微信公众号：wwwtangshuangnet】【关注微信公众号：wwwtangshuangnet】l 基于观察者模式解决相同的问题。

【访问 www.tangshuang.net 获取更多精彩内容】【作者：唐霜】

我们用真实的代码来体验一下：

本文版权归作者所有，未经授权不得转载。本文作者：唐霜，转载请注明出处。【本文首发于唐霜的博客】【本文首发于唐霜的博客】 
// store.js
const store = new Store({ count: 0, })
export default store
// some.js
import { React, Component, Section, Text, Button, observe } from 'nautil/components'
import store from './store'

// 对于 Some 组件本身而言，store 中 state 的变化，不会触发 Some 的更新。
// 更新将交给上层组件去做。
export default class Some extends Component {
  render() {
    return <Section>
      <Text>{store.state.count}</Text>
      <Button onHit={() => store.dispatch(state => state.count ++)}>+</Button>
    </Section>
  }
}
// app.js
import { Component, Store, Observer } from 'nautil/components'
import Some from './some'
import store from './store'

export default class App extends Component {
  render() {
    return <Observer 
      subscribe={dispatch => store.subscribe(dispatch)} 
      unsubscribe={dispatch => store.unsubscribe(dispatch)} 
      dispatch={this.weakUpdate}
    >
      <Some />
    </Observer>
  }
}

store 在多个组件之间共享，这些组件【作者：唐霜】著作权归作者所有，禁止商业用途转载。都被一个顶层组件使用（上面的 APP），【本文首发于唐霜的博客】原创内容，盗版必究。并且在该顶层组件中使用观察者模式订阅 s本文作者：唐霜，转载请注明出处。原创内容，盗版必究。tore 的变化，来触发更新界面，这样，未经授权，禁止复制转载。【原创内容，转载请注明出处】在任何组件中更新了 store 中的数据转载请注明出处：www.tangshuang.net【本文受版权保护】，就可以触发整个应用的更新。

【原创内容，转载请注明出处】【版权所有】唐霜 www.tangshuang.net

当然，不引用全局变量，使用 props 【本文受版权保护】转载请注明出处：www.tangshuang.net从外部传数据是最好的，这在前面的“观察者【转载请注明来源】原创内容，盗版必究。模式”“Store 和 State”这两未经授权，禁止复制转载。【版权所有，侵权必究】部分中已经用实例代码演示了。

【本文受版权保护】未经授权，禁止复制转载。未经授权，禁止复制转载。

双向绑定

Nautil 支持属性级别的双向绑定。双【未经授权禁止转载】著作权归作者所有，禁止商业用途转载。向绑定时，使用 $ 符合作为属性前缀。一【本文首发于唐霜的博客】【原创内容，转载请注明出处】个用于双向绑定的属性的值，是一个可被用于【本文受版权保护】【原创内容，转载请注明出处】监听的观察者模式参数。双向绑定完全打破了未经授权，禁止复制转载。未经授权，禁止复制转载。 react 生态单向数据流的主流思想，本文版权归作者所有，未经授权不得转载。本文版权归作者所有，未经授权不得转载。但带来的好处不言而喻，它可以避免复杂的回【转载请注明来源】未经授权，禁止复制转载。调地狱，最好的例子就是一个简单的显示和隐【原创内容，转载请注明出处】本文版权归作者所有，未经授权不得转载。藏效果。

【版权所有】唐霜 www.tangshuang.net【未经授权禁止转载】【原创不易，请尊重版权】 
class Modal extends Component {
  static props = {
    $show: Boolean, // 声明这是一个需要双向绑定的属性，外部传入时必须传入特定结构的值
  }
  render() {
    return (
      <If is={this.attrs.show}>
        <Section>
          <Button onHint={() => this.$attrs.show = false}>close</Button>
        </Section>
      </If>
    )
  }
}

function Some() {
  const $show = useState(false)
  const [, setShow] = $show
  return (
    <Section>
      <Button onHint={() => setShow(true)}></Button>
      <Modal $show={$show} /> {/* $show={[show, setShow]} */}
    </Section>
  )
}

上面代码中的红色部分是个神奇的操作。虽然著作权归作者所有，禁止商业用途转载。本文作者：唐霜，转载请注明出处。从语言上，你看不出什么不同之处，但是你回【版权所有，侵权必究】转载请注明出处：www.tangshuang.net想一下 react 的原生操作，就会发现【本文首发于唐霜的博客】【本文受版权保护】，这样的操作在 react 生态中是不被未经授权，禁止复制转载。【未经授权禁止转载】允许的，而在 nautil 却可以实现双【本文首发于唐霜的博客】未经授权，禁止复制转载。向绑定，触发界面更新。（需要注意的是，这未经授权，禁止复制转载。【未经授权禁止转载】里的 this.$attrs 虽然是响应【原创不易，请尊重版权】本文版权归作者所有，未经授权不得转载。式的，但它不是所有属性都是响应式的，只有本文版权归作者所有，未经授权不得转载。本文版权归作者所有，未经授权不得转载。以 $ 开头传入的属性是响应式的，而且依未经授权，禁止复制转载。【作者：唐霜】赖于外部逻辑完成响应，因此，和 vue 本文版权归作者所有，未经授权不得转载。【版权所有，侵权必究】的 this 还是有非常大的不同）。需要【原创不易，请尊重版权】【本文首发于唐霜的博客】注意，虽然在声明时要求传入的 prop 【未经授权禁止转载】【版权所有，侵权必究】为 $age，但是在 this.attr转载请注明出处：www.tangshuang.net本文版权归作者所有，未经授权不得转载。s 上，却要使用 this.attrs.【原创不易，请尊重版权】【版权所有，侵权必究】age 读取。

【本文首发于唐霜的博客】【转载请注明来源】【原创不易，请尊重版权】

蓝色部分需要被注意，它是一个特定结构，一【关注微信公众号：wwwtangshuangnet】转载请注明出处：www.tangshuang.net个含有两个元素的数组。第一个元素是作为传【关注微信公众号：wwwtangshuangnet】【本文首发于唐霜的博客】入 prop 的值，第二个元素是响应内部本文版权归作者所有，未经授权不得转载。本文作者：唐霜，转载请注明出处。发生变化时的函数 reactive。当 未经授权，禁止复制转载。【未经授权禁止转载】Sub 中执行了 this.$attrs.show = false 时，show 变化后的值作为参数，传给【作者：唐霜】著作权归作者所有，禁止商业用途转载。 reactive 函数，并执行 rea本文版权归作者所有，未经授权不得转载。未经授权，禁止复制转载。ctive 函数，在 reactive 【版权所有，侵权必究】【版权所有】唐霜 www.tangshuang.net函数中去更新当前组件的状态，从而触发界面著作权归作者所有，禁止商业用途转载。【原创不易，请尊重版权】变化。

【未经授权禁止转载】本文版权归作者所有，未经授权不得转载。未经授权，禁止复制转载。本文作者：唐霜，转载请注明出处。

必须声明为双向绑定的属性，才能直接在 t【版权所有，侵权必究】本文版权归作者所有，未经授权不得转载。his.$attrs 上进行操作，否则不【作者：唐霜】【版权所有】唐霜 www.tangshuang.net会有任何效果。另外，对 this.$at【版权所有，侵权必究】未经授权，禁止复制转载。trs 的操作，不会改写 this.at【版权所有，侵权必究】【转载请注明来源】trs 的值，而是仅调用外部传入的 re【本文受版权保护】【原创内容，转载请注明出处】active。如果外部传入的 react本文版权归作者所有，未经授权不得转载。【版权所有】唐霜 www.tangshuang.netive 没有修改传入的值，那么也不会有界【关注微信公众号：wwwtangshuangnet】【未经授权禁止转载】面的更新。例如，上面的 setShow 【关注微信公众号：wwwtangshuangnet】【版权所有】唐霜 www.tangshuang.net没有带来 show 的变化，那么 Mod【本文首发于唐霜的博客】【转载请注明来源】al 也不会有任何变化。

【原创内容，转载请注明出处】【转载请注明来源】【原创内容，转载请注明出处】原创内容，盗版必究。

此外，如果你希望使用更优雅的写法，你可以【原创内容，转载请注明出处】【转载请注明来源】使用内置的 createTwoWayBi【关注微信公众号：wwwtangshuangnet】【转载请注明来源】nding 函数：

【版权所有】唐霜 www.tangshuang.net著作权归作者所有，禁止商业用途转载。【关注微信公众号：wwwtangshuangnet】 
import { createTwoWayBinding } from 'nautil/utils'
class Some extends Component {
  state = {
    show: false,
  }
  render() {
    const $state = createTwoWayBinding(this.state, state => this.setState(state))
    return <Model $show={$state.show} />
  }
}

这样看上去更优雅，不需要传入数组，也不需著作权归作者所有，禁止商业用途转载。【版权所有】唐霜 www.tangshuang.net要传入 state（直接传入 state【版权所有】唐霜 www.tangshuang.net【作者：唐霜】 像是传入 state 整个值作为 sh【转载请注明来源】转载请注明出处：www.tangshuang.netow 的属性值一样，不是很好）。而通过 【版权所有，侵权必究】【原创内容，转载请注明出处】createTwoWayBinding 本文版权归作者所有，未经授权不得转载。【关注微信公众号：wwwtangshuangnet】函数，就可以将一个对象转化为可读取属性的【版权所有，侵权必究】原创内容，盗版必究。对象，实际上 $state.show 的原创内容，盗版必究。原创内容，盗版必究。返回值也是一个符合双向绑定的数组，但是在【版权所有，侵权必究】【原创不易，请尊重版权】阅读和理解上更容易理解一些。

著作权归作者所有，禁止商业用途转载。【关注微信公众号：wwwtangshuangnet】转载请注明出处：www.tangshuang.net

跨平台开发

Nautil 的设计目标之一，就是实现跨【版权所有，侵权必究】未经授权，禁止复制转载。平台开发，特别是移动端的跨平台开发。实现本文作者：唐霜，转载请注明出处。【版权所有，侵权必究】一处写代码，根据不同的平台编译后即可运行著作权归作者所有，禁止商业用途转载。【版权所有，侵权必究】的效果。要实现跨平台编程，需要遵循一些基本文版权归作者所有，未经授权不得转载。【版权所有，侵权必究】本的规则：

著作权归作者所有，禁止商业用途转载。【本文受版权保护】

开发时，应该关注：

【原创内容，转载请注明出处】著作权归作者所有，禁止商业用途转载。

JSX 渲染语法

在 Nautil 的理念中，存在这样的一【版权所有】唐霜 www.tangshuang.net转载请注明出处：www.tangshuang.net条有象征意义的 slogan：

著作权归作者所有，禁止商业用途转载。【版权所有，侵权必究】

Nautil is React, Nau本文版权归作者所有，未经授权不得转载。【版权所有】唐霜 www.tangshuang.nettil is more than Rea【本文受版权保护】【原创不易，请尊重版权】ct.

【访问 www.tangshuang.net 获取更多精彩内容】【访问 www.tangshuang.net 获取更多精彩内容】【原创内容，转载请注明出处】【原创内容，转载请注明出处】
未经授权，禁止复制转载。未经授权，禁止复制转载。【关注微信公众号：wwwtangshuangnet】

Nautil 和 react 几乎是完全【版权所有，侵权必究】未经授权，禁止复制转载。兼容的（16.8+ 版本的 react）著作权归作者所有，禁止商业用途转载。【未经授权禁止转载】，你可以把以前写的 react 组件直接【本文首发于唐霜的博客】【原创不易，请尊重版权】拿到 Nautil 中使用（不考虑跨平台【作者：唐霜】【转载请注明来源】，只想使用更新的写作方式），也可以把基于本文版权归作者所有，未经授权不得转载。【访问 www.tangshuang.net 获取更多精彩内容】 Nautil 写的代码放到其他 rea【未经授权禁止转载】本文版权归作者所有，未经授权不得转载。ct 应用中使用，相互之间不会造成任何兼著作权归作者所有，禁止商业用途转载。转载请注明出处：www.tangshuang.net容性问题（但是打包的代码量可能会比直接使【转载请注明来源】未经授权，禁止复制转载。用 react 写的代码大一点）。

【关注微信公众号：wwwtangshuangnet】转载请注明出处：www.tangshuang.net【转载请注明来源】

因此，写 Nautil 应用和写 rea原创内容，盗版必究。转载请注明出处：www.tangshuang.netct 应用没有任何差别。我们仍然使用 j著作权归作者所有，禁止商业用途转载。【转载请注明来源】sx 进行渲染结构的编写，语法上没有任何【原创不易，请尊重版权】【版权所有，侵权必究】差别。

【本文首发于唐霜的博客】【作者：唐霜】【版权所有】唐霜 www.tangshuang.net

生命周期函数

我们简化生命周期函数，因此，在开发 Na未经授权，禁止复制转载。原创内容，盗版必究。util 时，你可以忘记有关 react【作者：唐霜】著作权归作者所有，禁止商业用途转载。 生命周期函数的一切，使用更简短的生命周【原创不易，请尊重版权】【原创不易，请尊重版权】期钩子函数。

【未经授权禁止转载】【作者：唐霜】【关注微信公众号：wwwtangshuangnet】本文版权归作者所有，未经授权不得转载。

内置组件

使用 Nautil 进行开发时，必须使用原创内容，盗版必究。本文作者：唐霜，转载请注明出处。内置的组件进行开发。和原生 react 本文版权归作者所有，未经授权不得转载。【版权所有】唐霜 www.tangshuang.net开发 web 应用不同，我们不能使用 d【本文首发于唐霜的博客】未经授权，禁止复制转载。iv/span 这种 HTML 标签作为【本文受版权保护】【版权所有】唐霜 www.tangshuang.net基础组件，而是要使用 Nautil 的内【访问 www.tangshuang.net 获取更多精彩内容】【转载请注明来源】置组件（如 Section, Text 【原创内容，转载请注明出处】未经授权，禁止复制转载。等）代替。这是为跨平台准备的，只有使用内【版权所有】唐霜 www.tangshuang.net本文作者：唐霜，转载请注明出处。置组件构建起来的 nautil 应用才能未经授权，禁止复制转载。【关注微信公众号：wwwtangshuangnet】构建出跨平台的应用。

【关注微信公众号：wwwtangshuangnet】未经授权，禁止复制转载。

内置组件包含如下几类：

【访问 www.tangshuang.net 获取更多精彩内容】【作者：唐霜】未经授权，禁止复制转载。

这些组件都是由 Nautil 默认导出的【访问 www.tangshuang.net 获取更多精彩内容】【访问 www.tangshuang.net 获取更多精彩内容】，你可以在下文详细了解。

【转载请注明来源】【原创内容，转载请注明出处】【原创不易，请尊重版权】原创内容，盗版必究。

跨平台构建

不同的平台，使用不同的入口文件，使用不同【转载请注明来源】【本文首发于唐霜的博客】的构建配置。例如，我们在 web 上：

本文作者：唐霜，转载请注明出处。原创内容，盗版必究。【版权所有】唐霜 www.tangshuang.net【版权所有，侵权必究】 
import { mount } from 'nautil/dom'
import App from './app.jsx'

mount('#app', App)

而在 react-native 上：

转载请注明出处：www.tangshuang.net本文版权归作者所有，未经授权不得转载。本文作者：唐霜，转载请注明出处。原创内容，盗版必究。 
import { register } from 'nautil/native'
import App from './app.jsx'

register('ProjectName', App)

在小程序上：

【未经授权禁止转载】【版权所有，侵权必究】原创内容，盗版必究。 
import { createApp } from 'nautil/miniapp'
import App from './app.jsx'

export default createApp(App)

虽然它们看上去非常相似，但是背后的平台不【关注微信公众号：wwwtangshuangnet】著作权归作者所有，禁止商业用途转载。同，所要求的构建工具也不同。

本文作者：唐霜，转载请注明出处。【访问 www.tangshuang.net 获取更多精彩内容】【未经授权禁止转载】本文版权归作者所有，未经授权不得转载。

组件

虽然 Nautil 的组件本质上就是 r【访问 www.tangshuang.net 获取更多精彩内容】【版权所有】唐霜 www.tangshuang.neteact 组件，但是在具体细节上和 re【访问 www.tangshuang.net 获取更多精彩内容】【原创内容，转载请注明出处】act 组件还是有所不同。本章将详细讲解【版权所有】唐霜 www.tangshuang.net【作者：唐霜】 Nautil 组件在 react 组件【本文首发于唐霜的博客】【版权所有】唐霜 www.tangshuang.net之外还具备的新特征。

【版权所有】唐霜 www.tangshuang.net【本文受版权保护】【版权所有】唐霜 www.tangshuang.net 
import { Component } from 'nautil'

Props 声明和检查

和 react 的 propTypes 【本文受版权保护】转载请注明出处：www.tangshuang.net很像，你可以通过 props 属性对组件【版权所有】唐霜 www.tangshuang.net【原创不易，请尊重版权】接收的 props 进行声明和类型、结构本文作者：唐霜，转载请注明出处。【版权所有】唐霜 www.tangshuang.net进行检查。

未经授权，禁止复制转载。【转载请注明来源】【访问 www.tangshuang.net 获取更多精彩内容】

props 声明

通过 static props 属性，你【原创内容，转载请注明出处】未经授权，禁止复制转载。可以要求组件所传入的 props 必须包【本文首发于唐霜的博客】【作者：唐霜】含哪些属性。nautil 的属性包含三种原创内容，盗版必究。原创内容，盗版必究。：

原创内容，盗版必究。【本文受版权保护】

普通属性和 react 属性一样，没有差【关注微信公众号：wwwtangshuangnet】本文作者：唐霜，转载请注明出处。别。双向绑定属性用 $ 开头进行声明。o【本文首发于唐霜的博客】本文版权归作者所有，未经授权不得转载。n 开头的属性被认为是一个 handle【本文首发于唐霜的博客】【本文首发于唐霜的博客】r 属性，用于类似 react 中 on本文作者：唐霜，转载请注明出处。本文作者：唐霜，转载请注明出处。Click 这类属性。

本文作者：唐霜，转载请注明出处。本文版权归作者所有，未经授权不得转载。【本文受版权保护】

props 校验

通过 static props 的属性值【版权所有】唐霜 www.tangshuang.net本文作者：唐霜，转载请注明出处。，我们可以对传入的 props 的值进行【本文首发于唐霜的博客】原创内容，盗版必究。校验。nautil 中的类型校验遵循 t【原创不易，请尊重版权】【版权所有】唐霜 www.tangshuang.netyshemo 的类型校验方法。在撰写一个本文作者：唐霜，转载请注明出处。【访问 www.tangshuang.net 获取更多精彩内容】类型时，你需要从 nautil 中引入已【原创不易，请尊重版权】本文版权归作者所有，未经授权不得转载。支持的类型规则。

原创内容，盗版必究。未经授权，禁止复制转载。【原创不易，请尊重版权】【原创不易，请尊重版权】 
import { Dict, Component } from 'nautil'

class SomeComponent extends Component {
  static props = {
    person: new Dict({
      head: Object,
      body: Object,
      foot: Object,
    }),
  }
}

对于三种不同的属性，其校验规则也稍有不同【版权所有，侵权必究】【关注微信公众号：wwwtangshuangnet】：

【未经授权禁止转载】【原创内容，转载请注明出处】【本文受版权保护】未经授权，禁止复制转载。

其中，双向绑定属性、事件属性，无论在 p著作权归作者所有，禁止商业用途转载。【本文受版权保护】rops 中有无声明，在运行时都会进行基著作权归作者所有，禁止商业用途转载。【关注微信公众号：wwwtangshuangnet】本类型校验。

本文版权归作者所有，未经授权不得转载。【访问 www.tangshuang.net 获取更多精彩内容】【版权所有，侵权必究】

削减代码

在 process.env.NODE_E【版权所有，侵权必究】【转载请注明来源】NV === ‘produc【本文首发于唐霜的博客】【转载请注明来源】ition’ 时，校验会被禁【关注微信公众号：wwwtangshuangnet】【版权所有】唐霜 www.tangshuang.net用。也就是说，在正式环境中，组件 pro【作者：唐霜】【版权所有】唐霜 www.tangshuang.netps 的结构、类型校验是禁用掉的，不会执【访问 www.tangshuang.net 获取更多精彩内容】未经授权，禁止复制转载。行，并且通过 webpack 的 tre【未经授权禁止转载】【本文首发于唐霜的博客】e-shaking，可以将部分代码削减掉【关注微信公众号：wwwtangshuangnet】【本文首发于唐霜的博客】。

【关注微信公众号：wwwtangshuangnet】转载请注明出处：www.tangshuang.net【原创内容，转载请注明出处】【原创不易，请尊重版权】

Attrs 属性

Nautil 组件继承自 react 组著作权归作者所有，禁止商业用途转载。【版权所有】唐霜 www.tangshuang.net件，也包含了 props 属性，可以通过【转载请注明来源】本文版权归作者所有，未经授权不得转载。 this.props 属性读取原始的 原创内容，盗版必究。【版权所有】唐霜 www.tangshuang.netprops。但是，由于我们 Nautil原创内容，盗版必究。【版权所有，侵权必究】 组件的特性，双向绑定属性和事件属性，所著作权归作者所有，禁止商业用途转载。【版权所有】唐霜 www.tangshuang.net以原始 props 没有意义，无法正常发本文版权归作者所有，未经授权不得转载。【关注微信公众号：wwwtangshuangnet】挥 nautil 的特性。

【关注微信公众号：wwwtangshuangnet】【原创内容，转载请注明出处】【作者：唐霜】【版权所有，侵权必究】

Attrs 值

从 props 上的属性经过处理后产生 【转载请注明来源】【未经授权禁止转载】this.attrs。this.attr【本文受版权保护】本文作者：唐霜，转载请注明出处。s 和 this.props 不是包含与著作权归作者所有，禁止商业用途转载。著作权归作者所有，禁止商业用途转载。被包含关系，this.attrs 上的值【版权所有】唐霜 www.tangshuang.net本文版权归作者所有，未经授权不得转载。包含两部分：

【本文受版权保护】【关注微信公众号：wwwtangshuangnet】【未经授权禁止转载】转载请注明出处：www.tangshuang.net

对于 this.props 上的 cla【版权所有】唐霜 www.tangshuang.net原创内容，盗版必究。ssName, style, child【本文首发于唐霜的博客】著作权归作者所有，禁止商业用途转载。ren 属性，并不在 attrs 中，o转载请注明出处：www.tangshuang.net【原创不易，请尊重版权】n 开头的事件属性也不在其中。

【本文受版权保护】本文版权归作者所有，未经授权不得转载。【本文首发于唐霜的博客】原创内容，盗版必究。

双向绑定

通过直接反写 this.$attrs 可【作者：唐霜】【版权所有，侵权必究】以完成双向绑定。

【访问 www.tangshuang.net 获取更多精彩内容】本文作者：唐霜，转载请注明出处。本文作者：唐霜，转载请注明出处。 
reneder() {
  return <Button onHint={() => this.$attrs.age ++}></Button>
}

双向绑定的用法在前文已经详细解释过。需要【版权所有，侵权必究】原创内容，盗版必究。注意的是，只有外部传入时以 $ 开头的属【本文首发于唐霜的博客】著作权归作者所有，禁止商业用途转载。性才会触发双向绑定。比如外部传入 age本文版权归作者所有，未经授权不得转载。原创内容，盗版必究。 属性，则不会触发双向绑定操作 this转载请注明出处：www.tangshuang.net【版权所有】唐霜 www.tangshuang.net.$attrs.age ++ 操作不会产转载请注明出处：www.tangshuang.net【版权所有，侵权必究】生任何作用（甚至不会修改 this.at【未经授权禁止转载】转载请注明出处：www.tangshuang.nettrs）。

【版权所有，侵权必究】【版权所有】唐霜 www.tangshuang.net【本文首发于唐霜的博客】【版权所有】唐霜 www.tangshuang.net

在 static props 中未声明属本文作者：唐霜，转载请注明出处。【未经授权禁止转载】性为双向绑定属性，但是在传入时使用了双向【原创内容，转载请注明出处】【原创不易，请尊重版权】属性标记 $，那么该属性在内部仍然是一个【访问 www.tangshuang.net 获取更多精彩内容】著作权归作者所有，禁止商业用途转载。双向绑定属性。在 static prop【转载请注明来源】【版权所有】唐霜 www.tangshuang.nets 中声明了这个属性为双向绑定属性，那么著作权归作者所有，禁止商业用途转载。本文作者：唐霜，转载请注明出处。外部传入时，只允许传入双向绑定结构，而不【作者：唐霜】原创内容，盗版必究。允许传入普通属性值。

著作权归作者所有，禁止商业用途转载。【原创内容，转载请注明出处】未经授权，禁止复制转载。本文作者：唐霜，转载请注明出处。

stylesheet

和 react 组件不同，nautil 著作权归作者所有，禁止商业用途转载。【版权所有】唐霜 www.tangshuang.net传入样式时，不需要区分 classNam【未经授权禁止转载】【本文首发于唐霜的博客】e 和 style，直接通过独立的 st本文作者：唐霜，转载请注明出处。【作者：唐霜】ylesheet 属性传入。组件内部会自原创内容，盗版必究。【作者：唐霜】动进行识别，当值为 object 时自动【作者：唐霜】本文版权归作者所有，未经授权不得转载。识别为 style 或一个 classN【关注微信公众号：wwwtangshuangnet】【访问 www.tangshuang.net 获取更多精彩内容】ame 的 mapping，传入 str本文版权归作者所有，未经授权不得转载。著作权归作者所有，禁止商业用途转载。ing 时自动识别为 className【原创不易，请尊重版权】著作权归作者所有，禁止商业用途转载。。

【原创不易，请尊重版权】未经授权，禁止复制转载。未经授权，禁止复制转载。【未经授权禁止转载】

通过处理之后，this 上会多出 thi原创内容，盗版必究。本文版权归作者所有，未经授权不得转载。s.className 和 this.s【本文受版权保护】本文作者：唐霜，转载请注明出处。tyle，你可以在 render 中使用转载请注明出处：www.tangshuang.net【版权所有】唐霜 www.tangshuang.net这两个属性。

【未经授权禁止转载】本文版权归作者所有，未经授权不得转载。未经授权，禁止复制转载。本文版权归作者所有，未经授权不得转载。

chidlren

虽然你可以通过 this.props.c【本文受版权保护】转载请注明出处：www.tangshuang.nethildren 读取，但 nautil 原创内容，盗版必究。【版权所有，侵权必究】增加 this.children 帮你快原创内容，盗版必究。原创内容，盗版必究。速读取当前组件的内部组件。

【访问 www.tangshuang.net 获取更多精彩内容】原创内容，盗版必究。【作者：唐霜】【未经授权禁止转载】

on:streams

Nautil 的事件属性可以像 reac【版权所有】唐霜 www.tangshuang.net【本文受版权保护】t 的事件属性一样使用，但是名称会有不同【本文首发于唐霜的博客】【原创不易，请尊重版权】，例如 nautil 中不会有 onCl【未经授权禁止转载】【本文首发于唐霜的博客】ick 属性，而是采用 onHit 作为【版权所有】唐霜 www.tangshuang.net【转载请注明来源】替代。这是因为在跨平台开发时，我们将通过【作者：唐霜】著作权归作者所有，禁止商业用途转载。新的名字统一不同平台的事件名字。

本文版权归作者所有，未经授权不得转载。转载请注明出处：www.tangshuang.net【本文受版权保护】

事件属性你可以像 react 中一样使用【访问 www.tangshuang.net 获取更多精彩内容】未经授权，禁止复制转载。，例如：

【未经授权禁止转载】本文作者：唐霜，转载请注明出处。未经授权，禁止复制转载。【原创不易，请尊重版权】 
<Button onHit={e => console.log(e)}>click</Button>

但同时，nautil 基于 rxjs 开【版权所有】唐霜 www.tangshuang.net【转载请注明来源】发了一套更丰富的事件流机制。在开发中，可【访问 www.tangshuang.net 获取更多精彩内容】本文版权归作者所有，未经授权不得转载。以让抽象的事件更加独立完成某些操作。我们未经授权，禁止复制转载。【转载请注明来源】先来看一个例子：

【原创不易，请尊重版权】【转载请注明来源】 
class Some extends Component {
  static props = {
    onHit: false, // on 开头的事件属性在校验时会被忽略其值，使用内部的规则自动进行校验
    $age: Number,
    $weight: Number,
  }
  
  init() {
    // 通过 on 来为事件流绑定新的动作。
    // on 绑定的动作，不会影响外部传入的 onHit 已经生效的回调动作
    this.on('Hit', () => this.$attrs.age ++)
    this.on('Hit', () => this.$attrs.weight = this.attrs.age * 10)
  }
  render() {
    return (
      <Button onHit={this.Hit$}>grow</Button>
    )
  }
}

上面这个组件，在没有蓝色部分的情况下，也原创内容，盗版必究。本文版权归作者所有，未经授权不得转载。可以正常运行。蓝色的部分，在此基础上，对【原创不易，请尊重版权】【本文首发于唐霜的博客】 onHit 事件新增了订阅。也就是说，本文版权归作者所有，未经授权不得转载。【作者：唐霜】当用户点击 Button 的时候，不仅会转载请注明出处：www.tangshuang.net【原创内容，转载请注明出处】触发组件外部传入的 onHit 回调，而【版权所有】唐霜 www.tangshuang.net【访问 www.tangshuang.net 获取更多精彩内容】且还会触发新增的两个订阅，这使得关于事件著作权归作者所有，禁止商业用途转载。【未经授权禁止转载】的管理可分离后进行。

原创内容，盗版必究。【原创内容，转载请注明出处】本文版权归作者所有，未经授权不得转载。未经授权，禁止复制转载。

对于事件的传入，有 3 种形式：

【原创内容，转载请注明出处】著作权归作者所有，禁止商业用途转载。【原创内容，转载请注明出处】【版权所有】唐霜 www.tangshuang.net

这也就是 onHit$ 的魔力所在。我们本文作者：唐霜，转载请注明出处。【原创内容，转载请注明出处】用代码来演示怎么使用：

【关注微信公众号：wwwtangshuangnet】【关注微信公众号：wwwtangshuangnet】 
import { map } from 'rxjs/operators'

class App extends Component {
  render() {
    return <Some onHint={[map(x => x * x), x => console.log(x)]} />
  }
}

这种情况下必须注意，订阅函数必须被传入（【版权所有，侵权必究】【本文受版权保护】放在数组最后一个位置）。实际上，只传入一【版权所有】唐霜 www.tangshuang.net【本文受版权保护】个函数的情况，在内部实际上处理成数组对待【关注微信公众号：wwwtangshuangnet】未经授权，禁止复制转载。，只不过该数组只有一个元素，即该订阅函数未经授权，禁止复制转载。本文作者：唐霜，转载请注明出处。。有关事件流、管道操作符等，请详细阅读 rxjs 的文档了解如何使用。

【访问 www.tangshuang.net 获取更多精彩内容】本文作者：唐霜，转载请注明出处。著作权归作者所有，禁止商业用途转载。

update

Nautil 组件上有一个 this.u未经授权，禁止复制转载。未经授权，禁止复制转载。pdate 方法，用于更新当前组件。它有【版权所有，侵权必究】本文作者：唐霜，转载请注明出处。丰富的功能：

原创内容，盗版必究。【关注微信公众号：wwwtangshuangnet】【转载请注明来源】

组件上同时存在如下四个方法用于更新：

【版权所有，侵权必究】原创内容，盗版必究。著作权归作者所有，禁止商业用途转载。

在使用时，不需要使用 this.upda【本文首发于唐霜的博客】【关注微信公众号：wwwtangshuangnet】te.bind(this) 这种方法进行【版权所有】唐霜 www.tangshuang.net未经授权，禁止复制转载。绑定，直接使用 this.update,转载请注明出处：www.tangshuang.net【原创不易，请尊重版权】 this.forceUpdate, t【本文受版权保护】转载请注明出处：www.tangshuang.nethis.weakUpdate 即可，它自未经授权，禁止复制转载。【本文首发于唐霜的博客】己已经经过绑定了。

【本文首发于唐霜的博客】【访问 www.tangshuang.net 获取更多精彩内容】本文作者：唐霜，转载请注明出处。

生命周期

Nautil 组件的生命周期和 reac【原创不易，请尊重版权】转载请注明出处：www.tangshuang.nett 组件一致，在前文已经介绍过。

转载请注明出处：www.tangshuang.net本文作者：唐霜，转载请注明出处。

具体不同阶段的调用如下图演示：

【版权所有】唐霜 www.tangshuang.net本文作者：唐霜，转载请注明出处。【作者：唐霜】【版权所有】唐霜 www.tangshuang.net

【版权所有，侵权必究】【版权所有，侵权必究】

可以看到，所有生命周期钩子函数比 rea【本文受版权保护】未经授权，禁止复制转载。ct 原生的生命周期钩子函数简化且丰富了【本文首发于唐霜的博客】【作者：唐霜】不少。其中 onDigested 是比较【版权所有】唐霜 www.tangshuang.net【本文受版权保护】特殊的一个生命周期函数，在原生 reac【访问 www.tangshuang.net 获取更多精彩内容】【关注微信公众号：wwwtangshuangnet】t 中你找不到对应的处理时间点，这是 N【原创内容，转载请注明出处】【原创内容，转载请注明出处】autil 新增的。在 Nautil 中【关注微信公众号：wwwtangshuangnet】【未经授权禁止转载】，组件需要在 props 或 state【未经授权禁止转载】未经授权，禁止复制转载。 变化时进行处理，以生成新的 this.未经授权，禁止复制转载。【版权所有，侵权必究】attrs 或完成类型校验等其他工作，这未经授权，禁止复制转载。【版权所有】唐霜 www.tangshuang.net个过程叫 digest。另外，onAff【原创内容，转载请注明出处】本文作者：唐霜，转载请注明出处。ected 则在挂载和更新阶段都会调用，【关注微信公众号：wwwtangshuangnet】本文版权归作者所有，未经授权不得转载。非常有助于处理一些需要在两个阶段都处理的未经授权，禁止复制转载。【版权所有】唐霜 www.tangshuang.net一些任务。

未经授权，禁止复制转载。原创内容，盗版必究。【原创不易，请尊重版权】

Render

在 nautil 中，你可以在 clas本文版权归作者所有，未经授权不得转载。【原创内容，转载请注明出处】s 组件中写 hooks 了，区别在于，【未经授权禁止转载】著作权归作者所有，禁止商业用途转载。你需要用 Render(props) 代替 render()。在 Render 中你仍然可以使用 t本文版权归作者所有，未经授权不得转载。【版权所有，侵权必究】his 来调用组件 class 上写的方【版权所有】唐霜 www.tangshuang.net【本文首发于唐霜的博客】法。例如：

【访问 www.tangshuang.net 获取更多精彩内容】【关注微信公众号：wwwtangshuangnet】转载请注明出处：www.tangshuang.net【访问 www.tangshuang.net 获取更多精彩内容】 
class MyComponent extends Component {
  Render(props) {
    const [state, setState] = useState(0)
    const some = this.getSome() // 可以调用 this 上的方法
    ...
  }
}

虽然使用 class 组件可以很好的组织【转载请注明来源】【访问 www.tangshuang.net 获取更多精彩内容】代码，但是，有的时候，hooks 可以起转载请注明出处：www.tangshuang.net未经授权，禁止复制转载。到非常大的缓存作用。hooks 函数的第【转载请注明来源】【原创内容，转载请注明出处】二个参数可以解决很多复杂的场景。通过 R【访问 www.tangshuang.net 获取更多精彩内容】【版权所有】唐霜 www.tangshuang.netender 你可以同时发挥 class 【本文首发于唐霜的博客】【版权所有】唐霜 www.tangshuang.net组件和 hooks 的威力。

【版权所有】唐霜 www.tangshuang.net【原创不易，请尊重版权】

状态管理

现在，你需要忘掉 redux，它实在是太转载请注明出处：www.tangshuang.net本文作者：唐霜，转载请注明出处。冗余了，像一个笨拙的大象，匍匐在 rea【版权所有】唐霜 www.tangshuang.net本文作者：唐霜，转载请注明出处。ct 这个汗血宝马身上。我们在 reac原创内容，盗版必究。【本文首发于唐霜的博客】t 开发中为什么需要一个可全局使用的数据转载请注明出处：www.tangshuang.net【本文首发于唐霜的博客】存储器，这个问题相信你已经很清楚了吧。N【转载请注明来源】【关注微信公众号：wwwtangshuangnet】autil 提供了极其轻便的 Store未经授权，禁止复制转载。本文作者：唐霜，转载请注明出处。 用于管理全局数据。

【版权所有】唐霜 www.tangshuang.net【未经授权禁止转载】 
import { Store, Provider, Consumer, useStore, connect, applyStore } from 'nautil'

Store

Nautil 中的 Store 是一个轻【原创内容，转载请注明出处】【未经授权禁止转载】便的状态管理工具，它提供了 dispat【访问 www.tangshuang.net 获取更多精彩内容】【本文首发于唐霜的博客】ch 方法，可以用 immutable 转载请注明出处：www.tangshuang.net【转载请注明来源】的写法来修改状态。和 vue 不同，st著作权归作者所有，禁止商业用途转载。著作权归作者所有，禁止商业用途转载。ore 中的数据是动态的，不需要你提前规【本文受版权保护】转载请注明出处：www.tangshuang.net定都有哪些属性，store 中的数据是 【关注微信公众号：wwwtangshuangnet】转载请注明出处：www.tangshuang.netimmutable 的，可被观察，可恢复【转载请注明来源】转载请注明出处：www.tangshuang.net，可随时添加新属性。

未经授权，禁止复制转载。【未经授权禁止转载】

创建 Store 极为简单。你只需要传入【访问 www.tangshuang.net 获取更多精彩内容】著作权归作者所有，禁止商业用途转载。一个默认值即可。你甚至可以传入一个空对象【作者：唐霜】转载请注明出处：www.tangshuang.net。

原创内容，盗版必究。【本文受版权保护】【版权所有】唐霜 www.tangshuang.net 
const store = new Store({
  a: 1,
})

// 获取状态
const state = store.getState()

// 修改状态
store.setState({ a: 2 })
store.dispatch(state => state.a ++)

// 重置状态为第一次实例化时传入的值
store.resetState()

// 订阅状态变化
store.subscribe((next, prev) => { .. })
// 取消订阅
store.unsubscribe(fn)

以上就是 Store 的所有能力，极其简未经授权，禁止复制转载。本文版权归作者所有，未经授权不得转载。单（源码），且拥有魔法。

本文作者：唐霜，转载请注明出处。【本文受版权保护】

结合组件使用

在 Nautil 中你必须结合组件使用 本文版权归作者所有，未经授权不得转载。著作权归作者所有，禁止商业用途转载。Store，以发挥它的效果。这里面涉及到【作者：唐霜】【关注微信公众号：wwwtangshuangnet】监听 Store 变化和重新渲染。实际上【原创内容，转载请注明出处】【版权所有】唐霜 www.tangshuang.net操作非常简单：

【原创不易，请尊重版权】本文版权归作者所有，未经授权不得转载。【访问 www.tangshuang.net 获取更多精彩内容】 
import { React, Component, Store, Provider, Consumer } from 'nautil'

const store = new Store({
  a: 1,
})

class App extends Component {
  return (
    <Provider store={store}>
      <Some />
      <Trigger />
    </Provider>
  )
}

class Some extends Component {
  render() {
    return (
      <Consumer>
        {store => <span>{store.state.a}</span>}
      </Consumer>
    )
  }
}

class Trigger extends Component {
  render() { 
    return (
      <Consumer>
        {store => <button onClick={() => store.dispatch(state => state.a ++)}>grow</button>}
      </Consumer>
    )
  }
}

在上面的代码中，我们在 Some 和 T【版权所有，侵权必究】转载请注明出处：www.tangshuang.netrigger 之间共享了同一个 stor【作者：唐霜】【本文首发于唐霜的博客】e，它们都能够根据 store 中 st【原创不易，请尊重版权】【作者：唐霜】ate 的变化来重新渲染界面。

【未经授权禁止转载】未经授权，禁止复制转载。原创内容，盗版必究。本文作者：唐霜，转载请注明出处。

除了使用 Consumer 来渲染子组件本文版权归作者所有，未经授权不得转载。【本文受版权保护】外，你也可以使用 connect 来封装【原创不易，请尊重版权】【未经授权禁止转载】。

本文版权归作者所有，未经授权不得转载。【作者：唐霜】【版权所有】唐霜 www.tangshuang.net【本文受版权保护】 
const Trigger = connect(store => ({ a: store.state.a, grow: () => store.dispatch(state => state.a ++) }))(class extends Component {
  render() {
    const { a, grow } = this.props
    ...
  }
})

connect 的第一个参数是一个 ma未经授权，禁止复制转载。本文作者：唐霜，转载请注明出处。p 函数，用以接收 store，并返回一【访问 www.tangshuang.net 获取更多精彩内容】本文版权归作者所有，未经授权不得转载。个对象，这个对象将被增加到 props 原创内容，盗版必究。著作权归作者所有，禁止商业用途转载。上传给被封装的组件。而实际上，这个 ma未经授权，禁止复制转载。未经授权，禁止复制转载。p 也可以传给 Consumer 组件，转载请注明出处：www.tangshuang.net未经授权，禁止复制转载。例如：

【原创内容，转载请注明出处】【本文首发于唐霜的博客】【版权所有】唐霜 www.tangshuang.net【版权所有，侵权必究】 
<Consumer map={store => ({ ... })}>
  ...
</Consumer>

connect 的第二个参数是一个 wa【本文首发于唐霜的博客】著作权归作者所有，禁止商业用途转载。tch 数组，用以决定当发现 store【本文受版权保护】【原创不易，请尊重版权】 中 state 的哪些属性发生变化时，【版权所有，侵权必究】转载请注明出处：www.tangshuang.net才对内部进行重新渲染。同样，这个 wat本文版权归作者所有，未经授权不得转载。未经授权，禁止复制转载。ch 也可以传给 Consumer:

未经授权，禁止复制转载。著作权归作者所有，禁止商业用途转载。【原创内容，转载请注明出处】 
<Consumer map={store => ({ ... })} watch={['a']}>
   ...
</Consumer>

局部状态共享

有时候，我们不需要在整个应用共享一个 s本文作者：唐霜，转载请注明出处。【版权所有】唐霜 www.tangshuang.nettore，我们只需要在一个小范围内共享一本文作者：唐霜，转载请注明出处。本文作者：唐霜，转载请注明出处。个 store。此时，我们可以用到比较小原创内容，盗版必究。【访问 www.tangshuang.net 获取更多精彩内容】巧的一些方案。

本文版权归作者所有，未经授权不得转载。本文作者：唐霜，转载请注明出处。原创内容，盗版必究。原创内容，盗版必究。

第一种，使用 useStore hooks 函数：

【访问 www.tangshuang.net 获取更多精彩内容】著作权归作者所有，禁止商业用途转载。 
import { useStore } from 'nautil'

function MyComponent() {
  const { state, setState } = useStore(store, ['a'])
  ...
}

useStore 用于作为 hooks 未经授权，禁止复制转载。著作权归作者所有，禁止商业用途转载。函数监听 store 中 state 的【原创不易，请尊重版权】本文作者：唐霜，转载请注明出处。变化，并触发更新。它直接返回传入的 st【本文首发于唐霜的博客】未经授权，禁止复制转载。ore，但是由于 store 上的 st【访问 www.tangshuang.net 获取更多精彩内容】【版权所有，侵权必究】ate, setState, dispa【版权所有】唐霜 www.tangshuang.net【关注微信公众号：wwwtangshuangnet】tch 可以直接解构出来使用，所以上面的【原创不易，请尊重版权】【关注微信公众号：wwwtangshuangnet】这段代码看上去非常优雅。它的第二个参数是【版权所有，侵权必究】本文作者：唐霜，转载请注明出处。上文提到的 watch 列表，有助于我们【本文首发于唐霜的博客】未经授权，禁止复制转载。缩小观察的范围，提升性能。

【版权所有，侵权必究】原创内容，盗版必究。著作权归作者所有，禁止商业用途转载。

第二种，使用 applyStore 创建著作权归作者所有，禁止商业用途转载。本文作者：唐霜，转载请注明出处。共享函数。

著作权归作者所有，禁止商业用途转载。【未经授权禁止转载】【关注微信公众号：wwwtangshuangnet】 
import { applyStore } from 'nautil'

const { useStore, connect } = applyStore(store)

这里的 useStore 和上面的 useStore 异曲同工之转载请注明出处：www.tangshuang.net转载请注明出处：www.tangshuang.net妙，只是不再传入 store 作为参数。未经授权，禁止复制转载。【版权所有】唐霜 www.tangshuang.net而 connect 也是一样的，观察的是【本文受版权保护】【版权所有】唐霜 www.tangshuang.net这里传入的 store，而非 Provi本文版权归作者所有，未经授权不得转载。本文作者：唐霜，转载请注明出处。der 提供的 store。

【版权所有，侵权必究】【版权所有】唐霜 www.tangshuang.net【本文首发于唐霜的博客】【版权所有，侵权必究】

通过上面两种方法，我们非常灵活的在几个组【关注微信公众号：wwwtangshuangnet】原创内容，盗版必究。件小范围内的共享一个 store 来控制【版权所有】唐霜 www.tangshuang.net【访问 www.tangshuang.net 获取更多精彩内容】状态变化。

著作权归作者所有，禁止商业用途转载。未经授权，禁止复制转载。

导航/路由

对于一个框架而言，路由是必须要解决的。r转载请注明出处：www.tangshuang.net【版权所有，侵权必究】eact 虽然是一个优秀的 UI 库，却【版权所有】唐霜 www.tangshuang.net【原创内容，转载请注明出处】无法满足开发者对应用开发的所有需求。包括著作权归作者所有，禁止商业用途转载。【关注微信公众号：wwwtangshuangnet】路由在内的其他应用部件它都没有提供。为了原创内容，盗版必究。【作者：唐霜】解决这个痛点，Nautil 并没有直接采转载请注明出处：www.tangshuang.net著作权归作者所有，禁止商业用途转载。纳 react-router 等第三方组著作权归作者所有，禁止商业用途转载。【本文受版权保护】件，而是将提供一个路由方案。

转载请注明出处：www.tangshuang.net【本文受版权保护】【版权所有，侵权必究】

Navigation

导航器，对于应用来说是用户得以在不同界面【作者：唐霜】转载请注明出处：www.tangshuang.net之间切换的重要部分。对于开发者而言，也可本文作者：唐霜，转载请注明出处。本文版权归作者所有，未经授权不得转载。以通过导航快速了解应用都是由哪些界面组成【本文受版权保护】【版权所有】唐霜 www.tangshuang.net的。

【原创不易，请尊重版权】【原创不易，请尊重版权】【版权所有】唐霜 www.tangshuang.net

然而，react-router 提供了一【转载请注明来源】【版权所有】唐霜 www.tangshuang.net种将路由组件化的开发方式，这种方式值得学【原创内容，转载请注明出处】【原创不易，请尊重版权】习。但和 redux 一样，由于它默认认本文版权归作者所有，未经授权不得转载。【原创不易，请尊重版权】为一个应用只会有一个 react 应用实原创内容，盗版必究。未经授权，禁止复制转载。例。另外，不同的平台上，也需要不同的路由【原创内容，转载请注明出处】原创内容，盗版必究。管理来解决问题。为此，我们提供了统一的导【本文首发于唐霜的博客】原创内容，盗版必究。航器。

【版权所有】唐霜 www.tangshuang.net本文作者：唐霜，转载请注明出处。【本文首发于唐霜的博客】【原创不易，请尊重版权】 
import { Navigation } from 'nautil'

我们通过 Navigation 创建一个【关注微信公众号：wwwtangshuangnet】【转载请注明来源】导航器实例，可以被任何 nautil 应【未经授权禁止转载】【未经授权禁止转载】用使用。

【原创内容，转载请注明出处】本文作者：唐霜，转载请注明出处。【关注微信公众号：wwwtangshuangnet】原创内容，盗版必究。 
const navigation = new Navigation(config)

这里需要注意，一个应用一般只有一个导航器【作者：唐霜】本文作者：唐霜，转载请注明出处。，但是，Nautil 允许一个程序中存在【访问 www.tangshuang.net 获取更多精彩内容】【本文受版权保护】多个应用。

【版权所有】唐霜 www.tangshuang.net【版权所有】唐霜 www.tangshuang.net原创内容，盗版必究。【本文首发于唐霜的博客】

配置

我们来看下如何进行配置。对于不同的平台，【关注微信公众号：wwwtangshuangnet】转载请注明出处：www.tangshuang.net配置几乎是一样的，有些选项，在 web 著作权归作者所有，禁止商业用途转载。【关注微信公众号：wwwtangshuangnet】平台上生效，在其他平台不生效。

著作权归作者所有，禁止商业用途转载。【版权所有】唐霜 www.tangshuang.net【版权所有】唐霜 www.tangshuang.net 
{
  mode: 'history', // 可选
  searchQuery: '_url', // 可选，当 mode 为 search 时生效
  base: '/', // 可选
  routes: [ // 必须
    {
      name: 'home',
      path: '/home',
      children: [ // 子路由，可选
        {
          name: 'sub', // 实际名字为 home.sub
          path: '/sub', // 实际路径为 /home/sub
          params: {}, // 可选，默认传入什么 params
        },
      ],
    },
  ],
  maxHistoryLength: 20, // 可选，最多保存多少个历史记录
  defaultRoute: 'home', // 可选，默认路由，没传的时候使用第一个 route
}

由于 Nautil 的目标平台不单单包含【未经授权禁止转载】【访问 www.tangshuang.net 获取更多精彩内容】 web，因此，导航系统实际上的工作模式未经授权，禁止复制转载。【本文首发于唐霜的博客】要依赖不同平台的能力。实际上，navig【关注微信公众号：wwwtangshuangnet】本文版权归作者所有，未经授权不得转载。ation 支持 4 种模式运行：

【原创内容，转载请注明出处】转载请注明出处：www.tangshuang.net本文作者：唐霜，转载请注明出处。【作者：唐霜】

后三种都依赖于浏览器的 URL 进行识别【版权所有】唐霜 www.tangshuang.net著作权归作者所有，禁止商业用途转载。和控制。但即使在浏览器种，我们也可以使用未经授权，禁止复制转载。著作权归作者所有，禁止商业用途转载。内存模式，让界面的变化不依赖于浏览器 U转载请注明出处：www.tangshuang.net【版权所有】唐霜 www.tangshuang.netRL 的控制。

【未经授权禁止转载】本文作者：唐霜，转载请注明出处。【访问 www.tangshuang.net 获取更多精彩内容】

在配置选项中，你可以直接将对应的页面组件原创内容，盗版必究。【访问 www.tangshuang.net 获取更多精彩内容】配置到路由中。这个部分会在下文 Navi著作权归作者所有，禁止商业用途转载。著作权归作者所有，禁止商业用途转载。gator 中讲解。

本文作者：唐霜，转载请注明出处。【本文受版权保护】

state 和 status

在 Navigation 实例上也有一个本文版权归作者所有，未经授权不得转载。原创内容，盗版必究。 state，它上面收集了当前的 rou【本文受版权保护】本文作者：唐霜，转载请注明出处。te, url 等信息，用来在某些情况下著作权归作者所有，禁止商业用途转载。【关注微信公众号：wwwtangshuangnet】做判定使用。但是，我们要面临一个情况，就转载请注明出处：www.tangshuang.net原创内容，盗版必究。是当我们导航到一个不存在的路由时，导航器【本文受版权保护】本文版权归作者所有，未经授权不得转载。会返回给我一个 $onNotFound 著作权归作者所有，禁止商业用途转载。著作权归作者所有，禁止商业用途转载。的事件，这时，state 不会被更新或置【关注微信公众号：wwwtangshuangnet】【访问 www.tangshuang.net 获取更多精彩内容】空，而是保留上一个正确的路由信息。那么怎【作者：唐霜】【未经授权禁止转载】么区分这种情况呢？实例上会有一个 sta本文作者：唐霜，转载请注明出处。【访问 www.tangshuang.net 获取更多精彩内容】tus 属性，它的值为 0 或 1. 0【作者：唐霜】【访问 www.tangshuang.net 获取更多精彩内容】 表示 not found，而 1 表示原创内容，盗版必究。未经授权，禁止复制转载。正常进入某个页面，因此，在做判定时，一定著作权归作者所有，禁止商业用途转载。【原创内容，转载请注明出处】要通过这两个属性同时来进行判定。

著作权归作者所有，禁止商业用途转载。本文作者：唐霜，转载请注明出处。【作者：唐霜】

监听导航变化

对于 Navigation 实例而言，我【未经授权禁止转载】【版权所有】唐霜 www.tangshuang.net们可以通过 on 方法对它进行监听，当导【作者：唐霜】【本文首发于唐霜的博客】航到一个新的路由时，对应的监听回调会被执【关注微信公众号：wwwtangshuangnet】【未经授权禁止转载】行，（一般发生在 $onEnter 之后【版权所有，侵权必究】【本文受版权保护】），通过 off 方法解除监听。

【版权所有，侵权必究】【本文首发于唐霜的博客】 
navigation.on('home', state => console.log(state), exact)

监听的对象有：

【访问 www.tangshuang.net 获取更多精彩内容】本文作者：唐霜，转载请注明出处。【访问 www.tangshuang.net 获取更多精彩内容】 
navigation.on(/book\/[0-9]+/, callback) // 通过正则监听对应的 URL
navigation.on('parent.child', callback, true) // 通过 name 精确监听 parent.child 这个路由
navigation.on('/book/:id', callback) // 通过 path 监听

结合观察者模式，在 Nautil 中使用著作权归作者所有，禁止商业用途转载。【原创内容，转载请注明出处】导航器的监听功能，可以实现根据导航的变化著作权归作者所有，禁止商业用途转载。【作者：唐霜】而切换页面。

未经授权，禁止复制转载。本文作者：唐霜，转载请注明出处。

事件

事件的监听也是通过 on 方法，只不过事【版权所有，侵权必究】【原创内容，转载请注明出处】件监听时有特殊的标识，所有事件名称以 $转载请注明出处：www.tangshuang.net【本文首发于唐霜的博客】 开头，从而和路由分开。

未经授权，禁止复制转载。著作权归作者所有，禁止商业用途转载。未经授权，禁止复制转载。

is

在 Navigation 实例上存在一个转载请注明出处：www.tangshuang.net本文版权归作者所有，未经授权不得转载。 is 方法，用于判定当前的导航器状态是【版权所有】唐霜 www.tangshuang.net【本文首发于唐霜的博客】否和传入的参数匹配。

【版权所有】唐霜 www.tangshuang.net【未经授权禁止转载】未经授权，禁止复制转载。【访问 www.tangshuang.net 获取更多精彩内容】 
if (navigation.is(match, exact)) {}

判定当前的导航器状态是否和传入的 mat【关注微信公众号：wwwtangshuangnet】未经授权，禁止复制转载。ch 匹配。

原创内容，盗版必究。【访问 www.tangshuang.net 获取更多精彩内容】

这个判定逻辑，会被 Route 使用。另未经授权，禁止复制转载。著作权归作者所有，禁止商业用途转载。外，需要注意，这里的判定逻辑和 on 的【本文受版权保护】【版权所有，侵权必究】监听绑定稍有不同。* 在监听绑定中，表示【本文受版权保护】未经授权，禁止复制转载。任何变动都会被监听，而 * 在 is 中【版权所有，侵权必究】原创内容，盗版必究。仅表示匹配非 not found 状态。

【本文首发于唐霜的博客】【版权所有】唐霜 www.tangshuang.net

Navigator

在 Nautil 中你可以使用 Obse转载请注明出处：www.tangshuang.net【本文受版权保护】rver 组件来使用观察者模式，通过订阅转载请注明出处：www.tangshuang.net未经授权，禁止复制转载。 navigation 实例来达到根据路【作者：唐霜】原创内容，盗版必究。由切换页面的目的，但是，实践起来会非常麻【本文受版权保护】【本文首发于唐霜的博客】烦。Nautil 内置了导航相关的组件：原创内容，盗版必究。原创内容，盗版必究。Navigator, Route, Na【访问 www.tangshuang.net 获取更多精彩内容】【未经授权禁止转载】vigate，从而让你更方便的使用。

著作权归作者所有，禁止商业用途转载。【访问 www.tangshuang.net 获取更多精彩内容】

导航者组件（Navigator）创建一个转载请注明出处：www.tangshuang.net【未经授权禁止转载】区域，用于在这个区域中，根据导航器状态来未经授权，禁止复制转载。转载请注明出处：www.tangshuang.net切换界面。

【原创内容，转载请注明出处】【作者：唐霜】 
import { Navigator } from 'nautil/components'

这个组件的作用是创建一个区域，这个区域内转载请注明出处：www.tangshuang.net【版权所有】唐霜 www.tangshuang.net按照路由规则来进行。

【作者：唐霜】【版权所有】唐霜 www.tangshuang.net【作者：唐霜】

Navigator 的渲染有 3 种方式【关注微信公众号：wwwtangshuangnet】【作者：唐霜】。在进行渲染的时候，按照这 3 种方式顺【版权所有】唐霜 www.tangshuang.net原创内容，盗版必究。序检查，如果存在某一种方式的时候，就直接未经授权，禁止复制转载。【本文受版权保护】使用该方式进行渲染。

本文作者：唐霜，转载请注明出处。本文版权归作者所有，未经授权不得转载。【原创不易，请尊重版权】原创内容，盗版必究。

配置式渲染

当开启 inside 属性时，它会去读取【访问 www.tangshuang.net 获取更多精彩内容】【访问 www.tangshuang.net 获取更多精彩内容】 navigation 配置上的 rou原创内容，盗版必究。【本文受版权保护】te.component，使用该配置进行【版权所有】唐霜 www.tangshuang.net【原创不易，请尊重版权】渲染，并忽略掉内部元素。

【访问 www.tangshuang.net 获取更多精彩内容】本文版权归作者所有，未经授权不得转载。 
<Navigator navigation={navigation} inside />

此时不需要传入 dispatch 属性。

【版权所有，侵权必究】原创内容，盗版必究。【转载请注明来源】 
const navigation = new Navigation({
  routes: [
    {
      name: 'home',
      path: '/home',
      component: Home, // 使用哪个组件渲染 home 这个 route
      props: { title: 'Home' }, // 渲染时给 component 传入什么 props
      animation: 600,
    },
  ],
  notFound: NotFound, // 未匹配路径时渲染哪一个组件
})

这种配置方法，有点像 vue-route【版权所有】唐霜 www.tangshuang.net原创内容，盗版必究。r 或 ui-router 的做法，即 【版权所有】唐霜 www.tangshuang.net未经授权，禁止复制转载。navigation 本身已经包含了路由【关注微信公众号：wwwtangshuangnet】【本文受版权保护】渲染。配置式渲染时，这些组件会在 pro【版权所有，侵权必究】本文版权归作者所有，未经授权不得转载。ps 中接收一个 navigation。

【未经授权禁止转载】【未经授权禁止转载】未经授权，禁止复制转载。【关注微信公众号：wwwtangshuangnet】

函数式渲染

当 Navigator 的 childr原创内容，盗版必究。【版权所有】唐霜 www.tangshuang.neten 是一个函数时，使用该函数渲染界面。本文作者：唐霜，转载请注明出处。著作权归作者所有，禁止商业用途转载。该函数将接收 navigation.

【关注微信公众号：wwwtangshuangnet】【访问 www.tangshuang.net 获取更多精彩内容】【本文受版权保护】 
<Navigator navigation={navigation}>
  {Navi}
</Navigator>

function Navi(props) {
  const { navigaition } = props
  return <Text>{navigation.status ? navigation.state.name : 'not found'}</Text>
}

这里创建了一个函数 Navi 用以在 N【原创内容，转载请注明出处】【本文首发于唐霜的博客】avigator 中使用。由于函数接收一【版权所有】唐霜 www.tangshuang.net原创内容，盗版必究。个对象，里面包含 navigation，著作权归作者所有，禁止商业用途转载。【原创内容，转载请注明出处】因此，可以对那些只接收 navigati未经授权，禁止复制转载。未经授权，禁止复制转载。on 的函数组件实现复用。

【版权所有】唐霜 www.tangshuang.net【关注微信公众号：wwwtangshuangnet】

函数式渲染无需传 dispatch 属性【版权所有】唐霜 www.tangshuang.net【转载请注明来源】。在每次导航器状态发生变化时，都会重新执【版权所有】唐霜 www.tangshuang.net【原创内容，转载请注明出处】行一次，得到需要的渲染结果。由于每次变动【本文首发于唐霜的博客】未经授权，禁止复制转载。都就执行，性能上偏弱。

【访问 www.tangshuang.net 获取更多精彩内容】【本文受版权保护】著作权归作者所有，禁止商业用途转载。

元素式渲染

当 Navigator 里面有独立的 j【版权所有】唐霜 www.tangshuang.net【转载请注明来源】sx 片段时，会被直接采用。

【关注微信公众号：wwwtangshuangnet】本文作者：唐霜，转载请注明出处。【关注微信公众号：wwwtangshuangnet】【作者：唐霜】 
<Navigator navigation={navigation} dispatch={this.update}>
   <Route match="home" component={Home} />
   <Route match="page1" component={Page1} />
   <Route match="!" component={NotFound} />
</Navigator>

此时的 Navigator 仅仅像是一个原创内容，盗版必究。【版权所有】唐霜 www.tangshuang.net简写版的 Observer，它内部展示什原创内容，盗版必究。【版权所有】唐霜 www.tangshuang.net么内容完全没有约束，你不一定要使用 Ro本文作者：唐霜，转载请注明出处。未经授权，禁止复制转载。ute 来进行路由，甚至可以使用 Swi本文作者：唐霜，转载请注明出处。【版权所有，侵权必究】tch-Case 组件来完成路由。

【作者：唐霜】本文作者：唐霜，转载请注明出处。【本文受版权保护】本文版权归作者所有，未经授权不得转载。

此时，必须传入 dispatch 属性，【访问 www.tangshuang.net 获取更多精彩内容】著作权归作者所有，禁止商业用途转载。用以更新界面。

原创内容，盗版必究。转载请注明出处：www.tangshuang.net原创内容，盗版必究。

 

【原创内容，转载请注明出处】【转载请注明来源】【访问 www.tangshuang.net 获取更多精彩内容】

以上三种渲染方式具有先后顺序，如果对于一著作权归作者所有，禁止商业用途转载。转载请注明出处：www.tangshuang.net个 Navigator 而言，两种或以上未经授权，禁止复制转载。【原创内容，转载请注明出处】方式同时存在时，优先选用第一种，其次第二【本文受版权保护】未经授权，禁止复制转载。种，最后才是配置式。

著作权归作者所有，禁止商业用途转载。【访问 www.tangshuang.net 获取更多精彩内容】

自动污染

在 Navigator 内部使用 Rou【转载请注明来源】本文作者：唐霜，转载请注明出处。te 和 Navigate 组件时，会被【作者：唐霜】【版权所有】唐霜 www.tangshuang.net自动注入 navigation 属性。对于应用级别的开发，为了方便写作【关注微信公众号：wwwtangshuangnet】【作者：唐霜】，可以直接不向 Route 和 Navi转载请注明出处：www.tangshuang.net【作者：唐霜】gate 传 navigation 属性【转载请注明来源】【版权所有，侵权必究】。但是为了复用方便，或提高阅读性，建议最著作权归作者所有，禁止商业用途转载。【未经授权禁止转载】好还是传 navigation，这样对于本文版权归作者所有，未经授权不得转载。本文作者：唐霜，转载请注明出处。在其他 nautil 应用中使用该组件也【本文首发于唐霜的博客】【原创不易，请尊重版权】可以正常且准确的使用。

【关注微信公众号：wwwtangshuangnet】转载请注明出处：www.tangshuang.net【本文受版权保护】

Route

路由组件，用以根据 navigation转载请注明出处：www.tangshuang.net【作者：唐霜】 的当前状态，决定使用什么内容进行渲染。

本文作者：唐霜，转载请注明出处。【关注微信公众号：wwwtangshuangnet】【原创内容，转载请注明出处】【原创内容，转载请注明出处】 
import { Route } from 'nautil/components'

参数

它接收如下属性：

著作权归作者所有，禁止商业用途转载。【版权所有】唐霜 www.tangshuang.net 
<Route navigation={navigation} match={/book\/[0-9]+/}>
  <Book id={navigation.state.params.id} />
</Route>

注：如果在 Navigator 内部使用【版权所有，侵权必究】【本文首发于唐霜的博客】 Route，则无需传入 navigat转载请注明出处：www.tangshuang.net【作者：唐霜】ion，Navigator 会自动污染 【转载请注明来源】【原创不易，请尊重版权】Route。

原创内容，盗版必究。【未经授权禁止转载】

组件式渲染

通过传入 component 属性，让 【本文受版权保护】转载请注明出处：www.tangshuang.netRoute 知道使用什么组件进行渲染。此转载请注明出处：www.tangshuang.net转载请注明出处：www.tangshuang.net时接收 component 和 prop【原创不易，请尊重版权】转载请注明出处：www.tangshuang.nets 这两个属性：

【本文首发于唐霜的博客】【原创内容，转载请注明出处】 
<Route navigation={navigation} match="some" component={Some} props={{ title: 'Some' }}>
  <Text>children</Text>
</Route>

props 是可选的，需要的时候才传入。【版权所有】唐霜 www.tangshuang.net【原创内容，转载请注明出处】同时 Some 会接收到一个 navig转载请注明出处：www.tangshuang.net【原创不易，请尊重版权】ation 的 props，Some 组本文版权归作者所有，未经授权不得转载。【原创内容，转载请注明出处】件可以利用该实例做一些判断。另外，还能接【本文首发于唐霜的博客】未经授权，禁止复制转载。收内部的 children 到 comp【访问 www.tangshuang.net 获取更多精彩内容】【关注微信公众号：wwwtangshuangnet】onent 中使用。

本文作者：唐霜，转载请注明出处。【版权所有，侵权必究】

函数式渲染

和 Navigator 很像，在 Rou【原创不易，请尊重版权】未经授权，禁止复制转载。te 内部只有一个函数时，将使用该函数进原创内容，盗版必究。【版权所有】唐霜 www.tangshuang.net行渲染。

未经授权，禁止复制转载。【版权所有】唐霜 www.tangshuang.net未经授权，禁止复制转载。未经授权，禁止复制转载。 
<Route navigation={navigation} match="home">
  {Home}
</Route>

function Home(props) {
  const { navigation } = porps
  const { state } = navigation
  const { params } = state
  const { title } = params
  return <Text>{title}</Text>
}

元素式渲染

内部包含想要使用的 jsx 元素。

未经授权，禁止复制转载。原创内容，盗版必究。 
<Route navigation={navigation} match="some">
  <Text>some</Text>
</Route>

配置式渲染

和 Navigator 的配置式渲染很像【原创不易，请尊重版权】【原创不易，请尊重版权】，但是 Route 仅在 match 通本文版权归作者所有，未经授权不得转载。【关注微信公众号：wwwtangshuangnet】过的情况下读取当前被访问的路由的 com著作权归作者所有，禁止商业用途转载。未经授权，禁止复制转载。ponent 配置进行渲染。

【关注微信公众号：wwwtangshuangnet】著作权归作者所有，禁止商业用途转载。 
<Route navigation={navigation} match="some" />

在 navigation 配置中如下配置本文作者：唐霜，转载请注明出处。【版权所有】唐霜 www.tangshuang.net：

未经授权，禁止复制转载。本文作者：唐霜，转载请注明出处。 
{
  routes: [
    {
      name: 'some',
      patch: '/some',
      component: Some,
      props: { title: 'some' },
    },
  ],
}

Some 组件也会被注入一个名为 nav【版权所有】唐霜 www.tangshuang.net未经授权，禁止复制转载。igation 的 props。

本文版权归作者所有，未经授权不得转载。【转载请注明来源】【作者：唐霜】【作者：唐霜】

动画

在大部分应用中，切换界面时，有动画转场的未经授权，禁止复制转载。原创内容，盗版必究。需求。此时，我们可以通过 Route 的 animation 属性搭配内部动画组件来实现。

著作权归作者所有，禁止商业用途转载。【版权所有】唐霜 www.tangshuang.net本文作者：唐霜，转载请注明出处。本文版权归作者所有，未经授权不得转载。 
<Route navigation={navigation} match="some" animation={600} />

animation 属性的作用有两个：

【本文首发于唐霜的博客】未经授权，禁止复制转载。【版权所有，侵权必究】

再结合下文要讲的 Animation 组【访问 www.tangshuang.net 获取更多精彩内容】著作权归作者所有，禁止商业用途转载。件，我们可以实现我们自己的动画转场效果：

【版权所有】唐霜 www.tangshuang.net本文版权归作者所有，未经授权不得转载。【原创不易，请尊重版权】 
<Route navigation={navigation} match="some" animation={600} component={Animation} props={{
  enter: '600 fade:in',
  leave: '600 fade:out',
}}>
  <Text>content</Text>
</Route>

由于 Animation 组件是通过 s【本文首发于唐霜的博客】本文作者：唐霜，转载请注明出处。how 属性来控制进入和离开的，而 Ro【原创内容，转载请注明出处】【未经授权禁止转载】ute 正好像组件注入了 show 属性【版权所有】唐霜 www.tangshuang.net原创内容，盗版必究。，所以正好可以搭配起来使用。

【未经授权禁止转载】【原创内容，转载请注明出处】

上面这这段代码，实现了进入到某个路由和从本文版权归作者所有，未经授权不得转载。【原创不易，请尊重版权】该路由离开时的动画效果，虽然很简单，但是转载请注明出处：www.tangshuang.net转载请注明出处：www.tangshuang.net开发者可以根据这个思路，实现更复杂的动画【版权所有】唐霜 www.tangshuang.net【原创内容，转载请注明出处】效果。

转载请注明出处：www.tangshuang.net未经授权，禁止复制转载。

可移植性

和 react-router 不同，na【版权所有，侵权必究】【版权所有】唐霜 www.tangshuang.netutil 中的 Route 组件具有高可【转载请注明来源】本文版权归作者所有，未经授权不得转载。移植性。它是可以独立使用的，而非必须依赖【版权所有】唐霜 www.tangshuang.net【原创内容，转载请注明出处】 Navigator 组件。当你在使用 【关注微信公众号：wwwtangshuangnet】原创内容，盗版必究。Route 组件时，如果是被包含在 Na未经授权，禁止复制转载。原创内容，盗版必究。vigator 内部，可以不传入 nav著作权归作者所有，禁止商业用途转载。【访问 www.tangshuang.net 获取更多精彩内容】igation，但是这样的坏处是不可移植著作权归作者所有，禁止商业用途转载。【版权所有】唐霜 www.tangshuang.net，在其他应用中使用组件时，必须再在外部使【本文受版权保护】【原创内容，转载请注明出处】用同一个 Navigator。但是假如你未经授权，禁止复制转载。著作权归作者所有，禁止商业用途转载。传入了 navigation 属性，那么未经授权，禁止复制转载。转载请注明出处：www.tangshuang.net这个组件可以在任何 react 应用中使未经授权，禁止复制转载。转载请注明出处：www.tangshuang.net用。

【访问 www.tangshuang.net 获取更多精彩内容】转载请注明出处：www.tangshuang.net未经授权，禁止复制转载。

Navigate

导航组件，用于在应用中切换路由，实现页面【访问 www.tangshuang.net 获取更多精彩内容】【未经授权禁止转载】的跳转。

转载请注明出处：www.tangshuang.net著作权归作者所有，禁止商业用途转载。转载请注明出处：www.tangshuang.net 
import { Navigate } from 'nautil/components'

它接收如下参数：

【版权所有】唐霜 www.tangshuang.net【原创内容，转载请注明出处】 
<Navigate to={-1}>back</Navigate>
<Navigate to="some" params={{ title: 'Some' }} replace>some</Navigate>
<Navigate to="app:some/page1" open>app</Naviagate>

导航组件会有一个问题，就是当我们希望触发本文作者：唐霜，转载请注明出处。【转载请注明来源】的元素不同时，会有一些差异。例如：

【访问 www.tangshuang.net 获取更多精彩内容】【原创不易，请尊重版权】【本文受版权保护】 
<Navigate to="some">
  <Section><Text>Title</Text></Section>
  <Section><Text>content</Text></Section>
</Navigate>

此时，由于内部存在多个元素，所以 Nav本文版权归作者所有，未经授权不得转载。【本文首发于唐霜的博客】igate 会自动添加一个 Sectio转载请注明出处：www.tangshuang.net原创内容，盗版必究。n 作为包裹。如果像前面的代码一样，内部原创内容，盗版必究。【转载请注明来源】是直接的文字，那么它会选择用 Text 未经授权，禁止复制转载。本文版权归作者所有，未经授权不得转载。进行包裹。而如果里面只有一个元素，则它不著作权归作者所有，禁止商业用途转载。【版权所有】唐霜 www.tangshuang.net自己创建包裹，而是直接将触发事件绑定到该【转载请注明来源】【本文首发于唐霜的博客】元素上。

【作者：唐霜】著作权归作者所有，禁止商业用途转载。

你可以通过传入 component 属性原创内容，盗版必究。著作权归作者所有，禁止商业用途转载。来控制使用什么元素进行添加包裹。例如：

【版权所有】唐霜 www.tangshuang.net【版权所有】唐霜 www.tangshuang.net【原创内容，转载请注明出处】 
<Navigate to="some" component={Button}>some</Navigate>

则会用一个 Button 包裹文本。只要【未经授权禁止转载】本文版权归作者所有，未经授权不得转载。你传入了 component，那么内部元【原创内容，转载请注明出处】【转载请注明来源】素就会被作为子元素包裹在该组件内。传入 【作者：唐霜】【本文首发于唐霜的博客】component 时，支持传入 pro【未经授权禁止转载】【访问 www.tangshuang.net 获取更多精彩内容】ps 属性，用于向 component 【作者：唐霜】【转载请注明来源】传入属性。

【本文受版权保护】【本文受版权保护】

Storage

Nautil 内置了一个 Storage【版权所有，侵权必究】【原创不易，请尊重版权】 对象，用于提供持久化存储。由于 Nau转载请注明出处：www.tangshuang.net原创内容，盗版必究。til 的一个目标是实现跨平台开发，但是未经授权，禁止复制转载。本文作者：唐霜，转载请注明出处。在不同平台上，所提供的持久化存储工具并不【关注微信公众号：wwwtangshuangnet】【版权所有】唐霜 www.tangshuang.net相同，因此，我们通过内置的 Storag【转载请注明来源】【原创内容，转载请注明出处】e 抹平这些差异，让开发者在自己的代码中未经授权，禁止复制转载。未经授权，禁止复制转载。无需去适配不同平台。

未经授权，禁止复制转载。本文版权归作者所有，未经授权不得转载。原创内容，盗版必究。【原创不易，请尊重版权】

但是在使用时需要注意，Nautil 内置转载请注明出处：www.tangshuang.net【本文受版权保护】的 Storage 是异步的，而非同步的【版权所有，侵权必究】【转载请注明来源】，这一点一定要注意。

【原创不易，请尊重版权】【转载请注明来源】原创内容，盗版必究。 
import { Storage } from 'nautil'

async function init() {
  const data = await Storage.getItem('key')
  await Storage.setItem('key', 2)
  await Storage.removeItem('key')
}

该对象仅提供上述 3 个接口使用。

著作权归作者所有，禁止商业用途转载。【原创不易，请尊重版权】著作权归作者所有，禁止商业用途转载。原创内容，盗版必究。

多语言国际化

在我多年的项目经验中发现，所有的中文项目【未经授权禁止转载】【版权所有】唐霜 www.tangshuang.net，但凡运营超过 2 年，一定会有多语言国【访问 www.tangshuang.net 获取更多精彩内容】未经授权，禁止复制转载。际化需求。但是由于早期开发的时候抱着“到本文版权归作者所有，未经授权不得转载。未经授权，禁止复制转载。时候再说”的心态，导致真正要开始实施的时【本文首发于唐霜的博客】【版权所有，侵权必究】候，改动极其大，完全不知道该如何下手，甚【本文受版权保护】【本文受版权保护】至带来整个前端代码结构的变化。而实际上，未经授权，禁止复制转载。【转载请注明来源】在一个项目中加入国际化功能其实比较容易，转载请注明出处：www.tangshuang.net著作权归作者所有，禁止商业用途转载。只是在一开始设计上，就要尊从一些写法规则【转载请注明来源】著作权归作者所有，禁止商业用途转载。。“到时候再说”的心态应该改改，应该在一【关注微信公众号：wwwtangshuangnet】【原创不易，请尊重版权】开始的时候就加入国际化接口，按照多语言的【本文首发于唐霜的博客】【原创内容，转载请注明出处】方式去实施，虽然实际产品上线的时候可能只【作者：唐霜】【本文受版权保护】会有一门语言，但是，后期要上线其他语言的本文版权归作者所有，未经授权不得转载。【原创不易，请尊重版权】时候，便利程度难以用言语表达。

本文作者：唐霜，转载请注明出处。未经授权，禁止复制转载。【版权所有，侵权必究】原创内容，盗版必究。

在 Nautil 中提供了独立的 I18原创内容，盗版必究。【本文受版权保护】n 模块，该模块基于著名的 i18nex【本文首发于唐霜的博客】【原创不易，请尊重版权】t 开发。

【本文受版权保护】未经授权，禁止复制转载。 
import { I18n, Language, T, Locale } from 'nautil/i18n'

I18n

通过 I18n 我们可以得到一个多语言控【原创内容，转载请注明出处】原创内容，盗版必究。制器示例。

【版权所有】唐霜 www.tangshuang.net【本文首发于唐霜的博客】本文作者：唐霜，转载请注明出处。 
const i18n = new I18n(config)

其中，config 完全遵循 i18ne【本文受版权保护】【未经授权禁止转载】xt 的配置。但是 i18n 的接口经过处理，比 i【访问 www.tangshuang.net 获取更多精彩内容】本文版权归作者所有，未经授权不得转载。18next 更好用：

【本文首发于唐霜的博客】【未经授权禁止转载】未经授权，禁止复制转载。【作者：唐霜】

注意，对一门语言进行命名时，要遵循国际标准。例如，中文一定要以 zh-CN 这种形著作权归作者所有，禁止商业用途转载。著作权归作者所有，禁止商业用途转载。式命名。

【版权所有】唐霜 www.tangshuang.net著作权归作者所有，禁止商业用途转载。未经授权，禁止复制转载。

Language

和 Navigator 的功能差不多，当【原创内容，转载请注明出处】【版权所有，侵权必究】一个应用需要对某个区域实行多语言时，需要未经授权，禁止复制转载。原创内容，盗版必究。通过 Language 组件将其包起来。

本文作者：唐霜，转载请注明出处。【作者：唐霜】【转载请注明来源】【本文受版权保护】 
<Language i18n={i18n} dispatch={this.update}>
  <SomeComponent />
</Language>

只有这样，当语言发生切换的时候，内部的所未经授权，禁止复制转载。未经授权，禁止复制转载。有本地化处理，才会更新。

未经授权，禁止复制转载。【版权所有】唐霜 www.tangshuang.net【关注微信公众号：wwwtangshuangnet】

另外，Language 和 Naviga未经授权，禁止复制转载。【本文受版权保护】tor 一样，也会对其内部的 T, Lo未经授权，禁止复制转载。转载请注明出处：www.tangshuang.netcale 组件自动污染 i18n 属性，未经授权，禁止复制转载。【原创内容，转载请注明出处】因此，其内部的 T, Locale 组件本文版权归作者所有，未经授权不得转载。著作权归作者所有，禁止商业用途转载。不需要传 i18n. 但是还是那句老话，著作权归作者所有，禁止商业用途转载。【作者：唐霜】为了组件的复用性，建议仍然传入 i18n本文作者：唐霜，转载请注明出处。【原创内容，转载请注明出处】 属性。

本文版权归作者所有，未经授权不得转载。【未经授权禁止转载】

T

该组件用于翻译和显示语言文本。

本文作者：唐霜，转载请注明出处。【原创不易，请尊重版权】本文作者：唐霜，转载请注明出处。 
<T i18n={i18n} t="myHome">my home</T>

属性

可接受的属性包含：

本文作者：唐霜，转载请注明出处。原创内容，盗版必究。本文版权归作者所有，未经授权不得转载。著作权归作者所有，禁止商业用途转载。

渲染

T 组件的渲染按照如下顺序逻辑进行渲染：

本文版权归作者所有，未经授权不得转载。【转载请注明来源】【本文首发于唐霜的博客】 
<T t={i18n => i18n.t('my_home')} />
<T t="my_home" s="worker" /> ## i18n.t('worker:my_home')
<T>{i18n => i18n.t('my_home')}</T>
<T>My Home</T>

Locale

该组件用于创建一个可切换语言的区域。

【关注微信公众号：wwwtangshuangnet】未经授权，禁止复制转载。 
<Locale i18n={i18n} to="zh-CN"><Button>切换至中文</Button></Locale>

它的渲染规则和 Navigate 非常像原创内容，盗版必究。【转载请注明来源】。

未经授权，禁止复制转载。【本文受版权保护】【关注微信公众号：wwwtangshuangnet】未经授权，禁止复制转载。

内置逻辑组件

在前文我们已经指出 Nautil 包含了转载请注明出处：www.tangshuang.net【版权所有】唐霜 www.tangshuang.net 4 类内置组件。本章主要讲解其中的“逻本文版权归作者所有，未经授权不得转载。【版权所有】唐霜 www.tangshuang.net辑组件”。逻辑组件的主要作用是进行逻辑控原创内容，盗版必究。转载请注明出处：www.tangshuang.net制，根据不同的条件来决定是否渲染或如何渲【原创内容，转载请注明出处】【关注微信公众号：wwwtangshuangnet】染其内部子组件。

【原创内容，转载请注明出处】原创内容，盗版必究。【未经授权禁止转载】

条件逻辑组件

通过条件判断来决定组件的显示与隐藏。

著作权归作者所有，禁止商业用途转载。本文作者：唐霜，转载请注明出处。原创内容，盗版必究。

If/ElseIf/Else

代替 jsx 的 hyper 语法，用组【本文首发于唐霜的博客】著作权归作者所有，禁止商业用途转载。件来控制，让 jsx 更纯粹。

本文版权归作者所有，未经授权不得转载。【关注微信公众号：wwwtangshuangnet】本文作者：唐霜，转载请注明出处。转载请注明出处：www.tangshuang.net 
import { If, ElseIf, Else } from 'nautil/components'
<If is={boolean} render={() => 
  <Section><Text>if</Text></Section>
}>
  <ElseIf is={boolean} render={() =>
    <Section><Text>else if</Text></Section>
  } />
  <Else render={() => 
    <Section><Text>else</Text></Section>
  } />
</If>

通过上述演示代码，你可以很好的了解这三个【版权所有】唐霜 www.tangshuang.net【版权所有】唐霜 www.tangshuang.net组件具体怎么使用了吧。

著作权归作者所有，禁止商业用途转载。本文作者：唐霜，转载请注明出处。

内部支持函数，以方便在某些情况下不应该对【本文首发于唐霜的博客】【作者：唐霜】组件实例化时进行处理。

【关注微信公众号：wwwtangshuangnet】【访问 www.tangshuang.net 获取更多精彩内容】 
<If is={bool}>
  {() => <Text>should not init when loaded</Text}
</If>

Swich/Case

也是用于条件控制的组件。

【本文受版权保护】本文版权归作者所有，未经授权不得转载。 
<Switch of={value}>
  <Case is={target} render={() => 
    <Text>target</Text>
  } />
  <Case defualt render={() =>
    <Text>default</Text>
  } />
</Switch>

Case 内部支持函数，用以避免组件实例【本文首发于唐霜的博客】本文版权归作者所有，未经授权不得转载。化时，被立即执行。

【本文首发于唐霜的博客】原创内容，盗版必究。

Show

和 If 不同，Show 会立即渲染其内【原创不易，请尊重版权】【本文首发于唐霜的博客】部自组件，但会通过 is 控制其显示或隐转载请注明出处：www.tangshuang.net【本文受版权保护】藏。

【版权所有，侵权必究】原创内容，盗版必究。著作权归作者所有，禁止商业用途转载。【版权所有，侵权必究】 
<Show is={bool}>
  <Text>show me</Text>
</Show>

默认情况下，Show 会自己创建一个 S【访问 www.tangshuang.net 获取更多精彩内容】未经授权，禁止复制转载。ection, 但它支持你传入 comp原创内容，盗版必究。【版权所有】唐霜 www.tangshuang.netonent 属性来控制使用什么组件。

【转载请注明来源】【版权所有】唐霜 www.tangshuang.net

循环遍历组件

下面的组件帮助你实现循环和遍历。

未经授权，禁止复制转载。原创内容，盗版必究。

For

一个数字循环迭代组件。

【原创内容，转载请注明出处】【未经授权禁止转载】【版权所有，侵权必究】 
<For start={0} end={10} step={1} render={i => 
  <Text>{i}</Text>
} />

它也支持内部是一个普通元素，而非函数，这原创内容，盗版必究。【作者：唐霜】样就可以重复显示该内部子元素。

【作者：唐霜】未经授权，禁止复制转载。转载请注明出处：www.tangshuang.net

另外需要注意，For 会包含 end 值【版权所有】唐霜 www.tangshuang.net本文作者：唐霜，转载请注明出处。。也就是说上面会显示 0-10 这 11转载请注明出处：www.tangshuang.net著作权归作者所有，禁止商业用途转载。 个数字。

【未经授权禁止转载】【关注微信公众号：wwwtangshuangnet】

Each

一个对象遍历迭代组件。

著作权归作者所有，禁止商业用途转载。未经授权，禁止复制转载。【作者：唐霜】转载请注明出处：www.tangshuang.net 
<Each of={data} render={(value, key) => 
  <Text>{key}: {value}</Text>
} />

of 中可以传入对象或数组。

本文作者：唐霜，转载请注明出处。【原创内容，转载请注明出处】

渲染控制组件

下面将介绍用于渲染控制的组件。

本文版权归作者所有，未经授权不得转载。【未经授权禁止转载】著作权归作者所有，禁止商业用途转载。

Fragment

空内容组件。一般用于占位置。由于 rea【本文首发于唐霜的博客】【原创内容，转载请注明出处】ct 里面不能一次返回多个组件（reac著作权归作者所有，禁止商业用途转载。【原创不易，请尊重版权】t 升级之后可放在一个数组中），因此，可【本文首发于唐霜的博客】原创内容，盗版必究。以通过 Fragment 组件将这些组件转载请注明出处：www.tangshuang.net著作权归作者所有，禁止商业用途转载。包起来，达到返回一组平行的组件的目的。

【版权所有，侵权必究】转载请注明出处：www.tangshuang.net【原创不易，请尊重版权】【作者：唐霜】

Static

静态渲染组件。内部必须是一个函数。接收 【版权所有】唐霜 www.tangshuang.net本文版权归作者所有，未经授权不得转载。shouldUpdate 属性。

【原创不易，请尊重版权】本文作者：唐霜，转载请注明出处。本文作者：唐霜，转载请注明出处。 
<Static shouldUpdate={bool} render={() => 
  <Text>{Date.now()}</Text>
} />

只有当 shouldUpdate 为 t【原创内容，转载请注明出处】未经授权，禁止复制转载。rue 时，内部才会被更新，否则永远都不【关注微信公众号：wwwtangshuangnet】【本文首发于唐霜的博客】会被更新。在一些特定场景下的交互非常有用【版权所有】唐霜 www.tangshuang.net著作权归作者所有，禁止商业用途转载。。

【原创内容，转载请注明出处】著作权归作者所有，禁止商业用途转载。未经授权，禁止复制转载。【原创不易，请尊重版权】

Prepare

准备渲染组件。当遇到一些异步，或动态变化【本文首发于唐霜的博客】【转载请注明来源】时，你可能希望用一个 loading 效未经授权，禁止复制转载。原创内容，盗版必究。果返回给用户。Prepare 组件用于实未经授权，禁止复制转载。未经授权，禁止复制转载。现该目的。

【访问 www.tangshuang.net 获取更多精彩内容】【访问 www.tangshuang.net 获取更多精彩内容】 
<Prepare isReady={bool} loading={<Text>loading</Text>} render={() => 
  <Text>loaded</Text>
} />

它的内部支持函数和普通组件，但是函数仅在【原创内容，转载请注明出处】【作者：唐霜】 isReady 为 true 的情况下【本文受版权保护】转载请注明出处：www.tangshuang.net才执行，有助于我们拿到数据后进行渲染。

著作权归作者所有，禁止商业用途转载。本文版权归作者所有，未经授权不得转载。本文作者：唐霜，转载请注明出处。【关注微信公众号：wwwtangshuangnet】

Observer

用于监听变动的组件，该组件是 Nauti著作权归作者所有，禁止商业用途转载。【转载请注明来源】l 中非常重要且核心的组件，因为它是实现【作者：唐霜】【版权所有，侵权必究】 Nautil 中观察者模式的最主要助手【本文首发于唐霜的博客】本文作者：唐霜，转载请注明出处。。它需要三个属性：

本文作者：唐霜，转载请注明出处。原创内容，盗版必究。 
<Observer
  subscribe={dispatch => store.watch('*', dispatch)}
  unsubscribe={dispatch => store.unwatch('*', dispatch)}
  dispatch={this.update}
>
  <Text>{store.get('some')}</Text>
</Observer>

上面这个代码，演示了如何观察 store【原创内容，转载请注明出处】著作权归作者所有，禁止商业用途转载。 变化，并且更新视图渲染的过程。

著作权归作者所有，禁止商业用途转载。未经授权，禁止复制转载。

指令

和 vue 中指令的概念不同。Nauti【未经授权禁止转载】【转载请注明来源】l 中的指令是用于修改 Componen【本文受版权保护】【未经授权禁止转载】t 默认行为方式的函数生成器。

【版权所有，侵权必究】【本文首发于唐霜的博客】 
import { inject, observe, pollute, connect, pipe } from 'nautil/operators'

指令的用法，和 react-redux 【本文受版权保护】【作者：唐霜】的 connect 函数非常像。一般先通【本文受版权保护】【作者：唐霜】过指令创建一个 wrapper 函数，然【转载请注明来源】【原创不易，请尊重版权】后再用该函数去包裹目标组件。

【版权所有，侵权必究】【原创不易，请尊重版权】

observe

用于简化 Observer 操作的一个指【原创内容，转载请注明出处】【作者：唐霜】令。它接收两个参数：subscribe 本文作者：唐霜，转载请注明出处。【原创内容，转载请注明出处】和 unsubscribe。

【作者：唐霜】本文版权归作者所有，未经授权不得转载。转载请注明出处：www.tangshuang.net

用法一：两个函数

本文版权归作者所有，未经授权不得转载。未经授权，禁止复制转载。 
const observeByStore = observer(
  dispatch => store.watch('*', dispatch), 
  dispatch => store.unwatch('*', dispatch)
)
const ObservedComponent = observeByStore(Component)

通过这种方式，你就不需要再在组件内写 O转载请注明出处：www.tangshuang.net本文作者：唐霜，转载请注明出处。bserver 操作了。

【未经授权禁止转载】【原创内容，转载请注明出处】转载请注明出处：www.tangshuang.net著作权归作者所有，禁止商业用途转载。

用法二：store/model

【访问 www.tangshuang.net 获取更多精彩内容】【原创内容，转载请注明出处】

而且 observe 指令支持直接传入 【本文首发于唐霜的博客】【版权所有，侵权必究】store 和 model 实例，从而减【版权所有】唐霜 www.tangshuang.net转载请注明出处：www.tangshuang.net少麻烦的写作。

原创内容，盗版必究。原创内容，盗版必究。本文作者：唐霜，转载请注明出处。 
const observeByStore = observe(store)

这个时候，第二个参数可接收一个字符串，用本文版权归作者所有，未经授权不得转载。【原创内容，转载请注明出处】于表示具体监听 store/model 【原创内容，转载请注明出处】【本文首发于唐霜的博客】上的哪一个属性。

【本文首发于唐霜的博客】【本文首发于唐霜的博客】 
observe(store, 'age') // 监听 store 上的 age 属性

这样可以减小监听范围，但是，如果要监听多【原创不易，请尊重版权】本文作者：唐霜，转载请注明出处。个属性，就必须写多个 observe 指本文作者：唐霜，转载请注明出处。原创内容，盗版必究。令语句。

著作权归作者所有，禁止商业用途转载。未经授权，禁止复制转载。著作权归作者所有，禁止商业用途转载。【关注微信公众号：wwwtangshuangnet】

用法三：prop

【本文首发于唐霜的博客】本文作者：唐霜，转载请注明出处。

对于已知某个 prop 的值是 stor本文作者：唐霜，转载请注明出处。【未经授权禁止转载】e 或 model 的，可以直接传入一个转载请注明出处：www.tangshuang.net本文版权归作者所有，未经授权不得转载。字符串，例如：

【原创不易，请尊重版权】【本文首发于唐霜的博客】未经授权，禁止复制转载。原创内容，盗版必究。 
const observeByStore = observe('store')

而在这种情况下，也可以和用法二一样，传入【本文受版权保护】【访问 www.tangshuang.net 获取更多精彩内容】第二个参数为字符串，表示具体监听某个属性【转载请注明来源】【未经授权禁止转载】，例如：

【版权所有】唐霜 www.tangshuang.net【原创不易，请尊重版权】 
observe('store', 'age')

传入字符串的形式不推荐，一般只和其他指令本文作者：唐霜，转载请注明出处。原创内容，盗版必究。一起使用的时候才这样使用，例如：

原创内容，盗版必究。【版权所有】唐霜 www.tangshuang.net【本文首发于唐霜的博客】【本文受版权保护】 
const wrap = pipe([
  initialize('model', Model),
  observe('model'), // 在已知 model 属性为 Model 实例的情况下使用，其他情况下不要使用
])

inject

像组件 props 中注入新的属性。

本文作者：唐霜，转载请注明出处。【版权所有，侵权必究】著作权归作者所有，禁止商业用途转载。 
const injectState = inject('state', store.state)
const InjectedComponent = injectState(Component)

这样，组件将自动带上 state={st【版权所有】唐霜 www.tangshuang.net著作权归作者所有，禁止商业用途转载。ore.state} 这个属性。

【关注微信公众号：wwwtangshuangnet】原创内容，盗版必究。【本文受版权保护】

inject 第二个参数支持函数，该函数【版权所有】唐霜 www.tangshuang.net著作权归作者所有，禁止商业用途转载。接收组件本身的 props，你可以在该函【原创不易，请尊重版权】【未经授权禁止转载】数中决定新增的 prop 值。

【本文首发于唐霜的博客】【访问 www.tangshuang.net 获取更多精彩内容】【作者：唐霜】

pollute

污染组件内指定内嵌组件的 default本文版权归作者所有，未经授权不得转载。【原创不易，请尊重版权】Props。

【转载请注明来源】【原创内容，转载请注明出处】 
const polluteWithI18n = pollute(T, { i18n }) // 内部的所有 T 组件都会 defaultProps.i18n = i18n

需要注意，这里指的内嵌组件不单单包含被包【原创不易，请尊重版权】本文作者：唐霜，转载请注明出处。裹组件内的子组件，而且包括往下任何深层级【本文首发于唐霜的博客】【转载请注明来源】的后代组件。

【未经授权禁止转载】转载请注明出处：www.tangshuang.net【原创内容，转载请注明出处】

initialize

实例化一个类，并将该类作为对应的 pro本文版权归作者所有，未经授权不得转载。【未经授权禁止转载】p 传递给被包裹的组件。

【版权所有，侵权必究】【原创内容，转载请注明出处】 
const wrap = initialize('some', Some, ...args) // Some 是一个 js 类，在内部，它会被实例化。第 3 个参数开始，会作为实例化时的默认参数传入
// 被包裹的组件将会有一个名字为 some 的 prop

之所以提供一个 initialize 指【原创内容，转载请注明出处】【版权所有】唐霜 www.tangshuang.net令，是为了在某些情况下，我们希望只在组件【版权所有，侵权必究】【原创内容，转载请注明出处】实例化的时候同时实例化这个类，得到一个在转载请注明出处：www.tangshuang.net【原创内容，转载请注明出处】组件内可用的实例，而非一个外部传入的公用【转载请注明来源】本文版权归作者所有，未经授权不得转载。的实例。

【原创内容，转载请注明出处】【版权所有，侵权必究】著作权归作者所有，禁止商业用途转载。【访问 www.tangshuang.net 获取更多精彩内容】

比如说，我们希望组件在自己的生命周期里使【关注微信公众号：wwwtangshuangnet】本文作者：唐霜，转载请注明出处。用一个独立的 store，我们可以这样子【访问 www.tangshuang.net 获取更多精彩内容】【原创不易，请尊重版权】：

原创内容，盗版必究。【本文受版权保护】本文版权归作者所有，未经授权不得转载。 
const defaultData = { ... }
export default pipe([
  initialize('store', Store, defaultData),
  observe('store'),
])(SomeComponent)

class SomeComponent extends Component {
  static props = {
    store: Store,
  }
}

这样就可以在组件内使用一个外部传入的 s转载请注明出处：www.tangshuang.net【未经授权禁止转载】tore，并且，当这个 store 的数未经授权，禁止复制转载。【本文首发于唐霜的博客】据发生变化的时候，组件会自动刷新。

原创内容，盗版必究。本文作者：唐霜，转载请注明出处。本文作者：唐霜，转载请注明出处。

pipe

对组件的包裹可能会一次性进行多指令操作。原创内容，盗版必究。【本文受版权保护】比如我们既想观察 store，又想将 s【版权所有】唐霜 www.tangshuang.net【版权所有】唐霜 www.tangshuang.nettore.state 注入到组件中，这时本文作者：唐霜，转载请注明出处。【访问 www.tangshuang.net 获取更多精彩内容】我们不可能在函数外在包一层函数。pipe【本文受版权保护】未经授权，禁止复制转载。 指令用于解决这种问题。

【访问 www.tangshuang.net 获取更多精彩内容】【作者：唐霜】 
const WrapperedComponent = pipe([
  observe(store),
  inject('state', store.state),
])(Component)

注意，pipe 的参数是一个数组。

原创内容，盗版必究。【原创不易，请尊重版权】本文作者：唐霜，转载请注明出处。

MVC

前文一直都是在阐述有关视图层编程的东西，【作者：唐霜】著作权归作者所有，禁止商业用途转载。都是在丰富 react 开发的范式。而本【版权所有，侵权必究】【转载请注明来源】章将带领你进入应用开发更高一层的设计，即【本文首发于唐霜的博客】著作权归作者所有，禁止商业用途转载。以 MVC 的“设计模式”实现应用开发。本文版权归作者所有，未经授权不得转载。【原创不易，请尊重版权】虽然 MVC 不算是一种设计模式，但是它本文版权归作者所有，未经授权不得转载。【关注微信公众号：wwwtangshuangnet】却深远影响了现代应用开发的架构设计。用 本文作者：唐霜，转载请注明出处。未经授权，禁止复制转载。Nautil 开发应用，你可以根据自己的未经授权，禁止复制转载。【本文受版权保护】实际场景，渐进式地遵循 MVC。当你只是未经授权，禁止复制转载。本文作者：唐霜，转载请注明出处。完成简单的 UI 开发时，你只会用到 C【未经授权禁止转载】著作权归作者所有，禁止商业用途转载。omponent。但是当你需要灵活的处理【原创不易，请尊重版权】本文版权归作者所有，未经授权不得转载。用户输入与操作交互时，你就需要引入 Co转载请注明出处：www.tangshuang.net【版权所有】唐霜 www.tangshuang.netntroller 来整合 Compone【访问 www.tangshuang.net 获取更多精彩内容】原创内容，盗版必究。nt 和状态管理、事件管理等。而当你需要未经授权，禁止复制转载。本文作者：唐霜，转载请注明出处。对业务对象进行更好的数据控制时，你就需要【访问 www.tangshuang.net 获取更多精彩内容】【作者：唐霜】再引入 Model，用以创建领域模型，以【关注微信公众号：wwwtangshuangnet】【本文首发于唐霜的博客】理清楚业务实体与应用系统的联系。最后，如本文作者：唐霜，转载请注明出处。【作者：唐霜】果你需要从应用整体层面处理好数据流或业务【本文受版权保护】【版权所有】唐霜 www.tangshuang.net流，你就会借助 Service 来处理系【作者：唐霜】【版权所有】唐霜 www.tangshuang.net统层面的控制。

【访问 www.tangshuang.net 获取更多精彩内容】【版权所有】唐霜 www.tangshuang.net【版权所有，侵权必究】

Controller

后端框架中 Controller 往往是【转载请注明来源】著作权归作者所有，禁止商业用途转载。用户输入的入口，编写一个业务模块可以没有【本文首发于唐霜的博客】【版权所有，侵权必究】模型和视图，但是必须先编写它的 Cont本文作者：唐霜，转载请注明出处。著作权归作者所有，禁止商业用途转载。roller 来处理用户输入。和后端应用未经授权，禁止复制转载。【版权所有】唐霜 www.tangshuang.net的 Controller 不同，前端领域原创内容，盗版必究。【版权所有】唐霜 www.tangshuang.net的 View 才是必不可少的，一个业务模转载请注明出处：www.tangshuang.net【版权所有，侵权必究】块，可以没有用户输入，但是绝对不能没有用转载请注明出处：www.tangshuang.net本文版权归作者所有，未经授权不得转载。来展示的界面。所以，在前端中，Contr著作权归作者所有，禁止商业用途转载。转载请注明出处：www.tangshuang.netoller 的地位要低于 View。那么【关注微信公众号：wwwtangshuangnet】【原创内容，转载请注明出处】，在前端中，Controller 到底控【版权所有】唐霜 www.tangshuang.net转载请注明出处：www.tangshuang.net制什么呢？在 Nautil 中，Cont【转载请注明来源】著作权归作者所有，禁止商业用途转载。roller 是用于控制一个业务在处理用【关注微信公众号：wwwtangshuangnet】著作权归作者所有，禁止商业用途转载。户输入时的枢纽。它上承模型、服务，下接视【转载请注明来源】本文作者：唐霜，转载请注明出处。图、状态管理。在简单的业务模块编写时，我【本文受版权保护】【原创内容，转载请注明出处】们可能用不上 Controller，只需【版权所有】唐霜 www.tangshuang.net【作者：唐霜】要借助 Component 及状态管理即原创内容，盗版必究。【原创不易，请尊重版权】可完成。但是当遇到复杂（并非代码量多，而原创内容，盗版必究。【关注微信公众号：wwwtangshuangnet】是指需要合理组织代码才能清晰的表达每一个【关注微信公众号：wwwtangshuangnet】本文版权归作者所有，未经授权不得转载。需求点）业务时，将复杂的业务逻辑杂糅在 【本文首发于唐霜的博客】【原创内容，转载请注明出处】View 层代码中，就导致该业务的代码混未经授权，禁止复制转载。【原创内容，转载请注明出处】杂一片，视图和逻辑相互交织，难以在长期的【版权所有，侵权必究】本文版权归作者所有，未经授权不得转载。维护中清晰的展示一个业务点是怎么工作的。【作者：唐霜】【原创不易，请尊重版权】而一个 Controller 通过把该业著作权归作者所有，禁止商业用途转载。【原创内容，转载请注明出处】务点所涉及的模型、服务、视图放在一起，经【版权所有】唐霜 www.tangshuang.net【访问 www.tangshuang.net 获取更多精彩内容】过拆分组合，有效的组织起该业务的代码管理著作权归作者所有，禁止商业用途转载。著作权归作者所有，禁止商业用途转载。。

【原创不易，请尊重版权】著作权归作者所有，禁止商业用途转载。

在 Nautil 中，我们定义一个 Co【访问 www.tangshuang.net 获取更多精彩内容】【本文首发于唐霜的博客】ntroller，它将拥有一些特殊的能力著作权归作者所有，禁止商业用途转载。【本文受版权保护】，基于这些能力，我们可以在 Contro转载请注明出处：www.tangshuang.net未经授权，禁止复制转载。ller 中比较好的处理用户的输入/交互【原创不易，请尊重版权】【原创内容，转载请注明出处】所带来的数据影响，同时，又响应数据的变化【版权所有】唐霜 www.tangshuang.net【原创不易，请尊重版权】更新视图界面。

【转载请注明来源】【访问 www.tangshuang.net 获取更多精彩内容】【转载请注明来源】 
import { Controller } from 'nautil'

class CarController extends Controller {
  // CarModel 是一个关于 car 的领域模型，当 CarController 进行实例化时，会自动实例化 CarModel，你可以通过 this.car 读取该模型实例。
  // 当模型数据发生变化时，Controller 会自动更新自己所管理的视图
  static car = CarModel 
  
  // Controller 中通过  Rxjs 来管理事件流，通过 static sell$ 来提前定义一个名为 sell 的事件流，之后你可以使用 this.sell$ 来读取这个流
  static sell$(stream) {
    ...
  }

  // 和 CarModel 一样，Store 也会自动实例化，通过 this.store 来读取，并且在其 state 发生变化时，Controller 会自动更新自己所管理的视图
  static store = Store
 
  // Controller 会在实例化时，获取服务的单例，该单例是一个全局单例，可在任何 Controller 之间共享
  static service = CarService

  // 以大写开头的方法将被视为 Controller 管理的一个组件，该组件内部可以读取 Controller 实例上的属性和方法，并且在模型或 Store 变化时自动更新界面
  CarBasicInfo(props) {
    const { car } = this // 读取了模型实例
    return (
      <>
        <span>型号: {car.type}</span>
        <span>价格：{car.price}</span>
      </>
    )
  }

  // Controller 上的一个普通方法
  loadCarData(carId) {
    this.service.getCarDetail(carId).then(data => this.car.fromJSON(data))
  }
}

一个 Controller 自身其实并不【版权所有】唐霜 www.tangshuang.net【转载请注明来源】完成各种逻辑的决定，它更多的是调用自己控【转载请注明来源】【本文首发于唐霜的博客】制着的模型、服务等其他实体的方法，完成数【版权所有】唐霜 www.tangshuang.net本文版权归作者所有，未经授权不得转载。据和视图的调配。有关业务实体的逻辑，放在本文作者：唐霜，转载请注明出处。【原创内容，转载请注明出处】 Model 中定义，并以方法的形式暴露【未经授权禁止转载】【本文受版权保护】出来给 Controller 用。有关业未经授权，禁止复制转载。【版权所有，侵权必究】务流的逻辑，放在 Serivce 中定义著作权归作者所有，禁止商业用途转载。【访问 www.tangshuang.net 获取更多精彩内容】，也是暴露方法给 Controller 【转载请注明来源】本文版权归作者所有，未经授权不得转载。用。Controller 的方法，是对其【转载请注明来源】【关注微信公众号：wwwtangshuangnet】他实体的方法在具体语境下的一个二次封装，【访问 www.tangshuang.net 获取更多精彩内容】【原创内容，转载请注明出处】从而达到上下游数据流转的通顺。

【转载请注明来源】本文作者：唐霜，转载请注明出处。

我们来看一个例子：

著作权归作者所有，禁止商业用途转载。未经授权，禁止复制转载。 
import { React, Controller, Component, Store, Section, Input, Text } from 'nautil'

class MyController extends Controller {
  // Controller will initialize this.store of Store, and subscribe the changes to trigger rerendering
  static store = Store

  // Controller will initialize this.price$ of Stream (Rxjs Subject)
  // the initialized stream is passed into the function to be subscribed
  static price$(stream) {
    stream.pipe(e => +e.target.value)
      .pipe((price) => {
        const { count } = this.store.getState()
        return { count, price }
      })
      // a Rxjs Subject can be used as an observer
      .subscribe(this.total$)
  }
  static count$(stream) {
    stream.pipe(e => +e.target.value)
      .pipe((count) => {
        const { price } = this.store.getState()
        return { count, price }
      })
      .subscribe(this.total$)
  }
  static total$(stream) {
    stream.subscribe(({ count, price }) => {
      const total = price * count
      this.store.setState({ price, count, total })
    })
  }

  // a method whose name begins with uppercase will be treated as a component
  InputPrice() {
    const { price } = this.store.getState()
    return (
      <Section>
        <Text>Price:</Text>
        <Input value={price} onChange={this.price$} />
      </Section>
    )
  }

  InputCount() {
    const { count } = this.store.getState()
    return (
      <Section>
        <Text>Count:</Text>
        <Input value={count} onChange={this.count$} />
      </Section>
    )
  }

  ShowTotal() {
    const { total } = this.store.getState()
    return (
      <Section>
        <Text>Total: {total}</Text>
      </Section>
    )
  }
}

class MyComponent extends Component {
  controller = new MyController()

  render() {
    // components defined by controller can be destructed
    const { InputPrice, InputCount, ShowTotal } = this.controller

    return (
      <Section className="foo">
        <InputPrice className="price" />
        <InputCount className="count" />
        <ShowTotal className="total" />
      </Section>
    )
  }
}

在这段代码中，整个业务模块的入口，是 M未经授权，禁止复制转载。原创内容，盗版必究。yComponent 这个组件，它是视图【转载请注明来源】【转载请注明来源】层的东西，因此，我说前端领域和后端完全不原创内容，盗版必究。【版权所有，侵权必究】同，视图才是入口。但你可以发现，在入口组【未经授权禁止转载】【作者：唐霜】件中，内容非常少，它只是从 this.c【作者：唐霜】未经授权，禁止复制转载。ontroller 上读取预定义好的组件【转载请注明来源】本文作者：唐霜，转载请注明出处。，并进行布局安排（布局，样式等处理）。而【原创内容，转载请注明出处】【转载请注明来源】在 MyController 中，我定义【转载请注明来源】原创内容，盗版必究。了这些被用到的组件，但是，这些组件，完全著作权归作者所有，禁止商业用途转载。【原创内容，转载请注明出处】不考虑布局/样式，而只考虑了用户输入和业原创内容，盗版必究。【原创不易，请尊重版权】务展示（交互层面）。也就是说，我们在组织【转载请注明来源】原创内容，盗版必究。一个业务模块的代码的时候，我们可以抛开界本文作者：唐霜，转载请注明出处。【未经授权禁止转载】面的布局和样式，从需求文档的业务交互层面【原创内容，转载请注明出处】本文版权归作者所有，未经授权不得转载。进行代码管理。

【版权所有】唐霜 www.tangshuang.net转载请注明出处：www.tangshuang.net【关注微信公众号：wwwtangshuangnet】

而再来看 MyController，它虽原创内容，盗版必究。【未经授权禁止转载】然把各种交互逻辑拆分成比较小的碎片，但是本文版权归作者所有，未经授权不得转载。【版权所有】唐霜 www.tangshuang.net，一个完整的 Controller，可以著作权归作者所有，禁止商业用途转载。【版权所有】唐霜 www.tangshuang.net完整描述这一个业务模块所拥有的几乎全部交原创内容，盗版必究。【访问 www.tangshuang.net 获取更多精彩内容】互逻辑。Controller 自己做到了未经授权，禁止复制转载。【未经授权禁止转载】自洽，再没有 MyComponent 作本文作者：唐霜，转载请注明出处。本文版权归作者所有，未经授权不得转载。为入口时，它虽然不工作，但是同样为我们描【原创内容，转载请注明出处】【原创不易，请尊重版权】述了有关该业务模块的所有逻辑。这为我们撰著作权归作者所有，禁止商业用途转载。【本文首发于唐霜的博客】写跨端的业务逻辑提供了可能，以前，我们把原创内容，盗版必究。本文版权归作者所有，未经授权不得转载。业务逻辑写在组件或状态管理中，当我们同一【未经授权禁止转载】【原创内容，转载请注明出处】个业务既有 PC 端又有移动端时，我们很原创内容，盗版必究。【未经授权禁止转载】难从代码中分离出可以复用的部分（或者可以转载请注明出处：www.tangshuang.net【本文首发于唐霜的博客】分离，但是代码组织很麻烦）。而在 MVC【本文受版权保护】【转载请注明来源】 驱动下，这种分离或复用变得很自然，因为本文作者：唐霜，转载请注明出处。著作权归作者所有，禁止商业用途转载。 Controller 自管理了一个业务原创内容，盗版必究。未经授权，禁止复制转载。模块的所有（模型、服务、状态、交互），所【关注微信公众号：wwwtangshuangnet】未经授权，禁止复制转载。以，到不同端，就是用不同端的视图组件去进【原创内容，转载请注明出处】著作权归作者所有，禁止商业用途转载。行布局和处理即可。这就是 Nautil 未经授权，禁止复制转载。未经授权，禁止复制转载。中有关 Controller 的思想，有【版权所有，侵权必究】【关注微信公众号：wwwtangshuangnet】关 MVC 的具体实践之一。

【版权所有，侵权必究】【原创不易，请尊重版权】【作者：唐霜】【本文受版权保护】

结语

本文详细的讲解了如何使用 Nautil。【关注微信公众号：wwwtangshuangnet】【原创内容，转载请注明出处】虽然在某些细节上尚未做到细致，我会在今后【原创不易，请尊重版权】转载请注明出处：www.tangshuang.net慢慢弥补这些未完成的细节。Nautil 著作权归作者所有，禁止商业用途转载。【版权所有】唐霜 www.tangshuang.net是立足解决 react 开发痛点的新框架【未经授权禁止转载】【作者：唐霜】。它和 react 做到兼容，从而避免开【版权所有，侵权必究】【版权所有，侵权必究】发者以前写过的 react 应用完全不可本文作者：唐霜，转载请注明出处。【关注微信公众号：wwwtangshuangnet】用。这一点我认为是非常重要的。在我的开发原创内容，盗版必究。原创内容，盗版必究。理念中，“简单好用”永远是我认为最重要的【版权所有，侵权必究】【未经授权禁止转载】一条原则。如果不简单不好用，即使这门技术本文版权归作者所有，未经授权不得转载。著作权归作者所有，禁止商业用途转载。非常强大，仍然无法吸引我的眼球。

【原创内容，转载请注明出处】本文版权归作者所有，未经授权不得转载。

在开发者使用 Nautil 的过程中，一【版权所有，侵权必究】【访问 www.tangshuang.net 获取更多精彩内容】定要时刻记住，观察者模式贯穿始终。如果有【访问 www.tangshuang.net 获取更多精彩内容】【本文首发于唐霜的博客】兴趣更多的去研究 rxjs，你可能会惊喜【原创内容，转载请注明出处】转载请注明出处：www.tangshuang.net的发现，原来 nautil 是如此的先进本文作者：唐霜，转载请注明出处。【作者：唐霜】和了不起。它融合了所有 react 生态【版权所有】唐霜 www.tangshuang.net原创内容，盗版必究。中的非主流，非 redux，非单向数据流【本文受版权保护】本文版权归作者所有，未经授权不得转载。，非 immutable，非 react【版权所有】唐霜 www.tangshuang.net【原创不易，请尊重版权】-router，甚至，我们提供了新的表单著作权归作者所有，禁止商业用途转载。【版权所有】唐霜 www.tangshuang.net模型（这一块我们还在想办法解决表单模型和【本文首发于唐霜的博客】【本文受版权保护】视图如何更统一的尝试）而放弃了所谓业界流【本文受版权保护】【本文首发于唐霜的博客】行的几大表单库。

本文版权归作者所有，未经授权不得转载。【原创内容，转载请注明出处】【本文受版权保护】

另外，我们的一个重要目标，是建立跨平台的著作权归作者所有，禁止商业用途转载。著作权归作者所有，禁止商业用途转载。前端开发框架。真正做到在代码层面实现一处【转载请注明来源】本文作者：唐霜，转载请注明出处。撰写，多平台运行的目标。但是本质上，我们【本文首发于唐霜的博客】【访问 www.tangshuang.net 获取更多精彩内容】没有改变 react 开发的有趣性，我们原创内容，盗版必究。【关注微信公众号：wwwtangshuangnet】在它的基础上进行了扩展。如果你认为其中一【本文受版权保护】【本文受版权保护】部分好，另一部分不好，你可以尝试不使用其转载请注明出处：www.tangshuang.net转载请注明出处：www.tangshuang.net中的某些部分，而只是用其中的一部分。现在【转载请注明来源】【版权所有，侵权必究】的构建工具已经足够丰富，可以帮我们把那些【转载请注明来源】未经授权，禁止复制转载。不需要的部分从最终的代码中删除而不影响应【未经授权禁止转载】【版权所有，侵权必究】用的运行。

【访问 www.tangshuang.net 获取更多精彩内容】本文版权归作者所有，未经授权不得转载。【本文受版权保护】【转载请注明来源】

我还在继续开发 nautil 的细节功能未经授权，禁止复制转载。【版权所有，侵权必究】，本文中的思想、原则部分不会在发生变化，【作者：唐霜】原创内容，盗版必究。但具体的一些细节（例如某些组件的用法）还【访问 www.tangshuang.net 获取更多精彩内容】本文版权归作者所有，未经授权不得转载。可能会有调整。如果你对这个项目感兴趣，加入我们吧。

原创内容，盗版必究。未经授权，禁止复制转载。
转载请注明出处：www.tangshuang.net【原创内容，转载请注明出处】著作权归作者所有，禁止商业用途转载。原创内容，盗版必究。【作者：唐霜】原创内容，盗版必究。原创内容，盗版必究。【原创不易，请尊重版权】【本文首发于唐霜的博客】【原创内容，转载请注明出处】【本文受版权保护】本文版权归作者所有，未经授权不得转载。著作权归作者所有，禁止商业用途转载。原创内容，盗版必究。未经授权，禁止复制转载。未经授权，禁止复制转载。【关注微信公众号：wwwtangshuangnet】本文版权归作者所有，未经授权不得转载。【未经授权禁止转载】【本文首发于唐霜的博客】转载请注明出处：www.tangshuang.net【未经授权禁止转载】【原创内容，转载请注明出处】【未经授权禁止转载】转载请注明出处：www.tangshuang.net本文版权归作者所有，未经授权不得转载。【访问 www.tangshuang.net 获取更多精彩内容】【转载请注明来源】

如果你觉得本书对你有帮助，通过下方的二维码向我打赏吧，帮助我写出更多有用的内容。

2019-09-22 | , , ,