工具类规则
ng-alain
在 Ant Design 的基础上生产一套尺寸、间距、颜色等工具类。
尺寸
我认为这些工具类只会运用在内容区域,因此,按 Ant Design 的规范,尺寸的宽度是以一个 8px
Gutter 基础间距为基础;并衍生出三个尺寸,分别为:
名称 | 公式 | 尺寸 | 说明 |
---|---|---|---|
sm |
$gutter | 8px | 小号 |
md |
$gutter * 2 | 16px | 中号 |
lg |
$gutter * 3 | 24px | 大号 |
依这些尺寸规则,衍生出尺寸微调整的类,这些类包括 margin
、padding
,其命名规则如下。
类型包括:padding
、margin
。
方向包括:top
、right
、bottom
、left
、x
(left
、right
)、y
(top
、bottom
);方向为可选。
消除
[<类型>p|m][<方向>t|r|b|l|x|y]?0
基础
[<类型>p|m][<方向>t|r|b|l|x|y]?-[<尺寸>sm|md|lg]
示例:
.p-sm { padding: 8px !important; } .pt-sm { padding-top: 8px !important; } .m-sm { margin: 16px !important; } .mt-md { margin-top: 16px !important; } .p0 { padding: 0 !important; }
色彩
Ant Design 并没有按钮色这一说,而是以视觉效果为基准。nz-button
包括四种类型:primary
、dashed
等。但 primary
是固定的蓝色系列,这是默认色系。
而 ng-alain
依然不会破坏这种规则,但依 色彩 章节,我产生了一种运用于文本、背景的色系类。
色彩一共有十种,前九种依色彩为准,以及新增一种 teal【#20c997】
(别问我为什么,我就喜欢偶数而已),分别如下:
名称 | 基本色 | 说明 |
---|---|---|
red |
#f04134 |
热情、警示 |
green |
#00a854 |
成功、通过、安全 |
blue |
#108ee9 |
专业、科技 |
pink |
#f5317f |
典雅、明快、女性 |
orange |
#f56a00 |
醒目、温暖 |
purple |
#7265e6 |
高雅、浪漫 |
yellow |
#ffbf00 |
活力、提示 |
cyan |
#00a2ae |
清新、冷静、结构化 |
grey |
#bfbfbf |
平稳、中性 |
teal |
#20c997 |
这些色彩会衍生出 10 种渐变色,然而每一种渐变色要想产生一个有效的命名(10 * 10)非常困难。因此,我只衍生三种颜色规则,分别为:
名称 | 色号 |
---|---|
light |
5号 |
normal |
6号 |
dark |
7号 |
然后依以下规则产生:
类型包括:text
、background-color
、background-color:hover
。
[<类型>text|bg]-[<色彩名>red|green|blue|pink|orange|purple|yellow|cyan|teal|grey](-[light|dark])?(-h)?
normal
本身即是基本色,所以实际无须加上 normal
grey
可能会更常用,因此,除了grey-light
、grey-dark
额外增加了grey-lighter
、grey-darker
表示更浅深度。
示例:
// Text color .text-red-light { color: #fabeb9 !important; } .text-red { color: #f04134 !important; } .text-red-dark { color: #a31837 !important; } // background-color color .bg-red-light { background-color: #fabeb9 !important; } .bg-red { background-color: #f04134 !important; } .bg-red-dark { background-color: #a31837 !important; } // hover color .bg-red-light-h { &:hover { background-color: #fabeb9 !important; } } .bg-red-h { &:hover { background-color: #f04134 !important; } } .bg-red-dark-h { &:hover { background-color: #a31837 !important; } }
别名
实际上 Ant Design 提供一套类似 bootstrap 的命名方式的别名规则。只是,我们无法使用到这里内置的而已,这些别名包括:
别名 | 色系 |
---|---|
primary |
blue |
success |
green |
error |
red |
warning |
yellow |
进而,我将取转化成文本与背景,其命名规则同上面一样,只是将色彩名变成为别名而已。
示例:
// Text color .text-error-light { color: #fabeb9 !important; } .text-error { color: #f04134 !important; } .text-error-dark { color: #a31837 !important; } // background-color color .bg-error-light { background-color: #fabeb9 !important; } .bg-error { background-color: #f04134 !important; } .bg-error-dark { background-color: #a31837 !important; } // hover color .bg-error-light-h { &:hover { background-color: #fabeb9 !important; } } .bg-error-h { &:hover { background-color: #f04134 !important; } } .bg-error-dark-h { &:hover { background-color: #a31837 !important; } }
Clearfix
ng-zoroo-antd
自带清除浮动 .clearfix
。
Display
别名 | CSS |
---|---|
d-none |
display: none |
d-block |
display: block |
d-inline-block |
display: inline-block |
d-flex |
display: flex |
d-inline-flex |
display: inline-flex |
Float
名称 | 说明 |
---|---|
fixed-top |
顶部 |
fixed-bottom |
底部 |
Text
Sizing
Ant Design 是以 12px
为基准字号。
名称 | 说明 |
---|---|
text-sm |
12px |
text-md |
24px |
text-lg |
36px |
Alignment
名称 | 说明 |
---|---|
text-left |
文本居左 |
text-center |
文本居中 |
text-right |
文本居右 |
Wrapping
**容器必须是 display: inline-block
或 display: block
。
名称 | 说明 |
---|---|
text-nowrap |
文本超出不换行 |
text-truncate |
文本超出截取并加 ... |
Transformation
名称 | 说明 |
---|---|
text-lowercase |
小写文本 |
text-uppercase |
大写文本 |
text-capitalize |
首词大写 |
text-deleted |
删除线 |
Weight and italics
名称 | 说明 |
---|---|
font-weight-normal |
font-weight: normal |
font-weight-bold |
font-weight: 700 |
font-italic |
font-style: italic |
Borders
边框
名称 | 说明 |
---|---|
border |
border: 1px solid #f5f5f5 !important; |
border-0 |
border: 0 !important; |
border-top-0 |
border-top: 0 !important; |
border-right-0 |
border-right: 0 !important; |
border-bottom-0 |
border-bottom: 0 !important; |
border-left-0 |
border-left: 0 !important; |
颜色
支持色彩章节所有的色系&别名写法,例如:border-red
、border-success
。
圆角
名称 | 说明 |
---|---|
rounded-0 |
border-radius: 0; |
rounded-circle |
border-radius: 50%; |
rounded-sm |
border-radius: 2px; |
rounded-md |
border-radius: 4px; |
rounded-lg |
border-radius: 6px; |
Width
名称 | 说明 |
---|---|
width-sm |
160px |
width-md |
240px |
width-lg |
320px |
Responsive
类似 Bootstrap 响应式规则,当屏幕小于 480px
时会隐藏所有 hidden-xs
类。
名称 | 屏幕 |
---|---|
hidden-xs |
<480px |
hidden-sm |
<768px |
hidden-md |
<992px |
hidden-lg |
<1200px |
Other
名称 | 说明 |
---|---|
block-center |
margin: 0 auto |
point |
cursor: pointer |
no-resize |
设置不允许调整元素 |