Свойства компонента интерфейса, унаследованного от «КонтейнерHtml»

Показывает произвольный HTML-код. Например, YouTube-плеер.

Иерархия наследования

Компонент (абстрактный)
- КонтейнерHtml

Работа со скриптами

КонтейнерHtml позволяет вам вызывать скрипты, указанные в свойстве Содержимое. Вы можете обращаться к переменным скрипта, вызывать его функции и обрабатывать результат их выполнения, работать с объектами JavaScript.

Примечание: Чтобы включить выполнение скриптов, задайте свойству КонтейнерHtml.БезопасныйРежим значение Ложь.

Работу со скриптами рекомендуется выполнять в обработчике события ПослеЗагрузкиСодержимого. Использование данного события гарантирует, что скрипт начнет выполняться только после того, как объектная модель документа (DOM) будет полностью построена. В противном случае попытка вызвать скрипт может привести к исключению, например, если КонтейнерHtml находится за пределами экрана или скрыт.

Для обработки исключений, которые могут быть выброшены при вызове скрипта, обращении к его переменным, объектам или функциям, используйте тип ИсключениеВыполненияJs.

Работа с переменными

Для работы с переменными скрипта вы можете использовать следующие методы компонента КонтейнерHtml:

ПолучитьПеременную() — возвращает значение переменной с указанным именем.
УстановитьПеременную() — присваивает значение переменной с указанным именем.

В качестве имен переменных допустимо использовать имена, разделенные точкой (например, User.Name), и индексаторы (например, MyList.Values[0]).

Рассмотрим использование данных методов на примере следующего скрипта:

ВидЭлемента: КомпонентИнтерфейса
Ид: 340f7282-9b15-49b0-bf95-452ec06a4236
Имя: КонтейнерHtml1
ОбластьВидимости: ВПодсистеме
Наследует:
    Тип: КонтейнерHtml
    БезопасныйРежим: Ложь
    ПослеЗагрузкиСодержимого: КонтейнерHtmlПослеЗагрузкиСодержимого
    Содержимое: <html> <body> <script> var user1, user2 = 'Иван Кузнецов'; </script> </body> </html>

Обработка переменных скрипта во встроенном языке:

метод КонтейнерHtmlПослеЗагрузкиСодержимого(Источник: КонтейнерHtml, Событие: СобытиеКомпонента)
    // Присваивание значения переменной "user1".
    Источник.УстановитьПеременную("user1", "Андрей Смирнов")
    // Получение значения переменной "user2" - "Иван Кузнецов".
    пер Пользователь2 = Источник.ПолучитьПеременную("user2")
;

Работа с методами

КонтейнерHtml поддерживает вызов функций, содержащихся в скрипте. Для это используется метод ВызватьМетод(), позволяющий указать имя вызываемой функции и ее аргументы (при наличии). В качестве имени функции можно использовать составные имена, разделенные точкой (например, User.GetName). Метод ВызватьМетод() возвращает результат выполнения функции или Неопределено, если функция не возвращает значение.

Пример вызова функции скрипта:

ВидЭлемента: КомпонентИнтерфейса
Ид: 340f7282-9b15-49b0-bf95-452ec06a4236
Имя: КонтейнерHtml1
ОбластьВидимости: ВПодсистеме
Наследует:
    Тип: КонтейнерHtml
    БезопасныйРежим: Ложь
    ПослеЗагрузкиСодержимого: КонтейнерHtmlПослеЗагрузкиСодержимого
    Содержимое: <html> <body> <script> function sum(a, b) { return a + b; } </script> </body> </html>

метод КонтейнерHtmlПослеЗагрузкиСодержимого(Источник: КонтейнерHtml, Событие: СобытиеКомпонента)
    // Вызов функции "sum". 
    // Переменной будет присвоено значение 30.
    пер Результат = Источник.ВызватьМетод("sum", [10, 20])
;

Работа с объектами JavaScript

КонтейнерHtml поддерживает работу с объектами JavaScript, которые используются для хранения коллекций различных значений или более сложных структур. В частности, вы можете:

обращаться к методам и свойствам объекта;
использовать объекты JavaScript в качестве аргументов при вызове других методов;
создавать новые объекты с помощью метода КонтейнерHtml.СоздатьОбъектJs().

Для работы с объектами JavaScript во встроенном языке используются методы типа ОбъектJs:

ВызватьМетод() — вызывает метод объекта JavaScript и возвращает результат выполнения.
ПолучитьСвойство() — возвращает значение указанного свойства объекта JavaScript.
УстановитьСвойство() — присваивает значение указанному свойству объекта JavaScript.

Ниже показано использование данных методов на примере простого объекта JavaScript.

ВидЭлемента: КомпонентИнтерфейса
Ид: 340f7282-9b15-49b0-bf95-452ec06a4236
Имя: КонтейнерHtml1
ОбластьВидимости: ВПодсистеме
Наследует:
    Тип: КонтейнерHtml
    БезопасныйРежим: Ложь
    ПослеЗагрузкиСодержимого: КонтейнерHtmlПослеЗагрузкиСодержимого
    Содержимое: <html> <body> <script> var user = {firstName:"Иван", lastName:"Кузнецов", fullName() {return this.firstName + " " + this.lastName;}}; </script> </body> </html>

Обращение к переменным и методам объекта JavaScript во встроенном языке:

метод КонтейнерHtmlПослеЗагрузкиСодержимого(Источник: КонтейнерHtml, Событие: СобытиеКомпонента)
   пер Пользователь = Источник.ПолучитьПеременную("user")
   // Считывание значений свойств объекта JavaScript.
   пер Имя = (Пользователь как ОбъектJs).ПолучитьСвойство("firstName")
   пер Фамилия = (Пользователь как ОбъектJs).ПолучитьСвойство("lastName")
   // Вызов метода объекта JavaScript.
   // Переменной будет присвоено значение "Иван Кузнецов".
   пер ПолноеИмя = (Пользователь как ОбъектJs).ВызватьМетод("fullName")
;