JavaScript-среда хоста

QML предоставляет JavaScript-среду хоста, оптимизированную для написания приложений QML. Эта среда отличается от среды хоста, предоставляемой браузером или серверной JavaScript-средой, такой как Node.js. Например, QML не предоставляет объект window или DOM API, как это обычно встречается в среде браузера.

Общие основы

Как браузерная, так и серверная JavaScript-среда, среда выполнения QML реализует стандарт Спецификации языка ECMAScript. Это обеспечивает доступ ко всем встроенным типам и функциям, определённым стандартом, таким как Object, Array и Math. Среда выполнения QML реализует 7-ю редакцию стандарта.

В документации QML встроенные объекты стандарта ECMAScript не документируются явно. Для получения дополнительной информации об их использовании, пожалуйста, обратитесь к стандарту ECMA-262 7-го издания или к одному из многочисленных онлайн-справочников и обучающих ресурсов по JavaScript, таких как Справочник по JavaScript от W3Schools (раздел "Справочник по JavaScript-объектам"). Многие сайты фокусируются на JavaScript в браузере, поэтому в некоторых случаях вам может потребоваться проверить спецификацию, чтобы определить, является ли та или иная функция или объект частью стандартного ECMAScript или специфична для среды браузера. В случае ссылки на W3Schools выше, раздел JavaScript Objects Reference обычно охватывает стандарт, в то время как разделы Browser Objects Reference и HTML DOM Objects Reference специфичны для браузера (и, следовательно, неприменимы к QML).

Глобальный объект QML

JavaScript-среда хоста QML реализует ряд объектов и функций хоста, как подробно описано в документации Глобальный объект QML.

Эти объекты и функции хоста всегда доступны, независимо от того, были ли импортированы какие-либо модули.

JavaScript-объекты и функции

Список JavaScript-объектов, функций и свойств, поддерживаемых движком QML, можно найти в списке JavaScript-объектов и функций.

Обратите внимание, что QML вносит следующие изменения в родные объекты:

• Функция arg() добавлена к прототипу String.
• Функции преобразования с учётом локали добавлены к прототипам Date и Number.

Кроме того, QML расширяет поведение функции instanceof, чтобы разрешить проверку типов по отношению к типам QML. Это означает, что вы можете использовать её для проверки того, что переменная действительно является ожидаемым типом, например:

var v = something();
if (!v instanceof Item) {
    throw new TypeError("I need an Item type!");
}

...

Ограничения среды JavaScript

QML реализует следующие ограничения для JavaScript-кода:

• JavaScript-код, написанный в файле .qml , не может изменять глобальный объект. JavaScript-код в файле .js может изменять глобальный объект, и эти изменения будут видны в файле .qml при импорте.

  В QML глобальный объект является постоянным — существующие свойства не могут быть изменены или удалены, и новые свойства не могут быть созданы.

  Большинство JavaScript-программ не намеренно изменяют глобальный объект. Однако автоматическое создание не объявленных переменных JavaScript является неявным изменением глобального объекта и запрещено в QML.

  Предполагая, что переменная a не существует в цепочке области видимости, следующий код является незаконным в QML:

  // Illegal modification of undeclared variable
  a = 1;
  for (var ii = 1; ii < 10; ++ii)
      a = a * ii;
  console.log("Result: " + a);

  Он может быть тривиально изменён на этот допустимый код.

  var a = 1;
  for (var ii = 1; ii < 10; ++ii)
      a = a * ii;
  console.log("Result: " + a);

  Любая попытка изменить глобальный объект — явным или неявным образом — вызовет исключение. Если оно не перехвачено, это приведёт к отображению предупреждения, содержащего имя файла и номер строки нарушающего код.

• Глобальный код выполняется в сокращённой области видимости.

  При запуске, если файл QML включает внешний JavaScript-файл с кодом "global", он выполняется в области видимости, которая содержит только сам внешний файл и глобальный объект. То есть, он не будет иметь доступа к QML-объектам и свойствам, которые обычно имелись бы.

  Допускается глобальный код, который обращается только к локальным переменным скрипта. Это пример допустимого глобального кода.

  var colors = [ "red", "blue", "green", "orange", "purple" ];

  Глобальный код, который обращается к QML-объектам, не будет работать правильно.

  // Invalid global code - the "rootObject" variable is undefined
  var initialPosition = { rootObject.x, rootObject.y }

  Это ограничение существует, поскольку QML-среда ещё не полностью установлена. Чтобы запустить код после завершения настройки среды, обратитесь к JavaScript в коде запуска приложения.

• Значение this в QML в большинстве контекстов не определено.

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

  Чтобы обратиться к конкретному объекту, укажите id. Например:

  Item {
      width: 200; height: 100
      function mouseAreaClicked(area) {
          console.log("Clicked in area at: " + area.x + ", " + area.y);
      }
      // This will pass area to the function
      MouseArea {
          id: area
          y: 50; height: 50; width: 200
          onClicked: mouseAreaClicked(area)
      }
  }

См. также Область видимости и разрешение имён.