mirror of
https://github.com/codex-team/editor.js
synced 2024-05-02 22:53:23 +02:00
581289c03e
* Default tunes to popover * Add the rest of default tunes * Add popover * Cleanup * Rename custom content * Cleanup * Add ability to open block settings upwards * Fix tests * Cleanup default tunes * Rename and cleanup * Add ability to display rendered custom tunes * cleanup * Rename * Add flag to close tunes popover * Cleanup * i18n * Cleanup * Fix build and tests * Fix for iframe * Add comments * Display active item, move closeOnActivate to popover * Add confirmation support to popover * Handle boolean value in confirmation param * Clarify flippable logic in popover * Comments * Pass editor element as a param of popover constructor * Fix readability * Tests * Fix flipper for confirmation element * Update confirmation config structure * Rename onClick to onActivate * Fix tests and build * Make confirmation props optional * Simplify processing tunes * Renamings * Fix text block tunes * Docs * Update event type * Move enabling confirmation state to separate method * move popover types * Unhardcode color * Support toggling * Add support of disabled items * Fix tab in empty block leading to selecting second item in popover * Remove margins for styles api settings button class * Fix arrow navigation between blocks after opening block tunes * Cleaup in default tunes code * Fix chaining confirmations * Colors * Types * Change the way flippable elements of popover custom area are set * Remove borders around popover icons * Fix untabbable inline toolbar * Fix locked scroll after closing tunes popover on mobile * Cleanup * Set max popover width * Make popover icon's border outside * Fix tab issue * Fix focus/hover issue * Reformat * Cleanup * Fix opening block tunes via keyboard * Add disableSpecialHoverAndFocusBehavior * Add deprecated comment * Cleanup * Fix popover active state * Fix checklist deletion with confirmation * Fix checklist deletion 2 * Fix popover focus * Fix popover items being impossible to flip after searching * Fix popover item highlighting issue * Update flipper.spec.ts * Fixes after review * Add Tunes Api tests * Fix multiple popover entries configured by one tune * Add tool's renderSettings() tests * Add popover confirmation state test * Fix popover width on mobile * Add popover tests * Add changelog and update version * Update changelog * Fix block tunes being unable to open after tune activation Co-authored-by: Peter Savchenko <specc.dev@gmail.com>
423 lines
14 KiB
HTML
423 lines
14 KiB
HTML
<!--
|
||
This page contains example of editor.js internalization.
|
||
See <script> section -> i18n property of the configuration object
|
||
|
||
\ (•◡•) /
|
||
-->
|
||
<!DOCTYPE html>
|
||
<html lang="en">
|
||
<head>
|
||
<meta charset="UTF-8">
|
||
<title>Editor.js 🤩🧦🤨 example</title>
|
||
<link href="https://fonts.googleapis.com/css?family=PT+Mono" rel="stylesheet">
|
||
<link href="assets/demo.css" rel="stylesheet">
|
||
<script src="assets/json-preview.js"></script>
|
||
<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=no" />
|
||
</head>
|
||
<body>
|
||
<div class="ce-example">
|
||
<div class="ce-example__header">
|
||
<a class="ce-example__header-logo" href="https://codex.so/editor">Editor.js 🤩🧦🤨</a>
|
||
|
||
<div class="ce-example__header-menu">
|
||
<a href="https://github.com/editor-js" target="_blank">Plugins</a>
|
||
<a href="https://editorjs.io/usage" target="_blank">Usage</a>
|
||
<a href="https://editorjs.io/configuration" target="_blank">Configuration</a>
|
||
<a href="https://editorjs.io/creating-a-block-tool" target="_blank">API</a>
|
||
</div>
|
||
</div>
|
||
<div class="ce-example__content _ce-example__content--small">
|
||
<div id="editorjs"></div>
|
||
<div id="hint-core" style="text-align: center;">
|
||
No core bundle file found. Run <code class="inline-code">yarn build</code>
|
||
</div>
|
||
|
||
<div class="ce-example__button" id="saveButton">
|
||
editor.save()
|
||
</div>
|
||
</div>
|
||
<div class="ce-example__output">
|
||
<pre class="ce-example__output-content" id="output"></pre>
|
||
|
||
<div class="ce-example__output-footer">
|
||
<a href="https://codex.so" style="font-weight: bold;">Made by CodeX</a>
|
||
</div>
|
||
</div>
|
||
</div>
|
||
|
||
<!-- Load Tools -->
|
||
<script src="https://cdn.jsdelivr.net/npm/@editorjs/header@latest"></script><!-- Header -->
|
||
<script src="https://cdn.jsdelivr.net/npm/@editorjs/image@latest"></script><!-- Image -->
|
||
<script src="https://cdn.jsdelivr.net/npm/@editorjs/delimiter@latest"></script><!-- Delimiter -->
|
||
<script src="https://cdn.jsdelivr.net/npm/@editorjs/list@latest"></script><!-- List -->
|
||
<script src="https://cdn.jsdelivr.net/npm/@editorjs/checklist@latest"></script><!-- Checklist -->
|
||
<script src="https://cdn.jsdelivr.net/npm/@editorjs/quote@latest"></script><!-- Quote -->
|
||
<script src="https://cdn.jsdelivr.net/npm/@editorjs/code@latest"></script><!-- Code -->
|
||
<script src="https://cdn.jsdelivr.net/npm/@editorjs/embed@latest"></script><!-- Embed -->
|
||
<script src="https://cdn.jsdelivr.net/npm/@editorjs/table@latest"></script><!-- Table -->
|
||
<script src="https://cdn.jsdelivr.net/npm/@editorjs/link@latest"></script><!-- Link -->
|
||
<script src="https://cdn.jsdelivr.net/npm/@editorjs/warning@latest"></script><!-- Warning -->
|
||
<script src="https://cdn.jsdelivr.net/npm/@editorjs/marker@latest"></script><!-- Marker -->
|
||
<script src="https://cdn.jsdelivr.net/npm/@editorjs/inline-code@latest"></script><!-- Inline Code -->
|
||
|
||
<!-- Load Editor.js's Core -->
|
||
<script src="../dist/editor.js" onload="document.getElementById('hint-core').hidden = true"></script>
|
||
|
||
<!-- Initialization -->
|
||
<script>
|
||
/**
|
||
* Saving button
|
||
*/
|
||
const saveButton = document.getElementById('saveButton');
|
||
|
||
/**
|
||
* To initialize the Editor, create a new instance with configuration object
|
||
* @see docs/installation.md for mode details
|
||
*/
|
||
var editor = new EditorJS({
|
||
/**
|
||
* Wrapper of Editor
|
||
*/
|
||
holder: 'editorjs',
|
||
|
||
/**
|
||
* Tools list
|
||
*/
|
||
tools: {
|
||
paragraph: {
|
||
config: {
|
||
placeholder: "Enter something"
|
||
}
|
||
},
|
||
/**
|
||
* Each Tool is a Plugin. Pass them via 'class' option with necessary settings {@link docs/tools.md}
|
||
*/
|
||
header: {
|
||
class: Header,
|
||
inlineToolbar: ['link'],
|
||
config: {
|
||
placeholder: 'Header'
|
||
},
|
||
shortcut: 'CMD+SHIFT+H'
|
||
},
|
||
|
||
/**
|
||
* Or pass class directly without any configuration
|
||
*/
|
||
image: ImageTool,
|
||
|
||
list: {
|
||
class: List,
|
||
inlineToolbar: true,
|
||
shortcut: 'CMD+SHIFT+L'
|
||
},
|
||
|
||
checklist: {
|
||
class: Checklist,
|
||
inlineToolbar: true,
|
||
},
|
||
|
||
quote: {
|
||
class: Quote,
|
||
inlineToolbar: true,
|
||
config: {
|
||
quotePlaceholder: 'Enter a quote',
|
||
captionPlaceholder: 'Quote\'s author',
|
||
},
|
||
shortcut: 'CMD+SHIFT+O'
|
||
},
|
||
|
||
warning: Warning,
|
||
|
||
marker: {
|
||
class: Marker,
|
||
shortcut: 'CMD+SHIFT+M'
|
||
},
|
||
|
||
code: {
|
||
class: CodeTool,
|
||
shortcut: 'CMD+SHIFT+C'
|
||
},
|
||
|
||
delimiter: Delimiter,
|
||
|
||
inlineCode: {
|
||
class: InlineCode,
|
||
shortcut: 'CMD+SHIFT+C'
|
||
},
|
||
|
||
linkTool: LinkTool,
|
||
|
||
embed: Embed,
|
||
|
||
table: {
|
||
class: Table,
|
||
inlineToolbar: true,
|
||
shortcut: 'CMD+ALT+T'
|
||
},
|
||
|
||
},
|
||
/**
|
||
* To provide localization of the editor.js you need to provide 'i18n' option with 'messages' dictionary:
|
||
*
|
||
* 1. At the 'ui' section of 'messages' there are translations for the internal editor.js UI elements.
|
||
* You can create or find/download a dictionary for your language
|
||
*
|
||
* 2. As long as tools list is a user-specific thing (we do not know which tools you use and under which names),
|
||
* so we can't provide a ready-to-use tool names dictionary.
|
||
* There is a 'toolNames' section for that reason. Put translations for the names of your tools there.
|
||
*
|
||
* 3. Also, the UI of the tools you use is also invisible to editor.js core.
|
||
* To pass translations for specific tools (that supports I18n API), there are 'tools' and 'blockTunes' section.
|
||
* Pass dictionaries for specific plugins through them.
|
||
*/
|
||
i18n: {
|
||
/**
|
||
* @type {I18nDictionary}
|
||
*/
|
||
messages: {
|
||
/**
|
||
* Other below: translation of different UI components of the editor.js core
|
||
*/
|
||
"ui": {
|
||
"blockTunes": {
|
||
"toggler": {
|
||
"Click to tune": "Нажмите, чтобы настроить",
|
||
"or drag to move": "или перетащите"
|
||
},
|
||
},
|
||
"inlineToolbar": {
|
||
"converter": {
|
||
"Convert to": "Конвертировать в"
|
||
}
|
||
},
|
||
"toolbar": {
|
||
"toolbox": {
|
||
"Add": "Добавить",
|
||
}
|
||
},
|
||
"popover": {
|
||
"Filter": "Поиск",
|
||
"Nothing found": "Ничего не найдено"
|
||
}
|
||
},
|
||
|
||
/**
|
||
* Section for translation Tool Names: both block and inline tools
|
||
*/
|
||
"toolNames": {
|
||
"Text": "Параграф",
|
||
"Heading": "Заголовок",
|
||
"List": "Список",
|
||
"Warning": "Примечание",
|
||
"Checklist": "Чеклист",
|
||
"Quote": "Цитата",
|
||
"Code": "Код",
|
||
"Delimiter": "Разделитель",
|
||
"Raw HTML": "HTML-фрагмент",
|
||
"Table": "Таблица",
|
||
"Link": "Ссылка",
|
||
"Marker": "Маркер",
|
||
"Bold": "Полужирный",
|
||
"Italic": "Курсив",
|
||
"InlineCode": "Моноширинный",
|
||
"Image": "Картинка"
|
||
},
|
||
|
||
/**
|
||
* Section for passing translations to the external tools classes
|
||
*/
|
||
"tools": {
|
||
/**
|
||
* Each subsection is the i18n dictionary that will be passed to the corresponded plugin
|
||
* The name of a plugin should be equal the name you specify in the 'tool' section for that plugin
|
||
*/
|
||
"warning": { // <-- 'Warning' tool will accept this dictionary section
|
||
"Title": "Название",
|
||
"Message": "Сообщение",
|
||
},
|
||
|
||
/**
|
||
* Link is the internal Inline Tool
|
||
*/
|
||
"link": {
|
||
"Add a link": "Вставьте ссылку"
|
||
},
|
||
/**
|
||
* The "stub" is an internal block tool, used to fit blocks that does not have the corresponded plugin
|
||
*/
|
||
"stub": {
|
||
'The block can not be displayed correctly.': 'Блок не может быть отображен'
|
||
},
|
||
"image": {
|
||
"Caption": "Подпись",
|
||
"Select an Image": "Выберите файл",
|
||
"With border": "Добавить рамку",
|
||
"Stretch image": "Растянуть",
|
||
"With background": "Добавить подложку",
|
||
},
|
||
"code": {
|
||
"Enter a code": "Код",
|
||
},
|
||
"linkTool": {
|
||
"Link": "Ссылка",
|
||
"Couldn't fetch the link data": "Не удалось получить данные",
|
||
"Couldn't get this link data, try the other one": "Не удалось получить данные по ссылке, попробуйте другую",
|
||
"Wrong response format from the server": "Неполадки на сервере",
|
||
},
|
||
"header": {
|
||
"Header": "Заголовок",
|
||
},
|
||
"paragraph": {
|
||
"Enter something": "Введите текст"
|
||
},
|
||
"list": {
|
||
"Ordered": "Нумерованный",
|
||
"Unordered": "Маркированный",
|
||
}
|
||
},
|
||
|
||
/**
|
||
* Section allows to translate Block Tunes
|
||
*/
|
||
"blockTunes": {
|
||
/**
|
||
* Each subsection is the i18n dictionary that will be passed to the corresponded Block Tune plugin
|
||
* The name of a plugin should be equal the name you specify in the 'tunes' section for that plugin
|
||
*
|
||
* Also, there are few internal block tunes: "delete", "moveUp" and "moveDown"
|
||
*/
|
||
"delete": {
|
||
"Delete": "Удалить"
|
||
},
|
||
"moveUp": {
|
||
"Move up": "Переместить вверх"
|
||
},
|
||
"moveDown": {
|
||
"Move down": "Переместить вниз"
|
||
}
|
||
},
|
||
}
|
||
},
|
||
|
||
/**
|
||
* Initial Editor data
|
||
*/
|
||
data: {
|
||
blocks: [
|
||
{
|
||
type: "header",
|
||
data: {
|
||
text: "Editor.js",
|
||
level: 2
|
||
}
|
||
},
|
||
{
|
||
type : 'paragraph',
|
||
data : {
|
||
text : 'Hey. Meet the new Editor. On this page you can see it in action — try to edit this text. Source code of the page contains the example of connection and configuration.'
|
||
}
|
||
},
|
||
{
|
||
type: "header",
|
||
data: {
|
||
text: "Key features",
|
||
level: 3
|
||
}
|
||
},
|
||
{
|
||
type : 'list',
|
||
data : {
|
||
items : [
|
||
'It is a block-styled editor',
|
||
'It returns clean data output in JSON',
|
||
'Designed to be extendable and pluggable with a simple API',
|
||
],
|
||
style: 'unordered'
|
||
}
|
||
},
|
||
{
|
||
type: "header",
|
||
data: {
|
||
text: "What does it mean «block-styled editor»",
|
||
level: 3
|
||
}
|
||
},
|
||
{
|
||
type : 'paragraph',
|
||
data : {
|
||
text : 'Workspace in classic editors is made of a single contenteditable element, used to create different HTML markups. Editor.js <mark class=\"cdx-marker\">workspace consists of separate Blocks: paragraphs, headings, images, lists, quotes, etc</mark>. Each of them is an independent contenteditable element (or more complex structure) provided by Plugin and united by Editor\'s Core.'
|
||
}
|
||
},
|
||
{
|
||
type : 'paragraph',
|
||
data : {
|
||
text : `There are dozens of <a href="https://github.com/editor-js">ready-to-use Blocks</a> and the <a href="https://editorjs.io/creating-a-block-tool">simple API</a> for creation any Block you need. For example, you can implement Blocks for Tweets, Instagram posts, surveys and polls, CTA-buttons and even games.`
|
||
}
|
||
},
|
||
{
|
||
type: "header",
|
||
data: {
|
||
text: "What does it mean clean data output",
|
||
level: 3
|
||
}
|
||
},
|
||
{
|
||
type : 'paragraph',
|
||
data : {
|
||
text : 'Classic WYSIWYG-editors produce raw HTML-markup with both content data and content appearance. On the contrary, Editor.js outputs JSON object with data of each Block. You can see an example below'
|
||
}
|
||
},
|
||
{
|
||
type : 'paragraph',
|
||
data : {
|
||
text : `Given data can be used as you want: render with HTML for <code class="inline-code">Web clients</code>, render natively for <code class="inline-code">mobile apps</code>, create markup for <code class="inline-code">Facebook Instant Articles</code> or <code class="inline-code">Google AMP</code>, generate an <code class="inline-code">audio version</code> and so on.`
|
||
}
|
||
},
|
||
{
|
||
type : 'paragraph',
|
||
data : {
|
||
text : 'Clean data is useful to sanitize, validate and process on the backend.'
|
||
}
|
||
},
|
||
{
|
||
type : 'delimiter',
|
||
data : {}
|
||
},
|
||
{
|
||
type : 'paragraph',
|
||
data : {
|
||
text : 'We have been working on this project more than three years. Several large media projects help us to test and debug the Editor, to make its core more stable. At the same time we significantly improved the API. Now, it can be used to create any plugin for any task. Hope you enjoy. 😏'
|
||
}
|
||
},
|
||
{
|
||
type: 'image',
|
||
data: {
|
||
file : {
|
||
url: 'assets/codex2x.png',
|
||
},
|
||
caption: '',
|
||
stretched: false,
|
||
withBorder: true,
|
||
withBackground: false,
|
||
}
|
||
},
|
||
]
|
||
},
|
||
onReady: function(){
|
||
saveButton.click();
|
||
},
|
||
});
|
||
|
||
/**
|
||
* Saving example
|
||
*/
|
||
saveButton.addEventListener('click', function () {
|
||
editor.save().then((savedData) => {
|
||
cPreview.show(savedData, document.getElementById("output"));
|
||
});
|
||
});
|
||
</script>
|
||
</body>
|
||
</html>
|