IconTile
icon-tile把一个图标放进带底色的小方块,排在功能或通知文字的左边
用法
基础用法
功能列表 / 通知流里「图标 + 文字」最左边那一格,默认主色浅底;图标尺寸随档,不必自己写。
MCP 服务
一行命令装上,助手查 props 而不是猜 props。
tsx
<IconTile><Plug /></IconTile>
<div>
<Text weight="semibold">MCP 服务</Text>
<Text size="sm" tone="muted">一行命令装上,助手查 props 而不是猜 props。</Text>
</div>变体 × 语义色
soft 浅底、solid 实底、outline 中性描边只染图标;六档语义色与 Tag / Button 同一口径。
tsx
<IconTile tone="success" variant="soft"><Bell /></IconTile>
<IconTile tone="success" variant="solid"><Bell /></IconTile>
<IconTile tone="success" variant="outline"><Bell /></IconTile>尺寸
sm 32px / md 36px / lg 40px,圆角与图标尺寸跟着走。
tsx
<IconTile size="sm"><ShieldCheck /></IconTile>
<IconTile size="md"><ShieldCheck /></IconTile>
<IconTile size="lg"><ShieldCheck /></IconTile>分类色
color 接语义色名或任意 CSS 色,覆盖 tone —— 通知流里按事件类别区分颜色。
tsx
<IconTile variant="solid" color="chart-1"><ShoppingBag /></IconTile>
<IconTile variant="solid" color="chart-4"><MessageCircle /></IconTile>
<IconTile variant="solid" color="chart-5"><Rocket /></IconTile>何时用
功能列表、通知流、产品线卡片、设置项里「图标 + 一段文字」最左边那一格。三档尺寸、三档变体、六档语义色与任意分类色。只要一个裸图标就直接放图标;要头像(人 / 账号)用 Avatar;要品牌徽章用 Brand。
导入
ts
import { IconTile } from "@hulianui/ui"Props
| 名称 | 类型 | 默认 | 说明 |
|---|---|---|---|
| tone | "brand" | "neutral" | "info" | "success" | "warning" | "danger" | "brand" | 语义色档,与 Tag / Button 同一口径 |
| variant | "soft" | "solid" | "outline" | "soft" | soft 浅语义底 + 语义色图标;solid 实心语义底 + 前景色图标;outline 中性描边卡面底,只有图标带语义色 |
| size | "sm" | "md" | "lg" | "md" | 32 / 36 / 40px,圆角与图标尺寸随档 |
| color | string | - | 分类色:语义色名(chart-3 …)、任意 CSS 色或 var(--color-*),覆盖 tone,三档变体都从它派生 |
继承<span>原生属性。默认aria-hidden(旁边总有文字说明);要单独表意时传role="img"+aria-label。
Slots
| 插槽 | 类型 | 说明 |
|---|---|---|
| children | ReactNode | 图标(lucide 等 SVG),尺寸由组件按档给 |
禁忌 / 坑
- 图标尺寸由组件按档给(
[&>svg]),图标上不要再写size-*类,否则各档尺寸对不齐。 - 默认
aria-hidden:它是装饰,语义由旁边的文字承担;单独出现、需要读屏念出来时才传role="img"+aria-label。
相关
Playground
<IconTile variant="soft" tone="brand" size="md">
<Bell />
</IconTile>