@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 的常见问题
@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 和提交记录判断。