Nautil 开发文档

Nautil 开发文档

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

前言【作者:唐霜】

【本文受版权保护】【未经授权禁止转载】【本文首发于唐霜的博客】

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

【转载请注明来源】【本文首发于唐霜的博客】著作权归作者所有,禁止商业用途转载。【未经授权禁止转载】

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

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

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

【原创内容,转载请注明出处】【本文首发于唐霜的博客】【关注微信公众号:wwwtangshuangnet】

Nautil 这个单词取自 Nautil本文版权归作者所有,未经授权不得转载。本文版权归作者所有,未经授权不得转载。us 的前面部分。Nautilus(鹦鹉本文版权归作者所有,未经授权不得转载。【版权所有】唐霜 www.tangshuang.net螺)是一种海洋生物,有数亿年的进化历程,【版权所有】唐霜 www.tangshuang.net著作权归作者所有,禁止商业用途转载。被成为海洋中的“活化石”。鹦鹉螺身上藏着本文版权归作者所有,未经授权不得转载。【转载请注明来源】非常多令人不可思议的秘密。鹦鹉螺外壳切面本文作者:唐霜,转载请注明出处。原创内容,盗版必究。所呈现优美的螺线,暗含了斐波拉契数列,而【访问 www.tangshuang.net 获取更多精彩内容】著作权归作者所有,禁止商业用途转载。斐波拉契数列的两项间比值也是无限接近黄金原创内容,盗版必究。【本文首发于唐霜的博客】分割数。Nautil 希望在前端开发领域本文作者:唐霜,转载请注明出处。【转载请注明来源】打破传统开发思维,创立独特的开发方式。

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

安装【作者:唐霜】

本文版权归作者所有,未经授权不得转载。本文版权归作者所有,未经授权不得转载。【版权所有,侵权必究】

本章详细阐述你准备使用 Nautil 前【作者:唐霜】未经授权,禁止复制转载。的准备工作。

转载请注明出处:www.tangshuang.net【未经授权禁止转载】【本文受版权保护】本文作者:唐霜,转载请注明出处。

兼容性未经授权,禁止复制转载。

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

Nautil 【版权所有】唐霜 www.tangshuang.net不支持原创内容,盗版必究。 IE8 及以下版本,因为它使用了 IE【版权所有,侵权必究】【原创不易,请尊重版权】8 无法模拟的 ECMAScript 特【未经授权禁止转载】著作权归作者所有,禁止商业用途转载。性(例如 Proxy)。

【作者:唐霜】【关注微信公众号:wwwtangshuangnet】著作权归作者所有,禁止商业用途转载。

当前版本【本文首发于唐霜的博客】

【原创不易,请尊重版权】本文作者:唐霜,转载请注明出处。转载请注明出处:www.tangshuang.net

最新稳定版本:v0.29未经授权,禁止复制转载。
【未经授权禁止转载】【原创不易,请尊重版权】 稳定版本对应分支:master【作者:唐霜】
原创内容,盗版必究。【转载请注明来源】 开发中分支:dev原创内容,盗版必究。

本文版权归作者所有,未经授权不得转载。著作权归作者所有,禁止商业用途转载。【版权所有】唐霜 www.tangshuang.net

NPM本文版权归作者所有,未经授权不得转载。

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

起步【版权所有】唐霜 www.tangshuang.net

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

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

【本文首发于唐霜的博客】【本文首发于唐霜的博客】本文版权归作者所有,未经授权不得转载。

你是怎样的开发者?本文作者:唐霜,转载请注明出处。

著作权归作者所有,禁止商业用途转载。【转载请注明来源】【访问 www.tangshuang.net 获取更多精彩内容】【原创不易,请尊重版权】

Nautil 的开发有一定的门槛,作为前【版权所有,侵权必究】【本文首发于唐霜的博客】端开发者,我们希望你可以使用 Nauti【原创不易,请尊重版权】【版权所有,侵权必究】l 完成自己的应用开发,但是,我们也不希【未经授权禁止转载】【未经授权禁止转载】望你在基础能力不足的情况下,勉强的去使用【关注微信公众号:wwwtangshuangnet】【版权所有】唐霜 www.tangshuang.net它。Nautil 需要开发者拥有以下基础原创内容,盗版必究。原创内容,盗版必究。能力:

【本文受版权保护】【版权所有】唐霜 www.tangshuang.net【版权所有】唐霜 www.tangshuang.net【原创内容,转载请注明出处】【原创不易,请尊重版权】

适用场景未经授权,禁止复制转载。

原创内容,盗版必究。【访问 www.tangshuang.net 获取更多精彩内容】【原创不易,请尊重版权】

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

原创内容,盗版必究。转载请注明出处:www.tangshuang.net【未经授权禁止转载】【版权所有,侵权必究】

为什么选择 Nautil?【本文受版权保护】

本文作者:唐霜,转载请注明出处。转载请注明出处:www.tangshuang.net【关注微信公众号:wwwtangshuangnet】

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

【版权所有,侵权必究】原创内容,盗版必究。【本文受版权保护】原创内容,盗版必究。

我提供了一揽子的解决方案,不需要开发者自本文作者:唐霜,转载请注明出处。【访问 www.tangshuang.net 获取更多精彩内容】己去选择(虽然你可以自己去选择):

未经授权,禁止复制转载。【转载请注明来源】【转载请注明来源】【原创不易,请尊重版权】【本文首发于唐霜的博客】

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

【本文首发于唐霜的博客】【版权所有,侵权必究】【版权所有,侵权必究】【关注微信公众号:wwwtangshuangnet】【未经授权禁止转载】

Nautil 的核心理念就是“为应用开发原创内容,盗版必究。本文作者:唐霜,转载请注明出处。设计最简单的工程性解决方案”,而非为技术著作权归作者所有,禁止商业用途转载。著作权归作者所有,禁止商业用途转载。而设计。包括 react 官方本身,很多【版权所有】唐霜 www.tangshuang.net原创内容,盗版必究。人都在一套被虚拟出来的技术体系中炫技,但【作者:唐霜】【原创不易,请尊重版权】是本质上,如果没有 react 本身所产【本文受版权保护】【版权所有,侵权必究】生的一系列问题,也就没有这些炫技的机会。【原创内容,转载请注明出处】【版权所有,侵权必究】这些自嗨中,似乎忘却了,使用框架的目的最【版权所有】唐霜 www.tangshuang.net转载请注明出处:www.tangshuang.net核心最重要的是做应用开发。如何做好应用开【本文受版权保护】转载请注明出处:www.tangshuang.net发?简单,易懂。转载请注明出处:www.tangshuang.net这两个单词,是我近来最喜欢的词。而 Na著作权归作者所有,禁止商业用途转载。【版权所有】唐霜 www.tangshuang.netutil 除了在一开始要理解“观察者模式【原创内容,转载请注明出处】未经授权,禁止复制转载。”的核心之外,一切都很简单。

【版权所有】唐霜 www.tangshuang.net著作权归作者所有,禁止商业用途转载。原创内容,盗版必究。【本文首发于唐霜的博客】本文作者:唐霜,转载请注明出处。

观察者模式【版权所有】唐霜 www.tangshuang.net

本文版权归作者所有,未经授权不得转载。著作权归作者所有,禁止商业用途转载。【本文受版权保护】未经授权,禁止复制转载。

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

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

观察者模式是整个 Nautil 的核心理【访问 www.tangshuang.net 获取更多精彩内容】【版权所有】唐霜 www.tangshuang.net念,开发者必须掌握这一概念,才不至于在 本文作者:唐霜,转载请注明出处。【原创内容,转载请注明出处】Nautil 的开发中迷路。

转载请注明出处:www.tangshuang.net【原创不易,请尊重版权】原创内容,盗版必究。

为什么这么说?我们先来看下,具体在 Na【原创内容,转载请注明出处】【关注微信公众号:wwwtangshuangnet】util 中如何发挥观察者模式的作用:

【关注微信公众号:wwwtangshuangnet】【本文受版权保护】【转载请注明来源】原创内容,盗版必究。
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 中使用观察【转载请注明来源】【转载请注明来源】者模式的方法之一。observe 指令通【访问 www.tangshuang.net 获取更多精彩内容】本文版权归作者所有,未经授权不得转载。过识别 store,自动对其进行观察,并【本文首发于唐霜的博客】【版权所有,侵权必究】在 store 发生变化时更新组件。有了【版权所有,侵权必究】【版权所有】唐霜 www.tangshuang.net这个利器,store 可以与其他组件共享本文作者:唐霜,转载请注明出处。【原创不易,请尊重版权】,在其他组件中更新 store 也会触发转载请注明出处:www.tangshuang.net【未经授权禁止转载】 ObservedComponent 的未经授权,禁止复制转载。【版权所有,侵权必究】更新。

【转载请注明来源】本文作者:唐霜,转载请注明出处。【版权所有】唐霜 www.tangshuang.net【版权所有】唐霜 www.tangshuang.net【原创不易,请尊重版权】

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

【原创不易,请尊重版权】【本文首发于唐霜的博客】【原创不易,请尊重版权】【关注微信公众号:wwwtangshuangnet】

Store 和 State【未经授权禁止转载】

【版权所有】唐霜 www.tangshuang.net【原创不易,请尊重版权】【作者:唐霜】

状态(State)是用于控制组件 UI 本文版权归作者所有,未经授权不得转载。本文作者:唐霜,转载请注明出处。界面的对象型数据。一旦一个组件的状态是某【作者:唐霜】【版权所有】唐霜 www.tangshuang.net个值,那么它对应的 UI 界面就是确定的【作者:唐霜】【原创不易,请尊重版权】。Nautil 提供的 State 和 转载请注明出处:www.tangshuang.net【版权所有,侵权必究】vue.js 中的数据更新方式相似,直接本文版权归作者所有,未经授权不得转载。【作者:唐霜】修改对象属性,就会触发 Store 进行原创内容,盗版必究。【本文受版权保护】响应。

【版权所有,侵权必究】【版权所有,侵权必究】【作者:唐霜】未经授权,禁止复制转载。

仓库(Store)是用于保存 State【未经授权禁止转载】【本文受版权保护】 的容器。一个 Store 内只保管一份本文作者:唐霜,转载请注明出处。未经授权,禁止复制转载。 State,同时,Store 提供了一本文版权归作者所有,未经授权不得转载。【版权所有】唐霜 www.tangshuang.net些接口,用于更新数据、获取数据、监听数据著作权归作者所有,禁止商业用途转载。【关注微信公众号:wwwtangshuangnet】变化。

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

我们来看下,在 Nautil 中具体如何【作者:唐霜】本文作者:唐霜,转载请注明出处。使用类似 vue 中的直接修改 stat著作权归作者所有,禁止商业用途转载。【原创不易,请尊重版权】e:

原创内容,盗版必究。本文版权归作者所有,未经授权不得转载。本文作者:唐霜,转载请注明出处。【版权所有,侵权必究】原创内容,盗版必究。
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 所【访问 www.tangshuang.net 获取更多精彩内容】未经授权,禁止复制转载。提出的 immutable 数据流的理念转载请注明出处:www.tangshuang.net【原创内容,转载请注明出处】,在 Nautil 中的视图编程(Com【作者:唐霜】【版权所有】唐霜 www.tangshuang.netponent, Store)都遵循这一理【关注微信公众号:wwwtangshuangnet】转载请注明出处:www.tangshuang.net念,直接修改 state 是不被允许的,【访问 www.tangshuang.net 获取更多精彩内容】【原创不易,请尊重版权】但是通过 this.$state 却可以【版权所有,侵权必究】【原创内容,转载请注明出处】像 vue 中一样,直接操作 state【原创内容,转载请注明出处】【转载请注明来源】(内部使用了 Proxy 进行代理,实际【未经授权禁止转载】本文作者:唐霜,转载请注明出处。产生的仍然是 immutable 的 s著作权归作者所有,禁止商业用途转载。未经授权,禁止复制转载。tate)。

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

接下来,我们看下同样的理念在 Store【版权所有,侵权必究】【原创不易,请尊重版权】 中的运用:

本文版权归作者所有,未经授权不得转载。【本文受版权保护】【访问 www.tangshuang.net 获取更多精彩内容】【版权所有】唐霜 www.tangshuang.net
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)

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

【版权所有】唐霜 www.tangshuang.net【原创不易,请尊重版权】原创内容,盗版必究。【版权所有,侵权必究】

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

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

响应式未经授权,禁止复制转载。

【本文首发于唐霜的博客】本文版权归作者所有,未经授权不得转载。本文版权归作者所有,未经授权不得转载。

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

【本文首发于唐霜的博客】原创内容,盗版必究。【作者:唐霜】未经授权,禁止复制转载。

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

原创内容,盗版必究。【原创内容,转载请注明出处】【作者:唐霜】

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

