Shortcuts

UnoCSS Shortcuts 系统,提供常用样式组合的快捷类名,简化开发并保持样式一致性。

基础用法

Tip

点击卡片可复制 shortcut 名称

empty
空值占位符(显示 --)
展开后的类名
empty:before:content-["--"]
flex-between
水平布局,两端对齐
展开后的类名
flex items-center justify-between
flex-col-between
垂直布局,两端对齐
展开后的类名
flex flex-col justify-between
form-card
表单卡片容器样式
展开后的类名
rounded bg-white px-6 pt-5 pb-1px
card-default
默认卡片容器样式
展开后的类名
rounded bg-white px-6 py-5
card-default-border
带边框的默认卡片样式
展开后的类名
rounded bg-white px-6 py-5 border border-solid border-gray-3
card-default-sm
小尺寸卡片容器样式
展开后的类名
rounded bg-white px-6 pt-4 pb-5
card-header
卡片头部容器样式
展开后的类名
flex items-center justify-between pb-4
card-header-title
卡片标题样式
展开后的类名
text-base-m truncate
card-header-extra
卡片头部额外操作区样式
展开后的类名
ml-4 flex-shrink-0 text-gray-6 cursor-pointer flex items-center gap-4
descriptions-title
描述列表标题样式
展开后的类名
font-600 text-gray-8 mb-4
descriptions
描述列表网格布局
展开后的类名
grid gap-x-6 gap-y-3 w-full grid-cols-1 md:grid-cols-2 lg:grid-cols-3 xl:grid-cols-4
descriptions-item
描述列表项样式
展开后的类名
flex gap-3 [&>:first-child]:text-gray-6 [&>:first-child]:text-nowrap [&>:last-child]:flex-1 [&>:last-child]:min-w-0
form-item-compact
紧凑型表单项样式
展开后的类名
[&_.ant-form-item-control-input]:min-h-22px [&_.ant-form-item-no-colon]:h-22px
tag-base
标签基础样式
展开后的类名
inline-block box-border rounded-xs border border-solid border-transparent
tag-default
默认标签样式
展开后的类名
inline-block box-border rounded-xs border border-solid border-transparent px-1 bg-gray-2 text-gray-7 text-xs
tag-default-lg
大尺寸默认标签样式
展开后的类名
inline-block box-border rounded-xs border border-solid border-transparent py-1px px-2 bg-gray-2 text-gray-7 text-sm
bg-body
页面背景色
展开后的类名
bg-#f5f5f5
tag-success
成功状态标签
展开后的类名
px-1 bg-gray-2 text-gray-7 text-xs border-success-1 bg-success-1 text-success
tag-error
错误状态标签
展开后的类名
px-1 bg-gray-2 text-gray-7 text-xs border-error-1 bg-error-1 text-error
tag-warning
警告状态标签
展开后的类名
px-1 bg-gray-2 text-gray-7 text-xs border-warning-1 bg-warning-1 text-warning
tag-success-lg
大尺寸成功状态标签
展开后的类名
py-1px px-2 bg-gray-2 text-gray-7 text-sm border-success-1 bg-success-1 text-success
tag-error-lg
大尺寸错误状态标签
展开后的类名
py-1px px-2 bg-gray-2 text-gray-7 text-sm border-error-1 bg-error-1 text-error
tag-warning-lg
大尺寸警告状态标签
展开后的类名
py-1px px-2 bg-gray-2 text-gray-7 text-sm border-warning-1 bg-warning-1 text-warning
tabs-no-border
无边框的 Tabs 样式
展开后的类名
[&_.ant-tabs-nav::before]:!border-none
pagination-bottom-0
底部无边距的分页样式
展开后的类名
[&_.ant-pagination]:mb-0

设计规范

占位符类

empty

空值占位符,用于数据为空时显示横线

布局类

用于快速实现常见布局结构的快捷类:

flex-between

水平布局,两端对齐(flex + items-center + justify-between)

flex-col-between

垂直布局,两端对齐(flex + flex-col + justify-between)

卡片类

统一的卡片容器样式,提供一致的视觉效果:

card-default

默认卡片样式(圆角 + 白色背景 + 标准内边距)

card-default-border

带边框的默认卡片样式

card-default-sm

小尺寸卡片样式(顶部内边距更小)

form-card

表单卡片样式(底部边距为 1px)From.Item 默认会有 margin-bottom: 24px;

卡片头部类

卡片区域的细分样式:

完整的卡片头部示例

描述列表类

用于展示键值对信息的网格布局:

完整的描述列表示例

标签类

统一的标签样式系统:

基础标签

状态标签

其他工具类

bg-body

页面背景色(#f5f5f5)

tabs-no-border

去除 Ant Design Tabs 组件导航栏底部的默认边框

pagination-bottom-0

去除 Ant Design Table 组件分页器的默认底部边距

使用建议

组件样式组合

// 完整的卡片结构
<div className="card-default">
  <div className="card-header">
    <div className="card-header-title">卡片标题</div>
    <div className="card-header-extra">额外操作</div>
  </div>
  <div className="pt-4">
    卡片内容
  </div>
</div>

// 描述列表
<div className="descriptions">
  <div className="descriptions-item">
    <span>标签</span>
    <span>内容值</span>
  </div>
</div>

标签状态

// 根据状态使用不同的标签样式
<span className="tag-success">成功</span>
<span className="tag-error">失败</span>
<span className="tag-warning">警告</span>

// 大尺寸标签
<span className="tag-success-lg">成功状态</span>

动态 Shortcuts

系统支持动态生成标签样式的 shortcuts:

  • tag-success / tag-success-lg
  • tag-error / tag-error-lg
  • tag-warning / tag-warning-lg

这些是通过正则匹配动态生成的,可以轻松扩展更多状态。

注意事项

  1. 语义化命名:shortcut 名称应清晰表达其用途
  2. 组合使用:多个 shortcuts 可以组合使用实现复杂效果
  3. 避免覆盖:使用 shortcuts 后如需调整,添加额外的类名而非修改 shortcut
  4. 保持一致:相同功能的组件应使用相同的 shortcuts