Skip to content

efoxTeam/imook

Repository files navigation

@efox/imook

基于immerreact hooks的轻量的局部状态管理,类比custom hook,@efox/imook强调基于功能设计store。

🎯 案例🎯
Counter I18n Todos

✨特性

  • 局部状态管理,精准定位store作用区间
  • 无this, 状态不可变
  • 支持异步action,修改状态简单化
  • 支持读写分离和定制更新(衍生数据)
  • 支持中断更新和批量更新同步逻辑

📦 安装

npm i @efox/imook
yarn add @efox/imook

⚡快速开始

1. 定义一个local store

import React from "react"
import { createLocalStore, ActUtil } from "@efox/imook";

// 创建counterStore
const initialState: number = 0
type CounterActUtil = ActUtil<number>;

export default createLocalStore(initialState, {
  inc({ commit }: CounterActUtil, step = 1) {
    commit((draftStore) => {
      draftStore.state += step;
    })
  },
});

2. 使用和修改状态

import counterSotre from "./counterStore"

function Counter() {
  // 返回[state, actions]
  const [count, { inc }] = counterStore.useStore()
  return (
    <div>
      count:{count}
      <button onClick={inc}>+</button>
    </div>
  )
}

export default function Counter() {
  return (
    <counterStore.Provider>
      <Counter />
    </counterStore.Provider>
  )
}

💡API

createLocalStore(initialState, actionCreators [, subscriptions])

createLocalStore接收初始状态initialState和用于修改状态的actionCreators,还有可选的订阅项subscriptions,返回一个localStore对象

actionCreators

action生成器对象,属性为任意的函数,函数第一个参数默认为ActUtil(action的工具类)。

import { ActUtil } from "@efox/imook";
const actionCreators = {
  actionName({commit, stateRef}: ActUtil<StateType>, ...args: any[]) {
    /** 
     * stateRef存储当前state的Ref
     */

   // stateRef.current...

    /**
     * commit 用于修改状态, 接受一个函数updater作为参数
     * updater和immer中的produce的第二个参数保持一致
     * 通过操作draftStore.state完成对state的修改
     */
    commit((draftStore) => {
      // draftStore.state...
    });
    // ...
  }
}

subscriptions

状态的订阅项,属性为接受state作为参数的纯函数,用于定制更新和生成衍生数据。

const subscriptions = {
  // 只订阅了name,只有name改变了才会重渲染
  name: (info: StateType) => info.name,
  // 订阅了gender,实现衍生数据
  genderText: (info: StateType) => (info.gender === 0 ? "女" : "男")
}

localStore

局部的store, 包含作用区间的Provider和对应的hooks方法;多个store之间可以通过imook暴露的withStores或Provider进行自动组合。

import {createLocalStore, Provider, withStores} from "@efox/imook"

const localStore = createLocalStore(initialState, actionCreators [, subscriptions])
// 需要读写状态的组件使用useStore, 返回一个元组,包含state和actions对象
function Component() {
  const [state, actions] = localStore.useStore()
  // ...
}

// 只需要写状态的组件使用useActions, 返回一个actions对象,组件不会触发重渲染
function Component() {
  const actions = localStore.useActions()
  // ...
}

// 通过useSubscribe获取订阅项,参数为subscriptions的属性名
function Component() {
  const xxx = localStore.useSubscribe('xxx')
  // ...
}

// 不需要组合stores,直接用localStore提供的Provider包裹Component即可
export default function App() {
  return (
    <localStore.Provider>
     <Component />
    </localStore.Provider>
  )
}

// 组合stores
const stores = [localStore]

// 方式1:使用Provider
export default function App() {
  return (
    <Provider stores={stores}>
     <Component />
    </Provider>
  )
}
// 方式2:使用withStores
function App() {
  return (
     <Component />
  )
}
export default withStores(App, stores)

About

Simple and lightweight local state management

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published