@epilot/base-elements

中文文档
4.0.2发布于 2026/09/09MITTypeScriptCommonJS近 30 天下载 2.3万

General purpose React components for epilot UI elements.

原始使用文档
文档目录4 节
  1. Quick start
  2. Storybook
  3. Run locally on http://localhost:5500/bundle.js
  4. Contributing MDX (markdown documentation)

@epilot/base-elements

General purpose React components for epilot UI elements.

base-elements.dev.epilot.io

Based on Material UI

Quick start

yarn
yarn start

Storybook

yarn run storybook
yarn run build-storybook

Run locally on http://localhost:5500/bundle.js

Contributing MDX (markdown documentation)

Add a .stories.mdx file alongside the story (example: stories/Progress.design.stories.mdx)

Add a <Meta> tag as follows:

import { Meta } from '@storybook/addon-docs';
import { Progress } from '../src';

<Meta title='Elements/Feedback/Progress/Design' component={Progress} />;

Pass the component you're documenting, as well as a title according to where you want your story to show up in navigation:

Example navigation

You can then add your documentation with markdown, embedded stories and images, as shown in this full example:

import { Canvas, Meta, Story } from '@storybook/addon-docs';
import { Progress } from '../src'

<Meta
  title="Elements/Feedback/Progress/Design"
  component={Progress}
/>

# Progress Indicator

Embedded story
<Canvas>
  <Story id="elements-feedback-progress--circular-progress-indeterminade-story" />
</Canvas>

Here is an image using Markdown:

![My image](/img/progress-image-demo.png)

Here is an image using MDX:

<img src="/img/progress-image-demo.png" alt="My image" />

版本与发布记录

@epilot/base-elements 共发布 264 个版本,首次发布于 2021/01/07;过去 12 个月发布了 4 个版本。

版本发布日期距今
4.0.2latest2026/09/092 个月前
4.0.12026/06/254 个月前
4.0.02026/06/224 个月前
3.10.32026/03/028 个月前
3.10.22025/09/021.2 年前
3.10.02025/07/281.3 年前

其他发布通道:next → 2.7.6-5。

关于 @epilot/base-elements 的常见问题

@epilot/base-elements 是什么?

General purpose React components for epilot UI elements.

如何安装 @epilot/base-elements?

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

@epilot/base-elements 支持 TypeScript 吗?

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

@epilot/base-elements 支持 ESM 还是 CommonJS?

以 CommonJS 形式发布,可以直接 require();在 ES Module 项目中也可以用 import 引入(Node.js 会把 module.exports 作为默认导出)。

@epilot/base-elements 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=18。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@epilot/base-elements 可以商用吗?

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

@epilot/base-elements 的下载量有多少?

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

@epilot/base-elements 还在维护吗?

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