.. _html_frame:

Редактор HTML
===============

.. _html_frame_sandbox:
Sandbox-разрешения фрейма
---------------------------

.. versionadded:: 1.27.0-ms5

.. versionadded:: BTK_1.5.39.0

:term:`Application Server` предоставляет возможность управлять `набором sandbox-разрешений <https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/iframe#sandbox>`_, накладываемых на HTML-фрейм, когда он находится в режиме просмотра HTML-кода.

**Значения**: Может быть пустым, т.е. не иметь ни одного разрешения, или содержать разделённый пробелами набор разрешений, например, ``allow-scripts allow-forms``.

**Важно**: Свойство всегда содержит ``allow-same-origin`` по умолчанию, даже если оно явно не указано. Это необходимо, так как без ``allow-same-origin`` :term:`AS` будет считать, что HTML-фрейм загружен из другого источника и выбросит исключение.

**Пример использования**: Если указать значение ``allow-scripts allow-forms``, то итоговый набор разрешений будет: ``allow-same-origin allow-scripts allow-forms``.

.. seealso::

    - :btk:frameprop:`Метаданные Oracle -> HTML-Редактор -> Sandbox-разрешения фрейма <Sandbox>`
    - :xsd:attr:`Метаданные Postgres -> HTML-Редактор -> Sandbox-разрешения фрейма <View.Representation.Layout.Frame.Html.sandbox>`

Примечания
^^^^^^^^^^^^

- Если код внутри HTML-фрейма не выполнится по причине отсутствия какого-либо разрешения, информация об этом будет выведена в консоль браузера.
- Если будут продублированы какие-либо разрешения, то это не приведёт к ошибке.
- Если будет указанно какое-либо значение, которое не относится к набору разрешений, указанных выше, то эти значения будут проигнорированы. Информация об этом будет выведена в консоль браузера.