Stook:极简主义的 React 状态管理库

Bash
• 阅读 3454

从 Hooks 说起

一年前,2018 年 9 月左右, React hooks 刚发布,那时 hooks 还不是稳定 Api,只能在 16.7.0-alpha.0 版本能用。那时我就预感到,基于 hooks 状态管理解决方案会逐渐崛起,当时我基于 hooks 创建一个我认为理想的状态管理库:stamen

我还写过一篇文章介绍它:可能是基于 Hooks 和 Typescript 最好的状态管理工具

回顾 Stamen

我之前说过,我想要这样的一个状态管理库:

  • 简单易用,并且适合中大型项目
  • 完美地支持 Typescript

所以我创建了 Stamen,Stamen 相比 Redux 更加简洁,对 TypeScript 支持度更好。一年多过去了,也在几个小项目中实践过,发现并没有很好满足我的两个期望。

Stamen 的 Api 借鉴了 dva 和 rematch,导致了它没有脱离 Redux 的影子,依然有 state、reducers、effects、dispatch、selector 等概念,可以说没有彻底 Hooks 化,特别是 reducers 处理同步和 effects 处理副作用让我觉得特别扭。

一年后,我创建了更加彻底 Hooks 化的状态管理库:Stook

关于 Stook

Stook,中文翻译是谷堆,命名灵感来自 store、hooks 两个单词的组合,一个极简主义的 React 状态管理库。

基本用法

我们看看 Stook 用法有多么的简单,下面是一个经典的 Counter 组件,展示了 stook 的最基本用法:

import React from "react";
import { useStore } from "stook";

function Counter() {
  const [count, setCount] = useStore("Counter", 0);
  return (
    <div>
      <p>You clicked {count} times</p>
      <button onClick={() => setCount(count + 1)}>Click me</button>
    </div>
  );
}

Stook:极简主义的 React 状态管理库

Stook 最核心的 Api 就是 useStore,也许你发现了,它和 useState 非常像,实际上,useStore 除了多了一个参数以外,其他用法一模一样。

Stook 极简之处在于它的用法跟 usState 几乎一致,学习成本几乎可以忽略,更多的学习成本在于 React Hooks 的掌握和理解,经过一年多,Hooks 已经逐渐在 React 社区中得到认可,相信以后 Hooks 将是每个 React 开发者的基本技能。

状态共享

对于状态管理,最核心的功能就是状态的跨组件通信。useState 用于管理单一组件内的状态,useStore 则可以跨组件管理整个应用的状态。

下面展示了如何多个组件如何共享状态:

import React from "react";
import { useStore } from "stook";

function Counter() {
  const [count, setCount] = useStore("Counter", 0);
  return (
    <div>
      <p>You clicked {count} times</p>
      <button onClick={() => setCount(count + 1)}>Click me</button>
    </div>
  );
}

function Display() {
  const [count] = useStore("Counter");
  return <p>{count}</p>;
}

function App() {
  return (
    <div>
      <Counter />
      <Display />
    </div>
  );
}

Stook:极简主义的 React 状态管理库

在这个例子中,我们可以看到,要共享状态,只需使用 useStore 订阅同一个 key 即可,非常简单。可以说,只要你学会了 useState,也就学会了 useStore,只要你学会了 useStore,你就学会了 React 的状态管理。

自定义 Hooks

为了能使组件和状态管理逻辑分离,强烈建议使用自定义 hooks 管理状态,比如说你要管理 Counter 的状态,那就是自定义一个叫 useCounter 的 hooks,然后在各组件中使用 useCounter(), 而不是直接使用 useStore('Counter')

示例:

import React from "react";
import { useStore } from "stook";

function useCounter() {
  const [count, setCount] = useStore("Counter", 0);
  const decrease = () => setCount(count - 1);
  const increase = () => setCount(count + 1);
  return { count, increase, decrease };
}

function Display() {
  const { count } = useCounter();
  return <div>{count}</div>;
}

function Increase() {
  const { increase } = useCounter();
  return <buttun onClick={increase}>+</buttun>;
}

function Decrease() {
  const { decrease } = useCounter();
  return <buttun onClick={decrease}>-</buttun>;
}

export default function App() {
  return (
    <div>
      <Decrease />
      <Display />
      <Increase />
    </div>
  );
}

Stook:极简主义的 React 状态管理库

上面三个子组件,都用到了 useCounter,它们实现了状态共享。

自定义 Hooks 是最佳实践,强烈建议在业务中都使用自定义 Hooks。

Api

Stook 的核心非常简洁,核心 Api 就 useStore 一个,全部 Api 也就 3 个:

单元测试

测试 stook 是一件非常简单的事,因为测试 stook 也就是在测试 react hooks。

推荐使用 react-hooks-testing-library工具来测试 stook。

安装依赖

npm install -D @testing-library/react-hooks react-test-renderer

例子

useCounter.ts

function useCounter() {
  const [count, setCount] = useStore("Counter", 0);
  const decrease = () => setCount(count - 1);
  const increase = () => setCount(count + 1);
  return { count, increase, decrease };
}

useCounter.test.ts

import { renderHook, act } from "@testing-library/react-hooks";
import useCounter from "./useCounter";

test("should increment counter", () => {
  const { result } = renderHook(() => useCounter());

  act(() => {
    result.current.increase();
  });

  expect(result.current.count).toBe(1);
});

