@designtools/cascade

中文文档
0.1.4发布于 2026/03/19MITTypeScriptESM + CJS零依赖近 30 天下载 1.3万

CSS布局属性图标. 15x15 SVG,反应组件,可树摇.

中文使用文档
文档目录9 节
  1. 安装
  2. 使用量
  3. 道具
  4. 无障碍
  5. 原始 SVGs 软件
  6. 元数据
  7. 类别
  8. 兼容性
  9. 许可证

@ 设计工具/ 套件

CSS 29 个属性及其值的手工图标. 用来设计说出代码的工具.

反应组件和生SVG. 每个图标都符合一个15x15像素网格,并有1x分辨率的脆边.

带给你的 flett.cc (英语)

安装

npm install @designtools/cascade

使用量

import { DisplayFlex, PaddingTop, FlexDirectionRow } from "@designtools/cascade";

function App() {
  return (
    <div>
      <DisplayFlex />
      <PaddingTop />
      <FlexDirectionRow />
    </div>
  );
}

道具

每个图标组件接受以下道具以及所有标准SVG属性(SVGAttributes<SVGSVGElement>:

Prop类型默认说明
colorstringcurrentColor图标颜色。 默认从父文本颜色继承 .
solidbooleanfalse完全不透明地发作(strips duotone flowing). 对非duotone图标没有影响.
widthnumber | string15图标宽度。 使用15的倍数进行像素完美渲染.
heightnumber | string15图标高. 使用15的倍数进行像素完美渲染.
<DisplayFlex color="#6366f1" />
<DisplayFlex solid />
<DisplayFlex width={30} height={30} />

任何标准的SVG属性(例如. className, (中文(简体) ), style, (中文(简体) ), aria-hidden)也可以直接通过.

无障碍

没有图标的船 aria-hidden 因此消费者可以决定每个使用案例.

装饰性 (最常见的)——添加 aria-hidden="true"数字 :

<label>
  <DisplayFlex aria-hidden="true" />
  Flex
</label>

独立/意义 ——使用 aria-label数字 :

<button aria-label="Set display to flex">
  <DisplayFlex aria-hidden="true" />
</button>

原始 SVGs 软件

静态 .svg 文件包含在 svg/ 用于外部 React 的目录.

元数据

包输出 a metadata 将 CSS 属性/ 值映射到图标名称 :

import { metadata } from "@designtools/cascade";

// Each entry: { property: string, value: string | null, icon: string }
metadata.forEach((entry) => {
  console.log(`${entry.property}: ${entry.value} → ${entry.icon}`);
});

用于构建图标拾取器,文档,或编辑器在程序上集成.

类别

类别图标实例
显示第8条DisplayBlock, (中文(简体) ), DisplayFlex, (中文(简体) ), DisplayGrid, (中文(简体) ), DisplayNone
弹性方向页:1FlexDirectionRow, (中文(简体) ), FlexDirectionColumn
弹性包装3个FlexWrapWrap, (中文(简体) ), FlexWrapNowrap
弹性生长/收缩2个FlexGrow, (中文(简体) ), FlexShrink
说明内容6个JustifyContentCenter, (中文(简体) ), JustifyContentSpaceBetween
对齐项目第7条AlignItemsCenter, (中文(简体) ), AlignItemsStretch
对齐自己第8条AlignSelfCenter, (中文(简体) ), AlignSelfStretch
对齐内容第9条AlignContentCenter, (中文(简体) ), AlignContentSpaceBetween
职位页:1PositionAbsolute, (中文(简体) ), PositionSticky
铺垫页:1PaddingAll, (中文(简体) ), PaddingTop
边距页:1MarginAll, (中文(简体) ), MarginTop
差距2个GapColumn, (中文(简体) ), GapRow
大小2个SizeHorizontal, (中文(简体) ), SizeVertical
轴2个AxisX, (中文(简体) ), AxisY
边界半径页:1BorderRadiusAll, (中文(简体) ), BorderRadiusTopLeft
边框样式/ 宽度2个BorderStyle, (中文(简体) ), BorderWidth
过多页:1OverflowVisible, (中文(简体) ), OverflowScroll
文本对齐页:1TextAlignLeft, (中文(简体) ), TextAlignCenter
文字装饰3个TextDecorationUnderline, (中文(简体) ), TextDecorationNone
文本转换3个TextTransformUppercase, (中文(简体) ), TextTransformCapitalize
类型页:1FontFamily, (中文(简体) ), FontSize, (中文(简体) ), FontWeight, (中文(简体) ), LineHeight, (中文(简体) ), LetterSpacing
不透明度1个Opacity
框阴影1个BoxShadow

兼容性

包裹两只 无害环境管理 (单位:千美元).mjs和 司法理事会 (单位:千美元).cjs)捆绑了完整的TypeScript声明. 它与任何现代的捆绑或运行时间一起在盒子外工作:

格式入境点用于
无害环境管理dist/index.mjsVite, Next.js, 网页包装 5+, 建设
司法理事会dist/index.cjs节点.js require(),旧捆绑者
类型dist/index.d.ts类型脚本

这个 exports 地图在 package.json 确保正确格式自动解决。 软件包是标记的 sideEffects: false,因此导入一个图标不会捆绑其余部分.

要求数 反应 18+ 作为同伴的依赖.

许可证

麻省理工学院. 生成自 间 (单位:千美元).

版本与发布记录

@designtools/cascade 共发布 4 个版本,首次发布于 2026/03/18;过去 12 个月发布了 4 个版本。

版本发布日期距今
0.1.4latest2026/03/197 个月前
0.1.32026/03/197 个月前
0.1.22026/03/187 个月前
0.1.12026/03/187 个月前

关于 @designtools/cascade 的常见问题

@designtools/cascade 是什么?

CSS布局属性图标. 15x15 SVG,反应组件,可树摇.

如何安装 @designtools/cascade?

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

@designtools/cascade 支持 TypeScript 吗?

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

@designtools/cascade 支持 ESM 还是 CommonJS?

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

@designtools/cascade 可以商用吗?

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

@designtools/cascade 的下载量有多少?

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

@designtools/cascade 还在维护吗?

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