[TOC]
# Vue3.0 前的 TypeScript 入门实践
## 前言
**其实`Vue`官方从`2.6.X`版本开始就部分使用`Ts`重写了。**
我个人对更严格类型限制没有积极的看法,毕竟各类转类型的骚写法写习惯了。
然鹅最近的一个项目中,是`TypeScript`+`Vue`,毛计喇,学之...…真香!
**注意此篇标题的“前”,本文旨在讲`Ts`混入框架的使用,不讲`Class API`**
![img](https://user-gold-cdn.xitu.io/2019/6/13/16b5094ed2a96828?imageView2/0/w/1280/h/960/format/webp/ignore-error/1)
## 1\. 使用官方脚手架构建
~~~
npm install -g @vue/cli
# OR
yarn global add @vue/cli
复制代码
~~~
新的`Vue CLI`工具允许开发者 使用`TypeScript`集成环境 创建新项目。
只需运行`vue create my-app`。
然后,命令行会要求选择预设。使用箭头键选择`Manually select features`。
接下来,只需确保选择了`TypeScript`和`Babel`选项,如下图:
![image-20190611163034679](https://user-gold-cdn.xitu.io/2019/6/12/16b47a57d82715e9?imageView2/0/w/1280/h/960/format/webp/ignore-error/1)
完成此操作后,它会询问你是否要使用`class-style component syntax`。
然后配置其余设置,使其看起来如下图所示。
![image-20190611163127181](https://user-gold-cdn.xitu.io/2019/6/12/16b47a57d83e1974?imageView2/0/w/1280/h/960/format/webp/ignore-error/1)
Vue CLI工具现在将安装所有依赖项并设置项目。
![image-20190611163225739](https://user-gold-cdn.xitu.io/2019/6/12/16b47a57dd7f8c66?imageView2/0/w/1280/h/960/format/webp/ignore-error/1)
接下来就跑项目喇。
![image-20190611163245714](https://user-gold-cdn.xitu.io/2019/6/12/16b47a57daeaf341?imageView2/0/w/1280/h/960/format/webp/ignore-error/1)
总之,先跑起来再说。
## 2\. 项目目录解析
通过`tree`指令查看目录结构后可发现其结构和正常构建的大有不同。
![image-20190611163812421](https://user-gold-cdn.xitu.io/2019/6/12/16b47a57e05c4d0f?imageView2/0/w/1280/h/960/format/webp/ignore-error/1)
这里主要关注`shims-tsx.d.ts`和`shims-vue.d.ts`两个文件
两句话概括:
* `shims-tsx.d.ts`,允许你以`.tsx`结尾的文件,在`Vue`项目中编写`jsx`代码
* `shims-vue.d.ts`主要用于`TypeScript`识别`.vue`文件,`Ts`默认并不支持导入`vue`文件,这个文件告诉`ts`导入`.vue`文件都按`VueConstructor<Vue>`处理。
此时我们打开亲切的`src/components/HelloWorld.vue`,将会发现写法已大有不同
~~~
<template>
<div class="hello">
<h1>{{ msg }}</h1>
<!-- 省略 -->
</div>
</template>
<script lang="ts">
import { Component, Prop, Vue } from 'vue-property-decorator';
@Component
export default class HelloWorld extends Vue {
@Prop() private msg!: string;
}
</script>
<!-- Add "scoped" attribute to limit CSS to this component only -->
<style scoped></style>
复制代码
~~~
至此,准备开启新的篇章`TypeScript`极速入门 和`vue-property-decorator`
## 3.`TypeScript`极速入门
### 3.1 基本类型和扩展类型
![image-20190611173126273](https://user-gold-cdn.xitu.io/2019/6/12/16b47a57de204bb4?imageView2/0/w/1280/h/960/format/webp/ignore-error/1)
`Typescript`与`Javascript`共享相同的基本类型,但有一些额外的类型。
* 元组`Tuple`
* 枚举`enum`
* `Any`与`Void`
#### 1\. 基本类型合集
~~~
// 数字,二、八、十六进制都支持
let decLiteral: number = 6;
let hexLiteral: number = 0xf00d;
// 字符串,单双引都行
let name: string = "bob";
let sentence: string = `Hello, my name is ${ name }.
// 数组,第二种方式是使用数组泛型,Array<元素类型>:
let list: number[] = [1, 2, 3];
let list: Array<number> = [1, 2, 3];
let u: undefined = undefined;
let n: null = null;
复制代码
~~~
#### 2\. 特殊类型
##### 1.**元组`Tuple`**
![image-20190611174157121](https://user-gold-cdn.xitu.io/2019/6/12/16b47a58028534c2?imageView2/0/w/1280/h/960/format/webp/ignore-error/1)
想象 元组 作为有组织的数组,你需要以正确的顺序预定义数据类型。
~~~
const messyArray = [' something', 2, true, undefined, null];
const tuple: [number, string, string] = [24, "Indrek" , "Lasn"]
复制代码
~~~
如果不遵循 为元组 预设排序的索引规则,那么`Typescript`会警告。
![image-20190611174515658](https://user-gold-cdn.xitu.io/2019/6/12/16b47a580a458319?imageView2/0/w/1280/h/960/format/webp/ignore-error/1)
(`tuple`第一项应为`number`类型)
##### 2\. 枚举`enum`
![image-20190611174833904](https://user-gold-cdn.xitu.io/2019/6/12/16b47a580c96180f?imageView2/0/w/1280/h/960/format/webp/ignore-error/1)
`enum`类型是对JavaScript标准数据类型的一个补充。 像C#等其它语言一样,使用枚举类型可以为一组数值赋予友好的名字。
~~~
// 默认情况从0开始为元素编号,也可手动为1开始
enum Color {Red = 1, Green = 2, Blue = 4}
let c: Color = Color.Green;
let colorName: string = Color[2];
console.log(colorName); // 输出'Green'因为上面代码里它的值是2
复制代码
~~~
另一个很好的例子是使用枚举来存储应用程序状态。
![image-20190611175542886](data:image/svg+xml;utf8,)
##### 3.`Void`
![image-20190611175724302](data:image/svg+xml;utf8,)
在`Typescript`中,**你必须在函数中定义返回类型**。像这样:
![image-20190611175858587](data:image/svg+xml;utf8,)
若没有返回值,则会报错:
![image-20190611175932713](data:image/svg+xml;utf8,)
我们可以将其返回值定义为`void`:
![image-20190611180043827](data:image/svg+xml;utf8,)
此时将无法`return`
##### 4.`Any`
![image-20190611180255381](data:image/svg+xml;utf8,)
Emmm...就是什么类型都行,当你无法确认在处理什么类型时可以用这个。
但要慎重使用,用多了就失去使用Ts的意义。
~~~
let person: any = "前端劝退师"
person = 25
person = true
复制代码
~~~
主要应用场景有:
1. 接入第三方库
2. Ts菜逼前期都用
##### 5.`Never`
![image-20190611180943940](data:image/svg+xml;utf8,)
用很粗浅的话来描述就是:"`Never`是你永远得不到的爸爸。"
具体的行为是:
* `throw new Error(message)`
* `return error("Something failed")`
* `while (true) {} // 存在无法达到的终点`
![image-20190611181410052](data:image/svg+xml;utf8,)
#### 3\. 类型断言
![image-20190611182337690](data:image/svg+xml;utf8,)
简略的定义是:可以用来手动指定一个值的类型。
有两种写法,尖括号和`as`:
~~~
let someValue: any = "this is a string";
let strLength: number = (<string>someValue).length;
let strLength: number = (someValue as string).length;
复制代码
~~~
使用例子有:
当 TypeScript 不确定一个联合类型的变量到底是哪个类型的时候,我们只能访问此联合类型的所有类型里共有的属性或方法:
~~~
function getLength(something: string | number): number {
return something.length;
}
// index.ts(2,22): error TS2339: Property 'length' does not exist on type 'string | number'.
// Property 'length' does not exist on type 'number'.
复制代码
~~~
如果你访问长度将会报错,而有时候,我们确实需要在还不确定类型的时候就访问其中一个类型的属性或方法,此时需要断言才不会报错:
~~~
function getLength(something: string | number): number {
if ((<string>something).length) {
return (<string>something).length;
} else {
return something.toString().length;
}
}
复制代码
~~~
### 3.2 泛型:`Generics`
软件工程的一个主要部分就是构建组件,构建的组件不仅需要具有明确的定义和统一的接口,同时也需要组件可复用。支持现有的数据类型和将来添加的数据类型的组件为大型软件系统的开发过程提供很好的灵活性。
在`C#`和`Java`中,可以使用"泛型"来创建可复用的组件,并且组件可支持多种数据类型。这样便可以让用户根据自己的数据类型来使用组件。
#### 1\. 泛型方法
在TypeScript里,**声明泛型方法**有以下两种方式:
~~~
function gen_func1<T>(arg: T): T {
return arg;
}
// 或者
let gen_func2: <T>(arg: T) => T = function (arg) {
return arg;
}
复制代码
~~~
**调用方式**也有两种:
~~~
gen_func1<string>('Hello world');
gen_func2('Hello world');
// 第二种调用方式可省略类型参数,因为编译器会根据传入参数来自动识别对应的类型。
复制代码
~~~
#### 2\. 泛型与`Any`
`Ts`的特殊类型`Any`在具体使用时,可以代替任意类型,咋一看两者好像没啥区别,其实不然:
~~~
// 方法一:带有any参数的方法
function any_func(arg: any): any {
console.log(arg.length);
return arg;
}
// 方法二:Array泛型方法
function array_func<T>(arg: Array<T>): Array<T> {
console.log(arg.length);
return arg;
}
复制代码
~~~
* 方法一,打印了`arg`参数的`length`属性。因为`any`可以代替任意类型,所以该方法在传入参数不是数组或者带有`length`属性对象时,会抛出异常。
* 方法二,定义了参数类型是`Array`的泛型类型,肯定会有`length`属性,所以不会抛出异常。
#### 3\. 泛型类型
泛型接口:
~~~
interface Generics_interface<T> {
(arg: T): T;
}
function func_demo<T>(arg: T): T {
return arg;
}
let func1: Generics_interface<number> = func_demo;
func1(123); // 正确类型的实际参数
func1('123'); // 错误类型的实际参数
复制代码
~~~
### 3.3 自定义类型:`Interface`vs`Type alias`
`Interface`,国内翻译成接口。
`Type alias`,类型别名。
![image-20190613192317416](data:image/svg+xml;utf8,)
以下内容来自:
> [Typescript 中的 interface 和 type 到底有什么区别](https://juejin.im/post/5c2723635188252d1d34dc7d#heading-11)
#### 1\. 相同点
**都可以用来描述一个对象或函数:**
~~~
interface User {
name: string
age: number
}
type User = {
name: string
age: number
};
interface SetUser {
(name: string, age: number): void;
}
type SetUser = (name: string, age: number): void;
复制代码
~~~
**都允许拓展(extends):**
`interface`和`type`都可以拓展,并且两者并不是相互独立的,也就是说`interface`可以`extends type`,`type`也可以`extends interface`。**虽然效果差不多,但是两者语法不同**。
**interface extends interface**
~~~
interface Name {
name: string;
}
interface User extends Name {
age: number;
}
复制代码
~~~
**type extends type**
~~~
type Name = {
name: string;
}
type User = Name & { age: number };
复制代码
~~~
**interface extends type**
~~~
type Name = {
name: string;
}
interface User extends Name {
age: number;
}
复制代码
~~~
**type extends interface**
~~~
interface Name {
name: string;
}
type User = Name & {
age: number;
}
复制代码
~~~
#### 2\. 不同点
**`type`可以而`interface`不行**
* `type`可以声明基本类型别名,联合类型,元组等类型
~~~
// 基本类型别名
type Name = string
// 联合类型
interface Dog {
wong();
}
interface Cat {
miao();
}
type Pet = Dog | Cat
// 具体定义数组每个位置的类型
type PetList = [Dog, Pet]
复制代码
~~~
* `type`语句中还可以使用`typeof`获取实例的 类型进行赋值
~~~
// 当你想获取一个变量的类型时,使用 typeof
let div = document.createElement('div');
type B = typeof div
复制代码
~~~
* 其他骚操作
~~~
type StringOrNumber = string | number;
type Text = string | { text: string };
type NameLookup = Dictionary<string, Person>;
type Callback<T> = (data: T) => void;
type Pair<T> = [T, T];
type Coordinates = Pair<number>;
type Tree<T> = T | { left: Tree<T>, right: Tree<T> };
复制代码
~~~
**`interface`可以而`type`不行**
`interface`能够声明合并
~~~
interface User {
name: string
age: number
}
interface User {
sex: string
}
/*
User 接口为 {
name: string
age: number
sex: string
}
*/
复制代码
~~~
`interface`有可选属性和只读属性
* 可选属性
接口里的属性不全都是必需的。 有些是只在某些条件下存在,或者根本不存在。 例如给函数传入的参数对象中只有部分属性赋值了。带有可选属性的接口与普通的接口定义差不多,只是在可选属性名字定义的后面加一个`?`符号。如下所示
~~~
interface Person {
name: string;
age?: number;
gender?: number;
}
复制代码
~~~
* 只读属性
顾名思义就是这个属性是不可写的,对象属性只能在对象刚刚创建的时候修改其值。 你可以在属性名前用`readonly`来指定只读属性,如下所示:
~~~
interface User {
readonly loginName: string;
password: string;
}
复制代码
~~~
上面的例子说明,当完成User对象的初始化后loginName就不可以修改了。
### 3.4 实现与继承:`implements`vs`extends`
`extends`很明显就是ES6里面的类继承,那么`implement`又是做什么的呢?它和`extends`有什么不同?
`implement`,实现。与C#或Java里接口的基本作用一样,`TypeScript`也能够用它来明确的强制一个类去符合某种契约
**implement基本用法**:
~~~
interface IDeveloper {
name: string;
age?: number;
}
// OK
class dev implements IDeveloper {
name = 'Alex';
age = 20;
}
// OK
class dev2 implements IDeveloper {
name = 'Alex';
}
// Error
class dev3 implements IDeveloper {
name = 'Alex';
age = '9';
}
复制代码
~~~
而`extends`是继承父类,两者其实可以混着用:
~~~
class A extends B implements C,D,E
复制代码
~~~
搭配`interface`和`type`的用法有:
![image-20190612003025759](data:image/svg+xml;utf8,)
### 3.5 声明文件与命名空间:`declare`和`namespace`
前面我们讲到Vue项目中的`shims-tsx.d.ts`和`shims-vue.d.ts`,其初始内容是这样的:
~~~
// shims-tsx.d.ts
import Vue, { VNode } from 'vue';
declare global {
namespace JSX {
// tslint:disable no-empty-interface
interface Element extends VNode {}
// tslint:disable no-empty-interface
interface ElementClass extends Vue {}
interface IntrinsicElements {
[elem: string]: any;
}
}
}
// shims-vue.d.ts
declare module '*.vue' {
import Vue from 'vue';
export default Vue;
}
复制代码
~~~
`declare`:当使用第三方库时,我们需要引用它的声明文件,才能获得对应的代码补全、接口提示等功能。
这里列举出几个常用的:
~~~
declare var 声明全局变量
declare function 声明全局方法
declare class 声明全局类
declare enum 声明全局枚举类型
declare global 扩展全局变量
declare module 扩展模块
复制代码
~~~
`namespace`:“内部模块”现在称做“命名空间”
`module X {`相当于现在推荐的写法`namespace X {`)
## 跟其他 JS 库协同
类似模块,同样也可以通过为其他 JS 库使用了命名空间的库创建`.d.ts`文件的声明文件,如为`D3`JS 库,可以创建这样的声明文件:
~~~
declare namespace D3{
export interface Selectors { ... }
}
declare var d3: D3.Base;
复制代码
~~~
所以上述两个文件:
* `shims-tsx.d.ts`, 在全局变量`global`中批量命名了数个内部模块。
* `shims-vue.d.ts`,意思是告诉`TypeScript``*.vue`后缀的文件可以交给`vue`模块来处理。
### 3.6 访问修饰符:`private`、`public`、`protected`
其实很好理解:
1. 默认为`public`
2. 当成员被标记为`private`时,它就不能在声明它的类的外部访问,比如:
~~~
class Animal {
private name: string;
constructor(theName: string) {
this.name = theName;
}
}
let a = new Animal('Cat').name; //错误,‘name’是私有的
复制代码
~~~
3. `protected`和`private`类似,但是,`protected`成员在派生类中可以访问
~~~
class Animal {
protected name: string;
constructor(theName: string) {
this.name = theName;
}
}
class Rhino extends Animal {
constructor() {
super('Rhino');
}
getName() {
console.log(this.name) //此处的name就是Animal类中的name
}
}
复制代码
~~~
### 3.7 可选参数 ( ?: )和非空断言操作符(!.)
**可选参数**
~~~
function buildName(firstName: string, lastName?: string) {
return firstName + ' ' + lastName
}
// 错误演示
buildName("firstName", "lastName", "lastName")
// 正确演示
buildName("firstName")
// 正确演示
buildName("firstName", "lastName")
复制代码
~~~
**非空断言操作符:**
能确定变量值一定不为空时使用。
与可选参数 不同的是,非空断言操作符不会防止出现 null 或 undefined。
~~~
let s = e!.name; // 断言e是非空并访问name属性
复制代码
~~~
## 4.`Vue`组件的`Ts`写法
从 vue2.5 之后,vue 对 ts 有更好的支持。根据[官方文档](https://vuejs.org/v2/guide/typescript.html),vue 结合 typescript ,有两种书写方式:
\*\*Vue.extend \*\*
~~~
import Vue from 'vue'
const Component = Vue.extend({
// type inference enabled
})
复制代码
~~~
**vue-class-component**
~~~
import { Component, Vue, Prop } from 'vue-property-decorator'
@Component
export default class Test extends Vue {
@Prop({ type: Object })
private test: { value: string }
}
复制代码
~~~
理想情况下,`Vue.extend`的书写方式,是学习成本最低的。在现有写法的基础上,几乎 0 成本的迁移。
但是`Vue.extend`模式,需要与`mixins`结合使用。在 mixin 中定义的方法,不会被 typescript 识别到
,这就意味着会出现**丢失代码提示、类型检查、编译报错等问题。**
菜鸟才做选择,大佬都挑最好的。直接讲第二种吧:
### 4.1`vue-class-component`
![image-20190613013846506](data:image/svg+xml;utf8,)
我们回到`src/components/HelloWorld.vue`
~~~
<template>
<div class="hello">
<h1>{{ msg }}</h1>
<!-- 省略 -->
</div>
</template>
<script lang="ts">
import { Component, Prop, Vue } from 'vue-property-decorator';
@Component
export default class HelloWorld extends Vue {
@Prop() private msg!: string;
}
</script>
<!-- Add "scoped" attribute to limit CSS to this component only -->
<style scoped></style>
复制代码
~~~
有写过`python`的同学应该会发现似曾相识:
* `vue-property-decorator`这个官方支持的库里,提供了函数 \*\*装饰器(修饰符)\*\*语法
#### 1\. 函数修饰符`@`
“@”,与其说是修饰函数倒不如说是引用、调用它修饰的函数。
或者用句大白话描述:`@`: "下面的被我包围了。"
举个栗子,下面的一段代码,里面两个函数,没有被调用,也会有输出结果:
~~~
test(f){
console.log("before ...");
f()
console.log("after ...");
}
@test
func(){
console.log("func was called");
}
复制代码
~~~
直接运行,输出结果:
~~~
before ...
func was called
after ...
复制代码
~~~
上面代码可以看出来:
* 只定义了两个函数:`test`和`func`,没有调用它们。
* 如果没有[“@test](mailto:%22@test)”,运行应该是没有任何输出的。
但是,解释器读到函数修饰符“@”的时候,后面步骤会是这样:
1. 去调用`test`函数,`test`函数的入口参数就是那个叫“`func`”的函数;
2. `test`函数被执行,入口参数的(也就是`func`函数)会被调用(执行);
换言之,修饰符带的那个函数的入口参数,就是下面的那个整个的函数。有点儿类似`JavaScrip`t里面的`function a (function () { ... });`
![ççç¥ç¥ï¼é¬¼é¬¼ç¥ç¥è¡¨æ
å
ï¼ä¸ç并ç¥ï¼ä¸ä¸ªçç©¿çå°è£åï¼é¬¼é¬¼ç¥ç¥è¡¨æ
å
.jpg](data:image/svg+xml;utf8,)
#### 2.`vue-property-decorator`和`vuex-class`提供的装饰器
`vue-property-decorator`的装饰器:
* [`@Prop`](https://github.com/kaorun343/vue-property-decorator#Prop)
* [`@PropSync`](https://github.com/kaorun343/vue-property-decorator#PropSync)
* [`@Provide`](https://github.com/kaorun343/vue-property-decorator#Provide)
* [`@Model`](https://github.com/kaorun343/vue-property-decorator#Model)
* [`@Watch`](https://github.com/kaorun343/vue-property-decorator#Watch)
* [`@Inject`](https://github.com/kaorun343/vue-property-decorator#Provide)
* [`@Provide`](https://github.com/kaorun343/vue-property-decorator#Provide)
* [`@Emit`](https://github.com/kaorun343/vue-property-decorator#Emit)
* `@Component`(**provided by**[vue-class-component](https://github.com/vuejs/vue-class-component))
* `Mixins`(the helper function named`mixins`**provided by**[vue-class-component](https://github.com/vuejs/vue-class-component))
`vuex-class`的装饰器:
* @State
* @Getter
* @Action
* @Mutation
我们拿原始Vue组件模版来看:
~~~
import {componentA,componentB} from '@/components';
export default {
components: { componentA, componentB},
props: {
propA: { type: Number },
propB: { default: 'default value' },
propC: { type: [String, Boolean] },
}
// 组件数据
data () {
return {
message: 'Hello'
}
},
// 计算属性
computed: {
reversedMessage () {
return this.message.split('').reverse().join('')
}
// Vuex数据
step() {
return this.$store.state.count
}
},
methods: {
changeMessage () {
this.message = "Good bye"
},
getName() {
let name = this.$store.getters['person/name']
return name
}
},
// 生命周期
created () { },
mounted () { },
updated () { },
destroyed () { }
}
复制代码
~~~
以上模版替换成修饰符写法则是:
~~~
import { Component, Vue, Prop } from 'vue-property-decorator';
import { State, Getter } from 'vuex-class';
import { count, name } from '@/person'
import { componentA, componentB } from '@/components';
@Component({
components:{ componentA, componentB},
})
export default class HelloWorld extends Vue{
@Prop(Number) readonly propA!: number | undefined
@Prop({ default: 'default value' }) readonly propB!: string
@Prop([String, Boolean]) readonly propC!: string | boolean | undefined
// 原data
message = 'Hello'
// 计算属性
private get reversedMessage (): string[] {
return this.message.split('').reverse().join('')
}
// Vuex 数据
@State((state: IRootState) => state . booking. currentStep) step!: number
@Getter( 'person/name') name!: name
// method
public changeMessage (): void {
this.message = 'Good bye'
},
public getName(): string {
let storeName = name
return storeName
}
// 生命周期
private created ():void { },
private mounted ():void { },
private updated ():void { },
private destroyed ():void { }
}
复制代码
~~~
正如你所看到的,我们在生命周期 列表那都添加`private XXXX`方法,因为这不应该公开给其他组件。
而不对`method`做私有约束的原因是,可能会用到`@Emit`来向父组件传递信息。
### 4.2 添加全局工具
引入全局模块,需要改`main.ts`:
~~~
import Vue from 'vue';
import App from './App.vue';
import router from './router';
import store from './store';
Vue.config.productionTip = false;
new Vue({
router,
store,
render: (h) => h(App),
}).$mount('#app');
复制代码
~~~
`npm i VueI18n`
~~~
import Vue from 'vue';
import App from './App.vue';
import router from './router';
import store from './store';
// 新模块
import i18n from './i18n';
Vue.config.productionTip = false;
new Vue({
router,
store,
i18n, // 新模块
render: (h) => h(App),
}).$mount('#app');
复制代码
~~~
但仅仅这样,还不够。你需要动`src/vue-shim.d.ts`:
~~~
// 声明全局方法
declare module 'vue/types/vue' {
interface Vue {
readonly $i18n: VueI18Next;
$t: TranslationFunction;
}
}
复制代码
~~~
之后使用`this.$i18n()`的话就不会报错了。
### 4.3 Axios 使用与封装
`Axios`的封装千人千面
如果只是想简单在Ts里体验使用`Axios`,可以安装`vue-axios`**简单使用`Axios`**
~~~
$ npm i axios vue-axios
复制代码
~~~
`main.ts`添加:
~~~
import Vue from 'vue'
import axios from 'axios'
import VueAxios from 'vue-axios'
Vue.use(VueAxios, axios)
复制代码
~~~
然后在组件内使用:
~~~
Vue.axios.get(api).then((response) => {
console.log(response.data)
})
this.axios.get(api).then((response) => {
console.log(response.data)
})
this.$http.get(api).then((response) => {
console.log(response.data)
})
复制代码
~~~
#### 1\. 新建文件`request.ts`
文件目录:
~~~
-api
- main.ts // 实际调用
-utils
- request.ts // 接口封装
复制代码
~~~
#### 2.`request.ts`文件解析
~~~
import * as axios from 'axios';
import store from '@/store';
// 这里可根据具体使用的UI组件库进行替换
import { Toast } from 'vant';
import { AxiosResponse, AxiosRequestConfig } from 'axios';
/* baseURL 按实际项目来定义 */
const baseURL = process.env.VUE_APP_URL;
/* 创建axios实例 */
const service = axios.default.create({
baseURL,
timeout: 0, // 请求超时时间
maxContentLength: 4000,
});
service.interceptors.request.use((config: AxiosRequestConfig) => {
return config;
}, (error: any) => {
Promise.reject(error);
});
service.interceptors.response.use(
(response: AxiosResponse) => {
if (response.status !== 200) {
Toast.fail('请求错误!');
} else {
return response.data;
}
},
(error: any) => {
return Promise.reject(error);
});
export default service;
复制代码
~~~
为了方便,我们还需要定义一套固定的 axios 返回的格式,新建`ajax.ts`:
~~~
export interface AjaxResponse {
code: number;
data: any;
message: string;
}
复制代码
~~~
#### 3.`main.ts`接口调用:
~~~
// api/main.ts
import request from '../utils/request';
// get
export function getSomeThings(params:any) {
return request({
url: '/api/getSomethings',
});
}
// post
export function postSomeThings(params:any) {
return request({
url: '/api/postSomethings',
methods: 'post',
data: params
});
}
复制代码
~~~
## 5\. 编写一个组件
为了减少时间,我们来替换掉`src/components/HelloWorld.vue`,做一个博客帖子组件:
~~~
<template>
<div class="blogpost">
<h2>{{ post.title }}</h2>
<p>{{ post.body }}</p>
<p class="meta">Written by {{ post.author }} on {{ date }}</p>
</div>
</template>
<script lang="ts">
import { Component, Prop, Vue } from 'vue-property-decorator';
// 在这里对数据进行类型约束
export interface Post {
title: string;
body: string;
author: string;
datePosted: Date;
}
@Component
export default class HelloWorld extends Vue {
@Prop() private post!: Post;
get date() {
return `${this.post.datePosted.getDate()}/${this.post.datePosted.getMonth()}/${this.post.datePosted.getFullYear()}`;
}
}
</script>
<style scoped>
h2 {
text-decoration: underline;
}
p.meta {
font-style: italic;
}
</style>
复制代码
~~~
然后在`Home.vue`中使用:
~~~
<template>
<div class="home">
<img alt="Vue logo" src="../assets/logo.png">
<HelloWorld v-for="blogPost in blogPosts" :post="blogPost" :key="blogPost.title" />
</div>
</template>
<script lang="ts">
import { Component, Vue } from 'vue-property-decorator';
import HelloWorld, { Post } from '@/components/HelloWorld.vue'; // @ is an alias to /src
@Component({
components: {
HelloWorld,
},
})
export default class Home extends Vue {
private blogPosts: Post[] = [
{
title: 'My first blogpost ever!',
body: 'Lorem ipsum dolor sit amet.',
author: 'Elke',
datePosted: new Date(2019, 1, 18),
},
{
title: 'Look I am blogging!',
body: 'Hurray for me, this is my second post!',
author: 'Elke',
datePosted: new Date(2019, 1, 19),
},
{
title: 'Another one?!',
body: 'Another one!',
author: 'Elke',
datePosted: new Date(2019, 1, 20),
},
];
}
</script>
复制代码
~~~
这时候运行项目:
![image-20190613191025585](data:image/svg+xml;utf8,)
这就是简单的父子组件
![ç«ç«ç¥ç¥.jpg](https://user-gold-cdn.xitu.io/2019/6/13/16b512f306db5c07?imageView2/0/w/1280/h/960/format/webp/ignore-error/1)
## 6\. 参考文章
[TypeScript — JavaScript with superpowers — Part II](https://medium.com/cleversonder/typescript-javascript-with-superpowers-part-ii-69a6bd2c6842)
[VUE WITH TYPESCRIPT](https://ordina-jworks.github.io/vue/2019/03/04/vue-with-typescript.html#6-your-first-deployment)
[TypeScript + 大型项目实战](https://juejin.im/post/5b54886ce51d45198f5c75d7#heading-6)
[Python修饰符 (一)—— 函数修饰符 “@”](https://blog.csdn.net/972301/article/details/59537712)
[Typescript 中的 interface 和 type到底有什么区别](https://juejin.im/post/5c2723635188252d1d34dc7d#heading-11)
## 7\. 总结
![](https://user-gold-cdn.xitu.io/2019/6/14/16b53e37a96b8d86?imageView2/0/w/1280/h/960/format/webp/ignore-error/1)
而关于`Class API`撤销,其实还是挺舒服的。 用`class`来编写`Vue`组件确实太奇怪了。 (所以我这篇`Ts`入门压根没写`Class API`)
![](https://user-gold-cdn.xitu.io/2019/6/14/16b53e5d5fd4daa2?imageView2/0/w/1280/h/960/format/webp/ignore-error/1)