less-retina-border

该工具基于 less 编写，解决移动端 1px 物理像素边框问题。

在 DPR = 2/3 的屏幕上会显示 0.5px/0.3333333px CSS 像素，即 1px 物理像素。

注意：此方式是通过将元素的 before 伪类先放大 200%/300%，再缩小为 0.5/0.3333，元素的 before 不能再做他用，但是可以使用元素的 after 伪类。

其他版本如下：

• stylus-retina-border

Features

• 可以模拟出 原生 CSS 的所有形式的边框，边框大小最小可以达到 1px 物理像素
• 通过 继承 功能，最终产出的代码量最少

使用方式

方式一：直接使用类名

<div class="retina-border-all">全边框</div>
<div class="retina-border-top">上边框</div>
<div class="retina-border-tr">上-右边框</div>

直接在标签元素的 class 特性里添加类名，默认边框设置为

• 边框宽度：1px
• 边框风格：solid
• 边框颜色：#e1e1e1
• 边框圆角：0

本工具提供一些内置的类名以供使用，其边框类型与类名、less 函数对应关系详见下表。

边框类型	类名	less 函数
全 边框	retina-border-all	#retina-border-all
上 边框	retina-border-top	#retina-border-top
右 边框	retina-border-right	#retina-border-right
下 边框	retina-border-bottom	#retina-border-bottom
左 边框	retina-border-left	#retina-border-left
上-右 边框	retina-border-tr	#retina-border-tr
上-下 边框	retina-border-tb	#retina-border-tb
上-左 边框	retina-border-tl	#retina-border-tl
右-下 边框	retina-border-rb	#retina-border-rb
右-左 边框	retina-border-rl	#retina-border-rl
下-左 边框	retina-border-bl	#retina-border-bl

表 1：边框类型与类名、less 函数对应关系

方式二：调用 less 函数，不传入参数

某些场景下无法直接在class里添加类名，可通过在 less 里调用对应的 less 函数，这些 less 函数与内置的类名同名，只是在类名前添加 #，边框类型与 less 函数的对应关系请见表 1。

// 全边框函数
.border-all {
    #retina-border-all;
}

// 上边框函数
.border-top {
    #retina-border-top;
}

// 上-右边框函数
.border-tr {
    #retina-border-tr;
}

方式三：调用 less 函数，传递参数

// 调用方式一：无参数名，参数值需按序传入
.border-xxx {
    #retina-border(border-width; border-style; border-color; border-radius);
}

// 调用方式二：有参数名，参数可无序传入
.border-xxx {
    #retina-border(@borderWidth: 1px; @borderColor: red);
}

在详细介绍传递参数调用 less 之前，需要隆重介绍一个函数，这个函数是整个解决方案的重中之重，核心中的核心，那就是 #retina-border 函数。之所以这么说，是因为所有的内置类名、内置 less 函数都是基于 #retina-border 函数实现的，只是传入的参数不一样而已。#retina-border函数共有四个参数，依次为：边框宽度、边框风格、边框颜色、边框圆角，只要原生 css 可以实现的边框，都可以通过使用 #retina-border 函数并依次传入四个参数实现其高清屏下 1px 版本。

如下以 #retina-border 为例，介绍 less 函数的两种调用方式。

（注意，只有 #retina-border 函数是四个参数，其他基于 #retina-border 实现的函数都只有三个参数）

• 调用方式一：无参数名，参数需按序传入

  • 参数依次为：边框宽度、边框风格、边框颜色、边框圆角，参数的使用方式同原生边框，可以简写，如
    • border-width：1px 或 1px 0 或 1px 0 1px 或 1px 2px 3px 4px
  • 参数间使用分号 ; 分隔，如果想省略参数，只能从最右参数依次向左省略，不能越过省略，如
    • #retina-border(border-width); √
    • #retina-border(border-style; border-color; border-radius); ×

• 调用方式二：有参数名，参数可无序传入

  • 参数为键值对，使用 : 分开，参数间使用 ; 隔开
  • 参数的键有 @borderWidth、@borderStyle、@borderColor、@borderRadius，参数间不区分顺序

此外，不仅 #retina-border 函数可以传入参数，使用方式三中介绍的与类名同名的内置 less 函数也可以传入参数使用，函数的调用方式同 #retina-border 函数，只是参数只有三个，依次是

• @borderStyle
• @borderColor
• @borderRadius

没有 @borderWidth 参数，宽度默认为 1px。如果有任何定制需求，请调用 #retina-border 函数。

.border-all {
    #retina-border-all(border-style; border-color; border-radius);
}
.border-right {
    #retina-border-right(border-style; border-color; border-radius);
}
.border-tr {
    #retina-border-tr(border-style; border-color; border-radius);
}

类名及 less 函数命名方式

• 一侧边框：retina-border-[top | right | bottom | left]
• 两侧边框：retina-border-[tr | tb | tl | rb | rl | bl]

其中，在两侧边框命名里，t 代表 top，r 代表 right，b 代表 bottom，l 代表 left，且 trbl 按上开始逆时针排序

版本更新