Filipe Silva 5b1668f9ba docs: add style include paths docs
This feature was introduce in #4003 but never documented.
2017-03-13 09:01:44 -07:00

1.4 KiB

Global styles

The styles.css file allows users to add global styles and supports CSS imports.

If the project is created with the --style=sass option, this will be a .sass file instead, and the same applies to scss/less/styl.

You can add more global styles via the apps[0].styles property in .angular-cli.json. These will be loaded exactly as if you had added them in a <link> tag inside index.html.

"styles": [
  "styles.css",
  "more-styles.css",
],

You can also rename the output and lazy load it by using the object format:

"styles": [
  "styles.css",
  "more-styles.css",
  { "input": "lazy-style.scss", "lazy": true },
  { "input": "pre-rename-style.scss", "output": "renamed-style" },
],

In Sass and Stylus you can also make use of the includePaths functionality for both component and global styles, which allows you to add extra base paths that will be checked for imports.

To add paths, use the stylePreprocessorOptions entry in angular-cli.json app object:

"stylePreprocessorOptions": {
  "includePaths": [
    "style-paths"
  ]
},

Files in that folder, e.g. src/style-paths/_variables.scss, can be imported from anywhere in your project without the need for a relative path:

// src/app/app.component.scss
// A relative path works
@import '../style-paths/variables';
// But now this works as well
@import 'variables';