mirror of
https://github.com/codex-team/editor.js
synced 2024-05-08 01:16:46 +02:00
2d89105670
* Add internal wrappers for tools classes * FIx lint * Change tools collections to map * Apply some more refactoring * Make tool instance private field * Add some docs * Fix eslint * Basic implementation for Block Tunes * Small fix for demo * Review changes * Fix * Add common tunes and ToolsCollection class * Fixes after review * Rename tools collections * Readonly fix * Some fixes after review * Apply suggestions from code review Co-authored-by: Peter Savchenko <specc.dev@gmail.com> * Fixes after review * Add docs and changelog * Update docs/block-tunes.md Co-authored-by: Peter Savchenko <specc.dev@gmail.com> * Apply suggestions from code review Co-authored-by: Peter Savchenko <specc.dev@gmail.com> * Update src/components/block/index.ts Co-authored-by: Murod Khaydarov <murod.haydarov@gmail.com> * [Dev] Tools utils tests (#1602) * Add tests for tools utils and coverage report * Fix eslint * Adjust test * Add more tests * Update after code review * Fix test & bump version Co-authored-by: Peter Savchenko <specc.dev@gmail.com> Co-authored-by: Murod Khaydarov <murod.haydarov@gmail.com>
107 lines
2.4 KiB
TypeScript
107 lines
2.4 KiB
TypeScript
import Module from '../__module';
|
|
import * as _ from '../utils';
|
|
import { OutputBlockData } from '../../../types';
|
|
import BlockTool from '../tools/block';
|
|
|
|
/**
|
|
* Editor.js Renderer Module
|
|
*
|
|
* @module Renderer
|
|
* @author CodeX Team
|
|
*
|
|
* @version 2.0.0
|
|
*/
|
|
export default class Renderer extends Module {
|
|
/**
|
|
* @typedef {object} RendererBlocks
|
|
* @property {string} type - tool name
|
|
* @property {object} data - tool data
|
|
*/
|
|
|
|
/**
|
|
* @example
|
|
*
|
|
* blocks: [
|
|
* {
|
|
* type : 'paragraph',
|
|
* data : {
|
|
* text : 'Hello from Codex!'
|
|
* }
|
|
* },
|
|
* {
|
|
* type : 'paragraph',
|
|
* data : {
|
|
* text : 'Leave feedback if you like it!'
|
|
* }
|
|
* },
|
|
* ]
|
|
*
|
|
*/
|
|
|
|
/**
|
|
* Make plugin blocks from array of plugin`s data
|
|
*
|
|
* @param {OutputBlockData[]} blocks - blocks to render
|
|
*/
|
|
public async render(blocks: OutputBlockData[]): Promise<void> {
|
|
const chainData = blocks.map((block) => ({ function: (): Promise<void> => this.insertBlock(block) }));
|
|
|
|
const sequence = await _.sequence(chainData as _.ChainData[]);
|
|
|
|
this.Editor.UI.checkEmptiness();
|
|
|
|
return sequence;
|
|
}
|
|
|
|
/**
|
|
* Get plugin instance
|
|
* Add plugin instance to BlockManager
|
|
* Insert block to working zone
|
|
*
|
|
* @param {object} item - Block data to insert
|
|
*
|
|
* @returns {Promise<void>}
|
|
*/
|
|
public async insertBlock(item: OutputBlockData): Promise<void> {
|
|
const { Tools, BlockManager } = this.Editor;
|
|
const { type: tool, data, tunes } = item;
|
|
|
|
if (Tools.available.has(tool)) {
|
|
try {
|
|
BlockManager.insert({
|
|
tool,
|
|
data,
|
|
tunes,
|
|
});
|
|
} catch (error) {
|
|
_.log(`Block «${tool}» skipped because of plugins error`, 'warn', data);
|
|
throw Error(error);
|
|
}
|
|
} else {
|
|
/** If Tool is unavailable, create stub Block for it */
|
|
const stubData = {
|
|
savedData: {
|
|
type: tool,
|
|
data,
|
|
},
|
|
title: tool,
|
|
};
|
|
|
|
if (Tools.unavailable.has(tool)) {
|
|
const toolboxSettings = (Tools.unavailable.get(tool) as BlockTool).toolbox;
|
|
|
|
stubData.title = toolboxSettings?.title || stubData.title;
|
|
}
|
|
|
|
const stub = BlockManager.insert({
|
|
tool: Tools.stubTool,
|
|
data: stubData,
|
|
});
|
|
|
|
stub.stretched = true;
|
|
|
|
_.log(`Tool «${tool}» is not found. Check 'tools' property at your initial Editor.js config.`, 'warn');
|
|
}
|
|
}
|
|
}
|