Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/AvaloniaUI/AvaloniaEdit
Avalonia-based text editor (port of AvalonEdit)
https://github.com/AvaloniaUI/AvaloniaEdit
avalonia code-editor editor netstandard text-editor
Last synced: about 1 month ago
JSON representation
Avalonia-based text editor (port of AvalonEdit)
- Host: GitHub
- URL: https://github.com/AvaloniaUI/AvaloniaEdit
- Owner: AvaloniaUI
- License: mit
- Created: 2017-04-22T12:54:31.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2024-05-02T12:51:22.000Z (5 months ago)
- Last Synced: 2024-05-22T08:09:54.344Z (4 months ago)
- Topics: avalonia, code-editor, editor, netstandard, text-editor
- Language: C#
- Size: 2.2 MB
- Stars: 666
- Watchers: 35
- Forks: 129
- Open Issues: 45
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-avalonia - AvaloniaEdit - This is a port of AvalonEdit for Avalonia. (Libraries & Extensions / Controls)
README
[](https://www.nuget.org/packages/Avalonia.AvaloniaEdit)
[](https://www.nuget.org/packages/Avalonia.AvaloniaEdit)
# AvaloniaEdit
This project is a port of [AvalonEdit](https://github.com/icsharpcode/AvalonEdit), a WPF-based text editor for [Avalonia](https://github.com/AvaloniaUI/Avalonia).
AvaloniaEdit supports features like:
* Syntax highlighting using [TextMate](https://github.com/danipen/TextMateSharp) grammars and themes.
* Code folding.
* Code completion.
* Fully customizable and extensible.
* Line numeration.
* Display whitespaces EOLs and tabs.
* Line virtualization.
* Multi-caret edition.
* Intra-column adornments.
* Word wrapping.
* Scrolling below document.
* Hyperlinks.
and many,many more!
AvaloniaEdit currently consists of 2 packages
* [Avalonia.AvaloniaEdit](https://www.nuget.org/packages/Avalonia.AvaloniaEdit) well-known package that incudes text editor itself.
* [AvaloniaEdit.TextMate](https://www.nuget.org/packages/AvaloniaEdit.TextMate/) package that adds TextMate integration to the AvaloniaEdit.
## Getting started
### How to set up a new project that displays an AvaloniaEdit editor?
* Create an [empty Avalonia application](https://docs.avaloniaui.net/docs/getting-started).
* Add a the [nuget reference](https://www.nuget.org/packages/Avalonia.AvaloniaEdit/#versions-body-tab) to the latest version:
``
* Include the *needed styles* into your `` in your `App.xaml`:
* If you're using `0.10.x.y` based versions, include ``
* If you're `11.x.y` based versions, include ``
* Finally, add the AvaloniaEdit editor into your window:
```xaml
...
...
```
You can see the [Demo Application](https://github.com/AvaloniaUI/AvaloniaEdit/tree/master/src/AvaloniaEdit.Demo) as a reference.
### How to set up TextMate theme and syntax highlighting for my project?
First of all, if you want to use grammars supported by [TextMateSharp](https://github.com/danipen/TextMateSharp), should install the following packages:
- [AvaloniaEdit.TextMate](https://www.nuget.org/packages/AvaloniaEdit.TextMate/)
- [TextMateSharp.Grammars](https://www.nuget.org/packages/TextMateSharp.Grammars/)
Alternatively, if you want to support your own grammars, you just need to install the AvaloniaEdit.TextMate package, and implement IRegistryOptions interface, that's currently the easiest way in case you want to use AvaloniaEdit with the set of grammars different from in-bundled TextMateSharp.Grammars.
```csharp
//First of all you need to have a reference for your TextEditor for it to be used inside AvaloniaEdit.TextMate project.
var _textEditor = this.FindControl("Editor");
//Here we initialize RegistryOptions with the theme we want to use.
var _registryOptions = new RegistryOptions(ThemeName.DarkPlus);
//Initial setup of TextMate.
var _textMateInstallation = _textEditor.InstallTextMate(_registryOptions);
//Here we are getting the language by the extension and right after that we are initializing grammar with this language.
//And that's all 😀, you are ready to use AvaloniaEdit with syntax highlighting!
_textMateInstallation.SetGrammar(_registryOptions.GetScopeByLanguageId(_registryOptions.GetLanguageByExtension(".cs").Id));
```
