Skip to content

Commit c034274

Browse files
committed
New tutorial: TypeScript in 5 minutes. zhongsp#173
1 parent 516dff1 commit c034274

4 files changed

Lines changed: 175 additions & 0 deletions

File tree

README.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -13,6 +13,7 @@ TypeScript是JavaScript的超集并且能够编译输出为纯粹的JavaScript.
1313
## 目录
1414

1515
* [快速上手](./doc/handbook/tutorials/README.md)
16+
* [5分钟了解TypeScript](./doc/handbook/tutorials/TypeScript%20in%205%20minutes.html)
1617
* [ASP.NET Core](./doc/handbook/tutorials/ASP.NET%20Core.md)
1718
* [ASP.NET 4](./doc/handbook/tutorials/ASP.NET%204.md)
1819
* [Gulp](./doc/handbook/tutorials/Gulp.md)

SUMMARY.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,7 @@
11
# Summary
22

33
* [快速上手](./doc/handbook/tutorials/README.md)
4+
* [5分钟了解TypeScript](./doc/handbook/tutorials/TypeScript in 5 minutes.md)
45
* [ASP.NET Core](./doc/handbook/tutorials/ASP.NET Core.md)
56
* [ASP.NET 4](./doc/handbook/tutorials/ASP.NET 4.md)
67
* [Gulp](./doc/handbook/tutorials/Gulp.md)
Lines changed: 171 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,171 @@
1+
让我们使用TypeScript来创建一个简单的Web应用。
2+
3+
## 安装TypeScript
4+
5+
有两种主要的方式来获取TypeScript工具:
6+
7+
* 通过npm(Node.js包管理器)
8+
* 安装Visual Studior的TypeScript插件
9+
10+
Visual Studio 2017和Visual Studio 2015 Update 3默认包含了TypeScript。
11+
如果你的Visual Studio还没有安装TypeScript,你可以[下载](/#download-links)它。
12+
13+
针对使用npm的用户:
14+
15+
```shell
16+
> npm install -g typescript
17+
```
18+
19+
## 构建你的第一个TypeScript文件
20+
21+
在编辑器,将下面的代码输入到`greeter.ts`文件里:
22+
23+
```ts
24+
function greeter(person) {
25+
return "Hello, " + person;
26+
}
27+
28+
var user = "Jane User";
29+
30+
document.body.innerHTML = greeter(user);
31+
```
32+
33+
## 编译代码
34+
35+
我们使用了`.ts`扩展名,但是这段代码仅仅是JavaScript而已。
36+
你可以直接从现有的JavaScript应用里复制/粘贴这段代码。
37+
38+
在命令行上,运行TypeScript编译器:
39+
40+
```shell
41+
tsc greeter.ts
42+
```
43+
44+
输出结果为一个`greeter.js`文件,它包含了和输入文件中相同的JavsScript代码。
45+
一切准备就绪,我们可以运行这个使用TypeScript写的JavaScript应用了!
46+
47+
接下来让我们看看TypeScript工具带来的高级功能。
48+
`person`函数的参数添加`: string`类型注解,如下:
49+
50+
```ts
51+
function greeter(person: string) {
52+
return "Hello, " + person;
53+
}
54+
55+
var user = "Jane User";
56+
57+
document.body.innerHTML = greeter(user);
58+
```
59+
60+
## 类型注解
61+
62+
TypeScript里的类型注解是一种轻量级的为函数或变量添加约束的方式。
63+
在这个例子里,我们希望`greeter`函数接收一个字符串参数。
64+
然后尝试把`greeter`的调用改成传入一个数组:
65+
66+
```ts
67+
function greeter(person: string) {
68+
return "Hello, " + person;
69+
}
70+
71+
var user = [0, 1, 2];
72+
73+
document.body.innerHTML = greeter(user);
74+
```
75+
76+
重新编译,你会看到产生了一个错误。
77+
78+
```shell
79+
greeter.ts(7,26): error TS2345: Argument of type 'number[]' is not assignable to parameter of type 'string'.
80+
```
81+
82+
类似地,尝试删除`greeter`调用的所有参数。
83+
TypeScript会告诉你使用了非期望个数的参数调用了这个函数。
84+
在这两种情况中,TypeScript提供了静态的代码分析,它可以分析代码结构和提供的类型注解。
85+
86+
要注意的是尽管有错误,`greeter.js`文件还是被创建了。
87+
就算你的代码里有错误,你仍然可以使用TypeScript。但在这种情况下,TypeScript会警告你代码可能不会按预期执行。
88+
89+
## 接口
90+
91+
让我们开发这个示例应用。这里我们使用接口来描述一个拥有`firstName``lastName`字段的对象。
92+
在TypeScript里,只在两个类型内部的结构兼容那么这两个类型就是兼容的。
93+
这就允许我们在实现接口时候只要保证包含了接口要求的结构就可以,而不必明确地使用`implements`语句。
94+
95+
```ts
96+
interface Person {
97+
firstName: string;
98+
lastName: string;
99+
}
100+
101+
function greeter(person: Person) {
102+
return "Hello, " + person.firstName + " " + person.lastName;
103+
}
104+
105+
var user = { firstName: "Jane", lastName: "User" };
106+
107+
document.body.innerHTML = greeter(user);
108+
```
109+
110+
##
111+
112+
最后,让我们使用类来改写这个例子。
113+
TypeScript支持JavaScript的新特性,比如支持基于类的面向对象编程。
114+
115+
让我们创建一个`Student`类,它带有一个构造函数和一些公共字段。
116+
注意类和接口可以一起共作,程序员可以自行决定抽象的级别。
117+
118+
还要注意的是,在构造函数的参数上使用`public`等同于创建了同名的成员变量。
119+
120+
```ts
121+
class Student {
122+
fullName: string;
123+
constructor(public firstName, public middleInitial, public lastName) {
124+
this.fullName = firstName + " " + middleInitial + " " + lastName;
125+
}
126+
}
127+
128+
interface Person {
129+
firstName: string;
130+
lastName: string;
131+
}
132+
133+
function greeter(person : Person) {
134+
return "Hello, " + person.firstName + " " + person.lastName;
135+
}
136+
137+
var user = new Student("Jane", "M.", "User");
138+
139+
document.body.innerHTML = greeter(user);
140+
```
141+
142+
重新运行`tsc greeter.ts`,你会看到生成的JavaScript代码和原先的一样。
143+
TypeScript里的类只是JavaScript里常用的基于原型面向对象编程的简写。
144+
145+
## 运行TypeScript Web应用
146+
147+
`greeter.html`里输入如下内容:
148+
149+
```html
150+
<!DOCTYPE html>
151+
<html>
152+
<head><title>TypeScript Greeter</title></head>
153+
<body>
154+
<script src="greeter.js"></script>
155+
</body>
156+
</html>
157+
```
158+
159+
在浏览器里打开`greeter.html`运行这个应用!
160+
161+
可选地:在Visual Studio里打开`greeter.ts`或者把代码复制到TypeScript playground。
162+
将鼠标悬停在标识符上查看它们的类型。
163+
注意在某些情况下它们的类型可以被自动地推断出来。
164+
重新输入一下最后一行代码,看一下自动补全列表和参数列表,它们会根据DOM元素类型而变化。
165+
将光标放在`greeter`函数上,点击F12可以跟踪到它的定义。
166+
还有一点,你可以右键点击标识,使用重构功能来重命名。
167+
168+
这些类型信息以及工具可以很好的和JavaScript一起工作。
169+
更多的TypeScript功能演示,请查看本网站的示例部分。
170+
171+
<!--![Visual Studio picture](/assets/images/docs/greet_person.png)-->

preface.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -23,6 +23,7 @@ TypeScript目前还在积极的开发完善之中,不断地会有新的特性
2323
## 目录
2424

2525
* [快速上手](./doc/handbook/tutorials/README.html)
26+
* [5分钟了解TypeScript](./doc/handbook/tutorials/TypeScript in 5 minutes.html)
2627
* [ASP.NET Core](./doc/handbook/tutorials/ASP.NET Core.html)
2728
* [ASP.NET 4](./doc/handbook/tutorials/ASP.NET 4.html)
2829
* [Gulp](./doc/handbook/tutorials/Gulp.html)
@@ -100,6 +101,7 @@ TypeScript目前还在积极的开发完善之中,不断地会有新的特性
100101

101102
## 主要修改 (Latest 5 updates)
102103

104+
* 2017-05-16 新增章节:[教程-5分钟了解TypeScript](./doc/handbook/tutorials/TypeScript in 5 minutes.html)
103105
* 2017-05-01 新增章节:[教程-React](./doc/handbook/tutorials/React.html)
104106
* 2016-11-27 新增章节:[使用`/// <reference types="..." />`](./doc/handbook/Triple-Slash Directives.html)
105107
* 2016-11-23 新增章节:[变量声明 - 展开操作符](./doc/handbook/Variable Declarations.html)

0 commit comments

Comments
 (0)