Skip to content

jwhitmarsh/vscode-scss

 
 

Repository files navigation

vscode-scss

SCSS IntelliSense (Variables, Mixins and Functions) for all files in the workspace.

Disclaimer

This is a preview release that may contain errors. This plugin works fine on my machine (SSD) with 1000+ Bootstrap files (SCSS, 3.3.7).

Please read this README file.

Donation

Do you like this project? Support it by donating, creating an issue or pull request.

Donate

Install

Plugin installation is performed in several stages:

  • Press F1 and select Extensions: Install Extensions.
  • Search and choose vscode-scss.

See the extension installation guide for details.

Usage

Just install the plugin and use it.

Supported features

  • Code Completion Proposals (variables, mixins, functions) — description
  • Hover (variables, mixins, functions) — description
  • Signature Help (mixins, functions) — description
  • Code navigation
    • Go to (variables, mixins, functions) — description
    • Show all All Symbol Definitions in Folder (variables, mixin, functions) — description
  • Visual Studio reference comments: // <reference path="./variable.scss" />.
  • Import files by @import "filepath"; from anywhere. Even outside of the open workspace.

Supported settings

scss.scannerDepth

  • Type: number
  • Default: 30

The maximum number of nested directories to scan.

scss.scannerExclude

  • Type: string[]
  • Default: [".git", "**/node_modules", "**/bower_components"]

List of Glob-patterns for directories that are excluded when scanning.

scss.scanImportedFiles

  • Type: boolean
  • Default: true

Allows scan imported files.

scss.scanImportedFilesDepth

  • Type: number
  • Default: 50

The maximum number of imported files to scan. Prevent an infinite recursion and very deep @import.

scss.implicitlyLabel

  • Type: string|null
  • Default: (implicitly)

The text of a label that the file imported implicitly. If null then label not displayed.

scss.showErrors

  • Type: boolean
  • Default: false

Allows to display errors.

scss.suggestVariables

  • Type: boolean
  • Default: true

Allows prompt Variables.

scss.suggestMixins

  • Type: boolean
  • Default: true

Allows prompt Mixins.

scss.suggestFunctions

  • Type: boolean
  • Default: true

Allows prompt Functions.

scss.suggestFunctionsInStringContextAfterSymbols

  • Type: boolean
  • Default: (+-*%

Allows prompt Functions in String context after specified symbols. For example, if you add the / symbol, then background: url(images/he|) will be suggest hello() function if it is defined.

Questions

I don't see suggestions in the SCSS files.

You must perform several steps:

  • Set scss.showErrors option in settings of Editor.
  • Restart VS Code.
  • Try to reproduce your problem.
  • Open Help -> Toggle Developer Tools and copy errors.
  • Create Issue on GitHub.

Changelog

See the Releases section of our GitHub project for changelogs for each release version.

License

This software is released under the terms of the MIT license.

About

🔌 IntelliSense for Variables, Mixins and Functions in all Sass (SCSS syntax only) files.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • TypeScript 99.4%
  • CSS 0.6%