README.md

Meteor Ace Editor

A simple package that asynchronously loads Ace editor to a Meteor app only when it is needed.

Note: this package is just a "wrapper" around the actual ace editor, asynchronously loading the ace script with XMLHttpRequest when AceEditor.instance is called for the first time.

QuickStart

Add it to your Meteor project

meteor add arch:ace-editor

Let's say you have a <pre id='archy'></pre>, and now you want to embed Ace and turn the DOM element into an Ace editor, this is all you need to do:

var ace = AceEditor.instance("archy",{
    theme:"dawn",
    mode:"html"
});

caling AceEditor.instance("dom") is basically the same as calling ace.edit('dom') in the Ace API. The only difference is that AceEditor.instance("dom") would load the script the first time you call it.

More on working with Ace Editor in Meteor

Using a callback:

AceEditor.instance("archy",null,function(editor){
   editor.insert("Live long and prosper.");
   editor.session.getLength();
});

Assigning AceEditor.instance("archy") to a variable with Tracker.autorun:

Tracker.autorun(function (e) {
  editor = AceEditor.instance("archy");
  if(editor.loaded!==undefined){
  e.stop();
  editor.insert("Live long and prosper.");
  }
});

.autorun is necessary only when the Ace script has not been loaded.

To learn more about Ace Editor, you can read the how-to guide on their website.

on using UndoManager, VirtualRenderer, etc

Since Ace is still accessible at window.ace, to create an instance of the UndoManager, new window.ace.UndoManager would do. The same goes to other things described in the api.

License

"THE BEER-WARE LICENSE" (Revision 42):

As long as you retain this notice you can do whatever you want with this stuff. If we meet some day, and you think this stuff is worth it, you can buy me a beer in return