【本文受版权保护】【关注微信公众号:wwwtangshuangnet】【版权所有,侵权必究】【原创内容,转载请注明出处】

我们用真实的代码来体验一下:本文作者:唐霜,转载请注明出处。

【本文首发于唐霜的博客】【原创内容,转载请注明出处】本文版权归作者所有,未经授权不得转载。【版权所有,侵权必究】
// 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 中的数据【未经授权禁止转载】【版权所有,侵权必究】,就可以触发整个应用的更新。

【版权所有,侵权必究】【版权所有,侵权必究】未经授权,禁止复制转载。原创内容,盗版必究。【转载请注明来源】

当然,不引用全局变量,使用 props 【版权所有,侵权必究】【版权所有】唐霜 www.tangshuang.net从外部传数据是最好的,这在前面的“观察者【未经授权禁止转载】【作者:唐霜】模式”“Store 和 State”这两转载请注明出处:www.tangshuang.net【访问 www.tangshuang.net 获取更多精彩内容】部分中已经用实例代码演示了。

【版权所有】唐霜 www.tangshuang.net本文版权归作者所有,未经授权不得转载。原创内容,盗版必究。【转载请注明来源】本文作者:唐霜,转载请注明出处。

双向绑定本文版权归作者所有,未经授权不得转载。

本文作者:唐霜,转载请注明出处。【原创不易,请尊重版权】著作权归作者所有,禁止商业用途转载。【原创不易,请尊重版权】【版权所有,侵权必究】

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

著作权归作者所有,禁止商业用途转载。转载请注明出处: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 【原创不易,请尊重版权】【版权所有】唐霜 www.tangshuang.net的 this 还是有非常大的不同)。需要【关注微信公众号:wwwtangshuangnet】【作者:唐霜】注意,虽然在声明时要求传入的 prop 【作者:唐霜】【本文受版权保护】为 $age,但是在 this.attr【原创不易,请尊重版权】【转载请注明来源】s 上,却要使用 this.attrs.原创内容,盗版必究。【版权所有】唐霜 www.tangshuang.netage 读取。

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

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

【作者:唐霜】【原创不易,请尊重版权】【原创不易,请尊重版权】

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

【版权所有】唐霜 www.tangshuang.net著作权归作者所有,禁止商业用途转载。【转载请注明来源】【原创不易,请尊重版权】【版权所有】唐霜 www.tangshuang.net

此外,如果你希望使用更优雅的写法,你可以【原创不易,请尊重版权】【访问 www.tangshuang.net 获取更多精彩内容】使用内置的 createTwoWayBi本文作者:唐霜,转载请注明出处。著作权归作者所有,禁止商业用途转载。nding 函数:

原创内容,盗版必究。转载请注明出处:www.tangshuang.net【原创不易,请尊重版权】本文版权归作者所有,未经授权不得转载。
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} />
  }
}

这样看上去更优雅,不需要传入数组,也不需本文版权归作者所有,未经授权不得转载。未经授权,禁止复制转载。要传入 state(直接传入 state【原创内容,转载请注明出处】转载请注明出处:www.tangshuang.net 像是传入 state 整个值作为 sh未经授权,禁止复制转载。本文版权归作者所有,未经授权不得转载。ow 的属性值一样,不是很好)。而通过 【版权所有】唐霜 www.tangshuang.net【转载请注明来源】createTwoWayBinding 【关注微信公众号:wwwtangshuangnet】【未经授权禁止转载】函数,就可以将一个对象转化为可读取属性的【本文受版权保护】转载请注明出处:www.tangshuang.net对象,实际上 $state.show 的【本文首发于唐霜的博客】【关注微信公众号:wwwtangshuangnet】返回值也是一个符合双向绑定的数组,但是在【本文受版权保护】本文版权归作者所有,未经授权不得转载。阅读和理解上更容易理解一些。

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

跨平台开发【版权所有】唐霜 www.tangshuang.net

本文作者:唐霜,转载请注明出处。【本文受版权保护】【关注微信公众号:wwwtangshuangnet】【原创内容,转载请注明出处】

Nautil 的设计目标之一,就是实现跨【本文受版权保护】【本文首发于唐霜的博客】平台开发,特别是移动端的跨平台开发。实现著作权归作者所有,禁止商业用途转载。本文作者:唐霜,转载请注明出处。一处写代码,根据不同的平台编译后即可运行【版权所有】唐霜 www.tangshuang.net【转载请注明来源】的效果。要实现跨平台编程,需要遵循一些基【原创不易,请尊重版权】【版权所有,侵权必究】本的规则:

【未经授权禁止转载】本文作者:唐霜,转载请注明出处。【未经授权禁止转载】

开发时,应该关注:著作权归作者所有,禁止商业用途转载。

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

JSX 渲染语法【关注微信公众号:wwwtangshuangnet】

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

在 Nautil 的理念中,存在这样的一著作权归作者所有,禁止商业用途转载。【访问 www.tangshuang.net 获取更多精彩内容】条有象征意义的 slogan:

著作权归作者所有,禁止商业用途转载。【未经授权禁止转载】【本文首发于唐霜的博客】著作权归作者所有,禁止商业用途转载。

Nautil is React, Nau【原创内容,转载请注明出处】【作者:唐霜】til is more than Rea【转载请注明来源】【转载请注明来源】ct.

【作者:唐霜】著作权归作者所有,禁止商业用途转载。【本文首发于唐霜的博客】【未经授权禁止转载】【原创不易,请尊重版权】
【版权所有,侵权必究】著作权归作者所有,禁止商业用途转载。【作者:唐霜】【关注微信公众号:wwwtangshuangnet】

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

【版权所有】唐霜 www.tangshuang.net著作权归作者所有,禁止商业用途转载。【版权所有,侵权必究】【本文受版权保护】【本文受版权保护】

因此,写 Nautil 应用和写 rea转载请注明出处:www.tangshuang.net【访问 www.tangshuang.net 获取更多精彩内容】ct 应用没有任何差别。我们仍然使用 j原创内容,盗版必究。【本文受版权保护】sx 进行渲染结构的编写,语法上没有任何【访问 www.tangshuang.net 获取更多精彩内容】著作权归作者所有,禁止商业用途转载。差别。

【关注微信公众号:wwwtangshuangnet】原创内容,盗版必究。【关注微信公众号:wwwtangshuangnet】转载请注明出处:www.tangshuang.net本文版权归作者所有,未经授权不得转载。

生命周期函数转载请注明出处:www.tangshuang.net

【原创不易,请尊重版权】【本文受版权保护】【原创不易,请尊重版权】著作权归作者所有,禁止商业用途转载。著作权归作者所有,禁止商业用途转载。

我们简化生命周期函数,因此,在开发 Na【本文受版权保护】【未经授权禁止转载】util 时,你可以忘记有关 react【本文受版权保护】【版权所有,侵权必究】 生命周期函数的一切,使用更简短的生命周【原创不易,请尊重版权】本文作者:唐霜,转载请注明出处。期钩子函数。

【版权所有,侵权必究】【关注微信公众号:wwwtangshuangnet】原创内容,盗版必究。【本文首发于唐霜的博客】原创内容,盗版必究。

内置组件转载请注明出处:www.tangshuang.net

本文作者:唐霜,转载请注明出处。【关注微信公众号:wwwtangshuangnet】转载请注明出处:www.tangshuang.net【转载请注明来源】

使用 Nautil 进行开发时,必须使用原创内容,盗版必究。本文版权归作者所有,未经授权不得转载。内置的组件进行开发。和原生 react 本文作者:唐霜,转载请注明出处。【转载请注明来源】开发 web 应用不同,我们不能使用 d著作权归作者所有,禁止商业用途转载。【作者:唐霜】iv/span 这种 HTML 标签作为本文版权归作者所有,未经授权不得转载。【未经授权禁止转载】基础组件,而是要使用 Nautil 的内【版权所有,侵权必究】【转载请注明来源】置组件(如 Section, Text 原创内容,盗版必究。【本文首发于唐霜的博客】等)代替。这是为跨平台准备的,只有使用内【原创内容,转载请注明出处】【版权所有】唐霜 www.tangshuang.net置组件构建起来的 nautil 应用才能【本文首发于唐霜的博客】原创内容,盗版必究。构建出跨平台的应用。

本文作者:唐霜,转载请注明出处。【作者:唐霜】【未经授权禁止转载】【版权所有】唐霜 www.tangshuang.net

内置组件包含如下几类:转载请注明出处:www.tangshuang.net

著作权归作者所有,禁止商业用途转载。【原创不易,请尊重版权】本文版权归作者所有,未经授权不得转载。转载请注明出处:www.tangshuang.net【未经授权禁止转载】

这些组件都是由 Nautil 默认导出的【关注微信公众号:wwwtangshuangnet】未经授权,禁止复制转载。,你可以在下文详细了解。

转载请注明出处:www.tangshuang.net【转载请注明来源】原创内容,盗版必究。本文作者:唐霜,转载请注明出处。

跨平台构建【版权所有】唐霜 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)

在小程序上:未经授权,禁止复制转载。

未经授权,禁止复制转载。【转载请注明来源】未经授权,禁止复制转载。【访问 www.tangshuang.net 获取更多精彩内容】【关注微信公众号:wwwtangshuangnet】
import { createApp } from 'nautil/miniapp'
import App from './app.jsx'

export default createApp(App)

虽然它们看上去非常相似,但是背后的平台不原创内容,盗版必究。【原创不易,请尊重版权】同,所要求的构建工具也不同。

【本文受版权保护】【关注微信公众号:wwwtangshuangnet】【原创内容,转载请注明出处】【版权所有】唐霜 www.tangshuang.net【未经授权禁止转载】

组件本文作者:唐霜,转载请注明出处。

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

虽然 Nautil 的组件本质上就是 r本文版权归作者所有,未经授权不得转载。【访问 www.tangshuang.net 获取更多精彩内容】eact 组件,但是在具体细节上和 re原创内容,盗版必究。未经授权,禁止复制转载。act 组件还是有所不同。本章将详细讲解【未经授权禁止转载】【原创内容,转载请注明出处】 Nautil 组件在 react 组件【原创不易,请尊重版权】【访问 www.tangshuang.net 获取更多精彩内容】之外还具备的新特征。

本文版权归作者所有,未经授权不得转载。【转载请注明来源】【版权所有】唐霜 www.tangshuang.net【版权所有】唐霜 www.tangshuang.net
import { Component } from 'nautil'

Props 声明和检查【本文首发于唐霜的博客】

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

和 react 的 propTypes 本文作者:唐霜,转载请注明出处。本文作者:唐霜,转载请注明出处。很像,你可以通过 props 属性对组件【作者:唐霜】【原创内容,转载请注明出处】接收的 props 进行声明和类型、结构本文作者:唐霜,转载请注明出处。【关注微信公众号:wwwtangshuangnet】进行检查。

转载请注明出处:www.tangshuang.net原创内容,盗版必究。【版权所有】唐霜 www.tangshuang.net

props 声明【转载请注明来源】

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

通过 static props 属性,你【版权所有】唐霜 www.tangshuang.net【原创不易,请尊重版权】可以要求组件所传入的 props 必须包【作者:唐霜】【未经授权禁止转载】含哪些属性。nautil 的属性包含三种【版权所有】唐霜 www.tangshuang.net【原创不易,请尊重版权】

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

普通属性和 react 属性一样,没有差【版权所有】唐霜 www.tangshuang.net本文作者:唐霜,转载请注明出处。别。双向绑定属性用 $ 开头进行声明。o【原创内容,转载请注明出处】本文版权归作者所有,未经授权不得转载。n 开头的属性被认为是一个 handle【本文受版权保护】原创内容,盗版必究。r 属性,用于类似 react 中 on转载请注明出处:www.tangshuang.net转载请注明出处:www.tangshuang.netClick 这类属性。

【原创不易,请尊重版权】【版权所有,侵权必究】【版权所有,侵权必究】【访问 www.tangshuang.net 获取更多精彩内容】

props 校验著作权归作者所有,禁止商业用途转载。

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

通过 static props 的属性值转载请注明出处:www.tangshuang.net【版权所有,侵权必究】,我们可以对传入的 props 的值进行【作者:唐霜】著作权归作者所有,禁止商业用途转载。校验。nautil 中的类型校验遵循 t【本文受版权保护】【关注微信公众号:wwwtangshuangnet】yshemo 的类型校验方法。在撰写一个本文作者:唐霜,转载请注明出处。本文作者:唐霜,转载请注明出处。类型时,你需要从 nautil 中引入已【版权所有】唐霜 www.tangshuang.net本文作者:唐霜,转载请注明出处。支持的类型规则。

本文版权归作者所有,未经授权不得转载。未经授权,禁止复制转载。【版权所有,侵权必究】【版权所有】唐霜 www.tangshuang.net
import { Dict, Component } from 'nautil'

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

