createApp

补充信息

默认情况下，本节所有 API 的导出包名为：@modern-js/runtime/model。

如果是在 Modern.js 以外单独集成 Reduck，导出包名为：@modern-js-reduck/react。

一个 Reduck 应用对应共享一个 Store 的应用。Reduck 内部默认会使用 createApp 创建一个全局应用，如果整个应用只需要共享一个 Store，那么是不需要使用 createApp 的。只有当需要在应用局部创建共享 Store 时，才需要使用 createApp 。

注意

• 注意 @modern-js/runtime/model 中导出的 createApp 用于管理状态，而 @modern-js/runtime 导出的 createApp 用于管理整个应用的运行时环境，两者功能不同。

类型

interface AppConfig extends StoreConfig {
  devTools?: boolean | DevToolsOptions;
  autoActions?: boolean;
}

function createApp(config: AppConfig): object;

参数

• config：Record<string, any>
  • StoreConfig：同 createStore 的参数。
  • devTools：默认值为true。是否开启 Redux DevTools，当为对象类型时，支持配置 Redux DevTools 的 Options。
  • autoActins：默认值为true。是否自动生成 Actions。

返回值

Reduck App，有以下属性组成：

• Provider：为应用局部的组件树注入共享 Store 的组件。用法同 Provider。
• useModel：获取应用局部 Store 挂载的 Model 对象。用法同 useModel。
• useStaticModel：获取应用局部 Store 挂载的 Model 对象。用法同 useStaticModel。
• useLocalModel：获取应用局部 Store 挂载的 Model 对象。用法同 useLocalModel。
• useStore：获取应用局部使用的 Store 对象。用法同 useStore。

示例

通过 createApp 可以创建局部状态，将不同 Reduck 应用间的状态隔离。

const { Provider: LocalFooProvider, useModel: useLocalFooModel } = createApp();
const { Provider: LocalBarProvider, useModel: useLocalBarModel } = createApp();

function Foo() {
  const [fooState] = useLocalFooModel(fooModel);
  const [barState] = useLocalBarModel(fooModel);

  return (
    <div>
      <div>Foo: {fooState}</div>
      <div>Bar: {barState}</div>
    </div>
  );
}

function Container() {
  return (
    <LocalFooProvider>
      <LocalBarProvider>
        <Foo />
      </LocalBarProvider>
    </LocalFooProvider>
  );
}