浏览器和 DOM API
Kotlin/JS 标准库允许你使用 kotlinx.browser
包访问浏览器特定的功能,该包包含了典型的顶级对象,例如 document
和 window
。标准库尽可能为这些对象暴露的功能提供了类型安全包装器。作为备用方案,当某些函数无法很好地映射到 Kotlin 类型系统时,会使用 dynamic
类型来提供交互。
与 DOM 交互
要与文档对象模型 (DOM) 交互,可以使用 document
变量。例如,你可以通过此对象设置我们网站的背景颜色:
kotlin
document.bgColor = "FFAA12"
document
对象还提供了通过 ID、名称、类名、标签名等方式检索特定元素的方法。所有返回的元素类型均为 Element?
。要访问它们的属性,你需要将它们强制转换为适当的类型。例如,假设你有一个包含电子邮件 <input>
字段的 HTML 页面:
html
<body>
<input type="text" name="email" id="email"/>
<script type="text/javascript" src="tutorial.js"></script>
</body>
请注意,你的脚本包含在 body
标签的底部。这确保了 DOM 在脚本加载之前完全可用。
通过此设置,你可以访问 DOM 元素。要访问 input
字段的属性,请调用 getElementById
并将其强制转换为 HTMLInputElement
。然后,你可以安全地访问其属性,例如 value
:
kotlin
val email = document.getElementById("email") as HTMLInputElement
email.value = "[email protected]"
就像你引用此 input
元素一样,你可以访问页面上的其他元素,并将它们强制转换为适当的类型。
要了解如何以简洁的方式在 DOM 中创建和构建元素,请查看类型安全 HTML DSL。