对于三种不同的属性,其校验规则也稍有不同【转载请注明来源】【本文受版权保护】

【访问 www.tangshuang.net 获取更多精彩内容】【作者:唐霜】【本文受版权保护】原创内容,盗版必究。

其中,双向绑定属性、事件属性,无论在 p未经授权,禁止复制转载。【原创内容,转载请注明出处】rops 中有无声明,在运行时都会进行基【原创内容,转载请注明出处】【关注微信公众号:wwwtangshuangnet】本类型校验。

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

削减代码著作权归作者所有,禁止商业用途转载。

【作者:唐霜】转载请注明出处:www.tangshuang.net【关注微信公众号:wwwtangshuangnet】未经授权,禁止复制转载。

在 process.env.NODE_E转载请注明出处:www.tangshuang.net转载请注明出处:www.tangshuang.netNV === ‘produc【原创内容,转载请注明出处】【本文受版权保护】ition’ 时,校验会被禁【本文首发于唐霜的博客】本文版权归作者所有,未经授权不得转载。用。也就是说,在正式环境中,组件 pro【未经授权禁止转载】【未经授权禁止转载】ps 的结构、类型校验是禁用掉的,不会执【原创不易,请尊重版权】【未经授权禁止转载】行,并且通过 webpack 的 tre【访问 www.tangshuang.net 获取更多精彩内容】【未经授权禁止转载】e-shaking,可以将部分代码削减掉转载请注明出处:www.tangshuang.net【关注微信公众号:wwwtangshuangnet】

【原创不易,请尊重版权】【原创不易,请尊重版权】【本文首发于唐霜的博客】【未经授权禁止转载】

Attrs 属性原创内容,盗版必究。

本文版权归作者所有,未经授权不得转载。【版权所有,侵权必究】本文版权归作者所有,未经授权不得转载。

Nautil 组件继承自 react 组【访问 www.tangshuang.net 获取更多精彩内容】著作权归作者所有,禁止商业用途转载。件,也包含了 props 属性,可以通过【转载请注明来源】本文版权归作者所有,未经授权不得转载。 this.props 属性读取原始的 著作权归作者所有,禁止商业用途转载。著作权归作者所有,禁止商业用途转载。props。但是,由于我们 Nautil【本文首发于唐霜的博客】著作权归作者所有,禁止商业用途转载。 组件的特性,双向绑定属性和事件属性,所转载请注明出处:www.tangshuang.net【访问 www.tangshuang.net 获取更多精彩内容】以原始 props 没有意义,无法正常发原创内容,盗版必究。未经授权,禁止复制转载。挥 nautil 的特性。

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

Attrs 值【转载请注明来源】

【本文首发于唐霜的博客】转载请注明出处:www.tangshuang.net【版权所有,侵权必究】【关注微信公众号:wwwtangshuangnet】【转载请注明来源】

从 props 上的属性经过处理后产生 转载请注明出处:www.tangshuang.net【未经授权禁止转载】this.attrs。this.attr【本文首发于唐霜的博客】未经授权,禁止复制转载。s 和 this.props 不是包含与转载请注明出处:www.tangshuang.net【版权所有,侵权必究】被包含关系,this.attrs 上的值【原创不易,请尊重版权】【转载请注明来源】包含两部分:

著作权归作者所有,禁止商业用途转载。转载请注明出处:www.tangshuang.net转载请注明出处:www.tangshuang.net【本文受版权保护】

对于 this.props 上的 cla【访问 www.tangshuang.net 获取更多精彩内容】【关注微信公众号:wwwtangshuangnet】ssName, style, child本文版权归作者所有,未经授权不得转载。【版权所有,侵权必究】ren 属性,并不在 attrs 中,o未经授权,禁止复制转载。本文作者:唐霜,转载请注明出处。n 开头的事件属性也不在其中。

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

双向绑定本文版权归作者所有,未经授权不得转载。

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

通过直接反写 this.$attrs 可【版权所有】唐霜 www.tangshuang.net本文作者:唐霜,转载请注明出处。以完成双向绑定。

原创内容,盗版必究。【关注微信公众号:wwwtangshuangnet】转载请注明出处:www.tangshuang.net转载请注明出处:www.tangshuang.net
reneder() {
  return <Button onHint={() => this.$attrs.age ++}></Button>
}

双向绑定的用法在前文已经详细解释过。需要【转载请注明来源】原创内容,盗版必究。注意的是,只有外部传入时以 $ 开头的属【转载请注明来源】【关注微信公众号:wwwtangshuangnet】性才会触发双向绑定。比如外部传入 age本文版权归作者所有,未经授权不得转载。本文版权归作者所有,未经授权不得转载。 属性,则不会触发双向绑定操作 this【作者:唐霜】本文作者:唐霜,转载请注明出处。.$attrs.age ++ 操作不会产【访问 www.tangshuang.net 获取更多精彩内容】【原创内容,转载请注明出处】生任何作用(甚至不会修改 this.at【转载请注明来源】【原创不易,请尊重版权】trs)。

【版权所有,侵权必究】未经授权,禁止复制转载。【版权所有】唐霜 www.tangshuang.net原创内容,盗版必究。

在 static props 中未声明属【作者:唐霜】【未经授权禁止转载】性为双向绑定属性,但是在传入时使用了双向本文版权归作者所有,未经授权不得转载。【未经授权禁止转载】属性标记 $,那么该属性在内部仍然是一个【关注微信公众号:wwwtangshuangnet】【版权所有,侵权必究】双向绑定属性。在 static prop本文版权归作者所有,未经授权不得转载。原创内容,盗版必究。s 中声明了这个属性为双向绑定属性,那么【本文受版权保护】【本文受版权保护】外部传入时,只允许传入双向绑定结构,而不【本文首发于唐霜的博客】【本文首发于唐霜的博客】允许传入普通属性值。

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

stylesheet【原创不易,请尊重版权】

未经授权,禁止复制转载。【转载请注明来源】【版权所有】唐霜 www.tangshuang.net

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

【未经授权禁止转载】【本文首发于唐霜的博客】【转载请注明来源】

通过处理之后,this 上会多出 thi著作权归作者所有,禁止商业用途转载。【版权所有】唐霜 www.tangshuang.nets.className 和 this.s著作权归作者所有,禁止商业用途转载。著作权归作者所有,禁止商业用途转载。tyle,你可以在 render 中使用著作权归作者所有,禁止商业用途转载。未经授权,禁止复制转载。这两个属性。

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

chidlren本文作者:唐霜,转载请注明出处。

【本文首发于唐霜的博客】本文作者:唐霜,转载请注明出处。【本文首发于唐霜的博客】【转载请注明来源】

虽然你可以通过 this.props.c【关注微信公众号:wwwtangshuangnet】转载请注明出处:www.tangshuang.nethildren 读取,但 nautil 【访问 www.tangshuang.net 获取更多精彩内容】【版权所有】唐霜 www.tangshuang.net增加 this.children 帮你快【原创内容,转载请注明出处】【版权所有】唐霜 www.tangshuang.net速读取当前组件的内部组件。

【关注微信公众号:wwwtangshuangnet】【转载请注明来源】本文版权归作者所有,未经授权不得转载。

on:streams【关注微信公众号:wwwtangshuangnet】

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

Nautil 的事件属性可以像 reac著作权归作者所有,禁止商业用途转载。【本文受版权保护】t 的事件属性一样使用,但是名称会有不同原创内容,盗版必究。【访问 www.tangshuang.net 获取更多精彩内容】,例如 nautil 中不会有 onCl【访问 www.tangshuang.net 获取更多精彩内容】【原创内容,转载请注明出处】ick 属性,而是采用 onHit 作为原创内容,盗版必究。【原创不易,请尊重版权】替代。这是因为在跨平台开发时,我们将通过本文作者:唐霜,转载请注明出处。【未经授权禁止转载】新的名字统一不同平台的事件名字。

著作权归作者所有,禁止商业用途转载。本文作者:唐霜,转载请注明出处。未经授权,禁止复制转载。【版权所有,侵权必究】【访问 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 的时候,不仅会原创内容,盗版必究。本文版权归作者所有,未经授权不得转载。触发组件外部传入的 onHit 回调,而【版权所有】唐霜 www.tangshuang.net转载请注明出处:www.tangshuang.net且还会触发新增的两个订阅,这使得关于事件【原创不易,请尊重版权】著作权归作者所有,禁止商业用途转载。的管理可分离后进行。

未经授权,禁止复制转载。【版权所有,侵权必究】原创内容,盗版必究。【作者:唐霜】【原创不易,请尊重版权】

对于事件的传入,有 3 种形式:【未经授权禁止转载】

本文版权归作者所有,未经授权不得转载。【访问 www.tangshuang.net 获取更多精彩内容】【关注微信公众号:wwwtangshuangnet】转载请注明出处:www.tangshuang.net

这也就是 onHit$ 的魔力所在。我们本文作者:唐霜,转载请注明出处。【版权所有,侵权必究】用代码来演示怎么使用:

转载请注明出处:www.tangshuang.net原创内容,盗版必究。【原创不易,请尊重版权】本文作者:唐霜,转载请注明出处。
import { map } from 'rxjs/operators'

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

这种情况下必须注意,订阅函数必须被传入(【原创内容,转载请注明出处】未经授权,禁止复制转载。放在数组最后一个位置)。实际上,只传入一【版权所有】唐霜 www.tangshuang.net【原创不易,请尊重版权】个函数的情况,在内部实际上处理成数组对待【访问 www.tangshuang.net 获取更多精彩内容】转载请注明出处:www.tangshuang.net,只不过该数组只有一个元素,即该订阅函数【本文受版权保护】转载请注明出处:www.tangshuang.net。有关事件流、管道操作符等,请详细阅读 rxjs 的文档【未经授权禁止转载】了解如何使用。未经授权,禁止复制转载。

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

update【关注微信公众号:wwwtangshuangnet】

【本文受版权保护】【访问 www.tangshuang.net 获取更多精彩内容】转载请注明出处:www.tangshuang.net【版权所有】唐霜 www.tangshuang.net未经授权,禁止复制转载。

Nautil 组件上有一个 this.u【关注微信公众号:wwwtangshuangnet】未经授权,禁止复制转载。pdate 方法,用于更新当前组件。它有著作权归作者所有,禁止商业用途转载。未经授权,禁止复制转载。丰富的功能:

【原创不易,请尊重版权】【本文首发于唐霜的博客】【版权所有】唐霜 www.tangshuang.net著作权归作者所有,禁止商业用途转载。转载请注明出处:www.tangshuang.net

组件上同时存在如下四个方法用于更新:本文作者:唐霜,转载请注明出处。

【本文受版权保护】本文版权归作者所有,未经授权不得转载。【本文受版权保护】【访问 www.tangshuang.net 获取更多精彩内容】【关注微信公众号:wwwtangshuangnet】

在使用时,不需要使用 this.upda【版权所有】唐霜 www.tangshuang.net【作者:唐霜】te.bind(this) 这种方法进行【关注微信公众号:wwwtangshuangnet】未经授权,禁止复制转载。绑定,直接使用 this.update,著作权归作者所有,禁止商业用途转载。著作权归作者所有,禁止商业用途转载。 this.forceUpdate, t【转载请注明来源】【未经授权禁止转载】his.weakUpdate 即可,它自未经授权,禁止复制转载。【本文首发于唐霜的博客】己已经经过绑定了。

【作者:唐霜】【版权所有,侵权必究】【转载请注明来源】

生命周期本文作者:唐霜,转载请注明出处。

【本文受版权保护】【版权所有,侵权必究】【版权所有】唐霜 www.tangshuang.net

Nautil 组件的生命周期和 reac【转载请注明来源】未经授权,禁止复制转载。t 组件一致,在前文已经介绍过。

【未经授权禁止转载】【版权所有】唐霜 www.tangshuang.net原创内容,盗版必究。【转载请注明来源】

具体不同阶段的调用如下图演示:【作者:唐霜】

【原创不易,请尊重版权】【访问 www.tangshuang.net 获取更多精彩内容】本文作者:唐霜,转载请注明出处。本文版权归作者所有,未经授权不得转载。原创内容,盗版必究。

【本文受版权保护】转载请注明出处:www.tangshuang.net本文作者:唐霜,转载请注明出处。

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

著作权归作者所有,禁止商业用途转载。本文版权归作者所有,未经授权不得转载。【原创不易,请尊重版权】【版权所有】唐霜 www.tangshuang.net

Render【原创内容,转载请注明出处】

【访问 www.tangshuang.net 获取更多精彩内容】【访问 www.tangshuang.net 获取更多精彩内容】未经授权,禁止复制转载。【版权所有,侵权必究】转载请注明出处:www.tangshuang.net

