Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/Microsoft/vscode-css-languageservice
CSS, LESS & SCSS language service extracted from VSCode to be reused, e.g in the Monaco editor.
https://github.com/Microsoft/vscode-css-languageservice
Last synced: 3 months ago
JSON representation
CSS, LESS & SCSS language service extracted from VSCode to be reused, e.g in the Monaco editor.
- Host: GitHub
- URL: https://github.com/Microsoft/vscode-css-languageservice
- Owner: microsoft
- License: mit
- Created: 2016-06-23T08:22:44.000Z (over 8 years ago)
- Default Branch: main
- Last Pushed: 2024-07-28T09:45:39.000Z (4 months ago)
- Last Synced: 2024-08-01T08:15:15.446Z (4 months ago)
- Language: TypeScript
- Size: 3.05 MB
- Stars: 310
- Watchers: 33
- Forks: 175
- Open Issues: 43
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE.md
- Security: SECURITY.md
Awesome Lists containing this project
README
# vscode-css-languageservice
Language services for CSS, LESS and SCSS
[](https://www.npmjs.org/package/vscode-css-languageservice)
[](https://npmjs.org/package/vscode-css-languageservice)
[](https://github.com/microsoft/vscode-css-languageservice/actions)
[](https://opensource.org/licenses/MIT)
Why?
----
The _vscode-css-languageservice_ contains the language smarts behind the CSS, LESS and SCSS editing experience of Visual Studio Code
and the Monaco editor.
- *doValidation* analyses an input string and returns syntax and lint errors.
- *doComplete* provides completion proposals for a given location.
- *doHover* provides a hover text for a given location.
- *findDefinition* finds the definition of the symbol at the given location.
- *findReferences* finds all references to the symbol at the given location.
- *findDocumentHighlights* finds all symbols connected to the given location.
- *findDocumentSymbols* provides all symbols in the given document
- *doCodeActions* evaluates code actions for the given location, typically to fix a problem.
- *findDocumentColors* evaluates all color symbols in the given document
- *doRename* renames all symbols connected to the given location.
- *prepareRename* the range of the node that can be renamed
- *getFoldingRanges* returns folding ranges in the given document.
Installation
------------
npm install --save vscode-css-languageservice
API
---
For the complete API see [cssLanguageService.ts](./src/cssLanguageService.ts) and [cssLanguageTypes.ts](./src/cssLanguageTypes.ts)
Development
-----------
- clone this repo, run `npm install``
- `npm test` to compile and run tests
How can I run and debug the service?
- open the folder in VSCode.
- set breakpoints, e.g. in `cssCompletion.ts`
- run the Unit tests from the run viewlet and wait until a breakpoint is hit:
How can I run and debug the service inside an instance of VSCode?
- run VSCode out of sources setup as described here: https://github.com/Microsoft/vscode/wiki/How-to-Contribute
- run `npm link` in the folder of `vscode-css-languageservice`
- use `npm link vscode-css-languageservice` in `vscode/extensions/css-language-features/server` to run VSCode with the latest changes from `vscode-css-languageservice`
- run VSCode out of source (`vscode/scripts/code.sh|bat`) and open a `.css` file
- in VSCode window that is open on the `vscode-css-languageservice` sources, run command `Debug: Attach to Node process` and pick the `code-oss` process with the `css-language-features` path
- set breakpoints, e.g. in `cssCompletion.ts`
- in the instance run from sources, invoke code completion in the `.css` file
**Note: All CSS entities (properties, at-rules, etc) are sourced from https://github.com/microsoft/vscode-custom-data/tree/master/web-data and transpiled here. For adding new property or fixing existing properties' completion/hover description, please open PR there).**
License
-------
(MIT License)
Copyright 2016, 20 Microsoft
With the exceptions of `build/mdn-documentation.js`, which is built upon content from [Mozilla Developer Network](https://developer.mozilla.org/docs/Web)
and distributed under CC BY-SA 2.5.