Skip to content

Latest commit

 

History

History
 
 

vscode

README.md

Slint for Visual Studio Code

This extension for VS Code adds support for the Slint design markup language.

Features

  • Syntax highlighting
  • Diagnostics from .slint files
  • Live Preview of a .slint file
  • Completion of properties
  • Jump to definition (currently, only definition of Component)

Installation

You can install the extension directly from the Visual Studio Code Marketplace. Afterwards it is automatically activated when editing files with the .slint extension.

Live-Preview

In addition to the usual code editing features such as completion and syntax highlighting, this extension also offers the ability to view a rendering of the file you're editing and update it on-the-fly when making changes.

You can issue the "Slint: Show Preview" command from the command palette when editing a .slint file. This will create a new top-level window that renders the file you're editing. Any changes you make are immediately visible, it is not necessary to save the file.

Reporting Issues

Issues should be reported in the Slint issue tracker.

Building from source and debugging

The following step will build a local version of the vscode extension and the LSP

cargo install wasm-pack
cargo build -p slint-lsp
cd editors/vscode
npm clean-install
npm run build:wasm_lsp
npm run compile

Later, you only need to do the steps for the part you change like cargo build -p slint-lsp to rebuild the lsp binary or npm run compile to rebuild the typescript.

You can run vscode with that extension by running, in the editors/vscode directory:

code --extensionDevelopmentPath=$PWD ../..

If you want to load the web extension, add --extensionDevelopmentKind=web

How to build the extension package

To create a .vsix package for local installation:

  1. Follow the setup steps above to build the lsp binary and install npm dependencies.

  2. Create a .vsix package (needs vsce installed)

npm run local-package
  1. Install the .vsix file with
code --install-extension slint-*.vsix
  1. Reload your VS code windows

Note that the resulting .vsix package contains your locally built debug LSP server. It is not suitable for distribution.

Rules for PR's

The code is typechecked with tsc and linted/formatted with Biome. If using VS Code then install the biome extension. To ensure your PR does not fail check everything with npm run syntax_check && npm run format && npm run lint. npm run lint:fix and npm run format:fix can be used to auto fix lint and code formatting issues.