在 nautil 中,你可以在 clas【访问 www.tangshuang.net 获取更多精彩内容】转载请注明出处:www.tangshuang.nets 组件中写 hooks 了,区别在于,未经授权,禁止复制转载。著作权归作者所有,禁止商业用途转载。你需要用 Render(props) 代替 原创内容,盗版必究。render()。在 Render 中你仍然可以使用 t【原创不易,请尊重版权】未经授权,禁止复制转载。his 来调用组件 class 上写的方【本文受版权保护】【原创内容,转载请注明出处】法。例如:

转载请注明出处:www.tangshuang.net【未经授权禁止转载】【访问 www.tangshuang.net 获取更多精彩内容】著作权归作者所有,禁止商业用途转载。
class MyComponent extends Component {
  Render(props) {
    const [state, setState] = useState(0)
    const some = this.getSome() // 可以调用 this 上的方法
    ...
  }
}

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

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

状态管理原创内容,盗版必究。

【访问 www.tangshuang.net 获取更多精彩内容】转载请注明出处:www.tangshuang.net【版权所有】唐霜 www.tangshuang.net

现在,你需要忘掉 redux,它实在是太【原创不易,请尊重版权】转载请注明出处:www.tangshuang.net冗余了,像一个笨拙的大象,匍匐在 rea原创内容,盗版必究。原创内容,盗版必究。ct 这个汗血宝马身上。我们在 reac【原创不易,请尊重版权】【转载请注明来源】t 开发中为什么需要一个可全局使用的数据【转载请注明来源】著作权归作者所有,禁止商业用途转载。存储器,这个问题相信你已经很清楚了吧。N【关注微信公众号:wwwtangshuangnet】【原创不易,请尊重版权】autil 提供了极其轻便的 Store【访问 www.tangshuang.net 获取更多精彩内容】原创内容,盗版必究。 用于管理全局数据。

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

Store【版权所有】唐霜 www.tangshuang.net

【原创不易,请尊重版权】本文版权归作者所有,未经授权不得转载。【本文受版权保护】本文版权归作者所有,未经授权不得转载。

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

未经授权,禁止复制转载。【本文首发于唐霜的博客】【转载请注明来源】【关注微信公众号:wwwtangshuangnet】

创建 Store 极为简单。你只需要传入【关注微信公众号:wwwtangshuangnet】【作者:唐霜】一个默认值即可。你甚至可以传入一个空对象【版权所有】唐霜 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 的所有能力,极其简【关注微信公众号:wwwtangshuangnet】本文作者:唐霜,转载请注明出处。单(源码),且拥有魔法。

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

结合组件使用【原创内容,转载请注明出处】

【未经授权禁止转载】【本文首发于唐霜的博客】未经授权,禁止复制转载。本文作者:唐霜,转载请注明出处。

在 Nautil 中你必须结合组件使用 【转载请注明来源】【原创内容,转载请注明出处】Store,以发挥它的效果。这里面涉及到【本文首发于唐霜的博客】【作者:唐霜】监听 Store 变化和重新渲染。实际上【版权所有】唐霜 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【版权所有,侵权必究】未经授权,禁止复制转载。rigger 之间共享了同一个 stor未经授权,禁止复制转载。【本文受版权保护】e,它们都能够根据 store 中 st未经授权,禁止复制转载。本文作者:唐霜,转载请注明出处。ate 的变化来重新渲染界面。

【关注微信公众号:wwwtangshuangnet】本文作者:唐霜,转载请注明出处。【转载请注明来源】本文版权归作者所有,未经授权不得转载。【转载请注明来源】

除了使用 Consumer 来渲染子组件【作者:唐霜】转载请注明出处:www.tangshuang.net外,你也可以使用 connect 来封装【本文受版权保护】未经授权,禁止复制转载。

【版权所有,侵权必究】著作权归作者所有,禁止商业用途转载。【原创内容,转载请注明出处】【本文受版权保护】【版权所有,侵权必究】
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【版权所有】唐霜 www.tangshuang.net【关注微信公众号:wwwtangshuangnet】p 函数,用以接收 store,并返回一【关注微信公众号:wwwtangshuangnet】【本文受版权保护】个对象,这个对象将被增加到 props 转载请注明出处:www.tangshuang.net【原创不易,请尊重版权】上传给被封装的组件。而实际上,这个 ma本文作者:唐霜,转载请注明出处。本文作者:唐霜,转载请注明出处。p 也可以传给 Consumer 组件,未经授权,禁止复制转载。【版权所有,侵权必究】例如:

转载请注明出处:www.tangshuang.net【版权所有,侵权必究】【原创不易,请尊重版权】
<Consumer map={store => ({ ... })}>
  ...
</Consumer>

connect 的第二个参数是一个 wa【原创不易,请尊重版权】本文作者:唐霜,转载请注明出处。tch 数组,用以决定当发现 store【未经授权禁止转载】【访问 www.tangshuang.net 获取更多精彩内容】 中 state 的哪些属性发生变化时,本文作者:唐霜,转载请注明出处。转载请注明出处:www.tangshuang.net才对内部进行重新渲染。同样,这个 wat本文版权归作者所有,未经授权不得转载。原创内容,盗版必究。ch 也可以传给 Consumer:

未经授权,禁止复制转载。原创内容,盗版必究。著作权归作者所有,禁止商业用途转载。
<Consumer map={store => ({ ... })} watch={['a']}>
   ...
</Consumer>

局部状态共享【作者:唐霜】

【未经授权禁止转载】【本文首发于唐霜的博客】原创内容,盗版必究。【本文受版权保护】著作权归作者所有,禁止商业用途转载。

有时候,我们不需要在整个应用共享一个 s【未经授权禁止转载】本文版权归作者所有,未经授权不得转载。tore,我们只需要在一个小范围内共享一【未经授权禁止转载】本文作者:唐霜,转载请注明出处。个 store。此时,我们可以用到比较小【关注微信公众号:wwwtangshuangnet】本文版权归作者所有,未经授权不得转载。巧的一些方案。

本文作者:唐霜,转载请注明出处。未经授权,禁止复制转载。转载请注明出处:www.tangshuang.net本文版权归作者所有,未经授权不得转载。

第一种,使用 【版权所有】唐霜 www.tangshuang.netuseStore hooks 函数:本文版权归作者所有,未经授权不得转载。

著作权归作者所有,禁止商业用途转载。【原创不易,请尊重版权】原创内容,盗版必究。【转载请注明来源】
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.nettch 可以直接解构出来使用,所以上面的转载请注明出处:www.tangshuang.net本文作者:唐霜,转载请注明出处。这段代码看上去非常优雅。它的第二个参数是【转载请注明来源】未经授权,禁止复制转载。上文提到的 watch 列表,有助于我们【版权所有,侵权必究】【本文受版权保护】缩小观察的范围,提升性能。

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

第二种,使用 applyStore 创建【版权所有,侵权必究】原创内容,盗版必究。共享函数。

未经授权,禁止复制转载。未经授权,禁止复制转载。本文版权归作者所有,未经授权不得转载。【原创不易,请尊重版权】
import { applyStore } from 'nautil'

const { useStore, connect } = applyStore(store)

这里的 著作权归作者所有,禁止商业用途转载。useStore 和上面的 useStore 异曲同工之【未经授权禁止转载】原创内容,盗版必究。妙,只是不再传入 store 作为参数。本文作者:唐霜,转载请注明出处。著作权归作者所有,禁止商业用途转载。而 connect 也是一样的,观察的是【访问 www.tangshuang.net 获取更多精彩内容】【原创内容,转载请注明出处】这里传入的 store,而非 Provi著作权归作者所有,禁止商业用途转载。【原创内容,转载请注明出处】der 提供的 store。

【版权所有,侵权必究】【关注微信公众号:wwwtangshuangnet】【版权所有,侵权必究】【关注微信公众号:wwwtangshuangnet】【版权所有,侵权必究】

通过上面两种方法,我们非常灵活的在几个组【未经授权禁止转载】未经授权,禁止复制转载。件小范围内的共享一个 store 来控制【原创不易,请尊重版权】原创内容,盗版必究。状态变化。

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

导航/路由【转载请注明来源】

未经授权,禁止复制转载。【版权所有】唐霜 www.tangshuang.net未经授权,禁止复制转载。

对于一个框架而言,路由是必须要解决的。r【本文首发于唐霜的博客】【版权所有,侵权必究】eact 虽然是一个优秀的 UI 库,却转载请注明出处:www.tangshuang.net【作者:唐霜】无法满足开发者对应用开发的所有需求。包括著作权归作者所有,禁止商业用途转载。【未经授权禁止转载】路由在内的其他应用部件它都没有提供。为了著作权归作者所有,禁止商业用途转载。【本文首发于唐霜的博客】解决这个痛点,Nautil 并没有直接采【转载请注明来源】未经授权,禁止复制转载。纳 react-router 等第三方组【版权所有,侵权必究】【转载请注明来源】件,而是将提供一个路由方案。

【访问 www.tangshuang.net 获取更多精彩内容】【关注微信公众号:wwwtangshuangnet】【原创不易,请尊重版权】原创内容,盗版必究。本文作者:唐霜,转载请注明出处。

Navigation【本文受版权保护】

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

导航器,对于应用来说是用户得以在不同界面著作权归作者所有,禁止商业用途转载。【原创不易,请尊重版权】之间切换的重要部分。对于开发者而言,也可【访问 www.tangshuang.net 获取更多精彩内容】【转载请注明来源】以通过导航快速了解应用都是由哪些界面组成【本文受版权保护】转载请注明出处:www.tangshuang.net的。

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

然而,react-router 提供了一本文版权归作者所有,未经授权不得转载。著作权归作者所有,禁止商业用途转载。种将路由组件化的开发方式,这种方式值得学【未经授权禁止转载】【关注微信公众号:wwwtangshuangnet】习。但和 redux 一样,由于它默认认著作权归作者所有,禁止商业用途转载。【关注微信公众号:wwwtangshuangnet】为一个应用只会有一个 react 应用实本文作者:唐霜,转载请注明出处。本文版权归作者所有,未经授权不得转载。例。另外,不同的平台上,也需要不同的路由本文版权归作者所有,未经授权不得转载。【关注微信公众号:wwwtangshuangnet】管理来解决问题。为此,我们提供了统一的导本文版权归作者所有,未经授权不得转载。本文版权归作者所有,未经授权不得转载。航器。

本文作者:唐霜,转载请注明出处。原创内容,盗版必究。未经授权,禁止复制转载。【关注微信公众号:wwwtangshuangnet】
import { Navigation } from 'nautil'

我们通过 Navigation 创建一个【版权所有】唐霜 www.tangshuang.net【版权所有】唐霜 www.tangshuang.net导航器实例,可以被任何 nautil 应本文版权归作者所有,未经授权不得转载。本文作者:唐霜,转载请注明出处。用使用。

【版权所有】唐霜 www.tangshuang.net著作权归作者所有,禁止商业用途转载。原创内容,盗版必究。【作者:唐霜】【转载请注明来源】
const navigation = new Navigation(config)

这里需要注意,一个应用一般只有一个导航器原创内容,盗版必究。著作权归作者所有,禁止商业用途转载。,但是,Nautil 允许一个程序中存在【版权所有】唐霜 www.tangshuang.net本文版权归作者所有,未经授权不得转载。多个应用。

【原创内容,转载请注明出处】未经授权,禁止复制转载。【原创不易,请尊重版权】

配置【未经授权禁止转载】

未经授权,禁止复制转载。【作者:唐霜】转载请注明出处:www.tangshuang.net本文版权归作者所有,未经授权不得转载。【原创内容,转载请注明出处】

我们来看下如何进行配置。对于不同的平台,【版权所有】唐霜 www.tangshuang.net【未经授权禁止转载】配置几乎是一样的,有些选项,在 web 【未经授权禁止转载】未经授权,禁止复制转载。平台上生效,在其他平台不生效。

【版权所有】唐霜 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 的目标平台不单单包含本文版权归作者所有,未经授权不得转载。著作权归作者所有,禁止商业用途转载。 web,因此,导航系统实际上的工作模式原创内容,盗版必究。本文作者:唐霜,转载请注明出处。要依赖不同平台的能力。实际上,navig【转载请注明来源】原创内容,盗版必究。ation 支持 4 种模式运行:

【原创不易,请尊重版权】【版权所有】唐霜 www.tangshuang.net【未经授权禁止转载】【关注微信公众号:wwwtangshuangnet】

后三种都依赖于浏览器的 URL 进行识别本文作者:唐霜,转载请注明出处。本文版权归作者所有,未经授权不得转载。和控制。但即使在浏览器种,我们也可以使用本文版权归作者所有,未经授权不得转载。【版权所有,侵权必究】内存模式,让界面的变化不依赖于浏览器 U【作者:唐霜】【访问 www.tangshuang.net 获取更多精彩内容】RL 的控制。

转载请注明出处:www.tangshuang.net未经授权,禁止复制转载。著作权归作者所有,禁止商业用途转载。著作权归作者所有,禁止商业用途转载。

