Question

图片工具提供的功能需 依赖本地能力，所以以下 src 要求使用已存在的 本地 图片路径。
如需使用 远程 图片，请直接写 CSS。

bg: src, width, height

设置背景图片。

假如本地存在 logo.png, logo@2x.png, logo@3x.png 三种尺寸的图片，只需在 src 中填入一倍尺寸的图片路径即可，二倍、三倍尺寸的图片会自动设置妥当。

• src - 一倍尺寸的图片路径
• width (可选) - 图片宽度。不填或值为 null 时，会自动获取一倍尺寸图片的宽度
• height (可选) - 图片高度。不填或值为 null 时，会自动获取一倍尺寸图片的高度

相关的全局配置：

• $-image-dppx-range
• $-image-dppx-separator
• $-image-dppx-quality-first

// 测试环境
// 存在 "../img/logo.png" 与 "../img/logo@2x.png" 文件
// 图片 "../img/logo.png" 的宽度为 120px，高度为 80px
.logo
    bg: '../img/logo.png'

生成的 CSS：

.logo {
    background-image: url("../img/logo.png");
    background-size: 120px 80px;
    background-repeat: no-repeat;
}
@media (min-resolution: 2dppx), (min-resolution: 192dpi) {
    .logo {
        background-image: url("../img/logo@2x.png");
    }
}

同样是上面的例子，开启了 质量优先模式 ($-image-dppx-quality-first) 后，生成的 CSS：

.logo {
    background-image: url("../img/logo.png");
    background-size: 120px 80px;
    background-repeat: no-repeat;
}
@media (min-resolution: 1.5dppx), (min-resolution: 144dpi) {
    .logo {
        background-image: url("../img/logo@2x.png");
    }
}

可以看到，在 dppx 大于等于 1.5 时，就使用了 @2x 质量的图片。

ir: src, x, y, width, height

图片替换。隐藏文字并设置背景图片，可指定背景图片坐标。

与 bg() 类似，具备 Retina 图片的探测与背景图片的设置能力。
增加了容器内文字隐藏与 background-position 坐标设置的功能。

• src - 一倍尺寸的图片路径
• x (可选) -
• y (可选) -
• width (可选) - 图片宽度。不填或值为 null 时，会自动获取一倍尺寸图片的宽度
• height (可选) - 图片高度。不填或值为 null 时，会自动获取一倍尺寸图片的高度

相关的全局配置：

• $-image-dppx-range
• $-image-dppx-separator
• $-image-dppx-quality-first

相关：排版

// 测试环境
// 存在 "../img/logo.png" 与 "../img/logo@2x.png" 文件
// 图片 "../img/logo.png" 的宽度为 120px，高度为 80px
.logo
    ir: '../img/logo.png'

生成的 CSS：

.logo {
    color: transparent;
    font: 0/0 a;
    text-shadow: none;
    background-image: url("../img/logo.png");
    background-size: 120px 80px;
    background-repeat: no-repeat;
}
@media (min-resolution: 2dppx), (min-resolution: 192dpi) {
    .logo {
        background-image: url("../img/logo@2x.png");
    }
}

bg-dppx: dppx, src, width, height

根据传入的 图片尺寸倍数 与 图片地址，获取并计算出所需尺寸，生成相关样式。

• dppx - 图片的尺寸倍数
• src - 图片路径
• width (可选) - 图片宽度。不填或值为 null 时，会计算出所需的图片宽度
• height (可选) - 图片高度。不填或值为 null 时，会计算出所需的图片高度

// 传入 2 倍尺寸的图片，实际宽高为：640px, 88px
.slogan
    bg-dppx: 2, '../img/slogan.png'

转换为 CSS：

.slogan {
    background-image: url("../img/slogan.png");
    background-size: 320px 44px;
    background-repeat: no-repeat;
}

bg2x: src, width, height

使用效果参考 bg-dppx，它这是 bg-dppx: 2, src, width, height 的简写。

bg3x: src, width, height

使用效果参考 bg-dppx，它这是 bg-dppx: 3, src, width, height 的简写。