# j-CloudEditor

> j-CloudEditor: het werkt in de iframe; ondersteunt meerdere cursoren (shift + cmd + arrow-down/up)

Framework: jcomponent20
Product: jComponent 20 (jcomponent@20)
Language: nl
Content-SHA256: 2fc2a1c14499c00b85371664d863a3b8707fe7ccf27526def90fdda9504d4a64
Snapshot: c0700e321579725c5cf4f5ace1ad7d2866d1b4f93c24a63c0b41b6b7998e976c
Sources: components@910ed1a86f6e72b4f031d3ad0dc7844f9fc5cb8e
Review: not-recorded

- Het werkt in de iframe
- Ondersteunt meerdere cursoren (`shift + cmd + arrow-down/up`)
- ondersteunt het vinden van geselecteerde tekst (`cmd + d`)
- Ondersteunt custom scrollbars
- Ondersteunt de diff tracker
- Ondersteunt een eenvoudige emmet plugin
- Ondersteunt realtime samenwerking
- Broncode: <https://github.com/totaljs/editor>
- Het maakt gebruik van de redactie: [CodeMirror](https://codemirror.net/)
- Zeer kleine code

__Configuratie__:

- `parent {String}` een selector voor de hoofdcontainers (default: `auto`)
- De `autosave {Boolean}` auto bindt de waarde van de editor naar de route van het onderdeel (default: `true`)
- `event {String}` een weg naar de `function(name, value)`
	- `click`
	- `errors`
	- `shortcut`
	- `cursor` bevat cursorpositie
	- `change` bevat gedeeltelijke wijzigingen voor realtime samenwerking (`config.realtime` moet `true`)
- `contextmenu {String}` een weg naar de `function(opt)`
- `realtime {Boolean}` maakt het mogelijk om in realtime wijzigingen te sturen naar de `event` methode (eventnaam is `change`)
- `keywords {String}` aangepaste sleutelwoorden in het formulier bijvoorbeeld `ID,PATH`
- `minheight {Number}` optioneel, een minimale hoogte (default: `0`)
- `margin {Number}` optioneel, een verticale marge (default: `0`)
- __NEW__: `url {String}` optioneel, een link naar de editor (default: `//cdn.componentator.com/editor/1.min.html`)

__Methode__:

- `component.insert('some text')`
- `component.replace('text', 'newvalue')`
- `component.search('text', callback(output))`
- `component.select(from, [to])`
- `component.goto(pos)`
- `component.focus()`
- `component.save(callback(value))`
- `component.marker(name, [from], [to], [color])` voegt + wijzigingen toe (met `from`) en verwijdert (geen argument `from`) markering
- `component.change(changes)` voor realtime samenwerking (`changes` kan worden gegenereerd in de `config.event`-functie)
- `component.clear()` verwijdert alle veranderingen
- `component.replaceselections(selections)`
- `component.replaceselection(selection)`
- `component.replacerange(value, from, [to])`
- `component.command(cmd)` uitvoert de methode `codemirror.execCommand()`
- `component.exec(a, [b], [c])` uitvoert de methode `document.execCommand(a, b, c)`

__Belangrijk__:

De argumenten van `from`, `to`, `pos` moeten in de vorm zijn: `{ line: Number, ch: Number }`.

Gebruik het met `<ui-component name="cloudeditor">`Wanneer de component nog niet is geladen, jComponent Download het op eerste gebruik van het adres in `DEF.fallback` (De Componentator Schrijver: Peter Širka. bron: de Componentator Componenten repository, MIT licentie.

```html example.html
<ui-component name="LAZY menu"></ui-component>

<div style="width:600px;height:200px;border:1px solid #E0E0E0">
	<ui-component name="cloudeditor" path="editormodel" config="contextmenu:editor_contextmenu;event:editor_event;realtime:1"></ui-component>
</div>
<br />
<div style="width:600px;height:200px;border:1px solid #E0E0E0">
	<ui-component name="cloudeditor" path="editormirrored" config="readonly:1;$id:mirrored"></ui-component>
</div>

<div class="clearfix"></div>

<script>

	var editorbody = '\n\n<h1>HELLO WORLD</h1>\n\n';
	var editormodel = { mode: 'clientside', body: editorbody, keywords: 'WORLD' };
	var editormirrored = { mode: 'clientside', body: editorbody };

	function editor_event(type, value) {
		switch (type) {
			case 'change':
				SETTER('#mirrored/change', value);
				break;
			case 'cursor':
				SETTER('#mirrored/marker', 'Peter', value.from);
				break;
		}
		SETTER('!menu/hide');
	}

	function editor_contextmenu(obj) {
		var opt = {};
		opt.x = obj.x;
		opt.y = obj.y;
		opt.items = [];
		opt.items.push({ id: '1', name: 'Test item 1' });
		opt.items.push({ id: '2', name: 'Test item 2' });
		opt.items.push({ id: '3', name: 'Test item 3' });
		opt.items.push({ id: '4', name: 'Test item 4' });
		opt.callback = function(selected) {
			console.log(selected);
		};
		SETTER('menu/show', opt);
	}

</script>
```