Spec-Zone.ru › Kotlin 1.9

API браузера и DOM

Стандартная библиотека Kotlin/JS позволяет получить доступ к функциям браузера с помощью пакета kotlinx.browser, который включает в себя такие типичные объекты верхнего уровня, как document и window. Стандартная библиотека предоставляет безопасные оболочки для функций, экспонируемых этими объектами, где это возможно. В качестве резервного варианта используется тип dynamic, чтобы обеспечить взаимодействие с функциями, которые плохо отображаются в системе типов Kotlin.

Взаимодействие с DOM

Для взаимодействия с объектной моделью документа (DOM) вы можете использовать переменную document. Например, вы можете установить цвет фона нашего веб-сайта с помощью этого объекта:

document.bgColor = "FFAA12" 

Объект document также предоставляет способ извлечения определенного элемента по идентификатору, имени, имени класса, имени тега и так далее. Все возвращаемые элементы имеют тип Element?. Для доступа к их свойствам необходимо привести их к соответствующему типу. Например, предположим, что у вас есть страница HTML с полем ввода электронного адреса <input>:

<body>
    <input type="text" name="email" id="email"/>

    <script type="text/javascript" src="tutorial.js"></script>
</body>

Обратите внимание, что ваш скрипт включен внизу тега body. Это гарантирует, что DOM полностью доступен до загрузки скрипта.

С этим настройками вы можете получить доступ к элементам DOM. Для доступа к свойствам поля input вызовите getElementById и приведите его к типу HTMLInputElement. После этого вы можете безопасно получить доступ к его свойствам, таким как value:

val email = document.getElementById("email") as HTMLInputElement
email.value = "hadi@jetbrains.com"

Так же, как вы ссылаетесь на этот элемент input, вы можете получить доступ к другим элементам на странице, приведя их к соответствующим типам.

Чтобы узнать, как создавать и структурировать элементы в DOM простым способом, ознакомьтесь со статьей Typesafe HTML DSL.

Последнее изменение: 15 февраля 2021 г.
Миграция проектов Kotlin/JS на компилятор IR Использование JavaScript-кода из Kotlin

© 2010–2023 JetBrains s.r.o. and Kotlin Programming Language contributors
Licensed under the Apache License, Version 2.0.
https://kotlinlang.org/docs/browser-api-dom.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API