@ghs-hazard-pictograms/core

中文文档
2.0.0发布于 2026/11/16MITTypeScriptESM + CJS零依赖构建来源已验证近 30 天下载 5030

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

中文使用文档
文档目录14 节
  1. 安装
  2. 快开始
  3. API 参考
  4. pictograms
  5. getAllPictograms()
  6. getGHSPictograms()
  7. getPictogram(id)
  8. getPictogramsByCategory(category)
  9. 类型脚本
  10. Pictogram
  11. PictogramAssets
  12. PictogramCategory
  13. 相关软件包
  14. 链接

@ghs- 危险图片/ 分数

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

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

安装

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

快开始

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

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

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


getAllPictograms()

getAllPictograms(): Pictogram[]

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


getGHSPictograms()

getGHSPictograms(): Pictogram[]

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


getPictogram(id)

getPictogram(id: string): Pictogram | undefined

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

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

getPictogramsByCategory(category)

getPictogramsByCategory(category: PictogramCategory): Pictogram[]

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

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

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

类型脚本

Pictogram

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

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

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每种象形图的反应组件
@ghs-hazard-pictograms/cssCSS 有短工具类名称的图示工作表
@ghs-hazard-pictograms/assets静态 SVG/PNG/JPG/WebP 图像文件
@ghs-hazard-pictograms/sprite特别工作组 <symbol> 图标用于 <use href> 嵌入

版本与发布记录

@ghs-hazard-pictograms/core 共发布 8 个版本,首次发布于 2026/04/14;过去 12 个月发布了 8 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
2.0.0latest2026/11/16今天
1.2.02026/10/161 个月前
1.1.02026/05/156 个月前
1.0.52026/05/086 个月前
1.0.42026/04/147 个月前
1.0.22026/04/147 个月前

关于 @ghs-hazard-pictograms/core 的常见问题

@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 和提交记录判断。