1.0.5 • Published 4 years ago

sprite-smith-loader v1.0.5

Weekly downloads
284
License
MIT
Repository
github
Last release
4 years ago

image image

介绍

sprite-smith-loader是一款自动生成雪碧图工具,你可以在webpack中使用它,它会遍历css中以_sprite.png结尾的图片并自动生成雪碧图,然后修改相应的css代码。

支持CSSSASSLESS

图片应为png格式(不要直接将jpg图片后缀改为png)。

安装

下载sprite-smith-loader

npm install --save-dev sprite-smith-loader remove-file-webpack-plugin

配置

将loader添加到webpack的配置中,必须放在css-loader之后,别忘了添加file-loader或url-loader处理图片路径。

webpack.config.js

// 添加 remove-file-webpack-plugin 来清理 sprites文件夹
const RemoveFileWebpackPlugin = require('remove-file-webpack-plugin'); 

module.exports = {
  module: {
    rules: [
        {
            test: /\.(png|jpe?g|gif)$/i,
            loader: 'file-loader',
            options: {
                outputPath: 'images',
            },
        },
        {
            test: /\.css$/i,
            use: ['style-loader', 'css-loader','sprite-smith-loader'],
        }
    ],
  },
  plugins: [
    new RemoveFileWebpackPlugin({
        dirNames:["sprites"]
    })
  ],
};

配合SASS

const RemoveFileWebpackPlugin = require('remove-file-webpack-plugin'); 

module.exports = {
  module: {
    rules: [
        {
            test: /\.(png|jpe?g|gif)$/i,
            loader: 'file-loader',
            options: {
                outputPath: 'images',
            },
        },
        {
            test: /\.(sass|scss|css)/,
            use: ['style-loader', 'css-loader','sprite-smith-loader',"sass-loader"],
        }
    ],
  },
  plugins: [
    new RemoveFileWebpackPlugin({
        dirNames:["sprites"]
    })
  ],
};

使用

修改图片名以 _sprite.png 结尾,并在css中引入它

.my_bg_1{
    height: 100px;
    width: 100px;
    background: url('./demo1_sprite.png') 0px 0px;
    background-size: 100px 100px;
}

.my_bg_2{
    height: 100px;
    width: 100px;
    background: url('./demo2_sprite.png') -20px -20px;
    background-size: 150px 150px;
}

只要你遵循以下规范,loader会在css中引入生成的雪碧图作为新的背景图,并替换background-size、background-position等属性。

属性名是否必填说明
heighttrue单位为 px
widthtrue单位为 px
background-sizetrue单位为 px
backgroundtrue包含 image,position,repeat
background-imagetrue包含于 background,图片名以 _sprite.png结尾
background-positionfalse包含于 background,值为 px px 的形式
background-repeatfalse不要填no-repeat以外的值

License

MIT