Skip to content

Latest commit

 

History

History
29 lines (19 loc) · 2.05 KB

MIGRATE.md

File metadata and controls

29 lines (19 loc) · 2.05 KB
Raw

Migration Guide

Migrating from v2.x.x to v3.x.x

  • Edit your index.html

    • To have a cleaner file, you can remove the stylesheet link to the Monaco Editor's css file (editor.main.css) in your html head. The new Monaco Editor version will automatically add it if it's not there.

    • The script tags you need to add to your html body are now cleaner. You need to update them.

    <script src="_content/BlazorMonaco/jsInterop.js"></script>
<script src="_content/BlazorMonaco/lib/monaco-editor/min/vs/loader.js"></script>
<script src="_content/BlazorMonaco/lib/monaco-editor/min/vs/editor/editor.main.js"></script>

  • Things reside in two namespaces now. So, you need to update your using directives in your root _Imports.razor file, or any other place you use them.

    @using BlazorMonaco
@using BlazorMonaco.Editor

  • Class, property and object names are now better aligned with the original Monaco Editor JavaScript library. So, you need to update your usages with the new names. You'll notice right away that MonacoEditor is renamed to StandaloneCodeEditor, and MonacoDiffEditor is renamed to StandaloneDiffEditor. Based on what you use, you'll notice more changes. Just check the namespace and class definitions. If Microsoft didnot remove that thing in the new Monaco Editor version, it'll be there with a new name similar to the old one.

  • Static methods in the MonacoEditor and MonacoEditorBase classes (e.g. SetTheme, Colorize, etc) are removed from the editor class and grouped together under a new class named BlazorMonacoGlobals.

  • Event callback methods used to have a parameter for the source editor instance that raised the event. It's removed for following the original Monaco Editor implementation.

  • The embedded Monaco Editor JavaScript library is updated from v0.22.3 to v0.34.1. So, Microsoft may have removed some things or changed the way they work. If you happen to use those things, please follow Microsoft's suggestions on how to update your usage.