tmui-cli 2.0.2 → 2.0.4

package/data/uniappx/uts/loops.md

@@ -0,0 +1,236 @@
+## 循环
+
+### for@for
+
+一个 for 循环会一直重复执行，直到指定的循环条件为 false。 一个 for 语句是这个样子的：
+
+```ts
+for ([initialExpression]; [condition]; [incrementExpression]) {
+    statement;
+}
+```
+
+当一个 for 循环执行的时候，会发生以下过程：
+
+1. 如果有初始化表达式 initialExpression，它将被执行。这个表达式通常会初始化一个或多个循环计数器。
+2. 计算 condition 表达式的值。如果 condition 的值是 true，循环中的语句会被执行。如果 condition 的值是 false，for 循环终止。如果 condition 表达式整个都被省略掉了，3. condition 的值会被认为是 true。
+3. 循环中的 statement 被执行。如果需要执行多条语句，可以使用块（{ ... }）来包裹这些语句。
+4. 如果有更新表达式 incrementExpression，执行更新表达式。
+5. 回到步骤 2。
+
+举例：
+
+```ts
+for (let i = 0; i < 10; i++) {
+    //...
+}
+```
+
+部分对象，还支持forEach方法，可以更简单的遍历。详见：
+- [数组的forEach](buildin-object-api/array.md#foreach)
+- [set的forEach](buildin-object-api/set.md#foreach)
+
+- 注意：数组遍历不推荐使用 for in 语句，因为在 ts 中 for in 遍历的是数组的下标，而在 Swift 和 Kotlin 中遍历的是数组的元素，存在行为不一致。
+
+### for of@forof
+
+for...of 语句执行一个循环，该循环处理来自可迭代对象的值序列。可迭代对象包括内置对象的实例，例如 Array、String、Map、Set，还包括用户定义的[可迭代对象](iterable.md)
+
+```ts
+for (variable of iterable)
+  statement
+```
+
+for...of 循环按顺序逐个处理从可迭代对象获取的值。循环对值的每次操作被称为一次迭代，而循环本身被称为迭代可迭代对象。每次迭代都会执行可能引用当前序列值的语句。
+
+在 `HBuilderX 4.41` 之后，for..of `全端的执行效果与 web 标准一致`，下面列出具体的内置对象的支持情况：
+
+#### Set / Array
+
+类似Set/Array 这样的一维数据容器，会遍历内部属性值
+
+```typescript
+let u1 = new Set<any>()
+u1.add("111")
+u1.add("222")
+for (item of u1) {
+	console.log("item",item)
+}
+```
+
+执行结果
+
+```typescript
+> item 111
+> item 222
+```
+
+#### Map
+
+Map 的遍历会将其key,value 封装为一个新的Array 数组
+
+```typescript
+let u1 = new Map<string,any>()
+u1.put("aaa","111")
+u1.put("bbb","222")
+for (item of u1) {
+	console.log("item",item)
+}
+```
+
+执行结果
+
+```typescript
+> ‍[Array]‍ [ "aaa", "111" ]
+> [Array]‍ [ "bbb", "222" ]
+```
+
+#### string
+
+会遍历string 的每一个字符
+
+```typescript
+let a = "123456"
+for(item of a ){
+  console.log(item)
+}
+```
+
+执行结果
+
+```typescript
+> "1"
+> "2"
+> "3"
+> "4"
+> "5"
+> "6"
+```
+
+#### number / Date / RegExp / Error / UTSJSONObject / 自定义的type类型 / 自定义class
+
+不支持，编译报错
+
+```typescript
+For-loop range must have an 'iterator()' method‌
+```
+
+需要特别说明的是一般情况下  自定义的type类型 / 自定义class  如果直接使用 for of 会运行报错，但有些场景我们需要赋予自定义class 循环访问自身的能力，甚至要定制迭代访问的内容，实现方式[详见](iterable.md).
+
+### for in@forin
+
+UTS 语言目前并没有对 for..in 进行特殊处理，所以开发者在 UTS 中使用 for..in 语法时，会触发各个平台具体内置规则。可以运行，但执行效果与 web 存在一定的差异。
+为了保持与 web 行为的一致性，针对 Array/Set/Map 等集合类型以及 String 的遍历建议使用 for...of， 不建议使用 for...in。
+
+下面我们列出了UTS内置对象对for..in的支持情况
+
+|类型			|Web	|Android	|ios		|
+|:--			|:--	|:--		|:--		|
+|Array			|返回索引|返回数值	|返回数值	|
+|Set			|不可枚举|返回数值	|返回数值	|
+|Map			|不可枚举|返回键值对	|返回键值对	|
+|String			|返回索引|返回字符	|返回字符	|
+|自定义type		|返回属性名|返回属性名|返回属性名	|
+|UTSJSONObject	|返回属性名|返回属性名|返回属性名	|
+
+### while@while
+
+一个 while 语句只要指定的条件求值为真（true）就会一直执行它的语句块。一个 while 语句看起来像这样：
+
+```ts
+while (condition) {
+    statement;
+}
+```
+
+如果这个条件变为假，循环里的 statement 将会停止执行并把控制权交回给 while 语句后面的代码。
+
+条件检测会在每次 statement 执行之前发生。如果条件返回为真， statement 会被执行并紧接着再次测试条件。如果条件返回为假，执行将停止并把控制权交回给 while 后面的语句。
+
+要执行多条语句（语句块），要使用语句块 ({ ... }) 包括起来。
+
+举例：
+
+```ts
+let n = 0;
+let x = 0;
+while (n < 3) {
+    n++;
+    x += n;
+}
+```
+
+### do...while@dowhile
+
+do...while 语句一直重复直到指定的条件求值得到假值（false）。 一个 do...while 语句看起来像这样：
+
+```ts
+do {
+    statement;
+} while (condition);
+```
+
+statement 在检查条件之前会执行一次。要执行多条语句（语句块），要使用块语句（{ ... }）包括起来。 如果 condition 为真（true），statement 将再次执行。 在每个执行的结尾会进行条件的检查。当 condition 为假（false），执行会停止并且把控制权交回给 do...while 后面的语句。
+
+举例：
+
+```ts
+let i = 0;
+do {
+    i += 1;
+} while (i < 10);
+```
+
+### break@break
+
+使用 break 语句来终止循环。在for、do、while等各种循环中，以及在switch中，都可以使用break跳出循环或switch的选择。
+
+举例：
+
+```ts
+for (let i = 0; i < 10; i++) {
+    if (i > 5) {
+        console.log(i)
+        break;
+        // 如果这里有代码的话，也不会执行，因为break执行时已经跳出了for循环。
+    }
+}
+// break后，跳出for循环，开始向下执行这里的代码。
+
+// 输出 6
+
+// 下面的示例和上面是类似的。
+let x = 0;
+while (true) {
+    x++;
+    if (x > 5) {
+        break;
+    }
+}
+```
+
+### continue@continue
+
+使用 continue 语句来终止当前循环，但与 break 不同， continue 只是终止了这次循环，还会在下一次迭代时继续执行循环。continue 可以在for、do、while等各种循环中使用。
+
+举例：
+
+```ts
+for (let i = 0; i < 10; i++) {
+    if (i > 5) {
+        console.log(i)
+        continue; // continue 后，本次循环结束，i+1后开始下一次循环。
+        // 这里的代码不会被执行，因为上一行 continue 了
+    }
+}
+// 输出 6、7、8、9
+
+// 下面的示例和上面是类似的。
+let x = 0;
+while (true) {
+    x++;
+    if (x > 5) {
+        continue;
+    }
+}
+```

package/data/uniappx/uts/module.md

@@ -0,0 +1,92 @@
+# 模块
+
+uts 支持将程序拆分为可按需导入的单独模块，模块中可以导入和导出各种类型的变量，如函数，字符串，数字，布尔值，类等。
+
+## 导出
+
+export 语句可以将一个文件中的函数，类等导出。比如：
+
+```ts
+export const name: string = "square";
+export function draw() {}
+export default class Canvas {} // default 关键词支持默认导出
+```
+
+- 导出的函数声明与类声明必须要有名称。
+- export 命令可以出现在模块的任何位置，但必需处于模块顶层。
+- 在一个文件中，export、import 可以有多个，export default 仅有一个。
+- 通过 export 方式导出，在导入时要加{ }，export default 则不需要。
+
+## 导入
+
+import 语句可以将另一个文件中的函数，类等导入到当前文件。比如：
+
+```ts
+import { name as name1, draw } from "./canvas.uts" // 支持 as 语法做别名导入
+import * as Utils from "./utils.uts" // Utils 包含所有 export 的导出
+import Canvas from "./canvas.uts" // 对应 export default 的导出
+```
+
+示例
+
+```ts
+/*-----export [test.js]-----*/
+export const name = 'test'
+export function test(){
+    console.log('test')
+}
+export default class Test{
+    test(){
+        console.log('Test.test')
+    }
+}
+```
+
+```ts
+import { name } from './test.uts'
+import * as testModule from './test.uts'
+import Test from './test.uts'
+console.log(name)
+testModule.test()
+const test = new Test()
+test.test()
+```
+
+### 指定别名
+
+使用 `as` 关键字可以为导入的值指定别名
+
+```ts
+import { name as testName } from './test.uts'
+import * as testModule from './test.uts'
+```
+
+## 数据共享和复用
+
+可以使用 export 语句将变量或函数导出，以便其他模块可以访问和使用它们。导出的变量可以在模块内共享，并在其他模块中导入和复用。
+
+示例
+
+```ts
+/*-----export [global.uts]-----*/
+// 导出变量
+export let count = 1
+// 导出函数
+export function addCount() {
+    count++
+}
+```
+
+```ts
+// module1.uts
+import { count, addCount } from './global.uts'
+console.log(count) // 1
+addCount()
+console.log(count) // 2
+
+// module2.uts
+import { count, addCount } from './global.uts'
+console.log(count) // 2
+```
+
+- 如果只想在不同模块中复用变量而不共享其引用，可以使用函数包装变量来创建独立的作用域。

package/data/uniappx/uts/object.md

@@ -0,0 +1,155 @@
+# 对象类型（Object Types）
+
+UTS 语言支持使用对象字面量（Object Literal）声明类型，但不支持任意位置直接使用匿名对象类型，需要先为对象类型命名。
+
+## 定义类型
+
+使用 [type](./type-aliases.md) 关键字为对象类型命名，命名后可在其他位置使用此别名。
+
+支持的用法：
+
+```ts
+type Person = {
+    name: string
+    fn: () => void
+}
+ 
+function greet(person: Person) {
+    // ...
+}
+```
+
+未支持的用法：
+
+```ts
+function greet(person: { name: string, fn: () => void }) {
+    // ...
+}
+```
+
+## 实例化
+
+使用 [type](./type-aliases.md) 为对象类型命名实际上编译器会自动创建对应名称的 [Class](./class.md)，使用 `as` 关键字将对象字面量的值与类型相关联，编译器会自动创建对应类型的实例。
+
+正确的用法：
+
+```ts
+greet({ name: 'Tom', fn: function () { } } as Person)
+```
+
+类型不匹配：
+
+```ts
+greet({ name: 'Tom', fn: function () { } })
+```
+
+## 嵌套限制
+
+定义时对象字面量仅支持一层，嵌套多层的对象字面量需要手动分解为多个类型分别定义。
+
+支持的用法：
+
+```ts
+type PersonInfo = {
+    age: number
+}
+
+type Person = {
+    name: string
+    info: PersonInfo
+}
+```
+
+未支持的用法：
+
+```ts
+type Person = {
+    name: string
+    info: {
+        age: number
+    }
+}
+```
+
+ HBuilderX 3.9 版本之前实例化的时候也需要逐级绑定类型
+
+支持的用法：
+
+```ts
+const person = {
+    name: 'Tom',
+    info: {
+        age: 18
+    } as PersonInfo
+} as Person
+```
+
+HBuilderX 3.9 版本之前未支持的用法：
+
+```ts
+const person = {
+    name: 'Tom',
+    info: {
+        age: 18
+    }
+} as Person
+```
+
+## 顺序限制
+
+在函数作用域内定义时需要注意按顺序声明
+
+支持的写法：
+
+```ts
+function test() {
+    type PersonInfo = {
+        age: number
+    }
+
+    type Person = {
+        name: string
+        info: PersonInfo
+    }
+}
+```
+
+不支持的写法：
+
+```ts
+function test() {
+    type Person = {
+        name: string
+        info: PersonInfo
+    }
+
+    type PersonInfo = {
+        age: number
+    }
+}
+```
+
+## 匿名对象（Anonymous Object）@anonymous-object
+
+UTS 语言虽然不支持匿名对象类型声明，但是支持匿名的对象字面量作为值使用。匿名的对象字面量作为值使用时，编译器会自动将其初始化为 [UTSJSONObject](./buildin-object-api/utsjsonobject.md) 类型的实例。
+
+>  仅支持UTSJSONObject 或者 type 定义的类型
+
+```ts
+const person: UTSJSONObject = {
+    name: 'Tom',
+    fn: () => {
+      // ...
+    }
+}
+```
+
+```ts
+function printName(obj: UTSJSONObject) {
+    console.log(obj['name'])
+}
+
+printName({
+    name: 'Tom'
+})
+```