imageUploadUrl

Описание

Необязательное. Задаёт URL, который будет использоваться для загрузки изображений (из панели инструментов, строки меню, вставки из буфера обмена или перетаскивания)

Если свойство задано, RichText загружает каждое вставленное изображение на указанный эндпоинт и подставляет URL, возвращённый сервером.

Если свойство не указано или имеет ложное значение ("", null, undefined), RichText переходит в режим inline: файл изображения читается на клиенте и встраивается непосредственно в содержимое в виде data URL в формате base64, поэтому сервер не требуется. Встроенные изображения размером более 1024×800 пропорционально уменьшаются до этих пределов.

Примечание

Встроенные (base64) изображения не сохраняются при встроенном экспорте в DOCX / PDF. Если вы используете экспорт, укажите imageUploadUrl, чтобы изображения ссылались на внешнее расположение.

Осторожно

Кодирование в base64 увеличивает размер данных примерно на одну треть по сравнению с исходным файлом. Документ с несколькими крупными встроенными изображениями вырастает соответственно, что влияет на размер значения, возвращаемого getValue(), на потребление памяти редактором и на стоимость сохранения или передачи содержимого. Для документов с большим количеством крупных изображений рекомендуется использовать серверный imageUploadUrl.

Использование

imageUploadUrl?: string;

Пример

Загрузка изображений на серверный эндпоинт:

// инициализация RichText
new richtext.Richtext("#root", {
    imageUploadUrl: "https://example.com/upload"
    // другие свойства конфигурации
});

Чтобы вставлять изображения inline в виде base64 (сервер не требуется), не указывайте свойство или передайте пустую строку:

new richtext.Richtext("#root", {
    // imageUploadUrl не задан, изображения вставляются как data URL в формате base64
    // другие свойства конфигурации
});

Журнал изменений: Свойство добавлено в v2.0. Начиная с v2.1 свойство является необязательным: если оно не указано, изображения вставляются inline в виде base64 data URL.

Полезные статьи: Конфигурация, Работа с сервером

Связанный пример: RichText. Инициализация