mirror of
https://github.com/codex-team/editor.js
synced 2024-05-19 06:47:16 +02:00
ac93017c70
* 2.16.0 * [Refactor] Separate internal and external settings (#845) * Enable flipping tools via standalone class (#830) * Enable flipping tools via standalone class * use flipper to refactor (#842) * use flipper to refactor * save changes * update * fix flipper on inline toolbar * ready for testing * requested changes * update doc * updates * destroy flippers * some requested changes * update * update * ready * update * last changes * update docs * Hghl active button of CT, simplify activate/deactivate * separate dom iterator * unhardcode directions * fixed a link in readme.md (#856) * Fix Block selection via CMD+A (#829) * Fix Block selection via CMD+A * Delete editor.js.map * update * update * Update CHANGELOG.md * Improve style of selected blocks (#858) * Cross-block-selection style improved * Update CHANGELOG.md * Fix case when property 'observer' in modificationObserver is not defined (#866) * Bump lodash.template from 4.4.0 to 4.5.0 (#885) Bumps [lodash.template](https://github.com/lodash/lodash) from 4.4.0 to 4.5.0. - [Release notes](https://github.com/lodash/lodash/releases) - [Commits](https://github.com/lodash/lodash/compare/4.4.0...4.5.0) Signed-off-by: dependabot[bot] <support@github.com> * Bump eslint-utils from 1.3.1 to 1.4.2 (#886) Bumps [eslint-utils](https://github.com/mysticatea/eslint-utils) from 1.3.1 to 1.4.2. - [Release notes](https://github.com/mysticatea/eslint-utils/releases) - [Commits](https://github.com/mysticatea/eslint-utils/compare/v1.3.1...v1.4.2) Signed-off-by: dependabot[bot] <support@github.com> * Bump mixin-deep from 1.3.1 to 1.3.2 (#887) Bumps [mixin-deep](https://github.com/jonschlinkert/mixin-deep) from 1.3.1 to 1.3.2. - [Release notes](https://github.com/jonschlinkert/mixin-deep/releases) - [Commits](https://github.com/jonschlinkert/mixin-deep/compare/1.3.1...1.3.2) Signed-off-by: dependabot[bot] <support@github.com> * update bundle and readme * Update README.md * upd codeowners, fix funding * Minor Docs Fix according to main Readme (#916) * Inline Toolbar now contains Conversion Toolbar (#932) * Block lifecycle hooks (#906) * [Fix] Arrow selection (#964) * Fix arrow selection * Add docs * [issue-926]: fix dom iterator leafing when items are empty (#958) * [issue-926]: fix dom iterator leafing when items are empty * update Changelog * Issue 869 (#963) * Fix issue 943 (#965) * [Draft] Feature/tooltip enhancements (#907) * initial * update * make module standalone * use tooltips as external module * update * build via prod mode * add tooltips as external module * add declaration file and options param * add api tooltip * update * removed submodule * removed due to the incorrect setip * setup tooltips again * wip * update tooltip module * toolbox, inline toolbar * Tooltips in block tunes not uses shorthand * shorthand in a plus and block settings * fix doc * Update tools-inline.md * Delete tooltip.css * Update CHANGELOG.md * Update codex.tooltips * Update api.md * [issue-779]: Grammarly conflicts (#956) * grammarly conflicts * update * upd bundle * Submodule Header now on master * Submodule Marker now on master * Submodule Paragraph now on master * Submodule InlineCode now on master * Submodule Simple Image now on master * [issue-868]: Deleting multiple blocks triggers back button in Firefox (#967) * Deleting multiple blocks triggers back button in Firefox @evgenusov * Update editor.js * Update CHANGELOG.md * pass options on removeEventListener (#904) * pass options on removeEventListener by removeAll * rebuild * Merge branch 'release/2.16' into pr/904 * Update CHANGELOG.md * Update inline.ts * [Fix] Selection rangecount (#968) * Fix #952 (#969) * Update codex.tooltips * Selection bugfix (#970) * Selection bugfix * fix cross block selection * close inline toolbar when blocks selected via shift * remove inline toolbar closing on cross block selection mouse up due to the bug (#972) * [Feature] Log levels (#971) * Decrease margins (#973) * Decrease margins * Update editor.licenses.txt * Update src/components/domIterator.ts Co-Authored-By: Murod Khaydarov <murod.haydarov@gmail.com> * [Fix] Fix delete blocks api method (#974) * Update docs/usage.md Co-Authored-By: Murod Khaydarov <murod.haydarov@gmail.com> * rm unused * Update yarn.lock file * upd bundle, changelog
178 lines
4.5 KiB
TypeScript
178 lines
4.5 KiB
TypeScript
import Module from '../../__module';
|
|
|
|
import {Blocks} from '../../../../types/api';
|
|
import {BlockToolData, OutputData, ToolConfig} from '../../../../types';
|
|
import * as _ from './../../utils';
|
|
|
|
/**
|
|
* @class BlocksAPI
|
|
* provides with methods working with Block
|
|
*/
|
|
export default class BlocksAPI extends Module {
|
|
/**
|
|
* Available methods
|
|
* @return {Blocks}
|
|
*/
|
|
get methods(): Blocks {
|
|
return {
|
|
clear: () => this.clear(),
|
|
render: (data: OutputData) => this.render(data),
|
|
renderFromHTML: (data: string) => this.renderFromHTML(data),
|
|
delete: () => this.delete(),
|
|
swap: (fromIndex: number, toIndex: number) => this.swap(fromIndex, toIndex),
|
|
getBlockByIndex: (index: number) => this.getBlockByIndex(index),
|
|
getCurrentBlockIndex: () => this.getCurrentBlockIndex(),
|
|
getBlocksCount: () => this.getBlocksCount(),
|
|
stretchBlock: (index: number, status: boolean = true) => this.stretchBlock(index, status),
|
|
insertNewBlock: () => this.insertNewBlock(),
|
|
insert: this.insert,
|
|
};
|
|
}
|
|
|
|
/**
|
|
* Returns Blocks count
|
|
* @return {number}
|
|
*/
|
|
public getBlocksCount(): number {
|
|
return this.Editor.BlockManager.blocks.length;
|
|
}
|
|
|
|
/**
|
|
* Returns current block index
|
|
* @return {number}
|
|
*/
|
|
public getCurrentBlockIndex(): number {
|
|
return this.Editor.BlockManager.currentBlockIndex;
|
|
}
|
|
|
|
/**
|
|
* Returns Block holder by Block index
|
|
* @param {Number} index
|
|
*
|
|
* @return {HTMLElement}
|
|
*/
|
|
public getBlockByIndex(index: number): HTMLElement {
|
|
const block = this.Editor.BlockManager.getBlockByIndex(index);
|
|
return block.holder;
|
|
}
|
|
|
|
/**
|
|
* Call Block Manager method that swap Blocks
|
|
* @param {number} fromIndex - position of first Block
|
|
* @param {number} toIndex - position of second Block
|
|
*/
|
|
public swap(fromIndex: number, toIndex: number): void {
|
|
this.Editor.BlockManager.swap(fromIndex, toIndex);
|
|
|
|
/**
|
|
* Move toolbar
|
|
* DO not close the settings
|
|
*/
|
|
this.Editor.Toolbar.move(false);
|
|
}
|
|
|
|
/**
|
|
* Deletes Block
|
|
* @param blockIndex
|
|
*/
|
|
public delete(blockIndex?: number): void {
|
|
this.Editor.BlockManager.removeBlock(blockIndex);
|
|
|
|
/**
|
|
* in case of last block deletion
|
|
* Insert new initial empty block
|
|
*/
|
|
if (this.Editor.BlockManager.blocks.length === 0) {
|
|
this.Editor.BlockManager.insert();
|
|
}
|
|
|
|
/**
|
|
* After Block deletion currentBlock is updated
|
|
*/
|
|
this.Editor.Caret.setToBlock(this.Editor.BlockManager.currentBlock, this.Editor.Caret.positions.END);
|
|
|
|
this.Editor.Toolbar.close();
|
|
}
|
|
|
|
/**
|
|
* Clear Editor's area
|
|
*/
|
|
public clear(): void {
|
|
this.Editor.BlockManager.clear(true);
|
|
this.Editor.InlineToolbar.close();
|
|
}
|
|
|
|
/**
|
|
* Fills Editor with Blocks data
|
|
* @param {OutputData} data — Saved Editor data
|
|
*/
|
|
public render(data: OutputData): Promise<void> {
|
|
this.Editor.BlockManager.clear();
|
|
return this.Editor.Renderer.render(data.blocks);
|
|
}
|
|
|
|
/**
|
|
* Render passed HTML string
|
|
* @param {string} data
|
|
* @return {Promise<void>}
|
|
*/
|
|
public renderFromHTML(data: string): Promise<void> {
|
|
this.Editor.BlockManager.clear();
|
|
return this.Editor.Paste.processText(data, true);
|
|
}
|
|
|
|
/**
|
|
* Stretch Block's content
|
|
* @param {number} index
|
|
* @param {boolean} status - true to enable, false to disable
|
|
*/
|
|
public stretchBlock(index: number, status: boolean = true): void {
|
|
const block = this.Editor.BlockManager.getBlockByIndex(index);
|
|
|
|
if (!block) {
|
|
return;
|
|
}
|
|
|
|
block.stretched = status;
|
|
}
|
|
|
|
/**
|
|
* Insert new Block
|
|
*
|
|
* @param {string} type — Tool name
|
|
* @param {BlockToolData} data — Tool data to insert
|
|
* @param {ToolConfig} config — Tool config
|
|
* @param {number?} index — index where to insert new Block
|
|
* @param {boolean?} needToFocus - flag to focus inserted Block
|
|
*/
|
|
public insert = (
|
|
type: string = this.config.initialBlock,
|
|
data: BlockToolData = {},
|
|
config: ToolConfig = {},
|
|
index?: number,
|
|
needToFocus?: boolean,
|
|
): void => {
|
|
this.Editor.BlockManager.insert(
|
|
type,
|
|
data,
|
|
config,
|
|
index,
|
|
needToFocus,
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Insert new Block
|
|
* After set caret to this Block
|
|
*
|
|
* @todo: remove in 3.0.0
|
|
*
|
|
* @deprecated with insert() method
|
|
*/
|
|
public insertNewBlock(): void {
|
|
_.log('Method blocks.insertNewBlock() is deprecated and it will be removed in next major release. ' +
|
|
'Use blocks.insert() instead.', 'warn');
|
|
this.insert();
|
|
}
|
|
}
|