vscode-css-languageserver-bin


Binary version published on npm of vscode-css-languageserver extracted from VSCode tree

Features

- [x] CSS Support
- [x] LESS Support
- [x] SASS Support
- [x] Completion provider (Need Snippets Support)
- [x] Color provider
- [x] Code Actions (rename mispelled properties)
- [x] Validation (syntax and lint errros)
- [X] Hover tooltip provider
- [x] Definition provider
- [x] Hover provider
- [x] References provider
- [x] Document Symbols & Highlights
- [x] Rename symbol
- [x] Scoped Settings

Clients

- Oni
- ide-css

Getting Started

These instructions will get you a copy of the project up and running on your local machine for development and testing purposes. See deployment for notes on how to deploy the project on a live system.

$3

To install this Language Server you need npm on your machine

$3

``bash
npm install --global vscode-css-languageserver-bin
`

$3

The common way to launch it is by using stdio transport:

`bash
css-languageserver --stdio
`

The server can also be launched with one of the following transports:

`bash
css-languageserver --socket={number}
css-languageserver --node-ipc
`

Settings

This Language Server accepts some settings sent with workspace/didChangeConfiguration

`typescript
type Level = "ignore" | "error" | "warning"

type LintSettings = {
// From: https://github.com/Microsoft/vscode-css-languageservice/blob/master/src/services/lintRules.ts#L25

compatibleVendorPrefixes?: Level, // When using a vendor-specific prefix make sure to also include all other vendor-specific properties. Default: Ignore
vendorPrefix?: Level, // When using a vendor-specific prefix also include the standard property. Default: Warning
duplicateProperties?: Level, //, localize('rule.duplicateDeclarations', "Do not use duplicate style definitions. Default: Ignore
emptyRules?: Level, // Do not use empty rulesets. Default: Warning
importStatement?: Level, // Import statements do not load in parallel. Default: Ignore
boxModel?: Level, // Do not use width or height when using padding or border. Default: Ignore
universalSelector?: Level, // The universal selector (*) is known to be slow. Default: Ignore
zeroUnits?: Level, // No unit for zero needed. Default: Ignore
fontFaceProperties?: Level, // @font-face rule must define 'src' and 'font-family' properties. Default: Warning
hexColorLength?: Level, // Hex colors must consist of three, four, six or eight hex numbers. Default: Error
argumentsInColorFunction?: Level, // Invalid number of parameters. Default: Error
unknownProperties?: Level, // Unknown property. Default: Warning
ieHack?: Level, // IE hacks are only necessary when supporting IE7 and older. Default: Ignore
unknownVendorSpecificProperties?: Level // Unknown vendor specific property. Default: Ignore
propertyIgnoredDueToDisplay?: Level, // Property is ignored due to the display. Default: Warning
important?: Level, // Avoid using !important. It is an indication that the specificity of the entire CSS has gotten out of control and needs to be refactored. Default: Ignore
float?: Level, // Avoid using 'float'. Floats lead to fragile CSS that is easy to break if one aspect of the layout changes. Default: Ignore
idSelector?: Level // Selectors should not contain IDs because these rules are too tightly coupled with the HTML. Default: Ignore
};

interface LanguageSettings {
validate?: boolean;
lint?: LintSettings;
}

interface Settings {
css?: LanguageSettings,
scss?: LanguageSettings,
less?: LanguageSettings
}
`

Deployment

`bash
npm run publish


or to try locally


npm run pack
`

Contributing

PRs are welcome.
To setup the repo locally run:
`bash
git clone --recursive https://github.com/vscode-langservers/vscode-css-languageserver-bin
cd vscode-css-languageserver-bin
npm install
npm run pack
`

Versioning

We use SemVer for versioning.

Because we can't guess VSCode extention version, we update MINOR when submodule is updated and PATCH` when only build method is updated

License

This project is licensed under the MIT License - see the LICENSE file for details

This is a derived work please see VSCode's LICENSE.txt for the original copyright and license.