Meteor smart package for transparently adding ShareJS editors to an app. Includes CodeMirror and the Ace editor.
This package is only tested for meteor 1.3 or later
For vanilla ShareJS with text only:
$ meteor add mizzao:sharejs
For ShareJS with the Ace editor
$ meteor add mizzao:sharejs-ace
For ShareJS with the CodeMirror editor:
$ meteor add mizzao:sharejs-codemirror
No configuration necessary for anonymous document editing. If you want to integrate with Meteor accounts, see below.
Use this helper on the client to get a textarea with the specified docid (as an argument) and with a DOM id of "editor", for example:
{{> sharejsText docid=docid id="editor"}}
Use this helper to get an Ace editor. Make sure you specify a size (via CSS) on the #editor div or you won't see anything.
{{> sharejsAce docid=docid id="editor"}}
Use this helper to get a CodeMirror editor.
{{> sharejsCM docid=docid id="editor"}}
The templates will clean themselves up when re-rendered (i.e., you have several documents and docid changes.)
For the Ace and CodeMirror editors, you can define onRender and onConnect callbacks in the options hash and use it to configure the editor. onRender is called when the editor is initially rendered, and onConnect is called after each successful connection to a document.
{{> sharejsAce docid=document onRender=config onConnect=setMode id="editor"}}
All standard Ace themes and extensions are supported. Note that the helper has to return a function inside of a function:
Template.foo.config = function () {
return function(editor) {
# Set some reasonable options on the editor
editor.setTheme('ace/theme/monokai')
editor.getSession().setMode('ace/mode/javascript')
editor.setShowPrintMargin(false)
editor.getSession().setUseWrapMode(true)
}
};
See this example config file for the various settings that you can use.
By default, the documents and edit operations will be persisted in Meteor's Mongo database. Mongo is the recommended usage as you don't need a separate database and user integration is supported. "opsCollectionPerDoc": false can be useful to set if you don't want a separate ops collection for each document.
You can also use db.type of none to have all documents and operations in memory.
The Authorization was removed in version 0.9.0, because the current implementation did not added any security as Meteor.userId is not a secret token.
You can access the ShareJS Server API via import { ShareJS } from 'meteor/mizzao:sharejs'. For example, you may want to delete documents ops when the document is deleted in your app. See the demo for an example.
- When using the default mongo driver, you must not use collections called
docsorops. These are used by ShareJS. - It's best to create a
Meteor.Collectionfor your documents which generates good unique ids to connect to ShareJS with. Use these to render the templates above. See the demo for examples.
Please submit pull requests for better features and cooperation!
- Andrew Mao (https://github.com/mizzao/)
- Karan Batra-Daitch (https://github.com/kbdaitch)
- CJ Carr (https://github.com/cortexelus)
- David Sichau (https://github.com/DavidSichau)
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent