/ Illustrations

Illustrations

用于显示数据状态的插图集。

@gravity-ui/illustrations · npm package CI storybook

安装

npm install --save-dev @gravity-ui/illustrations

用法

React

准备工作

设置插画主题。执行以下任一步骤:

使用自定义颜色调色板定义 CSS 变量

在应用中定义以下 CSS 变量:

--gil-color-object-base: rgb(255, 190, 92);
--gil-color-object-accent-heavy: rgb(211, 101, 7);
--gil-color-object-hightlight: rgb(255, 216, 157);
--gil-color-shadow-over-object: rgb(211, 158, 80);
--gil-color-background-lines: rgb(140, 140, 140);
--gil-color-background-shapes: rgb(242, 242, 242);
--gil-color-object-accent-light: rgb(255, 255, 255);
--gil-color-object-danger: rgb(255, 0, 61);
在 SCSS 中使用带有默认 gravity-theme 的 mixin

使用以下 mixin 为不同主题的插画设置样式:

@import '@gravity-ui/illustrations/styles/theme.scss';

.g-root {
  &_theme_light {
    @include g-illustrations-colors-light;
  }

  &_theme_light-hc {
    @include g-illustrations-colors-light-hc;
  }

  &_theme_dark {
    @include g-illustrations-colors-dark;
  }

  &_theme_dark-hc {
    @include g-illustrations-colors-dark-hc;
  }
}
对于已安装 gravity 主题的项目,有另一种选择

或者,如果项目中已安装 @gravity-ui/uikit 并使用默认主题,您可以直接在项目根样式文件中导入 styles.scss

// 现有的 gravity 样式定义
import '@gravity-ui/uikit/styles/styles.css';
// 只需在下方添加另一个导入
import '@gravity-ui/illustrations/styles/styles.scss';

组件用法

import NotFound from '@gravity-ui/illustrations/NotFound';

或者

import {NotFound} from '@gravity-ui/illustrations';

SVG

您可能需要相应的加载器来处理此文件

import notFound from '@gravity-ui/illustrations/svgs/not-found-light.svg';

开发

要根据新设计更新插画,请更改 light 主题下的 SVG 文件内容(位于 <此仓库根目录>/svgs/<插画名称>-light.svg 文件中),然后运行以下命令:

npm run generate
关于库
星标
8
版本
2.1.0
最后更新
28.02.2025
代码仓库
github.com/gravity-ui/illustrations
许可证
MIT License
贡献者