@bearstudio/ui-state

中文文档
2.0.0发布于 2026/08/28MITTypeScriptESM + CJS零依赖近 30 天下载 5601

轻量级工具库, 以方便管理 UI 显示状态, 如加载、 错误或任何自定义状态

中文使用文档
文档目录4 节
  1. * 特性
  2. * 安装
  3. 基本用途
  4. 麻省理工学院许可证

@baserstudio/ ui- state (英语)

处理动态 UI 显示状态的轻量级工具 loading, (中文(简体) ), error,或者任何自定义状态——基于您的应用逻辑.

* 特性

  • * 声明和表达性API
  • 有条件的动态状态评价
  • * 完全自定义状态和有效载荷

* 安装

pnpm install @bearstudio/ui-state
npm install @bearstudio/ui-state
yarn add @bearstudio/ui-state

基本用途

import { getUiState } from "@bearstudio/ui-state";

const ui = getUiState((set) => {
  if (bookQuery.status === "pending") return set("pending");
  if (bookQuery.status === "error") return set("error");
  return set("default", { book: bookQuery.data });
});

重现中渲染

ui.match("pending", () => <>Loading...</>)
  .match("error", () => <>Error</>)
  .match("default", ({ book }) => <>{book.title}</>)
  .exhaustive();

当状态已经知道时, 直接通过—— 不 set() 回调 :

getUiState(query.status)
  .match("pending", () => <>Loading...</>)
  .match("error", () => <>Error</>)
  .match("success", () => <>Ready</>)
  .exhaustive();

麻省理工学院许可证

由BearStudio团队制作

版本与发布记录

@bearstudio/ui-state 共发布 5 个版本,首次发布于 2025/05/21;过去 12 个月发布了 2 个版本。

版本发布日期距今
2.0.0latest2026/08/282 个月前
1.1.02026/01/209 个月前
1.0.22025/07/021.3 年前
1.0.12025/05/211.5 年前
1.0.02025/05/211.5 年前

关于 @bearstudio/ui-state 的常见问题

@bearstudio/ui-state 是什么?

轻量级工具库, 以方便管理 UI 显示状态, 如加载、 错误或任何自定义状态

如何安装 @bearstudio/ui-state?

在项目目录运行 npm install @bearstudio/ui-state,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:react(>=18.0.0)、react-dom(>=18.0.0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@bearstudio/ui-state 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@bearstudio/ui-state 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@bearstudio/ui-state 可以商用吗?

@bearstudio/ui-state 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@bearstudio/ui-state 的下载量有多少?

根据 npm 官方下载统计,@bearstudio/ui-state 在 2026/10/08 – 2026/11/06 这 30 天内被下载 5,601 次,日均约 187 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@bearstudio/ui-state 还在维护吗?

最新版本 2.0.0 发布于 2026/08/28(2 个月前);至今共发布 5 个版本,其中过去 12 个月发布了 2 个;首次发布于 2025/05/21。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。