在配置选项中,你可以直接将对应的页面组件著作权归作者所有,禁止商业用途转载。【版权所有】唐霜 www.tangshuang.net配置到路由中。这个部分会在下文 Navi【原创内容,转载请注明出处】原创内容,盗版必究。gator 中讲解。

本文作者:唐霜,转载请注明出处。【本文首发于唐霜的博客】未经授权,禁止复制转载。【转载请注明来源】

state 和 status【转载请注明来源】

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

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

【版权所有】唐霜 www.tangshuang.net【访问 www.tangshuang.net 获取更多精彩内容】【本文首发于唐霜的博客】未经授权,禁止复制转载。著作权归作者所有,禁止商业用途转载。

监听导航变化【版权所有】唐霜 www.tangshuang.net

【关注微信公众号:wwwtangshuangnet】【版权所有,侵权必究】本文作者:唐霜,转载请注明出处。【本文首发于唐霜的博客】

对于 Navigation 实例而言,我【版权所有】唐霜 www.tangshuang.net【本文受版权保护】们可以通过 on 方法对它进行监听,当导著作权归作者所有,禁止商业用途转载。【原创内容,转载请注明出处】航到一个新的路由时,对应的监听回调会被执【版权所有】唐霜 www.tangshuang.net未经授权,禁止复制转载。行,(一般发生在 $onEnter 之后转载请注明出处:www.tangshuang.net著作权归作者所有,禁止商业用途转载。),通过 off 方法解除监听。

著作权归作者所有,禁止商业用途转载。【未经授权禁止转载】【关注微信公众号:wwwtangshuangnet】【本文首发于唐霜的博客】本文版权归作者所有,未经授权不得转载。
navigation.on('home', state => console.log(state), exact)

监听的对象有:【作者:唐霜】

本文版权归作者所有,未经授权不得转载。【版权所有】唐霜 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 中使用本文作者:唐霜,转载请注明出处。转载请注明出处:www.tangshuang.net导航器的监听功能,可以实现根据导航的变化【原创不易,请尊重版权】【转载请注明来源】而切换页面。

本文作者:唐霜,转载请注明出处。原创内容,盗版必究。【访问 www.tangshuang.net 获取更多精彩内容】原创内容,盗版必究。

事件未经授权,禁止复制转载。

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

事件的监听也是通过 on 方法,只不过事未经授权,禁止复制转载。著作权归作者所有,禁止商业用途转载。件监听时有特殊的标识,所有事件名称以 $【版权所有】唐霜 www.tangshuang.net【本文首发于唐霜的博客】 开头,从而和路由分开。

本文作者:唐霜,转载请注明出处。【原创内容,转载请注明出处】转载请注明出处:www.tangshuang.net本文版权归作者所有,未经授权不得转载。

is未经授权,禁止复制转载。

【未经授权禁止转载】【转载请注明来源】【本文首发于唐霜的博客】本文版权归作者所有,未经授权不得转载。

在 Navigation 实例上存在一个【作者:唐霜】本文作者:唐霜,转载请注明出处。 is 方法,用于判定当前的导航器状态是【版权所有,侵权必究】【作者:唐霜】否和传入的参数匹配。

【版权所有】唐霜 www.tangshuang.net本文作者:唐霜,转载请注明出处。著作权归作者所有,禁止商业用途转载。本文作者:唐霜,转载请注明出处。未经授权,禁止复制转载。
if (navigation.is(match, exact)) {}

判定当前的导航器状态是否和传入的 mat【本文首发于唐霜的博客】【未经授权禁止转载】ch 匹配。

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

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

本文作者:唐霜,转载请注明出处。【本文受版权保护】【访问 www.tangshuang.net 获取更多精彩内容】

Navigator【版权所有】唐霜 www.tangshuang.net

【版权所有,侵权必究】转载请注明出处:www.tangshuang.net本文版权归作者所有,未经授权不得转载。本文版权归作者所有,未经授权不得转载。

在 Nautil 中你可以使用 Obse著作权归作者所有,禁止商业用途转载。原创内容,盗版必究。rver 组件来使用观察者模式,通过订阅【版权所有,侵权必究】【版权所有,侵权必究】 navigation 实例来达到根据路本文作者:唐霜,转载请注明出处。【关注微信公众号:wwwtangshuangnet】由切换页面的目的,但是,实践起来会非常麻本文作者:唐霜,转载请注明出处。【关注微信公众号:wwwtangshuangnet】烦。Nautil 内置了导航相关的组件:【原创不易,请尊重版权】【版权所有,侵权必究】Navigator, Route, Na本文作者:唐霜,转载请注明出处。【版权所有,侵权必究】vigate,从而让你更方便的使用。

【原创内容,转载请注明出处】【本文首发于唐霜的博客】转载请注明出处:www.tangshuang.net著作权归作者所有,禁止商业用途转载。

导航者组件(Navigator)创建一个著作权归作者所有,禁止商业用途转载。【原创内容,转载请注明出处】区域,用于在这个区域中,根据导航器状态来【版权所有,侵权必究】【转载请注明来源】切换界面。

【版权所有】唐霜 www.tangshuang.net本文作者:唐霜,转载请注明出处。【版权所有】唐霜 www.tangshuang.net
import { Navigator } from 'nautil/components'

这个组件的作用是创建一个区域,这个区域内【本文首发于唐霜的博客】【本文首发于唐霜的博客】按照路由规则来进行。

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

Navigator 的渲染有 3 种方式【转载请注明来源】【未经授权禁止转载】。在进行渲染的时候,按照这 3 种方式顺原创内容,盗版必究。【本文首发于唐霜的博客】序检查,如果存在某一种方式的时候,就直接【转载请注明来源】转载请注明出处:www.tangshuang.net使用该方式进行渲染。

【原创不易,请尊重版权】著作权归作者所有,禁止商业用途转载。未经授权,禁止复制转载。【访问 www.tangshuang.net 获取更多精彩内容】

配置式渲染著作权归作者所有,禁止商业用途转载。

【转载请注明来源】原创内容,盗版必究。【本文首发于唐霜的博客】【本文首发于唐霜的博客】未经授权,禁止复制转载。

当开启 inside 属性时,它会去读取【作者:唐霜】【版权所有】唐霜 www.tangshuang.net navigation 配置上的 rou转载请注明出处:www.tangshuang.net本文版权归作者所有,未经授权不得转载。te.component,使用该配置进行转载请注明出处:www.tangshuang.net【原创不易,请尊重版权】渲染,并忽略掉内部元素。

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

此时不需要传入 dispatch 属性。

【本文受版权保护】转载请注明出处:www.tangshuang.net原创内容,盗版必究。【原创不易,请尊重版权】
const navigation = new Navigation({
  routes: [
    {
      name: 'home',
      path: '/home',
      component: Home, // 使用哪个组件渲染 home 这个 route
      props: { title: 'Home' }, // 渲染时给 component 传入什么 props
      animation: 600,
    },
  ],
  notFound: NotFound, // 未匹配路径时渲染哪一个组件
})

这种配置方法,有点像 vue-route著作权归作者所有,禁止商业用途转载。【版权所有,侵权必究】r 或 ui-router 的做法,即 本文版权归作者所有,未经授权不得转载。【转载请注明来源】navigation 本身已经包含了路由转载请注明出处:www.tangshuang.net【本文受版权保护】渲染。配置式渲染时,这些组件会在 pro【转载请注明来源】【版权所有】唐霜 www.tangshuang.netps 中接收一个 navigation。

【访问 www.tangshuang.net 获取更多精彩内容】【未经授权禁止转载】【版权所有,侵权必究】未经授权,禁止复制转载。

函数式渲染【本文受版权保护】

【本文受版权保护】【作者:唐霜】【转载请注明来源】本文版权归作者所有,未经授权不得转载。

当 Navigator 的 childr本文版权归作者所有,未经授权不得转载。【版权所有】唐霜 www.tangshuang.neten 是一个函数时,使用该函数渲染界面。未经授权,禁止复制转载。【关注微信公众号:wwwtangshuangnet】该函数将接收 navigation.

本文版权归作者所有,未经授权不得转载。【原创不易,请尊重版权】未经授权,禁止复制转载。
<Navigator navigation={navigation}>
  {Navi}
</Navigator>

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

这里创建了一个函数 Navi 用以在 N【本文受版权保护】【关注微信公众号:wwwtangshuangnet】avigator 中使用。由于函数接收一【原创内容,转载请注明出处】【未经授权禁止转载】个对象,里面包含 navigation,【本文受版权保护】本文版权归作者所有,未经授权不得转载。因此,可以对那些只接收 navigati【原创内容,转载请注明出处】【作者:唐霜】on 的函数组件实现复用。

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

函数式渲染无需传 dispatch 属性【版权所有】唐霜 www.tangshuang.net【本文首发于唐霜的博客】。在每次导航器状态发生变化时,都会重新执【本文首发于唐霜的博客】著作权归作者所有,禁止商业用途转载。行一次,得到需要的渲染结果。由于每次变动【版权所有】唐霜 www.tangshuang.net【关注微信公众号:wwwtangshuangnet】都就执行,性能上偏弱。

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

元素式渲染本文版权归作者所有,未经授权不得转载。

【作者:唐霜】转载请注明出处:www.tangshuang.net【本文首发于唐霜的博客】

当 Navigator 里面有独立的 j【版权所有】唐霜 www.tangshuang.net本文版权归作者所有,未经授权不得转载。sx 片段时,会被直接采用。

【版权所有】唐霜 www.tangshuang.net本文作者:唐霜,转载请注明出处。著作权归作者所有,禁止商业用途转载。本文版权归作者所有,未经授权不得转载。转载请注明出处:www.tangshuang.net
<Navigator navigation={navigation} dispatch={this.update}>
   <Route match="home" component={Home} />
   <Route match="page1" component={Page1} />
   <Route match="!" component={NotFound} />
</Navigator>

此时的 Navigator 仅仅像是一个【本文首发于唐霜的博客】未经授权,禁止复制转载。简写版的 Observer,它内部展示什著作权归作者所有,禁止商业用途转载。【未经授权禁止转载】么内容完全没有约束,你不一定要使用 Ro【本文首发于唐霜的博客】【本文首发于唐霜的博客】ute 来进行路由,甚至可以使用 Swi【访问 www.tangshuang.net 获取更多精彩内容】本文版权归作者所有,未经授权不得转载。tch-Case 组件来完成路由。

未经授权,禁止复制转载。【本文受版权保护】著作权归作者所有,禁止商业用途转载。【关注微信公众号:wwwtangshuangnet】【未经授权禁止转载】

此时,必须传入 dispatch 属性,【版权所有】唐霜 www.tangshuang.net【转载请注明来源】用以更新界面。

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

 【访问 www.tangshuang.net 获取更多精彩内容】

【本文受版权保护】原创内容,盗版必究。本文版权归作者所有,未经授权不得转载。

以上三种渲染方式具有先后顺序,如果对于一【版权所有】唐霜 www.tangshuang.net【本文受版权保护】个 Navigator 而言,两种或以上原创内容,盗版必究。【本文受版权保护】方式同时存在时,优先选用第一种,其次第二【版权所有,侵权必究】本文版权归作者所有,未经授权不得转载。种,最后才是配置式。

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

自动污染【版权所有】唐霜 www.tangshuang.net

未经授权,禁止复制转载。【原创内容,转载请注明出处】转载请注明出处:www.tangshuang.net未经授权,禁止复制转载。【原创内容,转载请注明出处】

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

【本文首发于唐霜的博客】本文版权归作者所有,未经授权不得转载。【关注微信公众号:wwwtangshuangnet】【本文首发于唐霜的博客】转载请注明出处:www.tangshuang.net

Route转载请注明出处:www.tangshuang.net

【作者:唐霜】著作权归作者所有,禁止商业用途转载。【原创不易,请尊重版权】【转载请注明来源】著作权归作者所有,禁止商业用途转载。

路由组件,用以根据 navigation【原创内容,转载请注明出处】【原创不易,请尊重版权】 的当前状态,决定使用什么内容进行渲染。

【关注微信公众号:wwwtangshuangnet】【未经授权禁止转载】【访问 www.tangshuang.net 获取更多精彩内容】著作权归作者所有,禁止商业用途转载。【未经授权禁止转载】
import { Route } from 'nautil/components'

参数【本文受版权保护】

原创内容,盗版必究。【本文受版权保护】著作权归作者所有,禁止商业用途转载。原创内容,盗版必究。

它接收如下属性:【作者:唐霜】

【本文首发于唐霜的博客】转载请注明出处:www.tangshuang.net本文作者:唐霜,转载请注明出处。转载请注明出处:www.tangshuang.net
<Route navigation={navigation} match={/book\/[0-9]+/}>
  <Book id={navigation.state.params.id} />
