Shortcuts
UnoCSS Shortcuts 系统,提供常用样式组合的快捷类名,简化开发并保持样式一致性。
基础用法
Tip
点击卡片可复制 shortcut 名称
empty
空值占位符(显示 --)
展开后的类名
empty:before:content-["--"]flex-between
水平布局,两端对齐
展开后的类名
flex items-center justify-betweenflex-col-between
垂直布局,两端对齐
展开后的类名
flex flex-col justify-betweenform-card
表单卡片容器样式
展开后的类名
rounded bg-white px-6 pt-5 pb-1pxcard-default
默认卡片容器样式
展开后的类名
rounded bg-white px-6 py-5card-default-border
带边框的默认卡片样式
展开后的类名
rounded bg-white px-6 py-5 border border-solid border-gray-3card-default-sm
小尺寸卡片容器样式
展开后的类名
rounded bg-white px-6 pt-4 pb-5card-header
卡片头部容器样式
展开后的类名
flex items-center justify-between pb-4card-header-title
卡片标题样式
展开后的类名
text-base-m truncatecard-header-extra
卡片头部额外操作区样式
展开后的类名
ml-4 flex-shrink-0 text-gray-6 cursor-pointer flex items-center gap-4descriptions-title
描述列表标题样式
展开后的类名
font-600 text-gray-8 mb-4descriptions
描述列表网格布局
展开后的类名
grid gap-x-6 gap-y-3 w-full grid-cols-1 md:grid-cols-2 lg:grid-cols-3 xl:grid-cols-4descriptions-item
描述列表项样式
展开后的类名
flex gap-3 [&>:first-child]:text-gray-6 [&>:first-child]:text-nowrap [&>:last-child]:flex-1 [&>:last-child]:min-w-0form-item-compact
紧凑型表单项样式
展开后的类名
[&_.ant-form-item-control-input]:min-h-22px [&_.ant-form-item-no-colon]:h-22pxtag-base
标签基础样式
展开后的类名
inline-block box-border rounded-xs border border-solid border-transparenttag-default
默认标签样式
展开后的类名
inline-block box-border rounded-xs border border-solid border-transparent px-1 bg-gray-2 text-gray-7 text-xstag-default-lg
大尺寸默认标签样式
展开后的类名
inline-block box-border rounded-xs border border-solid border-transparent py-1px px-2 bg-gray-2 text-gray-7 text-smbg-body
页面背景色
展开后的类名
bg-#f5f5f5tag-success
成功状态标签
展开后的类名
px-1 bg-gray-2 text-gray-7 text-xs border-success-1 bg-success-1 text-successtag-error
错误状态标签
展开后的类名
px-1 bg-gray-2 text-gray-7 text-xs border-error-1 bg-error-1 text-errortag-warning
警告状态标签
展开后的类名
px-1 bg-gray-2 text-gray-7 text-xs border-warning-1 bg-warning-1 text-warningtag-success-lg
大尺寸成功状态标签
展开后的类名
py-1px px-2 bg-gray-2 text-gray-7 text-sm border-success-1 bg-success-1 text-successtag-error-lg
大尺寸错误状态标签
展开后的类名
py-1px px-2 bg-gray-2 text-gray-7 text-sm border-error-1 bg-error-1 text-errortag-warning-lg
大尺寸警告状态标签
展开后的类名
py-1px px-2 bg-gray-2 text-gray-7 text-sm border-warning-1 bg-warning-1 text-warningtabs-no-border
无边框的 Tabs 样式
展开后的类名
[&_.ant-tabs-nav::before]:!border-nonepagination-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 组件分页器的默认底部边距
使用建议
组件样式组合
标签状态
动态 Shortcuts
系统支持动态生成标签样式的 shortcuts:
tag-success/tag-success-lgtag-error/tag-error-lgtag-warning/tag-warning-lg
这些是通过正则匹配动态生成的,可以轻松扩展更多状态。
注意事项
- 语义化命名:shortcut 名称应清晰表达其用途
- 组合使用:多个 shortcuts 可以组合使用实现复杂效果
- 避免覆盖:使用 shortcuts 后如需调整,添加额外的类名而非修改 shortcut
- 保持一致:相同功能的组件应使用相同的 shortcuts