更多的测试技巧请看:react-hooks-testing-library

调试

为了更好的编程体验,Stook 支持使用 Redux DevTools 调试。

安装 Redux DevTools extension

如果你未安装 Redux DevTools extension,请安装相应浏览器的插件:Redux DevTools

Setup

使用 devtools 非常简单,先安装 stook-devtools 包:

npm i stook-devtools

然后在项目代码中进入,并初始化:

import { devtools } from "devtools";

devtools.init();

如果你不想在生产环境引入:

import { devtools } from "devtools";

if (process.env.NODE_ENV !== "production") {
  devtools.init();
}

效果

生效后,可以在浏览器的 Redux DevTools extension 看到整个应用的 state 状态:

Stook:极简主义的 React 状态管理库

总结

Stook 的理念和传统的状态管理方案不同,没有明确的 Action 的概念。事实上,它的理念跟 React 的 useState是类似的,推崇的是:一个 Hooks,一个 state,一个 action。Stook 建议把状态分拆,变成一个个 Hooks,然后就变成 [state, setState]

更多关于 Stook 的用法,请看 Github: Stook

点赞
收藏
评论区
推荐文章
blmius blmius
4年前
MySQL:[Err] 1292 - Incorrect datetime value: ‘0000-00-00 00:00:00‘ for column ‘CREATE_TIME‘ at row 1
文章目录问题用navicat导入数据时,报错:原因这是因为当前的MySQL不支持datetime为0的情况。解决修改sql\mode:sql\mode:SQLMode定义了MySQL应支持的SQL语法、数据校验等,这样可以更容易地在不同的环境中使用MySQL。全局s
Wesley13 Wesley13
3年前
MySQL部分从库上面因为大量的临时表tmp_table造成慢查询
背景描述Time:20190124T00:08:14.70572408:00User@Host:@Id:Schema:sentrymetaLast_errno:0Killed:0Query_time:0.315758Lock_
美凌格栋栋酱 美凌格栋栋酱
7个月前
Oracle 分组与拼接字符串同时使用
SELECTT.,ROWNUMIDFROM(SELECTT.EMPLID,T.NAME,T.BU,T.REALDEPART,T.FORMATDATE,SUM(T.S0)S0,MAX(UPDATETIME)CREATETIME,LISTAGG(TOCHAR(
皕杰报表之UUID
​在我们用皕杰报表工具设计填报报表时,如何在新增行里自动增加id呢?能新增整数排序id吗?目前可以在新增行里自动增加id,但只能用uuid函数增加UUID编码,不能新增整数排序id。uuid函数说明:获取一个UUID,可以在填报表中用来创建数据ID语法:uuid()或uuid(sep)参数说明:sep布尔值,生成的uuid中是否包含分隔符'',缺省为
Wesley13 Wesley13
3年前
FLV文件格式
1.        FLV文件对齐方式FLV文件以大端对齐方式存放多字节整型。如存放数字无符号16位的数字300(0x012C),那么在FLV文件中存放的顺序是:|0x01|0x2C|。如果是无符号32位数字300(0x0000012C),那么在FLV文件中的存放顺序是:|0x00|0x00|0x00|0x01|0x2C。2.  
Wesley13 Wesley13
3年前
mysql设置时区
mysql设置时区mysql\_query("SETtime\_zone'8:00'")ordie('时区设置失败,请联系管理员!');中国在东8区所以加8方法二:selectcount(user\_id)asdevice,CONVERT\_TZ(FROM\_UNIXTIME(reg\_time),'08:00','0
Wesley13 Wesley13
3年前
PHP创建多级树型结构
<!lang:php<?php$areaarray(array('id'1,'pid'0,'name''中国'),array('id'5,'pid'0,'name''美国'),array('id'2,'pid'1,'name''吉林'),array('id'4,'pid'2,'n
Wesley13 Wesley13
3年前
Java日期时间API系列36
  十二时辰,古代劳动人民把一昼夜划分成十二个时段,每一个时段叫一个时辰。二十四小时和十二时辰对照表:时辰时间24时制子时深夜11:00凌晨01:0023:0001:00丑时上午01:00上午03:0001:0003:00寅时上午03:00上午0
Wesley13 Wesley13
3年前
00:Java简单了解
浅谈Java之概述Java是SUN(StanfordUniversityNetwork),斯坦福大学网络公司)1995年推出的一门高级编程语言。Java是一种面向Internet的编程语言。随着Java技术在web方面的不断成熟,已经成为Web应用程序的首选开发语言。Java是简单易学,完全面向对象,安全可靠,与平台无关的编程语言。
Stella981 Stella981
3年前
Django中Admin中的一些参数配置
设置在列表中显示的字段,id为django模型默认的主键list_display('id','name','sex','profession','email','qq','phone','status','create_time')设置在列表可编辑字段list_editable
Python进阶者 Python进阶者
1年前
Excel中这日期老是出来00:00:00,怎么用Pandas把这个去除
大家好,我是皮皮。一、前言前几天在Python白银交流群【上海新年人】问了一个Pandas数据筛选的问题。问题如下:这日期老是出来00:00:00,怎么把这个去除。二、实现过程后来【论草莓如何成为冻干莓】给了一个思路和代码如下:pd.toexcel之前把这