</Route>

注:如果在 Navigator 内部使用【未经授权禁止转载】【原创内容,转载请注明出处】 Route,则无需传入 navigat【原创内容,转载请注明出处】转载请注明出处:www.tangshuang.netion,Navigator 会自动污染 本文版权归作者所有,未经授权不得转载。原创内容,盗版必究。Route。

【版权所有,侵权必究】【作者:唐霜】原创内容,盗版必究。

组件式渲染本文版权归作者所有,未经授权不得转载。

本文作者:唐霜,转载请注明出处。著作权归作者所有,禁止商业用途转载。【关注微信公众号:wwwtangshuangnet】原创内容,盗版必究。

通过传入 component 属性,让 【访问 www.tangshuang.net 获取更多精彩内容】【转载请注明来源】Route 知道使用什么组件进行渲染。此【版权所有,侵权必究】【版权所有】唐霜 www.tangshuang.net时接收 component 和 prop【未经授权禁止转载】本文版权归作者所有,未经授权不得转载。s 这两个属性:

【原创不易,请尊重版权】【作者:唐霜】【版权所有】唐霜 www.tangshuang.net【本文首发于唐霜的博客】著作权归作者所有,禁止商业用途转载。
<Route navigation={navigation} match="some" component={Some} props={{ title: 'Some' }}>
  <Text>children</Text>
</Route>

props 是可选的,需要的时候才传入。【未经授权禁止转载】未经授权,禁止复制转载。同时 Some 会接收到一个 navig【版权所有,侵权必究】原创内容,盗版必究。ation 的 props,Some 组【本文受版权保护】原创内容,盗版必究。件可以利用该实例做一些判断。另外,还能接转载请注明出处:www.tangshuang.net【原创不易,请尊重版权】收内部的 children 到 comp【原创内容,转载请注明出处】【版权所有】唐霜 www.tangshuang.netonent 中使用。

【本文首发于唐霜的博客】著作权归作者所有,禁止商业用途转载。【本文受版权保护】

函数式渲染原创内容,盗版必究。

本文作者:唐霜,转载请注明出处。【本文受版权保护】未经授权,禁止复制转载。【关注微信公众号:wwwtangshuangnet】

和 Navigator 很像,在 Rou本文版权归作者所有,未经授权不得转载。【访问 www.tangshuang.net 获取更多精彩内容】te 内部只有一个函数时,将使用该函数进著作权归作者所有,禁止商业用途转载。本文作者:唐霜,转载请注明出处。行渲染。

【访问 www.tangshuang.net 获取更多精彩内容】转载请注明出处:www.tangshuang.net【作者:唐霜】【访问 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 元素。【关注微信公众号:wwwtangshuangnet】

转载请注明出处:www.tangshuang.net著作权归作者所有,禁止商业用途转载。【未经授权禁止转载】未经授权,禁止复制转载。
<Route navigation={navigation} match="some">
  <Text>some</Text>
</Route>

配置式渲染【作者:唐霜】

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

和 Navigator 的配置式渲染很像【原创内容,转载请注明出处】【关注微信公众号:wwwtangshuangnet】,但是 Route 仅在 match 通【原创不易,请尊重版权】【版权所有,侵权必究】过的情况下读取当前被访问的路由的 com原创内容,盗版必究。【版权所有】唐霜 www.tangshuang.netponent 配置进行渲染。

【原创不易,请尊重版权】本文版权归作者所有,未经授权不得转载。【原创不易,请尊重版权】原创内容,盗版必究。【作者:唐霜】
<Route navigation={navigation} match="some" />

在 navigation 配置中如下配置原创内容,盗版必究。【版权所有,侵权必究】

【作者:唐霜】【版权所有】唐霜 www.tangshuang.net未经授权,禁止复制转载。本文版权归作者所有,未经授权不得转载。
{
  routes: [
    {
      name: 'some',
      patch: '/some',
      component: Some,
      props: { title: 'some' },
    },
  ],
}

Some 组件也会被注入一个名为 nav本文作者:唐霜,转载请注明出处。原创内容,盗版必究。igation 的 props。

本文作者:唐霜,转载请注明出处。原创内容,盗版必究。转载请注明出处:www.tangshuang.net

动画【未经授权禁止转载】

转载请注明出处:www.tangshuang.net转载请注明出处:www.tangshuang.net【作者:唐霜】【关注微信公众号:wwwtangshuangnet】

在大部分应用中,切换界面时,有动画转场的【访问 www.tangshuang.net 获取更多精彩内容】【版权所有】唐霜 www.tangshuang.net需求。此时,我们可以通过 Route 的【访问 www.tangshuang.net 获取更多精彩内容】【版权所有,侵权必究】 animation 属性搭配内部动画组件来实现。本文版权归作者所有,未经授权不得转载。

未经授权,禁止复制转载。未经授权,禁止复制转载。著作权归作者所有,禁止商业用途转载。【转载请注明来源】
<Route navigation={navigation} match="some" animation={600} />

animation 属性的作用有两个:著作权归作者所有,禁止商业用途转载。

【作者:唐霜】未经授权,禁止复制转载。【原创内容,转载请注明出处】本文作者:唐霜,转载请注明出处。【版权所有】唐霜 www.tangshuang.net

再结合下文要讲的 Animation 组【转载请注明来源】【转载请注明来源】件,我们可以实现我们自己的动画转场效果:

【关注微信公众号:wwwtangshuangnet】【本文受版权保护】著作权归作者所有,禁止商业用途转载。未经授权,禁止复制转载。转载请注明出处: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【版权所有】唐霜 www.tangshuang.net本文版权归作者所有,未经授权不得转载。ute 正好像组件注入了 show 属性本文版权归作者所有,未经授权不得转载。【本文首发于唐霜的博客】,所以正好可以搭配起来使用。

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

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

本文作者:唐霜,转载请注明出处。【作者:唐霜】原创内容,盗版必究。

可移植性著作权归作者所有,禁止商业用途转载。

原创内容,盗版必究。【本文首发于唐霜的博客】著作权归作者所有,禁止商业用途转载。本文版权归作者所有,未经授权不得转载。

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

转载请注明出处:www.tangshuang.net本文作者:唐霜,转载请注明出处。【关注微信公众号:wwwtangshuangnet】
<Navigate to="some">
  <Section><Text>Title</Text></Section>
  <Section><Text>content</Text></Section>
</Navigate>

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

【原创不易,请尊重版权】【未经授权禁止转载】未经授权,禁止复制转载。本文作者:唐霜,转载请注明出处。【本文首发于唐霜的博客】

你可以通过传入 component 属性【转载请注明来源】转载请注明出处:www.tangshuang.net来控制使用什么元素进行添加包裹。例如:

【原创内容,转载请注明出处】【关注微信公众号:wwwtangshuangnet】转载请注明出处:www.tangshuang.net【本文受版权保护】
<Navigate to="some" component={Button}>some</Navigate>

则会用一个 Button 包裹文本。只要【本文受版权保护】【访问 www.tangshuang.net 获取更多精彩内容】你传入了 component,那么内部元【访问 www.tangshuang.net 获取更多精彩内容】【本文受版权保护】素就会被作为子元素包裹在该组件内。传入 【原创内容,转载请注明出处】【本文受版权保护】component 时,支持传入 pro【原创内容,转载请注明出处】【原创不易,请尊重版权】ps 属性,用于向 component 【关注微信公众号:wwwtangshuangnet】原创内容,盗版必究。传入属性。

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

Storage【访问 www.tangshuang.net 获取更多精彩内容】

【版权所有,侵权必究】【本文首发于唐霜的博客】【原创内容,转载请注明出处】【作者:唐霜】未经授权,禁止复制转载。

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

【原创不易,请尊重版权】【访问 www.tangshuang.net 获取更多精彩内容】【本文受版权保护】【作者:唐霜】

但是在使用时需要注意,Nautil 内置【版权所有,侵权必究】【原创不易,请尊重版权】的 Storage 是异步的,而非同步的【未经授权禁止转载】【本文受版权保护】,这一点一定要注意。

【版权所有】唐霜 www.tangshuang.net【作者:唐霜】【作者:唐霜】转载请注明出处:www.tangshuang.net【转载请注明来源】
import { Storage } from 'nautil'

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

该对象仅提供上述 3 个接口使用。未经授权,禁止复制转载。

著作权归作者所有,禁止商业用途转载。【本文首发于唐霜的博客】原创内容,盗版必究。

多语言国际化【本文受版权保护】

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

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

【本文首发于唐霜的博客】【本文受版权保护】著作权归作者所有,禁止商业用途转载。【原创内容,转载请注明出处】

在 Nautil 中提供了独立的 I18【本文首发于唐霜的博客】【本文首发于唐霜的博客】n 模块,该模块基于著名的 i18nex【访问 www.tangshuang.net 获取更多精彩内容】【版权所有】唐霜 www.tangshuang.nett 开发。

【版权所有】唐霜 www.tangshuang.net【原创不易,请尊重版权】【版权所有】唐霜 www.tangshuang.net
import { I18n, Language, T, Locale } from 'nautil/i18n'

I18n【原创内容,转载请注明出处】

本文版权归作者所有,未经授权不得转载。本文作者:唐霜,转载请注明出处。本文版权归作者所有,未经授权不得转载。【版权所有】唐霜 www.tangshuang.net原创内容,盗版必究。

通过 I18n 我们可以得到一个多语言控【版权所有】唐霜 www.tangshuang.net本文版权归作者所有,未经授权不得转载。制器示例。

【原创不易,请尊重版权】著作权归作者所有,禁止商业用途转载。转载请注明出处:www.tangshuang.net
const i18n = new I18n(config)

其中,config 完全遵循 i18ne【版权所有】唐霜 www.tangshuang.net转载请注明出处:www.tangshuang.netxt 的配置【原创不易,请尊重版权】。但是 i18n 的接口经过处理,比 i本文版权归作者所有,未经授权不得转载。【关注微信公众号:wwwtangshuangnet】18next 更好用:

【版权所有,侵权必究】【转载请注明来源】【版权所有】唐霜 www.tangshuang.net转载请注明出处:www.tangshuang.net【原创内容,转载请注明出处】

注意,对一门语言进行命名时,要遵循本文作者:唐霜,转载请注明出处。国际标准转载请注明出处:www.tangshuang.net。例如,中文一定要以 zh-CN 这种形【转载请注明来源】【版权所有,侵权必究】式命名。

本文版权归作者所有,未经授权不得转载。【关注微信公众号:wwwtangshuangnet】【本文受版权保护】

Language转载请注明出处:www.tangshuang.net

本文作者:唐霜,转载请注明出处。【作者:唐霜】本文作者:唐霜,转载请注明出处。

和 Navigator 的功能差不多,当本文作者:唐霜,转载请注明出处。【本文首发于唐霜的博客】一个应用需要对某个区域实行多语言时,需要原创内容,盗版必究。本文作者:唐霜,转载请注明出处。通过 Language 组件将其包起来。

【访问 www.tangshuang.net 获取更多精彩内容】转载请注明出处:www.tangshuang.net【关注微信公众号:wwwtangshuangnet】
<Language i18n={i18n} dispatch={this.update}>
  <SomeComponent />
</Language>

只有这样,当语言发生切换的时候,内部的所【访问 www.tangshuang.net 获取更多精彩内容】【访问 www.tangshuang.net 获取更多精彩内容】有本地化处理,才会更新。

转载请注明出处:www.tangshuang.net本文作者:唐霜,转载请注明出处。【本文首发于唐霜的博客】

另外,Language 和 Naviga【版权所有】唐霜 www.tangshuang.net【转载请注明来源】tor 一样,也会对其内部的 T, Lo【转载请注明来源】未经授权,禁止复制转载。cale 组件自动污染 i18n 属性,【本文受版权保护】【原创内容,转载请注明出处】因此,其内部的 T, Locale 组件本文作者:唐霜,转载请注明出处。【版权所有】唐霜 www.tangshuang.net不需要传 i18n. 但是还是那句老话,【版权所有,侵权必究】【作者:唐霜】为了组件的复用性,建议仍然传入 i18n【本文首发于唐霜的博客】本文作者:唐霜,转载请注明出处。 属性。

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

T本文作者:唐霜,转载请注明出处。

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

该组件用于翻译和显示语言文本。【版权所有,侵权必究】

原创内容,盗版必究。【版权所有,侵权必究】转载请注明出处:www.tangshuang.net
<T i18n={i18n} t="myHome">my home</T>

属性原创内容,盗版必究。

【原创内容,转载请注明出处】【版权所有】唐霜 www.tangshuang.net未经授权,禁止复制转载。【原创内容,转载请注明出处】

可接受的属性包含:转载请注明出处:www.tangshuang.net

【原创不易,请尊重版权】【本文首发于唐霜的博客】【版权所有,侵权必究】【作者:唐霜】

