@carefrees/simple-store NPM

`simple-store`

状态管理

1. 定向更新组件
1. 数据存储
1. 监听值变化

状态包裹组件

SimpleStoreProvider
MultipleSimplProvider

hooks

useSimpleStore 实例化方法
useSimpleWatch 监听值变化
useSimple 子组件中获取实例
useSimpleItem 子组件使用数据更新和取值
useMultipleSimpleStore实例化收集多个状态管理方法
useMultipleSimple 子组件中获取实例

参数

/**状态存储*/
export declare class SimpleStore<T extends {} = any> {
    /**值存储*/
    private store;
    private initialValue;
    /**组件更新方法集合*/
    componentList: RegisterProps[];
    /**监听字段值变化*/
    watchList: RegisterWatchProps[];
    /**设置初始值*/
    init: (initialValue?: T) => void;
    /**注册组件更新方法*/
    register: (props: RegisterProps) => () => void;
    /**注册监听字段*/
    registerWatch: (props: RegisterWatchProps) => () => void;
    /**更新值*/
    updateValue: <K = any>(path: PathTypes, value: K, notice?: boolean | string[]) => void;
    /**批量数据更新*/
    bathUpdateValue: (values: Record<string, any>, notice?: boolean | string[]) => void;
    /**获取值*/
    getValue: (path?: PathTypes) => any;
    /**通知组件更新*/
    notice: (path: PathTypes) => void;
    /**
     * 批量更新组件，
     *
     * 当不传递值的时候，更新所有组件
    */
    bathNotice: (paths?: string[] | boolean) => void;
    /**通知监听*/
    noticeWatch: (path: PathTypes) => void;
}

export type PathTypes = number | string | (number | string)[]

export interface RegisterProps {
  path: PathTypes,
  update: Function
  /**是否保存*/
  preserve?: boolean
}

export declare class MultipleSimpleStore {
    /**数据存储*/
    store: Map<string, SimpleStore>;
    /**注册*/
    register: (path: string, simple: SimpleStore) => void;
    /**获取单个 simple */
    getSimple: (path: string) => SimpleStore<any>;
}

export interface RegisterWatchProps {
    path: PathTypes;
    update: (value: any) => void;
}
export interface SimpleStoreProviderProps<T extends {} = any> {
    simple?: SimpleStore;
    children?: React.ReactNode;
    initialValue?: T;
    path?: string;
}
export interface UseSimpleStoreItemProps {
    /**路径*/
    path: PathTypes;
}
export interface UseSimpleItemProps extends UseSimpleStoreItemProps {
}
export interface MultipleSimplProviderProps {
    multipleSimple?: MultipleSimpleStore;
    children?: React.ReactNode;
}

import { SimpleStoreProviderProps, PathTypes, UseSimpleItemProps, MultipleSimplProviderProps } from "./interface";
export declare const SimpleContext: import("react").Context<SimpleStore<any>>;
export declare const MultipleSimpleContext: import("react").Context<MultipleSimpleStore>;
export declare const useSimpleStore: <T extends {} = any>(simple?: SimpleStore) => SimpleStore<T>[];
export declare const useMultipleSimpleStore: (multipleSimple?: MultipleSimpleStore) => MultipleSimpleStore[];
export declare const SimpleStoreProvider: <T extends {} = any>(props: SimpleStoreProviderProps<T>) => import("react").FunctionComponentElement<import("react").ProviderProps<SimpleStore<any>>>;
export declare const MultipleSimplProvider: (props: MultipleSimplProviderProps) => import("react").FunctionComponentElement<import("react").ProviderProps<MultipleSimpleStore>>;
/**更新页面状态*/
export declare const useUpdate: () => import("react").MutableRefObject<Function>;
export declare const useSimple: <T extends {} = any>() => SimpleStore<T>;
export declare const useMultipleSimple: () => MultipleSimpleStore;
export declare const useSimpleStoreItem: <T extends {} = any>(props: UseSimpleItemProps) => SimpleStore<T>;
export declare const useSimpleItem: <T extends {} = any>(props: UseSimpleItemProps) => SimpleStore<T>;
export declare const useSimpleWatch: <T extends {} = any>(simple: SimpleStore<T>, path: PathTypes, fun?: (value: any) => void) => any;

选中案例

import React from "react"
import { SimpleStoreProvider, useSimpleItem } from "@carefrees/simple-store"


const Child = (props: { index: number }) => {
  const { index } = props
  const simple = useSimpleItem({ path: index })

  // 这个值，当组件不重新渲染的时候，获取的值是老的，当重新渲染才是最新的
  const checkValue = simple.getValue("checkValue")
  const onClick = () => {
    // 取最新的渲染值
    const preCheckValue = simple.getValue("checkValue")
    simple.bathUpdateValue({ checkValue: index })
    simple.bathNotice([`${index}`, `${preCheckValue}`])
  }
  console.log("选中项====>", index)

  return <button style={checkValue === index && { background: "red" } || {}} onClick={onClick} >点击{index}号</button>
}


