Skip to content

Styles options

styles

  • Type: false | object | string
  • Default: false

File destination like src/css/spritemap.css or styles object (see below available options)

styles.filename

  • Type: string
  • Default: undefined

The destination of the stylesheet file like your source folder.

styles.lang

  • Type: 'less' | 'scss' | 'styl' | 'css' | undefined
  • Default: undefined

Enforce the styles language generated by the plugin. By default, this will be detected based by the extension of the filename. If not found, it will fallback to css.

styles.include

  • Type: boolean | ['mixin', 'variables'] | ['bg', 'mask', 'bg-frag'] | undefined
  • Default: ['mixin', 'variables'] for SCSS/Less/Stylus, ['bg', 'mask', 'bg-frag'] for CSS

This allowing you to choose what to include in the styles output payload.

styles.names

  • Type: { prefix: string, sprites: string, mixin: string }
  • Default: { prefix: 'sprites-prefix', sprites: 'sprites', mixin: 'sprite' }

Allow to customize the variables/mixin names of the generated Sass/Less/Stylus.

styles.callback

  • Type: Function | undefined
  • Default: undefined

Allow you to customize the output of the generated styles file (see Customize Styles Outputs).