渲染转载请注明出处:www.tangshuang.net

本文版权归作者所有,未经授权不得转载。【访问 www.tangshuang.net 获取更多精彩内容】著作权归作者所有,禁止商业用途转载。

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原创内容,盗版必究。

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

该组件用于创建一个可切换语言的区域。转载请注明出处:www.tangshuang.net

本文版权归作者所有,未经授权不得转载。【原创内容,转载请注明出处】【版权所有,侵权必究】
<Locale i18n={i18n} to="zh-CN"><Button>切换至中文</Button></Locale>

它的渲染规则和 Navigate 非常像【转载请注明来源】【关注微信公众号:wwwtangshuangnet】

【本文首发于唐霜的博客】未经授权,禁止复制转载。【版权所有】唐霜 www.tangshuang.net

内置逻辑组件【原创内容,转载请注明出处】

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

在前文我们已经指出 Nautil 包含了本文作者:唐霜,转载请注明出处。本文版权归作者所有,未经授权不得转载。 4 类内置组件。本章主要讲解其中的“逻【版权所有】唐霜 www.tangshuang.net【未经授权禁止转载】辑组件”。逻辑组件的主要作用是进行逻辑控本文版权归作者所有,未经授权不得转载。【访问 www.tangshuang.net 获取更多精彩内容】制,根据不同的条件来决定是否渲染或如何渲【本文首发于唐霜的博客】转载请注明出处:www.tangshuang.net染其内部子组件。

【本文受版权保护】转载请注明出处:www.tangshuang.net著作权归作者所有,禁止商业用途转载。【关注微信公众号:wwwtangshuangnet】

条件逻辑组件【本文受版权保护】

【转载请注明来源】转载请注明出处:www.tangshuang.net【版权所有,侵权必究】

通过条件判断来决定组件的显示与隐藏。【原创不易,请尊重版权】

【关注微信公众号:wwwtangshuangnet】【本文首发于唐霜的博客】【关注微信公众号:wwwtangshuangnet】

If/ElseIf/Else【原创不易,请尊重版权】

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

代替 jsx 的 hyper 语法,用组【原创不易,请尊重版权】【本文受版权保护】件来控制,让 jsx 更纯粹。

【原创不易,请尊重版权】转载请注明出处: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【版权所有】唐霜 www.tangshuang.net

内部支持函数,以方便在某些情况下不应该对【原创内容,转载请注明出处】【关注微信公众号:wwwtangshuangnet】组件实例化时进行处理。

【转载请注明来源】【版权所有,侵权必究】原创内容,盗版必究。【关注微信公众号:wwwtangshuangnet】转载请注明出处:www.tangshuang.net
<If is={bool}>
  {() => <Text>should not init when loaded</Text}
</If>

Swich/Case【关注微信公众号:wwwtangshuangnet】

【原创不易,请尊重版权】未经授权,禁止复制转载。【关注微信公众号:wwwtangshuangnet】

也是用于条件控制的组件。【转载请注明来源】

转载请注明出处:www.tangshuang.net原创内容,盗版必究。【访问 www.tangshuang.net 获取更多精彩内容】转载请注明出处:www.tangshuang.net
<Switch of={value}>
  <Case is={target} render={() => 
    <Text>target</Text>
  } />
  <Case defualt render={() =>
    <Text>default</Text>
  } />
</Switch>

Case 内部支持函数,用以避免组件实例著作权归作者所有,禁止商业用途转载。著作权归作者所有,禁止商业用途转载。化时,被立即执行。

【版权所有】唐霜 www.tangshuang.net【未经授权禁止转载】【关注微信公众号:wwwtangshuangnet】【版权所有】唐霜 www.tangshuang.net转载请注明出处:www.tangshuang.net

Show【未经授权禁止转载】

转载请注明出处:www.tangshuang.net未经授权,禁止复制转载。【本文首发于唐霜的博客】本文作者:唐霜,转载请注明出处。

和 If 不同,Show 会立即渲染其内【本文首发于唐霜的博客】【版权所有,侵权必究】部自组件,但会通过 is 控制其显示或隐【本文首发于唐霜的博客】【原创不易,请尊重版权】藏。

原创内容,盗版必究。【转载请注明来源】【未经授权禁止转载】【未经授权禁止转载】【作者:唐霜】
<Show is={bool}>
  <Text>show me</Text>
</Show>

默认情况下,Show 会自己创建一个 S转载请注明出处:www.tangshuang.net【本文受版权保护】ection, 但它支持你传入 comp转载请注明出处:www.tangshuang.net本文版权归作者所有,未经授权不得转载。onent 属性来控制使用什么组件。

【未经授权禁止转载】【关注微信公众号:wwwtangshuangnet】【作者:唐霜】未经授权,禁止复制转载。【版权所有,侵权必究】

循环遍历组件原创内容,盗版必究。

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

下面的组件帮助你实现循环和遍历。【作者:唐霜】

【本文受版权保护】转载请注明出处:www.tangshuang.net本文版权归作者所有,未经授权不得转载。【关注微信公众号:wwwtangshuangnet】

For【原创内容,转载请注明出处】

【关注微信公众号:wwwtangshuangnet】【版权所有,侵权必究】【版权所有】唐霜 www.tangshuang.net【关注微信公众号:wwwtangshuangnet】

一个数字循环迭代组件。【转载请注明来源】

【未经授权禁止转载】转载请注明出处:www.tangshuang.net【关注微信公众号:wwwtangshuangnet】本文作者:唐霜,转载请注明出处。【作者:唐霜】
<For start={0} end={10} step={1} render={i => 
  <Text>{i}</Text>
} />

它也支持内部是一个普通元素,而非函数,这转载请注明出处:www.tangshuang.net【未经授权禁止转载】样就可以重复显示该内部子元素。

【原创不易,请尊重版权】【访问 www.tangshuang.net 获取更多精彩内容】【原创不易,请尊重版权】【版权所有】唐霜 www.tangshuang.net

另外需要注意,For 会包含 end 值原创内容,盗版必究。【转载请注明来源】。也就是说上面会显示 0-10 这 11【本文首发于唐霜的博客】原创内容,盗版必究。 个数字。

【未经授权禁止转载】【未经授权禁止转载】著作权归作者所有,禁止商业用途转载。著作权归作者所有,禁止商业用途转载。

Each【关注微信公众号:wwwtangshuangnet】

【关注微信公众号:wwwtangshuangnet】【转载请注明来源】著作权归作者所有,禁止商业用途转载。【未经授权禁止转载】

一个对象遍历迭代组件。【版权所有】唐霜 www.tangshuang.net

【本文首发于唐霜的博客】【版权所有,侵权必究】转载请注明出处:www.tangshuang.net
<Each of={data} render={(value, key) => 
  <Text>{key}: {value}</Text>
} />

of 中可以传入对象或数组。原创内容,盗版必究。

【作者:唐霜】【未经授权禁止转载】转载请注明出处:www.tangshuang.net转载请注明出处:www.tangshuang.net

渲染控制组件转载请注明出处:www.tangshuang.net

原创内容,盗版必究。【版权所有】唐霜 www.tangshuang.net【关注微信公众号:wwwtangshuangnet】本文作者:唐霜,转载请注明出处。原创内容,盗版必究。

下面将介绍用于渲染控制的组件。原创内容,盗版必究。

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

Fragment本文作者:唐霜,转载请注明出处。

【作者:唐霜】【未经授权禁止转载】【版权所有,侵权必究】

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

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

Static【未经授权禁止转载】

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

静态渲染组件。内部必须是一个函数。接收 【关注微信公众号:wwwtangshuangnet】本文作者:唐霜,转载请注明出处。shouldUpdate 属性。

原创内容,盗版必究。【关注微信公众号:wwwtangshuangnet】本文作者:唐霜,转载请注明出处。【访问 www.tangshuang.net 获取更多精彩内容】【关注微信公众号:wwwtangshuangnet】
<Static shouldUpdate={bool} render={() => 
  <Text>{Date.now()}</Text>
} />

只有当 shouldUpdate 为 t原创内容,盗版必究。【未经授权禁止转载】rue 时,内部才会被更新,否则永远都不【版权所有,侵权必究】著作权归作者所有,禁止商业用途转载。会被更新。在一些特定场景下的交互非常有用原创内容,盗版必究。本文版权归作者所有,未经授权不得转载。

【未经授权禁止转载】【作者:唐霜】【关注微信公众号:wwwtangshuangnet】转载请注明出处:www.tangshuang.net【未经授权禁止转载】

Prepare本文版权归作者所有,未经授权不得转载。

【作者:唐霜】【关注微信公众号:wwwtangshuangnet】转载请注明出处:www.tangshuang.net本文作者:唐霜,转载请注明出处。转载请注明出处:www.tangshuang.net

准备渲染组件。当遇到一些异步,或动态变化【访问 www.tangshuang.net 获取更多精彩内容】【版权所有,侵权必究】时,你可能希望用一个 loading 效【版权所有】唐霜 www.tangshuang.net【作者:唐霜】果返回给用户。Prepare 组件用于实原创内容,盗版必究。转载请注明出处:www.tangshuang.net现该目的。

【本文受版权保护】【版权所有】唐霜 www.tangshuang.net【版权所有】唐霜 www.tangshuang.net本文作者:唐霜,转载请注明出处。【本文受版权保护】
<Prepare isReady={bool} loading={<Text>loading</Text>} render={() => 
  <Text>loaded</Text>
} />

它的内部支持函数和普通组件,但是函数仅在【版权所有】唐霜 www.tangshuang.net未经授权,禁止复制转载。 isReady 为 true 的情况下【原创不易,请尊重版权】原创内容,盗版必究。才执行,有助于我们拿到数据后进行渲染。

【本文首发于唐霜的博客】【关注微信公众号:wwwtangshuangnet】【版权所有,侵权必究】【本文受版权保护】转载请注明出处:www.tangshuang.net

Observer著作权归作者所有,禁止商业用途转载。

【访问 www.tangshuang.net 获取更多精彩内容】【未经授权禁止转载】【本文首发于唐霜的博客】本文作者:唐霜,转载请注明出处。

用于监听变动的组件,该组件是 Nauti原创内容,盗版必究。【作者:唐霜】l 中非常重要且核心的组件,因为它是实现【原创内容,转载请注明出处】【版权所有,侵权必究】 Nautil 中观察者模式的最主要助手【原创内容,转载请注明出处】【原创不易,请尊重版权】。它需要三个属性:

原创内容,盗版必究。著作权归作者所有,禁止商业用途转载。【转载请注明来源】未经授权,禁止复制转载。原创内容,盗版必究。
<Observer
  subscribe={dispatch => store.watch('*', dispatch)}
  unsubscribe={dispatch => store.unwatch('*', dispatch)}
  dispatch={this.update}
>
  <Text>{store.get('some')}</Text>
</Observer>

上面这个代码,演示了如何观察 store著作权归作者所有,禁止商业用途转载。本文作者:唐霜,转载请注明出处。 变化,并且更新视图渲染的过程。

【本文受版权保护】【原创不易,请尊重版权】【本文首发于唐霜的博客】

指令转载请注明出处:www.tangshuang.net

【关注微信公众号:wwwtangshuangnet】【本文受版权保护】【本文首发于唐霜的博客】

和 vue 中指令的概念不同。Nauti著作权归作者所有,禁止商业用途转载。原创内容,盗版必究。l 中的指令是用于修改 Componen【本文受版权保护】【转载请注明来源】t 默认行为方式的函数生成器。

【本文首发于唐霜的博客】转载请注明出处:www.tangshuang.net本文作者:唐霜,转载请注明出处。原创内容,盗版必究。【原创不易,请尊重版权】
import { inject, observe, pollute, connect, pipe } from 'nautil/operators'

指令的用法,和 react-redux 【原创不易,请尊重版权】原创内容,盗版必究。的 connect 函数非常像。一般先通未经授权,禁止复制转载。本文作者:唐霜,转载请注明出处。过指令创建一个 wrapper 函数,然本文版权归作者所有,未经授权不得转载。未经授权,禁止复制转载。后再用该函数去包裹目标组件。

【转载请注明来源】【作者:唐霜】【关注微信公众号:wwwtangshuangnet】

observe原创内容,盗版必究。

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

用于简化 Observer 操作的一个指本文版权归作者所有,未经授权不得转载。本文版权归作者所有,未经授权不得转载。令。它接收两个参数:subscribe 【本文受版权保护】【原创不易,请尊重版权】和 unsubscribe。

【本文受版权保护】转载请注明出处:www.tangshuang.net著作权归作者所有,禁止商业用途转载。

用法一:两个函数本文作者:唐霜,转载请注明出处。

著作权归作者所有,禁止商业用途转载。本文作者:唐霜,转载请注明出处。【作者:唐霜】【作者:唐霜】
const observeByStore = observer(
  dispatch => store.watch('*', dispatch), 
  dispatch => store.unwatch('*', dispatch)
)
const ObservedComponent = observeByStore(Component)