const list = Array.from({ length: 10 }).map((_, index) => ({ index }))

const Demo = () => {
  
  return <div>
    <div>选中项</div>
    <hr />
    <SimpleStoreProvider>
      {list.map((ite) => <Child key={ite.index} index={ite.index} />)}
    </SimpleStoreProvider>
    <hr />
  </div>
}
export default Demo;

表单案例

import React from "react"
import { SimpleStoreProvider, useSimpleItem, useSimpleStore,useSimpleWatch} from "@carefrees/simple-store"

const Item = (props: { name: string }) => {

  const simple = useSimpleItem({ path: props.name })
  const value = simple.getValue(props.name)

  

  const onChange: React.ChangeEventHandler<HTMLInputElement> = (event) => {
    const value = event.target.value
    simple.updateValue(props.name, value)
  }

  console.log("表单====>", props.name)

  return <input placeholder={`${props.name}`}  value={value || ''} onChange={onChange}  />
}

const Form = () => {
  const [simple] = useSimpleStore()
 
  const onSubmit = () => {
    const data = simple.getValue()
    console.log("获取所有值", data)
  }

  const setValue = () => {
    simple.updateValue("1号", new Date().getTime().toString())
  }

  return <div>
    <div>表单</div>
    <hr />
    <button onClick={onSubmit} >获取表单值</button>
    <button onClick={setValue} >设置 1号值 </button>
    <br />
    <SimpleStoreProvider simple={simple} >
      <Item name="1号" />
      <Item name="1号" />
      <Item name="2号" />
      <Item name="3号" />
      <Item name="4号" />
      <Item name="5号" />
      <Item name="5号" />
      <Item name="6号" />
      <Item name="6号" />
    </SimpleStoreProvider>
    <hr />
  </div>
}

export default Form

数据监听

import React from "react"
import { SimpleStoreProvider, useSimpleItem, useSimpleStore,useSimpleWatch} from "@carefrees/simple-store"

const Item = (props: { name: string }) => {
  const simple = useSimpleItem({ path: props.name })
  const value = simple.getValue(props.name)

  const onChange: React.ChangeEventHandler<HTMLInputElement> = (event) => {
    const value = event.target.value
    simple.updateValue(props.name, value)
  }
  return <input placeholder={`${props.name}`}  value={value || ''} onChange={onChange}  />
}

const Form = () => {

  const [simple] = useSimpleStore()
  /**监听*/
  const values = useSimpleWatch(simple,"1号")

  /**监听*/
  useSimpleWatch(simple,"1号",(value)=>{
    console.log("打印哈哈哈====>",value)
  })

  console.log("监听 1号 字段 的值变化",values)

  const setValue = () => {
    simple.updateValue("1号", new Date().getTime().toString())
  }

  return <div>
    <div>表单</div>
    <hr />
    <button onClick={setValue} >设置 1号值 </button>
    <br />
    <SimpleStoreProvider simple={simple} >
      <Item name="1号" />
      <Item name="1号" />
      <Item name="2号" />
      <Item name="3号" />
      <Item name="4号" />
      <Item name="5号" />
      <Item name="5号" />
      <Item name="6号" />
      <Item name="6号" />
    </SimpleStoreProvider>
    <hr />
  </div>
}

export default Form

useSelector使用

import React from "react"
import { SimpleStoreProvider, useSimpleItem, useSimpleStore,useSimpleWatch ,useSelector } from "@carefrees/simple-store"

const Item = (props: { name: string }) => {
  const simple = useSimpleItem({ path: props.name })
  const { value } = useSelector(({ instance })=> ({ value:instance.store[props.name] }))
  const onChange: React.ChangeEventHandler<HTMLInputElement> = (event) => {
    const value = event.target.value
    simple.updateValue(props.name, value,false)
    /**手动触发 useSelector 执行选择器*/
    simple.bathRunSelector()
  }

  console.log(`useSelector===${props.name}===>`,simple,value)

  return <input placeholder={`${props.name}`}  value={value || ''} onChange={onChange}  />
}

const Form = () => {

  const [simple] = useSimpleStore()

  const setValue = () => {
    simple.updateValue("1号", new Date().getTime().toString(),false)
    /**手动触发 useSelector 执行选择器*/
    simple.bathRunSelector()
  }
  console.log("simple====>",simple)

  return <div>
    <div>表单</div>
    <hr />
    <button onClick={setValue} >设置 1号值 </button>
    <br />
    <SimpleStoreProvider simple={simple} >
      <Item name="1号" />
      <Item name="2号" />
      <Item name="3号" />
      <Item name="4号" />
      <Item name="5号" />
      <Item name="5号" />
      <Item name="6号" />
      <Item name="6号" />
    </SimpleStoreProvider>
    <hr />
  </div>
}

export default Form

@carefrees/simple-store-utils

@everything-registry/sub-chunk-156

19 days ago

6 months ago

7 months ago

7 months ago

8 months ago