Le contenu de cet article concerne le cadre de gestion de l'état réactif de Pastate.js. Il a une certaine valeur de référence. Les amis dans le besoin peuvent s'y référer

Introduction à Pastate

Quoi. is Pastate

Pastate est un cadre de gestion d'état réactif réactif qui implémente une gestion réactive asynchrone de l'état. Paste est un framework allégé qui fournit une encapsulation conviviale de nombreux concepts avancés, ce qui signifie que vous n'avez pas besoin d'apprendre certains concepts difficiles à comprendre et pouvez facilement utiliser Paste dans une application simple. À mesure que l'application devient de plus en plus complexe, il vous suffit d'apprendre et d'utiliser progressivement davantage de fonctions en pâte pour répondre aux besoins de développement de systèmes de plus en plus complexes. Dans le même temps, Paste est également un framework progressif rétrocompatible. Vous pouvez utiliser Paste pour implémenter certains composants dans un projet React ou Redux existant, puis l'étendre progressivement à l'ensemble du projet.

Page d'accueil de Pastate : https://pastate.js.org

Pastate GitHub : https://github.com/BirdLeeSCUT/pastate (étoiles bienvenues)

Exemple simple :

const state = store.state

class AppView extends Component {
    increaseAge(){
        state.myInfo.age += 1
    }
    changeName(newName){
        state.myInfo.name = newName
    }
    render() {
        ...
    }
}

Copier après la connexion

Vous pouvez directement attribuer des valeurs au nœud d'état, et le moteur réactif de Paste mettra à jour la vue pour vous de manière asynchrone ! Ce mode est beaucoup plus pratique et flexible que la méthode setState de native React ou le mode réducteur de Native Redux !

Caractéristiques

Pratique et facile à utiliser : Paste encapsule des concepts avancés, et vous pouvez démarrer facilement tant que vous avez des connaissances de base sur réagir
État réactif : vous pouvez directement mettre à jour la valeur de l'état en utilisant le mode natif js, et coller mettra à jour les vues pertinentes pour vous de manière réactive
Conseils de type : Paste dispose d'un fichier de définition de type complet, ce qui peut grandement améliorer l'efficacité du développement à l'aide d'intelliSense
Rendu à la demande : implémentation de Paste Grâce au mécanisme de référence de mise à jour de traçabilité à la demande du nœud d'état, la vue peut répondre efficacement aux changements d'état
Mécanisme de mise à jour asynchrone : Lorsque vous apportez des modifications continues à l'état, le pâturage effectuera efficacement une seule mise à jour de la vue asynchrone pour vous
Courbe d'apprentissage conviviale : Paste encapsule les concepts avancés du flux mode, vous n'avez besoin d'y aller que lorsque vous êtes intéressé Comprendre ces concepts
Compatible avec les projets Redux : Vous pouvez facilement intégrer Paste dans des projets Redux et implémenter certains conteneurs comme Mode Paste
Support TypeScript : Paste lui-même est développé à l'aide de TypeScript, avec des définitions de types complètes et un support générique
Licence MIT autorisée : Vous pouvez l'utiliser gratuitement dans des projets personnels ou commerciaux, et la modifier ou l'étendre selon vos besoins

Introduction du principe

Le nom Paste vient de l'abréviation de Path State, Paste Ajoutez les informations d'emplacement (chemin) du nœud et stockez les informations de propriété sur chaque nœud de l'état, réalisant ainsi des mises à jour de référence récursives à la demande des nœuds d'objet ou de tableau et réalisant la fonctionnalité d'état immuable, donc la pâte peut gérer des arbres d'état complexes et obtenir un rendu asynchrone efficace à la demande. Dans le même temps, Paste implémente la prise en charge des opérations réactives sur tous les nœuds pour l'état basé sur Object.assign d'ES5. Il vous suffit de modifier l'état comme une variable normale, telle que state.userinfo.name = 'myName', puis le moteur réactif de Paste le fera automatiquement de manière asynchrone. faites-le pour vous. Mettez à jour efficacement les vues associées. Pour les principes détaillés, veuillez consulter le chapitre principal :

