2.0.5 • Published 6 years ago

juicy-ace-editor v2.0.5

Weekly downloads
8
License
MIT
Repository
github
Last release
6 years ago

<juicy-ace-editor>

Even more embeddable code editor. Custom Element - just one tag, and no JS needed to provide Ace - The High Performance Code Editor

Demo

Check it live!

Play & Configure with kitchen sink

Features

Besides Ace features, <juicy-ace-editor> does:

  • provide extremely clean and easy way to embed it (see Usage)
  • observe DOM changes:
  • Update your code by just updating Element's text content
  • Change Editor's setting by changing DOM attributes
  • Compatible with Shadow DOM v0 and v1
  • Custom Elements v1 (more)

You can still fiddle with Ace editor programmatically using <juicy-ace-editor>.editor.

Install

Install the component using Bower:

$ bower install juicy-ace-editor --save

Or download as ZIP.

Usage

  1. Import Web Components' polyfill (if needed):

    <script src="bower_components/webcomponentsjs/webcomponents.min.js"></script>
    <!-- CE v0 -> v1 -->
    <script src="document-register-element/document-register-element.js"></script>
  2. Import Custom Element:

    <link rel="import" href="bower_components/juicy-ace-editor/juicy-ace-editor.html">
  3. Start using it!

    <juicy-ace-editor theme="ace/theme/monokai">Type your code here...</juicy-ace-editor>

Attributes

AttributeOptionsDefaultDescription
themeStringEditor#setTheme at Ace API
modeStringEditSession#setMode at Ace API
fontsizeStringEditor#setFontSize at Ace API
softtabsBooleanEditSession#setUseSoftTabs() at Ace API
tabsizeBooleanSession#setTabSize() at Ace API
readonlyBooleanEditor#setReadOnly() at Ace API
wrapmodeBooleanSession#setWrapMode() at Ace API

Properties

NameDescription
editorAce editor object.
valueeditor.get-/setValue()

Events

NameDescription
changeTriggered when editor content gets changed
editor-readyTriggered once Ace editor instance is created.

Web Components v0 vs v1

Currently, this element supports both Shadow DOM v1 and v0, but only Custom Elements v1. If your environment uses Custom Elements v0 only, we strongly recommend to use lightweight v0 to v1 polyfill

bower install --save document-register-element

Who uses it?

Contributing and Development

History

For detailed changelog, check Releases.

License

MIT