shellscape / vscode-shellscape-brackets

Atom bracket matching for VS Code

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

marketplace openvsx libera manifesto

Shellscape Brackets

shellscape-brackets

A subtle bracket match decorator for VS Code based on Atom.

shellscape-brackets

Shellscape Brackets applies a customizable, subtle dotted underline to matching bracket pairs next to the cursor, inspired by Atom's bracket matcher. By default, VS Code uses outline boxes, which impairs visibility.

Requirements

This extension requires VS Code v1.73.0 or greater.

Options

Options for this extension can be set in the User settings.json, and should be prefixed with shellscapeBrackets.

shellscapeBrackets.disableNative

Type: boolean
Default: true

If true, disables VS Code's matchBrackets core extension. Set to false to prevent disabling matchBrackets.

shellscapeBrackets.parse

Type: boolean
Default: true

If true, documents will be parsed using Prism to prevent brackets within strings and comments from being decorated. Note: Edge cases may occur.

shellscapeBrackets.pairs

Bracket pairs consist of an open and close character, specified by properties of the same name. The default pairs can be seen below:

"shellscapeBrackets.pairs": [
  {
    "open": "(",
    "close": ")"
  },
  {
    "open": "[",
    "close": "]"
  },
  {
    "open": "{",
    "close": "}"
  }
]

Parsing can also be disabled for a specific pair, using the parse: false property, as seen below:

"shellscapeBrackets.pairs": [
  {
    "open": "(",
    "close": ")",
    "parse": false
  },
  ...
]

shellscapeBrackets.style

The appearance of the bracket decorations can be customized using the properties as seen in the default settings seen below. While the extension technically allows any properties available to decorations, it only officially supports the properties seen below.

"shellscapeBrackets.style": {
  "borderColor": "lime",
  "borderStyle": "none none dotted none",
  "borderWidth": "1px"
}

Bracket pairs can also be customized, by adding a style property to a pair definition.

"shellscapeBrackets.pairs" : [{
  "open": "{",
  "close": "}",
  "style": {
    "color": "#ff00ff"
  }
}]

Meta

LICENSE (MIT)

About

Atom bracket matching for VS Code

License:MIT License


Languages

Language:TypeScript 92.2%Language:JavaScript 7.5%Language:Shell 0.3%