Cadre de gestion de l'état de réaction réactif Pastate.js

Source d'inspiration

. Paste s'inspire du modèle de gestion d'état immuable de Redux et du modèle de conception d'état réactif de vue.js tout en incorporant des idées de conception allégée.

Fiabilité

Pastate a été entièrement testé avec plus de 160 cas de test et est stable et fiable. Le contenu spécifique des cas de test peut être consulté dans le répertoire src/pastate/tests du code source du projet.

Commentaires de bienvenue

Si vous trouvez des bugs dans Pasteate ou si vous avez des suggestions, veuillez soumettre un problème. Merci pour vos commentaires. Si vous aimez le pastae, j'espère que vous pourrez lui donner une étoile précieuse ^_^ : pastate github.

Démarrez rapidement

Voyons comment créer l'application la plus simple en utilisant Coller.

Installation

Pastate est un cadre de gestion d'état de réaction qui doit être utilisé avec React. Nous utilisons d'abord l'outil create-react-app pour créer un projet React de base et montrons comment utiliser Paste sur ce projet :

$ npm install -g create-react-app
$ create-react-app my-pastate-app
$ cd my-pastate-app

Copier après la connexion

Ensuite, vous pouvez utiliser npm pour installer directement Paste :

$ npm install --save pastate

Copier après la connexion

Ou utilisez du fil pour installer :

$ yarn add pastate

Copier après la connexion

Commencez à utiliser

Pastate est très simple à utiliser Créons un composant Paste pour afficher des informations personnelles simples.

Créer un fichier src/MyPastateApp.jsx pour écrire notre composant :

import React, { Component } from &#39;react&#39;;
import { Pastore, makeOnlyContainer } from &#39;pastate&#39;;

const store = new Pastore({
    name: &#39;Peter&#39;,
    isBoy: true,
    age: 10
})

class AppView extends Component {
    render() {
        let state = store.state;
        return (
            <p>
                My name is {state.name}.<br/>
                I am a {state.isBoy ? "boy" : "girl"}.<br/>
                I am {state.age} years old.<br/>
            </p>
        )
    }
}

export default makeOnlyContainer(AppView, store)

Copier après la connexion

Terminé, il s'agit d'un composant Paste d'entrée de gamme Il présente les deux points suivants qui le distinguent des projets React natifs. :

magasin indépendant des composants

const store = new Pastore({
    name: &#39;Peter&#39;,
    isBoy: true,
    age: 10
})

Copier après la connexion

Le magasin est un centre de données qui stocke les données d'état et comprend un ensemble de moteurs de gestion d'état et de moteurs de mise à jour de vues.

在初始化 store 时，需要向 Pastore 构造函数里传入一个初始化 state, 我们通常使用以下命名的方式书写, 以便复用这个初始化 state：

const initState = {
    name: &#39;Peter&#39;,
    isBoy: true,
    age: 10
}
const store = new Pastore(initState)

Copier après la connexion

对组件和 store 进行连接

对于只有唯一一个 store 的应用，我们使用 pastate 提供的 makeOnlyContainer 把 store 和组件(Component)连接成一个的容器, 这使得组件视图可以响应 store 中 state 的变化：

Cadre de gestion de l'état de réaction réactif Pastate.js

接着，把该容器(Container)渲染在HTML中即可：

src/MyPastateApp.jsx

...
export default makeOnlyContainer(App, store)

Copier après la connexion

src/index.js

