mirror of
https://github.com/adambard/learnxinyminutes-docs.git
synced 2024-12-25 08:13:29 +03:00
500 lines
14 KiB
Markdown
500 lines
14 KiB
Markdown
---
|
||
language: dart
|
||
lang: zh-cn
|
||
filename: learndart-cn.dart
|
||
contributors:
|
||
- ["Joao Pedrosa", "https://github.com/jpedrosa/"]
|
||
translators:
|
||
- ["Guokai Han", "https://github.com/hanguokai/"]
|
||
---
|
||
|
||
Dart 是编程语言王国的新人。
|
||
它借鉴了许多其他主流语言，并且不会偏离它的兄弟语言 JavaScript 太多。
|
||
就像 JavaScript 一样，Dart 的目标是提供良好的浏览器集成。
|
||
|
||
Dart 最有争议的特性必然是它的可选类型。
|
||
|
||
```javascript
|
||
import "dart:collection";
|
||
import "dart:math" as DM;
|
||
|
||
// 欢迎进入15分钟的 Dart 学习。 http://www.dartlang.org/
|
||
// 这是一个可实际执行的向导。你可以用 Dart 运行它
|
||
// 或者在线执行! 可以把代码复制/粘贴到这个网站。 http://try.dartlang.org/
|
||
|
||
// 函数声明和方法声明看起来一样。
|
||
// 函数声明可以嵌套。声明使用这种 name() {} 的形式，
|
||
// 或者 name() => 单行表达式; 的形式。
|
||
// 右箭头的声明形式会隐式地返回表达式的结果。
|
||
example1() {
|
||
example1nested1() {
|
||
example1nested2() => print("Example1 nested 1 nested 2");
|
||
example1nested2();
|
||
}
|
||
example1nested1();
|
||
}
|
||
|
||
// 匿名函数没有函数名。
|
||
example2() {
|
||
example2nested1(fn) {
|
||
fn();
|
||
}
|
||
example2nested1(() => print("Example2 nested 1"));
|
||
}
|
||
|
||
// 当声明函数类型的参数的时候，声明中可以包含
|
||
// 函数参数需要的参数，指定所需的参数名即可。
|
||
example3() {
|
||
example3nested1(fn(informSomething)) {
|
||
fn("Example3 nested 1");
|
||
}
|
||
example3planB(fn) { // 或者不声明函数参数的参数
|
||
fn("Example3 plan B");
|
||
}
|
||
example3nested1((s) => print(s));
|
||
example3planB((s) => print(s));
|
||
}
|
||
|
||
// 函数有可以访问到外层变量的闭包。
|
||
var example4Something = "Example4 nested 1";
|
||
example4() {
|
||
example4nested1(fn(informSomething)) {
|
||
fn(example4Something);
|
||
}
|
||
example4nested1((s) => print(s));
|
||
}
|
||
|
||
// 下面这个包含 sayIt 方法的类声明，同样有一个可以访问外层变量的闭包，
|
||
// 就像前面的函数一样。
|
||
var example5method = "Example5 sayIt";
|
||
class Example5Class {
|
||
sayIt() {
|
||
print(example5method);
|
||
}
|
||
}
|
||
example5() {
|
||
// 创建一个 Example5Class 类的匿名实例，
|
||
// 并调用它的 sayIt 方法。
|
||
new Example5Class().sayIt();
|
||
}
|
||
|
||
// 类的声明使用这种形式 class name { [classBody] }.
|
||
// classBody 中可以包含实例方法和变量，
|
||
// 还可以包含类方法和变量。
|
||
class Example6Class {
|
||
var example6InstanceVariable = "Example6 instance variable";
|
||
sayIt() {
|
||
print(example6InstanceVariable);
|
||
}
|
||
}
|
||
example6() {
|
||
new Example6Class().sayIt();
|
||
}
|
||
|
||
// 类方法和变量使用 static 关键词声明。
|
||
class Example7Class {
|
||
static var example7ClassVariable = "Example7 class variable";
|
||
static sayItFromClass() {
|
||
print(example7ClassVariable);
|
||
}
|
||
sayItFromInstance() {
|
||
print(example7ClassVariable);
|
||
}
|
||
}
|
||
example7() {
|
||
Example7Class.sayItFromClass();
|
||
new Example7Class().sayItFromInstance();
|
||
}
|
||
|
||
// 字面量非常方便，但是对于在函数/方法的外层的字面量有一个限制，
|
||
// 类的外层或外面的字面量必需是常量。
|
||
// 字符串和数字默认是常量。
|
||
// 但是 array 和 map 不是。他们需要用 "const" 声明为常量。
|
||
var example8A = const ["Example8 const array"],
|
||
example8M = const {"someKey": "Example8 const map"};
|
||
example8() {
|
||
print(example8A[0]);
|
||
print(example8M["someKey"]);
|
||
}
|
||
|
||
// Dart 中的循环使用标准的 for () {} 或 while () {} 的形式，
|
||
// 以及更加现代的 for (.. in ..) {} 的形式, 或者
|
||
// 以 forEach 开头并具有许多特性支持的函数回调的形式。
|
||
var example9A = const ["a", "b"];
|
||
example9() {
|
||
for (var i = 0; i < example9A.length; i++) {
|
||
print("Example9 for loop '${example9A[i]}'");
|
||
}
|
||
var i = 0;
|
||
while (i < example9A.length) {
|
||
print("Example9 while loop '${example9A[i]}'");
|
||
i++;
|
||
}
|
||
for (var e in example9A) {
|
||
print("Example9 for-in loop '${e}'");
|
||
}
|
||
example9A.forEach((e) => print("Example9 forEach loop '${e}'"));
|
||
}
|
||
|
||
// 遍历字符串中的每个字符或者提取其子串。
|
||
var example10S = "ab";
|
||
example10() {
|
||
for (var i = 0; i < example10S.length; i++) {
|
||
print("Example10 String character loop '${example10S[i]}'");
|
||
}
|
||
for (var i = 0; i < example10S.length; i++) {
|
||
print("Example10 substring loop '${example10S.substring(i, i + 1)}'");
|
||
}
|
||
}
|
||
|
||
// 支持两种数字格式 int 和 double 。
|
||
example11() {
|
||
var i = 1 + 320, d = 3.2 + 0.01;
|
||
print("Example11 int ${i}");
|
||
print("Example11 double ${d}");
|
||
}
|
||
|
||
// DateTime 提供了日期/时间的算法。
|
||
example12() {
|
||
var now = new DateTime.now();
|
||
print("Example12 now '${now}'");
|
||
now = now.add(new Duration(days: 1));
|
||
print("Example12 tomorrow '${now}'");
|
||
}
|
||
|
||
// 支持正则表达式。
|
||
example13() {
|
||
var s1 = "some string", s2 = "some", re = new RegExp("^s.+?g\$");
|
||
match(s) {
|
||
if (re.hasMatch(s)) {
|
||
print("Example13 regexp matches '${s}'");
|
||
} else {
|
||
print("Example13 regexp doesn't match '${s}'");
|
||
}
|
||
}
|
||
match(s1);
|
||
match(s2);
|
||
}
|
||
|
||
// 布尔表达式必需被解析为 true 或 false，
|
||
// 因为不支持隐式转换。
|
||
example14() {
|
||
var v = true;
|
||
if (v) {
|
||
print("Example14 value is true");
|
||
}
|
||
v = null;
|
||
try {
|
||
if (v) {
|
||
// 不会执行
|
||
} else {
|
||
// 不会执行
|
||
}
|
||
} catch (e) {
|
||
print("Example14 null value causes an exception: '${e}'");
|
||
}
|
||
}
|
||
|
||
// try/catch/finally 和 throw 语句用于异常处理。
|
||
// throw 语句可以使用任何对象作为参数。
|
||
example15() {
|
||
try {
|
||
try {
|
||
throw "Some unexpected error.";
|
||
} catch (e) {
|
||
print("Example15 an exception: '${e}'");
|
||
throw e; // Re-throw
|
||
}
|
||
} catch (e) {
|
||
print("Example15 catch exception being re-thrown: '${e}'");
|
||
} finally {
|
||
print("Example15 Still run finally");
|
||
}
|
||
}
|
||
|
||
// 要想有效地动态创建长字符串，
|
||
// 应该使用 StringBuffer。 或者 join 一个字符串的数组。
|
||
example16() {
|
||
var sb = new StringBuffer(), a = ["a", "b", "c", "d"], e;
|
||
for (e in a) { sb.write(e); }
|
||
print("Example16 dynamic string created with "
|
||
"StringBuffer '${sb.toString()}'");
|
||
print("Example16 join string array '${a.join()}'");
|
||
}
|
||
|
||
// 字符串连接只需让相邻的字符串字面量挨着，
|
||
// 不需要额外的操作符。
|
||
example17() {
|
||
print("Example17 "
|
||
"concatenate "
|
||
"strings "
|
||
"just like that");
|
||
}
|
||
|
||
// 字符串使用单引号或双引号做分隔符，二者并没有实际的差异。
|
||
// 这种灵活性可以很好地避免内容中需要转义分隔符的情况。
|
||
// 例如，字符串内容里的 HTML 属性使用了双引号。
|
||
example18() {
|
||
print('Example18 <a href="etc">'
|
||
"Don't can't I'm Etc"
|
||
'</a>');
|
||
}
|
||
|
||
// 用三个单引号或三个双引号表示的字符串
|
||
// 可以跨越多行，并且包含行分隔符。
|
||
example19() {
|
||
print('''Example19 <a href="etc">
|
||
Example19 Don't can't I'm Etc
|
||
Example19 </a>''');
|
||
}
|
||
|
||
// 字符串可以使用 $ 字符插入内容。
|
||
// 使用 $ { [expression] } 的形式，表达式的值会被插入到字符串中。
|
||
// $ 跟着一个变量名会插入变量的值。
|
||
// 如果要在字符串中插入 $ ，可以使用 \$ 的转义形式代替。
|
||
example20() {
|
||
var s1 = "'\${s}'", s2 = "'\$s'";
|
||
print("Example20 \$ interpolation ${s1} or $s2 works.");
|
||
}
|
||
|
||
// 可选类型允许作为 API 的标注，并且可以辅助 IDE，
|
||
// 这样 IDE 可以更好地提供重构、自动完成和错误检测功能。
|
||
// 目前为止我们还没有声明任何类型，并且程序运行地很好。
|
||
// 事实上，类型在运行时会被忽略。
|
||
// 类型甚至可以是错的，并且程序依然可以执行，
|
||
// 好像和类型完全无关一样。
|
||
// 有一个运行时参数可以让程序进入检查模式，它会在运行时检查类型错误。
|
||
// 这在开发时很有用，但是由于增加了额外的检查会使程序变慢，
|
||
// 因此应该避免在部署时使用。
|
||
class Example21 {
|
||
List<String> _names;
|
||
Example21() {
|
||
_names = ["a", "b"];
|
||
}
|
||
List<String> get names => _names;
|
||
set names(List<String> list) {
|
||
_names = list;
|
||
}
|
||
int get length => _names.length;
|
||
void add(String name) {
|
||
_names.add(name);
|
||
}
|
||
}
|
||
void example21() {
|
||
Example21 o = new Example21();
|
||
o.add("c");
|
||
print("Example21 names '${o.names}' and length '${o.length}'");
|
||
o.names = ["d", "e"];
|
||
print("Example21 names '${o.names}' and length '${o.length}'");
|
||
}
|
||
|
||
// 类的继承形式是 class name extends AnotherClassName {} 。
|
||
class Example22A {
|
||
var _name = "Some Name!";
|
||
get name => _name;
|
||
}
|
||
class Example22B extends Example22A {}
|
||
example22() {
|
||
var o = new Example22B();
|
||
print("Example22 class inheritance '${o.name}'");
|
||
}
|
||
|
||
// 类也可以使用 mixin 的形式 ：
|
||
// class name extends SomeClass with AnotherClassName {}.
|
||
// 必需继承某个类才能 mixin 另一个类。
|
||
// 当前 mixin 的模板类不能有构造函数。
|
||
// Mixin 主要是用来和辅助的类共享方法的，
|
||
// 这样单一继承就不会影响代码复用。
|
||
// Mixin 声明在类定义的 "with" 关键词后面。
|
||
class Example23A {}
|
||
class Example23Utils {
|
||
addTwo(n1, n2) {
|
||
return n1 + n2;
|
||
}
|
||
}
|
||
class Example23B extends Example23A with Example23Utils {
|
||
addThree(n1, n2, n3) {
|
||
return addTwo(n1, n2) + n3;
|
||
}
|
||
}
|
||
example23() {
|
||
var o = new Example23B(), r1 = o.addThree(1, 2, 3),
|
||
r2 = o.addTwo(1, 2);
|
||
print("Example23 addThree(1, 2, 3) results in '${r1}'");
|
||
print("Example23 addTwo(1, 2) results in '${r2}'");
|
||
}
|
||
|
||
// 类的构造函数名和类名相同，形式为
|
||
// SomeClass() : super() {}, 其中 ": super()" 的部分是可选的，
|
||
// 它用来传递参数给父类的构造函数。
|
||
class Example24A {
|
||
var _value;
|
||
Example24A({value: "someValue"}) {
|
||
_value = value;
|
||
}
|
||
get value => _value;
|
||
}
|
||
class Example24B extends Example24A {
|
||
Example24B({value: "someOtherValue"}) : super(value: value);
|
||
}
|
||
example24() {
|
||
var o1 = new Example24B(),
|
||
o2 = new Example24B(value: "evenMore");
|
||
print("Example24 calling super during constructor '${o1.value}'");
|
||
print("Example24 calling super during constructor '${o2.value}'");
|
||
}
|
||
|
||
// 对于简单的类，有一种设置构造函数参数的快捷方式。
|
||
// 只需要使用 this.parameterName 的前缀，
|
||
// 它就会把参数设置为同名的实例变量。
|
||
class Example25 {
|
||
var value, anotherValue;
|
||
Example25({this.value, this.anotherValue});
|
||
}
|
||
example25() {
|
||
var o = new Example25(value: "a", anotherValue: "b");
|
||
print("Example25 shortcut for constructor '${o.value}' and "
|
||
"'${o.anotherValue}'");
|
||
}
|
||
|
||
// 可以在大括号 {} 中声明命名参数。
|
||
// 大括号 {} 中声明的参数的顺序是随意的。
|
||
// 在中括号 [] 中声明的参数也是可选的。
|
||
example26() {
|
||
var _name, _surname, _email;
|
||
setConfig1({name, surname}) {
|
||
_name = name;
|
||
_surname = surname;
|
||
}
|
||
setConfig2(name, [surname, email]) {
|
||
_name = name;
|
||
_surname = surname;
|
||
_email = email;
|
||
}
|
||
setConfig1(surname: "Doe", name: "John");
|
||
print("Example26 name '${_name}', surname '${_surname}', "
|
||
"email '${_email}'");
|
||
setConfig2("Mary", "Jane");
|
||
print("Example26 name '${_name}', surname '${_surname}', "
|
||
"email '${_email}'");
|
||
}
|
||
|
||
// 使用 final 声明的变量只能被设置一次。
|
||
// 在类里面，final 实例变量可以通过常量的构造函数参数设置。
|
||
class Example27 {
|
||
final color1, color2;
|
||
// 更灵活一点的方法是在冒号 : 后面设置 final 实例变量。
|
||
Example27({this.color1, color2}) : color2 = color2;
|
||
}
|
||
example27() {
|
||
final color = "orange", o = new Example27(color1: "lilac", color2: "white");
|
||
print("Example27 color is '${color}'");
|
||
print("Example27 color is '${o.color1}' and '${o.color2}'");
|
||
}
|
||
|
||
// 要导入一个库，使用 import "libraryPath" 的形式，或者如果要导入的是
|
||
// 核心库使用 import "dart:libraryName" 。还有一个称为 "pub" 的包管理工具，
|
||
// 它使用 import "package:packageName" 的约定形式。
|
||
// 看下这个文件顶部的 import "dart:collection"; 语句。
|
||
// 导入语句必需在其它代码声明之前出现。IterableBase 来自于 dart:collection 。
|
||
class Example28 extends IterableBase {
|
||
var names;
|
||
Example28() {
|
||
names = ["a", "b"];
|
||
}
|
||
get iterator => names.iterator;
|
||
}
|
||
example28() {
|
||
var o = new Example28();
|
||
o.forEach((name) => print("Example28 '${name}'"));
|
||
}
|
||
|
||
// 对于控制流语句，我们有：
|
||
// * 必需带 break 的标准 switch 语句
|
||
// * if-else 和三元操作符 ..?..:..
|
||
// * 闭包和匿名函数
|
||
// * break, continue 和 return 语句
|
||
example29() {
|
||
var v = true ? 30 : 60;
|
||
switch (v) {
|
||
case 30:
|
||
print("Example29 switch statement");
|
||
break;
|
||
}
|
||
if (v < 30) {
|
||
} else if (v > 30) {
|
||
} else {
|
||
print("Example29 if-else statement");
|
||
}
|
||
callItForMe(fn()) {
|
||
return fn();
|
||
}
|
||
rand() {
|
||
v = new DM.Random().nextInt(50);
|
||
return v;
|
||
}
|
||
while (true) {
|
||
print("Example29 callItForMe(rand) '${callItForMe(rand)}'");
|
||
if (v != 30) {
|
||
break;
|
||
} else {
|
||
continue;
|
||
}
|
||
// 不会到这里。
|
||
}
|
||
}
|
||
|
||
// 解析 int，把 double 转成 int，或者使用 ~/ 操作符在除法计算时仅保留整数位。
|
||
// 让我们也来场猜数游戏吧。
|
||
example30() {
|
||
var gn, tooHigh = false,
|
||
n, n2 = (2.0).toInt(), top = int.parse("123") ~/ n2, bottom = 0;
|
||
top = top ~/ 6;
|
||
gn = new DM.Random().nextInt(top + 1); // +1 because nextInt top is exclusive
|
||
print("Example30 Guess a number between 0 and ${top}");
|
||
guessNumber(i) {
|
||
if (n == gn) {
|
||
print("Example30 Guessed right! The number is ${gn}");
|
||
} else {
|
||
tooHigh = n > gn;
|
||
print("Example30 Number ${n} is too "
|
||
"${tooHigh ? 'high' : 'low'}. Try again");
|
||
}
|
||
return n == gn;
|
||
}
|
||
n = (top - bottom) ~/ 2;
|
||
while (!guessNumber(n)) {
|
||
if (tooHigh) {
|
||
top = n - 1;
|
||
} else {
|
||
bottom = n + 1;
|
||
}
|
||
n = bottom + ((top - bottom) ~/ 2);
|
||
}
|
||
}
|
||
|
||
// 程序的唯一入口点是 main 函数。
|
||
// 在程序开始执行 main 函数之前，不期望执行任何外层代码。
|
||
// 这样可以帮助程序更快地加载，甚至仅惰性加载程序启动时需要的部分。
|
||
main() {
|
||
print("Learn Dart in 15 minutes!");
|
||
[example1, example2, example3, example4, example5, example6, example7,
|
||
example8, example9, example10, example11, example12, example13, example14,
|
||
example15, example16, example17, example18, example19, example20,
|
||
example21, example22, example23, example24, example25, example26,
|
||
example27, example28, example29, example30
|
||
].forEach((ef) => ef());
|
||
}
|
||
|
||
```
|
||
|
||
## 延伸阅读
|
||
|
||
Dart 有一个综合性网站。它涵盖了 API 参考、入门向导、文章以及更多，
|
||
还包括一个有用的在线试用 Dart 页面。
|
||
http://www.dartlang.org/
|
||
http://try.dartlang.org/
|
||
|
||
|
||
|