官方文檔: http://kotlinlang.org/docs/reference/js-to-kotlin-interop.html
在JS平臺上, kotlin代碼會被Kotlin編譯器轉(zhuǎn)換成JavaScript類/函數(shù)/屬性;
因此在JavaScript代碼中可以自由地調(diào)用kotlin代碼, 然而還有一些細節(jié)需要注意!
1.獨立JavaScript對象隔離聲明(Isolating declarations in a separate JavaScript object)
為了防止損壞全局對象,Kotlin創(chuàng)建一個模塊(module)對象,它包含當前模塊中所有Kotlin聲明;
如果kotlin模塊名是myModule,那么在JavaScript中可通過myModule對象使用kotlin聲明:
// kotlin模塊名是myModule
fun foo() = "Hello"
// 在JavaScript中調(diào)用, myModule是kotlin模塊
alert(myModule.foo());
當Kotlin模塊(module)編譯為JavaScript模塊(module)時,不適用于上述情況!
在此情況下,Kotlin不會創(chuàng)建的模塊對象,而是將kotlin聲明作為相應(yīng)類型的JavaScript模塊,對外暴露:
// myModule是kotlin模塊,被編譯為JavaScript模塊
alert(require('myModule').foo());
2.包結(jié)構(gòu)(Package structure)
Kotlin將其包結(jié)構(gòu)暴露給JavaScript,
因此除非在根包中定義聲明, 否則必須在JavaScript中使用完整限定名,例如:
// kotlin
package my.qualified.packagename
fun foo() = "Hello"
// 在JavaScript中調(diào)用
alert(myModule.my.qualified.packagename.foo());
3.@JsName注解(@JsName annotation)
在某些情況下(如為了支持重載),Kotlin編譯器會修改生成的JavaScript的函數(shù)名/屬性名,
使用@JsName注解,控制生成JavaScript的函數(shù)名/屬性名,:
// kotlin模塊"kjs"
class Person(val name: String) {
fun hello() {
println("Hello $name!")
}
@JsName("helloWithGreeting")
fun hello(greeting: String) {
println("$greeting $name!")
}
}
// 在JavaScript中
var person = new kjs.Person("Dmitry"); // 引用模塊"kjs"
person.hello(); // 輸出"Hello Dmitry!"
person.helloWithGreeting("Servus"); // 輸出"Servus Dmitry!"
//如果沒有指定@JsName注解,相應(yīng)函數(shù)名會添加從函數(shù)簽名計算而來的后綴,例如hello_61zpoe$
注意: 1.Kotlin編譯器不會對external聲明使用@JsName注解修飾
2.繼承自external類的非external類,被覆蓋的函數(shù)也不會被@JsName修飾!
@JsName參數(shù)是一個字符串字面值常量(有效標識符),如果將非標識符字符串傳遞給@JsName,編譯器會報錯:
@JsName("new C()") // 報錯, new C()不是字符串字面值常量
external fun newC()
4.在JavaScript中表示Kotlin類型(Representing Kotlin types in JavaScript)
1.Kotlin數(shù)字類型(kotlin.Long除外)都映射到JavaScript Number
2.kotlin.Char映射到JavaScript Number,表示字符碼
3.Kotlin在運行時無法區(qū)分數(shù)字類型(kotlin.Long除外),即以下代碼能工作:
fun f() {
val x: Int = 23
val y: Any = x
println(y as Float)
}
4.Kotlin保留了kotlin.Int, kotlin.Byte, kotlin.Short, kotlin.Char, kotlin.Long的溢出語義
5.JavaScript沒有64位整型數(shù), 所以kotlin.Long沒有映射到任何JavaScript類型對象, 它由Kotlin類模擬
6.kotlin.String 映射到 JavaScript String
7.kotlin.Any 映射到 JavaScript Object (即new Object(), {}等)
8.kotlin.Array 映射到 JavaScript Array
9.Kotlin 集合(即List, Set, Map等)沒有映射到任何JavaScript類型
10.kotlin.Throwable 映射到 JavaScript Error
11.Kotlin 在JavaScript中保留了惰性對象初始化
12.Kotlin 在JavaScript中沒有實現(xiàn)頂層屬性的惰性初始化
簡書：http://www.reibang.com/p/a377d6284f1c
CSDN博客: http://blog.csdn.net/qq_32115439/article/details/75808450
GitHub博客: http://lioil.win/2017/07/22/Kotlin-kotlinInJS.html
Coding博客: http://c.lioil.win/2017/07/22/Kotlin-kotlinInJS.html
