Справочник на функциите

Всяка функция по-долу е част от редактора. Някои принадлежат на приставка (в последната колона); RteOptions.Plugins избира кои от 14-те вградени приставки да се заредят.

Редактиране

Функция	Бележки	Приставка
Настройваема лента с инструменти	Toolbar изброява бутоните; бутонът „още“ прибира останалите на тесни екрани	ядро
Назад и напред	неограничено, и за таблици	ядро
Режими	Design, HTML код и Preview; режимът HTML показва чистия HTML	ядро
Цял екран	F11 или бутонът	ядро
Enter	прави p, br или div (EnterMode); Shift+Enter е нов ред	ядро
Отстъп	с CSS поле, при списъците чрез вложеност	ядро
Търсене и замяна	главни и малки, цяла дума, замяна на всички с една стъпка назад	find
Режими на писане	„пишеща машина“ и „фокус“	tools
Локална чернова	браузърът пази чернова и пита дали да се възстанови	ядро

Текст и блокове

Стилове на абзаца и заглавия от 1 до 6, получер, курсив, подчертан, зачертан, код в реда, долен и горен индекс, цветове на текста и осветяване, размер на шрифта, междуредие, подравняване, списъци с точки, номерирани и със задачи, цитати, хоризонтални линии, блокове с код и откъси, и „изчистване на форматирането“.

Модерни блокове (менюто /, приставки slash и blocks): рамки за информация (информация, успех, предупреждение), две до четири колони, сгъваеми блокове, списъци със задачи, формули (TeX), диаграми (Mermaid), карти за отметки, етикети за дата, човек и връзка, сгъваеми заглавия, и дръжка на всеки блок за плъзгане или за неговото меню (дублиране, нагоре и надолу, изтриване).

Таблици (приставка tables)

Вмъкване с решетка или диалог, добавяне и махане на редове и колони, сливане и разделяне на клетки, подравняване, рамки, свойства на таблицата и клетката, преоразмеряване на колони, избор на клетки, контекстно меню, Tab и Shift+Tab за преминаване между клетките.

Връзки, изображения и медия

• Диалог за връзка: уеб адрес, имейл, телефон или заглавие в същия текст; заглавие, цел и rel. Двойката noopener noreferrer се добавя за нов прозорец.
• Диалог за изображение: адрес или качване, алтернативен текст с подсказка, ширина и височина със запазени пропорции, подравняване, надпис (изображението става фигура), късно зареждане, дръжки за преоразмеряване.
• Библиотека от файлове (MediaStore): миниатюри, папки, преименуване, изтриване, търсене, подредба, страници, намаляване на големи изображения при качване, плъзгане и пускане.
• Видео и аудио: адрес или файл; адреси от YouTube и Vimeo се вграждат в рамка с sandbox; приемат се само хостовете от Embed.AllowedHosts.
• Шаблони: девет вградени оформления и свои чрез IRteTemplateProvider.
• Избор на емоджи и :кодове:.
• Качване на файлове с филтър на видовете и ограничение на размера.

Поставяне и внос

• Чистене на съдържание от Word и Excel: списъците остават списъци, таблиците остават таблици, офис разметката се маха.
• Три режима: със запазено форматиране, само символно форматиране, чист текст. Ctrl+Shift+V поставя като чист текст. След поставяне меню (Alt+Shift+V) сменя режима.
• Плъзгане и пускане на изображения и файлове.
• Внос на Markdown от менюто за изход; внос на JSON.

Помощ при писане

Кратки команди на Markdown докато пишете (# , - , 1. , **получер**, ` код , текст), проверка на правописа (браузърът или сървърът чрез IRteSpellChecker), четене на глас, диктуване (иска браузър, който го поддържа, и микрофон), кодовете :емоджи:`.

Преглед

• Коментари върху селекция, с отговори и приключване (IRteCommentStore).
• Именувани ревизии със сравнение една до друга (IRteRevisionStore).
• Панел за достъпност на живо: алтернативен текст, празни заглавия, неясен текст на връзки, контраст, таблици, рамки. За много от забележките има бутон за поправка.
• Полета за сливане (MergeFields) със преглед, който не променя записания текст.
• Инспектор на таговете: показва пътя от тагове при курсора и позволява да се редактират атрибути, да се махне обвивката или елементът.

Изход

Чист HTML 5, XHTML, структуриран JSON, Markdown, HTML за писма с вградени стилове, статичен HTML, чист текст, DOCX на сървъра, PDF през диалога за печат. Вижте Износ и внос.

Контрол на съдържанието

Разрешени и забранени елементи и атрибути, лимити на дължината в лентата за състояние, относителни или абсолютни адреси, проверка на JSON. Вижте Сигурност.

Достъпност на самия редактор

Всяка команда може да се ползва от клавиатурата. Лентата е една точка за Tab и се движи със стрелките; диалозите задържат и връщат фокуса; промените на състоянието се съобщават на екранни четци; зачитат се prefers-reduced-motion и принудителните цветове; иконите са SVG; на тесни екрани има компактна лента с долни панели (написана и проверена по стиловите правила, още не изпробвана на устройства).

Куки за тежките части

Функция	Вградено	Свързва се
Формули	TeX в стилизирана кутия; когато страницата има window.katex или window.MathJax, те се ползват	заредете KaTeX или MathJax
Диаграми	код на Mermaid в стилизирана кутия; ползва се window.mermaid, ако го има	заредете Mermaid
Едновременно писане	editor.collab: чужди курсори, списък на присъстващите, последният записал печели	IRteCollaboration и CRDT като Yjs
Износ и внос на Word	BasicDocxExporter, BasicDocxImporter	IRteDocxExporter, IRteDocxImporter
PDF	диалогът за печат	свой сървърен изобразител
Хора за споменавания	няма	IRtePeopleProvider
Заглавия на карти за отметки	само домейнът	IRteLinkPreviewProvider

Разширяване в браузъра

Приставката е модул с export default function install(editor). Регистрирайте я, преди да стартират редакторите:

const { registerPlugin } = await import("/_content/Rte/js/rte.js");
registerPlugin("mine", editor => {
    editor.commands.register("hello", { label: "Hello", run: ed => ed.insertHtml("<p>Hello</p>") });
    editor.toolbar.add({ name: "hello", type: "button", label: "Hello", icon: "edit", command: "hello" });
    editor.slash.add({ id: "hello", label: "Hello", keywords: ["hi"], run: ed => ed.exec("hello") });
});

Добавете "hello" в Options.Toolbar, за да се покаже бутонът. Програмният интерфейс (команди, лента, диалози, менюта, панели, лента за състояние, история, селекция, събития, dotnet.call) е описан в спецификацията към изходния код (SPEC.md). window.Rte.getEditors() връща живите редактори.