@dnanpm/styleguide

中文文档
4.0.14发布于 2026/09/28ISCTypeScriptESM + CJS近 30 天下载 3170

DNA Styleguide寄存器提供了各种DNA项目中使用的一组组件和主题对象.

中文使用文档
文档目录9 节
  1. 安装
  2. 文档
  3. 交互式文档和API
  4. 更改日志
  5. 移徙指南
  6. 贡献指南
  7. 用法实例
  8. 主题
  9. 构成部分

DNA Styleguide寄存器提供了各种DNA项目中使用的一组组件和主题对象.

安装

在应添加DNA样式指南的仓库中运行安装命令

npm install @dnanpm/styleguide

文档

[注] 需要访问DNA Cloud URL!

交互式文档和API

见最新版本 DNA 样式指南 用于主题文档、 API 和组件的交互式文档.

更改日志

见 更改日志 用于当前主要版本修改,或 Changelog 归档 对于旧的主要版本的修改.

移徙指南

见 移徙指南 用于了解如何在DNA样式指南的主要版本之间迁移的更多信息.

贡献指南

见 贡献指南 关于如何为DNA样式指南做出贡献的更多信息.

用法实例

主题

import { theme as defaultTheme } from '@dnanpm/styleguide';

const color = {
    ...defaultTheme.color,
    background: '#000000',
};

const iconSize = {
    default: '0.75em',
    defaultMobile: '2em',
};

const theme = {
    ...defaultTheme,
    colors,
    iconSize,
};

export type ThemeInterface = typeof theme;
export default theme;
import theme from './theme';

class MyApp {
    public render() {
        const { Component, pageProps } = this.props;

        return (
            <ThemeProvider theme={theme}>
                <Component {...pageProps} />
            </ThemeProvider>
        );
    }
}

构成部分

import { ButtonPrimary } from '@dnanpm/styleguide';

interface Props {
    myProp?: string;
}

const MyComponent = ({
    myProp,
}: Props) => {
    return (
        <ButtonPrimary>{myProp || 'Lorem Ipsum'}</ButtonPrimary>
    );
};

export default MyComponent;

版本与发布记录

@dnanpm/styleguide 共发布 88 个版本,首次发布于 2019/09/20;过去 12 个月发布了 15 个版本。

版本发布日期距今
4.0.14latest2026/09/281 个月前
4.0.132026/09/072 个月前
4.0.122026/08/312 个月前
4.0.112026/07/144 个月前
4.0.102026/05/295 个月前
4.0.92026/05/046 个月前

关于 @dnanpm/styleguide 的常见问题

@dnanpm/styleguide 是什么?

DNA Styleguide寄存器提供了各种DNA项目中使用的一组组件和主题对象.

如何安装 @dnanpm/styleguide?

在项目目录运行 npm install @dnanpm/styleguide,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:react(>=17.x <=19.x)、react-dom(>=17.x <=19.x)、@dnanpm/icons(^2.x)、styled-components(6.x)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@dnanpm/styleguide 支持 TypeScript 吗?

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

@dnanpm/styleguide 支持 ESM 还是 CommonJS?

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

@dnanpm/styleguide 需要什么版本的 Node.js?

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

@dnanpm/styleguide 可以商用吗?

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

@dnanpm/styleguide 的下载量有多少?

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

@dnanpm/styleguide 还在维护吗?

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