Styles

wemake-vue-template
Search…
Introduction
Architecture
Styles
We use a combination of scss and css-modules for our styles by adding the lang="scss" and module attributes to <style> tag:
1
<style lang="scss" module>
2
.link {
3
  width: 10px;
4
}
5
</style>
Copied!
We also enforce strong linting of styles to keep it consistent and find possible errors early.
Global CSS
If you want to use any global css here's what you need to do:
1.
Install the library you need: npm run add normalize.css
2.
Add the file path to css property of nuxt.config.ts​
It will look something like so:
1
  /**
2
  * Global CSS
3
  */
4
  css: [
5
    'normalize.css/normalize.css'
6
  ],
Copied!
This file will be included in the final build.
Layout specific styles
Every layout in client/layouts/ is not scoped or bundled in a module. It is required to drop some global styles for all components that are using this layout.
SCSS
We use scss to write components' styles. Because it is just like css. But better! You can just drop-in any plain css and it will work with no any other actions required.
scss is a preprocessor. It means, that scss get compiled to css later. And before it is compiled scss allows to use features that are missing from css3 spec, including:
​variables​
​nesting​
​mixins​
That's the bare minimum you need to know to productively use scss.
Aliases and imports
We have a preconfigured ~/scss alias inside nuxt.config.ts to import local files. You can use it inside Vue components like so:
1
<style lang="scss" module>
2
@import "~/scss/variables";
3
​
4
.component {
5
  color: $imported-color-from-variables;
6
}
7
</style>
Copied!
Things to keep in mind:
you don't have to specify a file extension or leading _, this will be considered as a linting error
do not import modules that produce css output, it will pollute your stylesheets with multiple declarations
do not import external css libraries, use nuxt.config.ts for that
CSS Modules
Every Vue component should be a css module. How does it work?
The main idea is:
to rename your classes to some unique name during build time
to make your css classes available from js
So, this:
1
<style lang="scss" module>
2
.component { ... }
3
.input { ... }
4
</style>
Copied!
Will became this:
1
this.$style = {
2
  'component': '_3hLE8Zr42CA8Iz_38AM4TJ_0',
3
  'input': 'VZZoxarQNkuSWSg1ftV1v_0'
4
}
Copied!
Now you don't have to worry about naming your classes or binding them together with Vue. The future is now!
Naming
When naming your css classes stick to camelCase, as it would be easier to call it inside your Vue component:
1
<template>
2
   <div>
3
      <p class="$style.camelCase"></p>
4
      <p class="$style['kebab-case']"></p>
5
   </div>
6
</template>
7
​
8
<style lang="scss" module>
9
.camelCase { ... }
10
.kebab-case { ... }
11
</style>
Copied!
Also, keep in mind that all nested classes will be flattened for $style access:
1
<template>
2
   <div>
3
      <p class="$style.root"></p>
4
      <p class="$style.child"></p>
5
   </div>
6
</template>
7
​
8
<style lang="scss" module>
9
.root {
10
  .child { ... }
11
}
12
</style>
Copied!
You can play around with :local selector if you would like to make them nested.
Exporting SCSS variables to Javascript
Imagine that you have to use your scss variable in vue. Sounds like a nightmare? No, that's not. Imaging exporting this variable:
1
$grid-size: 15rem;
Copied!
And use it like so:
1
<style lang="scss" module>
2
@import '~/scss/variables';
3
​
4
:export {
5
  $var-grid-size: $grid-size;
6
}
7
</style>
Copied!
It would be available as this.$style['var-grid-size']. It might be useful for dynamic colors, grids, blocks, and tables.
PostCSS
After we have created all our styles they are processed by a post-processor. Why? Because it is easier to make optimizations on this step.
It comes bundled with nuxt. What kind of custom optimizations or plugins do we use?
​css-mqpacker - which allows
to combine all @media queries into one block for better performance
These optimizations are applied by webpack. You don't have to run them manually.
Vue
Linting
Last modified 2yr ago
Copy link
Contents
Global CSS
Layout specific styles
Exporting SCSS variables to Javascript
PostCSS