通过这种方式,你就不需要再在组件内写 O本文版权归作者所有,未经授权不得转载。【本文首发于唐霜的博客】bserver 操作了。

著作权归作者所有,禁止商业用途转载。本文版权归作者所有,未经授权不得转载。【作者:唐霜】转载请注明出处:www.tangshuang.net本文版权归作者所有,未经授权不得转载。

用法二:store/model著作权归作者所有,禁止商业用途转载。

【本文受版权保护】未经授权,禁止复制转载。【未经授权禁止转载】【本文受版权保护】原创内容,盗版必究。

而且 observe 指令支持直接传入 未经授权,禁止复制转载。【访问 www.tangshuang.net 获取更多精彩内容】store 和 model 实例,从而减【转载请注明来源】【版权所有,侵权必究】少麻烦的写作。

转载请注明出处:www.tangshuang.net【未经授权禁止转载】【转载请注明来源】
const observeByStore = observe(store)

这个时候,第二个参数可接收一个字符串,用【版权所有,侵权必究】【本文首发于唐霜的博客】于表示具体监听 store/model 【转载请注明来源】【转载请注明来源】上的哪一个属性。

【作者:唐霜】【访问 www.tangshuang.net 获取更多精彩内容】未经授权,禁止复制转载。
observe(store, 'age') // 监听 store 上的 age 属性

这样可以减小监听范围,但是,如果要监听多【版权所有】唐霜 www.tangshuang.net转载请注明出处:www.tangshuang.net个属性,就必须写多个 observe 指【关注微信公众号:wwwtangshuangnet】【访问 www.tangshuang.net 获取更多精彩内容】令语句。

未经授权,禁止复制转载。本文作者:唐霜,转载请注明出处。【未经授权禁止转载】

用法三:prop原创内容,盗版必究。

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

对于已知某个 prop 的值是 stor原创内容,盗版必究。未经授权,禁止复制转载。e 或 model 的,可以直接传入一个【未经授权禁止转载】【未经授权禁止转载】字符串,例如:

【原创不易,请尊重版权】转载请注明出处:www.tangshuang.net未经授权,禁止复制转载。【版权所有】唐霜 www.tangshuang.net
const observeByStore = observe('store')

而在这种情况下,也可以和用法二一样,传入【原创内容,转载请注明出处】本文版权归作者所有,未经授权不得转载。第二个参数为字符串,表示具体监听某个属性【版权所有】唐霜 www.tangshuang.net【版权所有,侵权必究】,例如:

【访问 www.tangshuang.net 获取更多精彩内容】本文版权归作者所有,未经授权不得转载。【本文受版权保护】本文作者:唐霜,转载请注明出处。
observe('store', 'age')

传入字符串的形式不推荐,一般只和其他指令【本文首发于唐霜的博客】未经授权,禁止复制转载。一起使用的时候才这样使用,例如:

【未经授权禁止转载】原创内容,盗版必究。未经授权,禁止复制转载。本文版权归作者所有,未经授权不得转载。
const wrap = pipe([
  initialize('model', Model),
  observe('model'), // 在已知 model 属性为 Model 实例的情况下使用,其他情况下不要使用
])

inject原创内容,盗版必究。

转载请注明出处:www.tangshuang.net本文版权归作者所有,未经授权不得转载。本文版权归作者所有,未经授权不得转载。【原创不易,请尊重版权】本文作者:唐霜,转载请注明出处。

像组件 props 中注入新的属性。【转载请注明来源】

【版权所有,侵权必究】本文作者:唐霜,转载请注明出处。【访问 www.tangshuang.net 获取更多精彩内容】
const injectState = inject('state', store.state)
const InjectedComponent = injectState(Component)

这样,组件将自动带上 state={st【未经授权禁止转载】转载请注明出处:www.tangshuang.netore.state} 这个属性。

【未经授权禁止转载】【关注微信公众号:wwwtangshuangnet】【关注微信公众号:wwwtangshuangnet】原创内容,盗版必究。【转载请注明来源】

inject 第二个参数支持函数,该函数未经授权,禁止复制转载。未经授权,禁止复制转载。接收组件本身的 props,你可以在该函【本文首发于唐霜的博客】【原创不易,请尊重版权】数中决定新增的 prop 值。

【版权所有】唐霜 www.tangshuang.net【版权所有】唐霜 www.tangshuang.net【未经授权禁止转载】【未经授权禁止转载】未经授权,禁止复制转载。

pollute未经授权,禁止复制转载。

转载请注明出处:www.tangshuang.net本文作者:唐霜,转载请注明出处。未经授权,禁止复制转载。转载请注明出处:www.tangshuang.net

污染组件内指定内嵌组件的 default【关注微信公众号:wwwtangshuangnet】【未经授权禁止转载】Props。

【本文首发于唐霜的博客】未经授权,禁止复制转载。【本文受版权保护】【访问 www.tangshuang.net 获取更多精彩内容】未经授权,禁止复制转载。
const polluteWithI18n = pollute(T, { i18n }) // 内部的所有 T 组件都会 defaultProps.i18n = i18n

需要注意,这里指的内嵌组件不单单包含被包【未经授权禁止转载】未经授权,禁止复制转载。裹组件内的子组件,而且包括往下任何深层级未经授权,禁止复制转载。著作权归作者所有,禁止商业用途转载。的后代组件。

【作者:唐霜】【本文首发于唐霜的博客】【关注微信公众号:wwwtangshuangnet】转载请注明出处:www.tangshuang.net【版权所有】唐霜 www.tangshuang.net

initialize转载请注明出处:www.tangshuang.net

本文作者:唐霜,转载请注明出处。【关注微信公众号:wwwtangshuangnet】著作权归作者所有,禁止商业用途转载。

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

本文作者:唐霜,转载请注明出处。【本文受版权保护】转载请注明出处:www.tangshuang.net本文作者:唐霜,转载请注明出处。
const wrap = initialize('some', Some, ...args) // Some 是一个 js 类,在内部,它会被实例化。第 3 个参数开始,会作为实例化时的默认参数传入
// 被包裹的组件将会有一个名字为 some 的 prop

之所以提供一个 initialize 指原创内容,盗版必究。本文作者:唐霜,转载请注明出处。令,是为了在某些情况下,我们希望只在组件【原创不易,请尊重版权】【转载请注明来源】实例化的时候同时实例化这个类,得到一个在【原创内容,转载请注明出处】【本文首发于唐霜的博客】组件内可用的实例,而非一个外部传入的公用【未经授权禁止转载】【本文首发于唐霜的博客】的实例。

【版权所有】唐霜 www.tangshuang.net原创内容,盗版必究。【作者:唐霜】【本文受版权保护】

比如说,我们希望组件在自己的生命周期里使【作者:唐霜】【版权所有】唐霜 www.tangshuang.net用一个独立的 store,我们可以这样子本文作者:唐霜,转载请注明出处。【版权所有,侵权必究】

【作者:唐霜】未经授权,禁止复制转载。【本文受版权保护】著作权归作者所有,禁止商业用途转载。
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 的数【原创不易,请尊重版权】转载请注明出处:www.tangshuang.net据发生变化的时候,组件会自动刷新。

未经授权,禁止复制转载。原创内容,盗版必究。著作权归作者所有,禁止商业用途转载。

pipe原创内容,盗版必究。

著作权归作者所有,禁止商业用途转载。【原创内容,转载请注明出处】【本文首发于唐霜的博客】

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

本文作者:唐霜,转载请注明出处。【转载请注明来源】本文作者:唐霜,转载请注明出处。著作权归作者所有,禁止商业用途转载。
const WrapperedComponent = pipe([
  observe(store),
  inject('state', store.state),
])(Component)

注意,pipe 的参数是一个数组。原创内容,盗版必究。

【原创不易,请尊重版权】未经授权,禁止复制转载。著作权归作者所有,禁止商业用途转载。著作权归作者所有,禁止商业用途转载。未经授权,禁止复制转载。

MVC著作权归作者所有,禁止商业用途转载。

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

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

【本文首发于唐霜的博客】【作者:唐霜】转载请注明出处:www.tangshuang.net著作权归作者所有,禁止商业用途转载。著作权归作者所有,禁止商业用途转载。

Controller【访问 www.tangshuang.net 获取更多精彩内容】

本文作者:唐霜,转载请注明出处。未经授权,禁止复制转载。著作权归作者所有,禁止商业用途转载。未经授权,禁止复制转载。【转载请注明来源】

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

【版权所有】唐霜 www.tangshuang.net著作权归作者所有,禁止商业用途转载。著作权归作者所有,禁止商业用途转载。

在 Nautil 中,我们定义一个 Co【作者:唐霜】【作者:唐霜】ntroller,它将拥有一些特殊的能力【未经授权禁止转载】【作者:唐霜】,基于这些能力,我们可以在 Contro【关注微信公众号:wwwtangshuangnet】本文版权归作者所有,未经授权不得转载。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 中定义【原创不易,请尊重版权】【关注微信公众号:wwwtangshuangnet】,也是暴露方法给 Controller 本文作者:唐霜,转载请注明出处。【访问 www.tangshuang.net 获取更多精彩内容】用。Controller 的方法,是对其【转载请注明来源】未经授权,禁止复制转载。他实体的方法在具体语境下的一个二次封装,【原创不易,请尊重版权】【版权所有】唐霜 www.tangshuang.net从而达到上下游数据流转的通顺。

转载请注明出处:www.tangshuang.net本文作者:唐霜,转载请注明出处。【原创内容,转载请注明出处】【作者:唐霜】【访问 www.tangshuang.net 获取更多精彩内容】

我们来看一个例子:【访问 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转载请注明出处:www.tangshuang.net本文版权归作者所有,未经授权不得转载。yComponent 这个组件,它是视图原创内容,盗版必究。【作者:唐霜】层的东西,因此,我说前端领域和后端完全不著作权归作者所有,禁止商业用途转载。【作者:唐霜】同,视图才是入口。但你可以发现,在入口组【未经授权禁止转载】转载请注明出处:www.tangshuang.net件中,内容非常少,它只是从 this.c【访问 www.tangshuang.net 获取更多精彩内容】【关注微信公众号:wwwtangshuangnet】ontroller 上读取预定义好的组件【本文受版权保护】【访问 www.tangshuang.net 获取更多精彩内容】,并进行布局安排(布局,样式等处理)。而【版权所有】唐霜 www.tangshuang.net未经授权,禁止复制转载。在 MyController 中,我定义【原创内容,转载请注明出处】转载请注明出处:www.tangshuang.net了这些被用到的组件,但是,这些组件,完全转载请注明出处:www.tangshuang.net【本文受版权保护】不考虑布局/样式,而只考虑了用户输入和业【本文受版权保护】【关注微信公众号:wwwtangshuangnet】务展示(交互层面)。也就是说,我们在组织【本文受版权保护】【本文受版权保护】一个业务模块的代码的时候,我们可以抛开界【本文首发于唐霜的博客】本文版权归作者所有,未经授权不得转载。面的布局和样式,从需求文档的业务交互层面【版权所有】唐霜 www.tangshuang.net【未经授权禁止转载】进行代码管理。

本文版权归作者所有,未经授权不得转载。【未经授权禁止转载】本文版权归作者所有,未经授权不得转载。原创内容,盗版必究。

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

【版权所有】唐霜 www.tangshuang.net【原创内容,转载请注明出处】【本文受版权保护】转载请注明出处:www.tangshuang.net

结语本文作者:唐霜,转载请注明出处。

著作权归作者所有,禁止商业用途转载。【转载请注明来源】本文作者:唐霜,转载请注明出处。【版权所有,侵权必究】

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

【原创内容,转载请注明出处】未经授权,禁止复制转载。【原创内容,转载请注明出处】

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

【未经授权禁止转载】【未经授权禁止转载】【本文首发于唐霜的博客】

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

本文作者:唐霜,转载请注明出处。著作权归作者所有,禁止商业用途转载。未经授权,禁止复制转载。

我还在继续开发 nautil 的细节功能本文作者:唐霜,转载请注明出处。著作权归作者所有,禁止商业用途转载。,本文中的思想、原则部分不会在发生变化,【未经授权禁止转载】著作权归作者所有,禁止商业用途转载。但具体的一些细节(例如某些组件的用法)还【本文首发于唐霜的博客】原创内容,盗版必究。可能会有调整。如果你对这个项目感兴趣,加入我们著作权归作者所有,禁止商业用途转载。吧。【原创不易,请尊重版权】

【版权所有】唐霜 www.tangshuang.net【关注微信公众号:wwwtangshuangnet】著作权归作者所有,禁止商业用途转载。转载请注明出处:www.tangshuang.net【未经授权禁止转载】

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

2019-09-22 | , , ,