# @ghs-hazard-pictograms/core 中文文档

规范地址：https://npmcn.com/package/%40ghs-hazard-pictograms/core/

版本：2\.0\.0
npm 元数据更新时间：2026-11-15T22:16:01.317Z
中文译文更新时间：2026-11-16T08:05:42.233Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40ghs-hazard-pictograms/core
原文对照：https://npmcn.com/package/%40ghs-hazard-pictograms/core/?lang=original
项目主页：https://karlnorling.github.io/ghs-hazard-pictograms/
源码仓库：https://github.com/karlnorling/ghs-hazard-pictograms

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：566 kB，36 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：0 个
- 首次发布：2026-04-14T12:32:47.973Z
- 最新版本发布：2026-11-15T22:16:00.958Z
- 近 30 天下载量：5030（2026-10-17 至 2026-11-15，npm 官方下载统计）
- 已发布版本数：8（近 12 个月 8 个）

## 中文简介

TypeScript 登记和查找全球统一制度危险和ADR/UN运输象形图的帮助者——包括内置SVG、资产路径和说明

## 安装

```sh
npm install @ghs-hazard-pictograms/core
```

也可以使用：`pnpm add @ghs-hazard-pictograms/core`、`yarn add @ghs-hazard-pictograms/core`、`bun add @ghs-hazard-pictograms/core`

## README

# @ghs- 危险图片/ 分数

所有全球统一制度化学品危险象形图(GHS01-GHS09)和联合国运输危险类象形图的数据、类型和查询助手.

这是本集其他包所消耗的基础包. 当需要程序访问象形元数据、内置SVG或资产路径时直接使用它——而不与任何UI框架相接.

## 安装

```sh
npm install @ghs-hazard-pictograms/core
# or
yarn add @ghs-hazard-pictograms/core
# or
pnpm add @ghs-hazard-pictograms/core
```

## 快开始

```ts
import { getPictogram, getGHSPictograms, getAllPictograms } from '@ghs-hazard-pictograms/core';

// Look up a single pictogram by slug ID
const explosive = getPictogram('ghs01-explosive');
console.log(explosive?.name); // "Explosive"
console.log(explosive?.code); // "GHS01"
console.log(explosive?.category); // "physical_hazards"

// Render the inline SVG directly
document.getElementById('icon')!.innerHTML = explosive!.svg;

// Get all 9 core GHS pictograms
const ghsPictograms = getGHSPictograms();

// Get every pictogram (GHS + transport)
const all = getAllPictograms();
console.log(all.length); // 27
```

## API 参考

### `pictograms`

```ts
import { pictograms } from '@ghs-hazard-pictograms/core';
```

所有27个象形图的预建阵列. 包括9个全球统一制度化学品危险象形图和18个联合国运输危险类象相图.

* * *

### `getAllPictograms()`

```ts
getAllPictograms(): Pictogram[]
```

返回登记册中的每个象形图(GHS01-GHS09加上所有运输类别).

* * *

### `getGHSPictograms()`

```ts
getGHSPictograms(): Pictogram[]
```

只返回9个核心全球统一制度化学品危险象形图(GHS01-GHS09),不包括联合国运输类别.

* * *

### `getPictogram(id)`

```ts
getPictogram(id: string): Pictogram | undefined
```

以弹道识别器显示一个象形图 回返 `undefined` 如果找不到的话.

```ts
getPictogram('ghs01-explosive');
getPictogram('ghs09-hazardous-to-the-environment');
getPictogram('divisions-1-1-1-3'); // transport
getPictogram('un-class-8'); // transport
```

* * *

### `getPictogramsByCategory(category)`

```ts
getPictogramsByCategory(category: PictogramCategory): Pictogram[]
```

返回属于指定类别的所有象形图.

```ts
import { getPictogramsByCategory } from '@ghs-hazard-pictograms/core';

const physical = getPictogramsByCategory('physical_hazards');
const transport = getPictogramsByCategory('transport');
```

