editor.js/docs/api.md
2018-06-28 14:27:03 +03:00

1.5 KiB

CodeX Editor API

Blocks have access to the public methods provided by CodeX Editor API Module. Plugin and Tune Developers can use Editor API as they want.

Api object description

Common API interface.

export interface IAPI {
   blocks: IBlocksAPI;
   caret: ICaretAPI;
   sanitizer: ISanitizerAPI;
   toolbar: IToolbarAPI;
 }

IBlocksAPI

Methods that working with Blocks

moveDown() - method moves down the current block.

moveUp() - method moves up the current block.

delete(blockIndex?: Number) - deletes block with passed index

ISanitizerAPI

clean(taintString, config) - method uses HTMLJanitor to clean taint string. CodeX Editor provides basic config without attributes, but you can inherit by passing your own config.

Usage:

let taintString = '<div><p style="font-size: 5em;"><b></b>BlockWithText<a onclick="void(0)"></div>'
let customConfig = {
  b: true,
  p: {
    style: true,
  },
}
this.api.sanitizer.clean(taintString, customConfig);

IToolbarAPI

Methods that working with Toolbar

open() - Opens toolbar

close() - Closes toolbar, toolbox and blockSettings if they are opened

IEventsAPI

Methods that allows to subscribe on CodeX Editor events

on(eventName: string, callback: Function) - subscribe callback on event

off(eventName: string, callback: Function) - unsubscribe callback from event

emit(eventName: string, data: object) - fires all subscribed callbacks with passed data