import ReactDOM from &#39;react-dom&#39;;
import container from &#39;./MyPastateApp&#39;;
ReactDOM.render(container, document.getElementById(&#39;root&#39;));

Copier après la connexion

注意，makeOnlyContainer 生成的是一个 React Element, 即 <Xxx />, 因此在 render 时不必再多加一层 <... />。

更新 state 值

接下来我们来尝试更新 state 的值：通过两个按钮来控制 state.age 值的增加和减少。

先在组件中添加两个操作函数 increaseAge 和 decreaseAge

// src/MyPastateApp.jsx
...
const store = new Pastore(initState)
class AppView extends Component {

    increaseAge(){
        store.state.age += 1
    }
    
    decreaseAge(){
        store.state.age -= 1
    }

    render() {
        ...
    }
}
...

Copier après la connexion

可以看到，使用 pastate 更新 state 非常简便：直接对 state 中需要更新的节点进行赋值即可，与 store 连接的视图会自动更新。

接下来在 JSX 中添加两个按钮来触发这两个操作函数：

src/MyPastateApp.jsx

...
    render() {
        let state = store.state;
        return (
            <p>
            
                My name is {state.name}.<br/>
                I am a {state.isBoy ? "boy" : "girl"}.<br/>
                I am {state.age} years old.<br/>
                
                <button onClick={this.decreaseAge}> decrease age </button> 
                <button onClick={this.increaseAge}> increase age </button> 
                
            </p>
        )
    }
...

Copier après la connexion

Amazing！我们第一个简单的 pastate 应用大功告成：

Cadre de gestion de l'état de réaction réactif Pastate.js

点击 increaseAge 和 decreaseAge 按钮，可以看到年龄值的变化。
你可以再添加几个按钮来修改 state 中名字和性别，看看视图有没有如你所愿地更新。

Pastate 在 store 中实现了一个响应式和 immutable 特性结合的 state 管理引擎, 我们可以像修改普通变量一样操作 state, 同时 pastate 可以高效地根据 state 的改变对相关视图进行更新。

编辑器智能提示(intelliSense)

我们推荐使用 Visual Studio Code 编辑器开发 react / pastate 应用，它拥有很好的变量类型智能提示功能和其他优秀特性，使得我们可以提高开发效率，并探测减少一些输入性错误。

Tips: vscode 默认关闭了通过 tab 键触发 emmet 的功能, 你可以通过修改设置开启： "emmet.triggerExpansionOnTab": true 。

下面我们简单地使用 jsDoc 注释来使 state 具有类型提示效果:
src/MyPastateApp.jsx

...
const initState = {
    name: &#39;Peter&#39;,
    isBoy: true,
    age: 10,
}
const store = new Pastore(initState)

/** @type {initState} */
const state = store.state; // 修改点, 把 state 提取成文件级的变量

class AppView extends Component {

    increaseAge(){
        state.age += 1 // 修改点，使用文件级的变量 state，下同
    }
    
    decreaseAge(){
        state.age -= 1 // 修改点
    }

    render() {
        // 修改点
        return (
            <p>
                My name is {state.name}.<br/> 
                I am a {state.isBoy ? "boy" : "girl"}.<br/>
                I am {state.age} years old.<br/>
                ... 
            </p>
        )
    }
}
...

Copier après la connexion

我们把 store.state 提取为文件级的变量 state，这使得对 state 的使用和修改变得方便。
同时我们在 const state 之前加上类型注释 /** @type {initState} */, 使得编辑器知道 state 的格式，并获得如下的智能提示效果：

Cadre de gestion de l'état de réaction réactif Pastate.js

智能提示的功能在 state 结构复杂的时候非常实用。

你也可以使用 pastate 提供的 createStore 函数来创建 store, 并自动获取 state 类型定义，具体用法请看API文档，我们现在先使用 new Pastore 的方式创建 store 。如果你使用 Typescript 进行开发，pastate 支持 Typescript 泛型的变量类型传递功能，无需使用 jsdoc 注释。

这里只是简单例子只是涉及到一个 react 组件，在文档中我们会介绍如何构建一个包含多个组件的 pastate 应用。