Interface: IframeSandboxConfig

Интерфейс разрешений для элемента iframe редактора.

Используется для явной настройки атрибута allow у iframe при интеграции редактора. Позволяет включать или выключать доступ к специфическим функциям браузера: буфер обмена, микрофон, полноэкранный режим и др.

Remarks

Типичные сценарии использования:

• Встраивание редактора с ограничением или разрешением доступа к буферу обмена (копировать/вставить).
• Получение голосового ввода через микрофон.
• Управление презентациями в полноэкранном режиме.

Example

Разрешить чтение/запись буфера обмена и микрофон

builder.withIframeSandboxConfig({
  allowClipboardRead: true,
  allowClipboardWrite: true,
  allowMicrophone: true
})

Только полноэкранный режим для презентаций

builder.withIframeSandboxConfig({
  fullscreen: true
})

Без разрешений (iframe максимально защищён)

builder.withIframeSandboxConfig({})

Не включайте лишние разрешения без бизнес-обоснования. Браузеры могут показать пользователю запрос на предоставление доступа. Необходимые разрешения влияют на UX и безопасность пользовательских данных.

Свойство	По умолчанию	Атрибут в iframe	Назначение
allowClipboardRead	false	clipboard-read	Paste из ОС/менеджеров
allowClipboardWrite	false	clipboard-write	Copy в ОС
allowMicrophone	false	allowMicrophone	Голосовой ввод
fullscreen	false	fullscreen	Fullscreen режиме

See

• MDN: iframe allow attribute
• EditorBuilder.withIframeSandboxConfig

Properties

allowClipboardRead?

optional allowClipboardRead: boolean

Доступ к буферу обмена на чтение. Позволяет читать данные из системного clipboard, использовать paste из ОС.

Default

false

---

allowClipboardWrite?

optional allowClipboardWrite: boolean

Доступ к буферу обмена на запись. Позволяет записывать данные в системный clipboard, использовать copy в ОС.

Default

false

---

allowFullscreen?

optional allowFullscreen: boolean

Доступ к полноэкранному режиму. Позволяет развернуть редактор/документ на весь экран, важно для презентаций.

Default

false

---

allowMicrophone?

optional allowMicrophone: boolean

Доступ к микрофону. Нужен для голосового ввода, захвата аудио, диктовки текста.

Default

false