@abqm-ds/react

中文文档
4.0.57发布于 2026/10/31MITTypeScriptESM + CJS近 30 天下载 2476

Componentes React do Design System ABQM.

原始使用文档
文档目录7 节
  1. 📦 Instalação
  2. ✨ Componentes Disponíveis
  3. 💡 Como Usar
  4. ErrorBoundary
  5. 📁 Estrutura
  6. 🤝 Contribuição
  7. 📃 Licença

@abqm-ds/react

Componentes React do Design System ABQM.

Este pacote fornece componentes reutilizáveis, acessíveis e estilizados para uso em aplicações React, seguindo o padrão visual da ABQM.


📦 Instalação

yarn add @abqm-ds/react
# ou
npm install @abqm-ds/react

✨ Componentes Disponíveis

  • Box
  • Button
  • Text
  • Heading
  • Avatar
  • TextInput
  • TextArea
  • Checkbox
  • MultiStep
  • ColorBar
  • Footer
  • Header
  • RoundedButton
  • SideMenu
  • TopSideMenu
  • UserDropdown
  • Dropdown
  • HeaderMobile
  • Tooltip
  • Modal
  • Toast
  • ErrorBoundary ...

💡 Como Usar

Importe e utilize os componentes normalmente:

import { Button, ToastRoot, ErrorBoundary } from '@abqm-ds/react';

function App() {
  return (
    <ErrorBoundary>
      <ToastRoot />
      <Button text="Salvar" variant="primary" size="md" onClick={() => alert('ola')} />
    </ErrorBoundary>
  );
}

ErrorBoundary

O ErrorBoundary captura erros de renderização em componentes filhos e exibe uma mensagem de fallback amigável.

Exemplo de uso:

import { ErrorBoundary } from '@abqm-ds/react';

function BuggyComponent() {
  throw new Error('Erro de teste!');
}

function App() {
  return (
    <ErrorBoundary>
      <BuggyComponent />
    </ErrorBoundary>
  );
}
  • Use para evitar que erros de componentes quebrem toda a aplicação.
  • O fallback padrão exibe a mensagem de erro e o stack trace.

📁 Estrutura

packages/react/
├── src/
│   ├── components/
│   ├── styles/
│   ├── types/
│   └── index.tsx
├── package.json
└── README.md

🤝 Contribuição

Para sugerir novos componentes ou melhorias, abra um PR ou entre em contato com o time de design.


📃 Licença

Este projeto é privado e pertence à ABQM. Uso externo é restrito.

版本与发布记录

@abqm-ds/react 共发布 107 个版本,首次发布于 2025/06/08;过去 12 个月发布了 49 个版本。

版本发布日期距今
4.0.57latest2026/10/318 天前
4.0.562026/10/1919 天前
4.0.552026/10/1722 天前
4.0.542026/10/1722 天前
4.0.532026/10/1622 天前
4.0.522026/10/1523 天前

关于 @abqm-ds/react 的常见问题

@abqm-ds/react 是什么?

Componentes React do Design System ABQM.

如何安装 @abqm-ds/react?

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

@abqm-ds/react 支持 TypeScript 吗?

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

@abqm-ds/react 支持 ESM 还是 CommonJS?

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

@abqm-ds/react 可以商用吗?

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

@abqm-ds/react 的下载量有多少?

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

@abqm-ds/react 还在维护吗?

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