JSPM

monaco-jsx-syntax-highlight

1.2.2
  • ESM via JSPM
  • ES Module Entrypoint
  • Export Map
  • Keywords
  • License
  • Repository URL
  • TypeScript Types
  • README
  • Created
  • Published
  • Downloads 247
  • Score
    100M100P100Q82519F
  • License MIT

Highlight the jsx or tsx syntax for monaco editor

Package Exports

  • monaco-jsx-syntax-highlight
  • monaco-jsx-syntax-highlight/lib/index.js
  • monaco-jsx-syntax-highlight/lib/index.module.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (monaco-jsx-syntax-highlight) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

monaco-jsx-syntax-highlight

npm version npm downloads

Support monaco jsx/tsx syntax highlight

Monaco only support the jsx syntax checker

Live demo

Installing

$ npm install monaco-jsx-syntax-highlight

Use

The main part of this package is a worker for analysing jsx syntax So we have to way to init the Controller class

Use blob create worker

import { MonacoJsxSyntaxHighlight, getWorker } from 'monaco-jsx-syntax-highlight'

const controller = new MonacoJsxSyntaxHighlight(getWorker(), monaco)

When using getWorker return value as Worker, we can custom the typescript compile source file url(for the purpose of speeding up load time)

If do not set, the default source is https://cdnjs.cloudflare.com/ajax/libs/typescript/4.6.4/typescript.min.js

const controller = new MonacoJsxSyntaxHighlight(getWorker(), monaco, {
    customTypescriptUrl: 'https://xxx/typescript.min.js'
})

Use js worker file

If your browser do not support to use blob worker, you can download the worker file and save it in your project

  • web worker has same-origin policy
import { MonacoJsxSyntaxHighlight } from 'monaco-jsx-syntax-highlight'

const controller = new MonacoJsxSyntaxHighlight('https://xxxx', monaco)

Controller

Remember, when this editor is disposed(editor.dispose), we should invoke the dispose function returned by the highlighterBuilder too

  • highlighter: send latest content to worker for analysing
  • dispose: remove event listener of the worker
// editor is the result of monaco.editor.create
const { highlighter, dispose } = monacoJsxSyntaxHighlight.highlighterBuilder(
  { editor: editor }
)

// init hightlight
highlighter()

editor.onDidChangeModelContent(() => {
  // content change, highlight
  highlighter()
})
interface HighlighterConfig {
  /**
   * max jsx tag order loop value
   * @default 3
   */
  jsxTagCycle: number
  /**
   * open console to log some error information
   * @default false
   */
  enableConsole?: boolean
}

type HighlighterBuilder = (context: {
    editor: any;
    filePath?: string;
}, config?: HighlighterConfig) => {
    highlighter: (code?: string) => void;
    dispose: () => void;
}

Highlight class

Use css class to highlight the jsx syntax

  • 'jsx-tag-angle-bracket': <>/>
  • 'jsx-tag-attribute-key': the attribute key
  • 'jsx-expression-braces': the braces of attribute value
  • 'jsx-text': the text in jsx tag content
  • 'jsx-tag-name': the tag name of jsx tag
  • 'jsx-tag-order-xxx': the tag order class

FAQ

monaco do not check the jsx syntax

You can try below config code

PS: the file name must end with jsx or tsx

monaco.languages.typescript.typescriptDefaults.setCompilerOptions({
    jsx: monaco.languages.typescript.JsxEmit.Preserve,
    target: monaco.languages.typescript.ScriptTarget.ES2020,
    esModuleInterop: true
})

const model = monaco.editor.createModel(
  'const test: number = 666',
  'typescript',
  monaco.Uri.parse('index.tsx')
)

editor.current = monaco.editor.create(editorElement.current)
editor.current.setModel(model)