codemirror-mode-pcre

Perl Compatible Regular Expressions (PCRE) mode for CodeMirror


Keywords
codemirror-mode, pcre, pcre-regex
License
BSD-3-Clause
Install
npm install codemirror-mode-pcre@1.0.2

Documentation

CodeMirror PCRE mode

This is a CodeMirror mode that brings syntax highlighting for Perl Compatible Regular Expressions (PCRE).

How to use

Basic use

Load pcre.js and pcre.css at adequate locations in your HTML structure. Mention mode: 'pcre' when creating your CodeMirror instance.

Configuration

codemirror-mode-pcre supports extended mode (x flag) and actually enables it by default. This can be turned off by passing extended: false when creating the CodeMirror instance.

Theming

This mode does not leverage CodeMirror's default tokens (they are not exactly fitted for regular expressions). Consequently, if you use a theme other than the default one, you will likely want to write your own pcre.css file.

Breaking change: starting with version 2.0.0, the cm-end-group style is no longer supported and should no longer be used. It is replaced with cm-start-group.

Nesting

codemirror-mode-pcre can be nested within another mode, i.e. it can highlight regular expressions for another mode. This requires adjusting the other mode though. See the demo page for an example of such nesting.

Non-features

codemirror-mode-pcre does not offer:

  • completion (e.g. suggesting POSIX class names or script names for \p and \P);
  • tooltips reflecting what the various parts of an expression actually mean.

Those may come in the future though.

License

Like the PCRE library, this mode is released under the 3-clause BSD license.