## 类型脚本

### `Pictogram`

```ts
interface Pictogram {
  /** Slug identifier, e.g. "ghs01-explosive". */
  id: string;
  /** GHS code, e.g. "GHS01". Empty string for transport-only pictograms. */
  code: string;
  /** Human-readable name, e.g. "Explosive". */
  name: string;
  /** Pictogram category. */
  category: PictogramCategory;
  /** Documentation text from Wikipedia describing the hazard classes covered. */
  description: string;
  /** Full inline SVG string (optimised by SVGO). */
  svg: string;
  /** Pre-built image asset paths at multiple sizes and formats. */
  assets: PictogramAssets;
}
```

### `PictogramAssets`

```ts
interface PictogramAssets {
  /** Relative path to the original SVG source file. */
  svg: string;
  /** Map of pixel size → relative path for PNG variants. */
  png: Record<number, string>;
  /** Map of pixel size → relative path for JPEG variants. */
  jpg: Record<number, string>;
  /** Map of pixel size → relative path for WebP variants. */
  webp: Record<number, string>;
}
```

可用大小 : **240、512、768、1024、2048** px2 (英语).

### `PictogramCategory`

```ts
type PictogramCategory =
  | 'physical_hazards' // GHS01–GHS05 (explosive, flammable, oxidising, compressed gas, corrosive)
  | 'health_hazards' // GHS06–GHS08 (toxic, health hazard, serious health hazard)
  | 'physical_and_health_hazards' // unused: GHS05 is filed under physical_hazards
  | 'environmental_hazards' // GHS09 (hazardous to the aquatic environment)
  | 'transport'; // UN transport hazard class pictograms (divisions 1.1–9)
```

## 相关软件包

| 软件包 | 说明 |
| --- | --- |
| [`@ghs-hazard-pictograms/react`](https://www.npmjs.com/package/@ghs-hazard-pictograms/react) | 每种象形图的反应组件 |
| [`@ghs-hazard-pictograms/css`](https://www.npmjs.com/package/@ghs-hazard-pictograms/css) | CSS 有短工具类名称的图示工作表 |
| [`@ghs-hazard-pictograms/assets`](https://www.npmjs.com/package/@ghs-hazard-pictograms/assets) | 静态 SVG/PNG/JPG/WebP 图像文件 |
| [`@ghs-hazard-pictograms/sprite`](https://www.npmjs.com/package/@ghs-hazard-pictograms/sprite) | 特别工作组 `<symbol>` 图标用于 `<use href>` 嵌入 |

## 链接

-   **文档 :** [(原始内容存档于2013-10-12). karlnorling.github.io/ghs-危险-相图](https://karlnorling.github.io/ghs-hazard-pictograms/)
-   **资料来源:** [github.com/karlnorling/ghs-危险相图](https://github.com/karlnorling/ghs-hazard-pictograms)
-   **问题:** [github.com/karlnorling/ghs-危险图/问题](https://github.com/karlnorling/ghs-hazard-pictograms/issues)

## 常见问题

### @ghs-hazard-pictograms/core 是什么？

TypeScript 登记和查找全球统一制度危险和ADR/UN运输象形图的帮助者——包括内置SVG、资产路径和说明

### 如何安装 @ghs-hazard-pictograms/core？

在项目目录运行 npm install @ghs-hazard-pictograms/core，或使用 pnpm add / yarn add / bun add。

### @ghs-hazard-pictograms/core 支持 TypeScript 吗？

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

### @ghs-hazard-pictograms/core 支持 ESM 还是 CommonJS？

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

### @ghs-hazard-pictograms/core 可以商用吗？

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

### @ghs-hazard-pictograms/core 的下载量有多少？

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

### @ghs-hazard-pictograms/core 还在维护吗？

最新版本 2\.0\.0 发布于 2026/11/16（今天）；至今共发布 8 个版本，其中过去 12 个月发布了 8 个；首次发布于 2026/04/14。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。

