.. _chromium_frame_g1:

Редактор HTML (Chromium)
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Классы фреймов:

.. class:: btkFrame.TbtkLookupChromiumHTMLViewerFrame

.. attention::
    
    Данный фрейм не реализован в :term:`AS`

Описание
^^^^^^^^
Фрейм для просмотра и редактирования HTML страниц на основе `Chromium Embedded Framework <https://bitbucket.org/chromiumembedded/cef/src/master/>`_


Свойства фрейма
^^^^^^^^^^^^^^^

+------------------------------------------------------------------+-----------------------------------------+
| Свойство                                                         | Описание                                |
+------------------------------------------------------------------+-----------------------------------------+
| :btk:frameprop:`TbtkLookupChromiumHTMLViewerFrame.HTMLFieldName` | Атрибут, который содержит HTML текст.   |
+------------------------------------------------------------------+-----------------------------------------+

Вызов паскаль скриптов из HTML
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Паскаль скрипт в ссылке
''''''''''''''''''''''''

В документе HTML паскаль-скриптами могут быть ссылки. При нажатии на
сслылку произойдёт выполнение скрипта в рамках текущей выборки.

Для этого в теле тэга, обозначающего гипер-ссылку, необходимо поместить
управляющий тэг <script>. То что находится после этого тэга будет
считаться скриптом

.. code-block:: html
  :caption: Пример

    <a href="<script><Pascal>
      ShowMessage('Hello, World');
    </Pascal>">Паскаль скрипт</a>
    
Вызов паскаль скрипта из JS
''''''''''''''''''''''''''''

Для выполнениия паскаль скрипта из JS нужно воспользоваться методом :js:func:`btkSelection.executeOperationText`.

JS расширения
^^^^^^^^^^^^^

.. js:function:: btkSelection.executeOperationText(operationText [, operationArgs])
    
    Выполняет текст паскаль скрипта в контексте текущей выборки.
   
    :param string operationText: Текст паскаль скрипта.
    :param operationArgs: Аргументы паскаль скрипта.
   
    .. code-block:: js
      :caption: Выполнениие паскаль скрипта

      btkSelection.executeOperationText("<Pascal> ShowMessage('Pascal exec'); </Pascal>");
 
    В качестве operationArgs можно передать как единственное значение, так и массив. Аргуметы в паскаль скрипте доступны через "args" в открывающем теге "PASCAL". В качестве аргументов можно передать только простые типы данных - Int, Bool, Double, Date, String.

    .. code-block:: js
      :caption: Выполнениие паскаль скрипта с параметрами

      btkSelection.executeOperationText("<Pascal arg> ShowMessage(arg); </Pascal>", "some text");
      
      btkSelection.executeOperationText("<Pascal arg1, arg2, arg3> ShowMessage(IntToStr(arg1 + arg2 + arg3)); </Pascal>", [10, 18, 36]);
      
    
    Выполенние паскаль скрипта происходит асинхронно. Для получения результата из паскаль скрипта у функции :js:func:`btkSelection.executeOperationText` необходимо вызвать метод "then", в который необходимо передать коллбек вида `callback(result)`.
    После выполнения паскаль скрипта будет вызван переданный коллбек, в который будет передан результат выполнения паскаль скрипта. 
    В качестве результата из паскаль скрипта можно передавать только простые типы данных - Int, Bool, Double, String, или массив этих типов.
    
    .. code-block:: js
      :caption: Выполнениие паскаль скрипта с возвраащемым результатом

      function onOperationExecuted(result)
      {
        alert(reslut);
      }
      
      btkSelection.executeOperationText("<Pascal> Result := 'Result from pascal'; </Pascal>").then(onOperationExecuted);