https://github.com/atom/bracket-matcher

Jump to brackets
https://github.com/atom/bracket-matcher

Last synced: 3 months ago
JSON representation

Jump to brackets

• Host: GitHub
• URL: https://github.com/atom/bracket-matcher
• Owner: atom
• License: mit
• Archived: true
• Created: 2013-08-13T17:34:31.000Z (almost 11 years ago)
• Default Branch: master
• Last Pushed: 2022-09-28T10:52:01.000Z (almost 2 years ago)
• Last Synced: 2024-01-22T05:18:34.921Z (5 months ago)
• Language: JavaScript
• Size: 636 KB
• Stars: 142
• Watchers: 19
• Forks: 109
• Open Issues: 85
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE.md

Lists

• awesome-starter - bracket matcher

README

        
##### Atom and all repositories under Atom will be archived on December 15, 2022. Learn more in our [official announcement](https://github.blog/2022-06-08-sunsetting-atom/)

 # Bracket Matcher package

[![CI](https://github.com/atom/bracket-matcher/actions/workflows/ci.yml/badge.svg)](https://github.com/atom/bracket-matcher/actions/workflows/ci.yml)

Highlights and jumps between `[]`, `()`, and `{}`. Also highlights matching XML

and HTML tags.

Autocompletes `[]`, `()`, `{}`, `""`, `''`, `“”`, `‘’`, `«»`, `‹›`, and

backticks by default.

Use ctrl-m to jump to the bracket matching the one adjacent to the cursor.

It jumps to the nearest enclosing bracket when there's no adjacent bracket,

Use ctrl-cmd-m to select all the text inside the current brackets.

Use alt-cmd-. to close the current XML/HTML tag.

---

### Configuration

Matching brackets and quotes are sensibly inserted for you. If you dislike this

functionality, you can disable it from the Bracket Matcher section of the

Settings View.

#### Custom Pairs

You can customize matching pairs in Bracket Matcher at any time. You can do so either globally via the Settings View or at the scope level via your `config.cson`. Changes take effect immediately.

* **Autocomplete Characters** - Comma-separated pairs that the editor will treat as brackets / quotes. Entries in this field override the package defaults.

  * For example: `<>, (), []`

* **Pairs With Extra Newline** - Comma-separated pairs that enhance the editor's auto indent feature. When used, a newline is automatically added between the pair when enter is pressed between them. Note: This feature is meant to be used in combination with brackets defined for indentation by the active language package (`increaseIndentPattern` / `decreaseIndentPattern`).

Example:

```

fn main() {

    | <---- Cursor positioned at one indent level higher

}

```

#### Scoped settings

In addition to the global settings, you are also able to add scope-specific modifications to Atom in your `config.cson`. This is especially useful for editor rule changes specific to each language. Scope-specific settings override package defaults _and_ global settings.

Example:

```cson

".rust.source":

  "bracket-matcher":

    autocompleteCharacters: [

      "()"

      "[]"

      "{}"

      "<>"

      "\"\""

      "``"

    ]

```