NPM 包 tinper-mirrorx 使用教程

阅读时长 5 分钟读完

前言

本文介绍了 tinper-mirrorx 的使用教程,它是一个 React 的状态管理库,有着类 Redux 的 API 设计,但更加简单易用,适合小型项目的使用。本文将从安装开始,详细介绍使用该库的流程及其 API 设计,希望对初学者有所帮助。

安装

使用 npm 安装 tinper-mirrorx

设计思想

tinper-mirrorx 的设计思想类似于 Redux。在 Redux 中,我们通过定义 reducer 函数来处理状态改变的逻辑。而在 tinper-mirrorx 中,我们也是通过 model 来定义状态的结构和处理状态改变的逻辑。

不同的是,tinper-mirrorx 支持使用“内置的全局状态”,首次访问的时候会自动请求数据,并缓存到本地,下次访问时可以直接使用缓存的数据返回,实现了数据跨越无需再次请求的效果。

使用教程

创建 model

我们通过创建 model 来声明状态的状态结构、默认值和处理状态改变的逻辑。使用 tinper-mirrorx 时,需要先创建一个名为 app.js 的文件,该文件内包含我们的所有 model、插件以及其他配置信息。

我们以一个简单的计数器应用作为示例,假设我们需要一个状态来表示计数器的数值,则可创建以下 model

-- -------------------- ---- -------
------ - -------- ------- - ---- ----------

------ ------- -
  ----- ----------
  ------------- -
    ------ --
  --
  --------- -
    ---------- ------- -- -
      ------ -
        ---------
        ------ ----------- - -
      --
    --
    ---------- ------- -- -
      ------ -
        ---------
        ------ ----------- - -
      --
    -
  -
--

在上面的 model 中,我们定义了一个名为 counter 的模型,其结构为一个包含一个 value 字段的对象,用来存储计数器的数值。我们同时在 reducers 中定义了两个函数,分别实现数值的增加和减少。这些函数将会用 actions 对象来进行调用。

启用模型

我们需要在 app.js 文件中启用模型,然后在 index.js 中挂载应用。

app.js:

-- -------------------- ---- -------
------ - ------ ------- - ---- ----------
------ ------- ---- -------------------

-------
  ----- ------
  ------------- ---
  --------- ---
  -------- ---
---

--------------
  --------
---

index.js:

-- -------------------- ---- -------
------ ----- ---- --------
------ -------- ---- ------------
------ - -------- - ---- ----------
------ --------------
------ --- ---- --------
------ - -- ------------- ---- ------------------
------ ---------------

----------------
  ----------
    ---- --
  ------------
  -------------------------------
--

---------------------------

调用 model

在组件中,我们可以通过 connect 方法来调用我们的 modelconnect 方法接受一个函数作为参数,这个函数返回一个对象,对象的属性将被注入到组件的 props 中。其中,我们需要使用 action 函数来触发 model 中的指定方法完成相应的状态改变。

-- -------------------- ---- -------
------ ----- ---- --------
------ - ------- - ---- ----------

----- ------- - -- ------ ---------- --------- -- -- -
  ------ -
    -----
      ------- ------------------------------
      -------
      ------- ------------------------------
    ------
  --
--

----- -------- - ----- -- -
  ----- ------- - ------------- -- ---
  ------ -
    ------ ------------- -- --
  --
--

----- ----------- - -- -------- - ---------- --------- - -- -- --
  ---------- -- -- ------------
  ---------- -- -- ------------
---

------ ------- --------
  ---------
  -----------
-----------

在上面的组件中,我们通过 connect 方法将 counter.value 映射到了组件的 props 中,然后在按钮的 onClick 事件中调用 incrementdecrement 方法来改变计数器的数值。

结束语

本文介绍了 tinper-mirrorx 的使用教程,先对其设计思想进行了简单介绍,然后详细介绍了该库的使用流程及相关 API 的设计及用法。希望读者能够通过本文对该库有更深入的理解,并在实际开发中能够熟练运用该库实现相应的状态管理功能。

来源:JavaScript中文网 ,转载请注明来源 https://www.javascriptcn.com/post/6005616581e8991b448df47d

纠错
反馈