vue項目中使用ts(typescript)入門教程
最近項目需要將原vue項目結合ts的使用進行改造,這個後面應該是中大型項目的發展趨勢,看到一篇不錯的入門教程,結合它並進行瞭一點拓展記錄之。本文從安裝到vue組件編寫進行瞭說明,適合入門。
1、引入Typescript
npm install vue-class-component vue-property-decorator --save npm install ts-loader typescript tslint tslint-loader tslint-config-standard --save-dev
vue-class-component
:擴展vue支持typescript,將原有的vue語法通過聲明的方式來支持ts
vue-property-decorator
:基於vue-class-component擴展更多裝飾器
ts-loader
:讓webpack能夠識別ts文件
tslint-loader
:tslint用來約束文件編碼
tslint-config-standard
: tslint 配置 standard風格的約束
2、配置文件webpack配置
根據項目的不同配置的地方不同,如果是vue cli 3.0創建的項目需要在vue.config.js中配置,如果是3.0以下版本的話,需要webpack.base.conf中配置。(以下說明是在webpack.base.conf文件中更改)
在resolve.extensions中增加.ts,目的是在代碼中引入ts文件不用寫.ts後綴
resolve: { extensions: ['.js', '.vue', '.json', '.ts'], alias: {} }
在module.rules中增加ts的rules
module: { rules: [ { test: /\.ts$/, exclude: /node_modules/, enforce: 'pre', loader: 'tslint-loader' }, { test: /\.tsx?$/, loader: 'ts-loader', exclude: /node_modules/, options: { appendTsSuffixTo: [/\.vue$/] } } ] }
tsconfig.json配置
ts-loader會檢索文件中的tsconfig.json.以其中的規則來解析ts文件,詳細的配置可以參考https://www.tslang.cn/docs/handbook/tsconfig-json.html
貼上測試項目tsconfig.json文件
{ // 編譯選項 "compilerOptions": { // 輸出目錄 "outDir": "./output", // 是否包含可以用於 debug 的 sourceMap "sourceMap": true, // 以嚴格模式解析 "strict": false, // 采用的模塊系統 "module": "esnext", // 如何處理模塊 "moduleResolution": "node", // 編譯輸出目標 ES 版本 "target": "es5", // 允許從沒有設置默認導出的模塊中默認導入 "allowSyntheticDefaultImports": true, // 將每個文件作為單獨的模塊 "isolatedModules": false, // 啟用裝飾器 "experimentalDecorators": true, // 啟用設計類型元數據(用於反射) "emitDecoratorMetadata": true, // 在表達式和聲明上有隱含的any類型時報錯 "noImplicitAny": false, // 不是函數的所有返回路徑都有返回值時報錯。 "noImplicitReturns": true, // 從 tslib 導入外部幫助庫: 比如__extends,__rest等 "importHelpers": true, // 編譯過程中打印文件名 "listFiles": true, // 移除註釋 "removeComments": true, "suppressImplicitAnyIndexErrors": true, // 允許編譯javascript文件 "allowJs": true, // 解析非相對模塊名的基準目錄 "baseUrl": "./", // 指定特殊模塊的路徑 "paths": { "jquery": [ "node_modules/jquery/dist/jquery" ] }, // 編譯過程中需要引入的庫文件的列表 "lib": [ "dom", "es2015", "es2015.promise" ] } }
tslint.json配置
在目錄中新增tslint.json文件,由於我們前面安裝瞭tslint-config-standard,所以可以直接用tslint-config-standard中規則,文件如下:
{ "extends": "tslint-config-standard", "globals": { "require": true } }
3、讓項目識別.ts
由於 TypeScript 默認並不支持 *.vue 後綴的文件,所以在 vue 項目中引入的時候需要創建一個 vue-shim.d.ts 文件,放在根目錄下
declare module '*.vue' { import Vue from 'vue'; export default Vue; }
4、vue組件的編寫
vue組件裡大多數的方法改成通過@xxx(裝飾器)來表明當前定義的為什麼數據,類似ng中的註入。而業務邏輯js的部分就可以直接采用ts的寫法瞭。
基本寫法
模板template
和樣式style
的寫法不變,script
的模塊進行瞭改變,基本寫法如下:
<script lang="ts"> import { Component, Vue } from "vue-property-decorator"; @Component export default class Test extends Vue { }; </script>
lang="ts"
:script
張聲明下當前的語言是ts
@Component
:註明此類為一個vue組件export default class Test extends Vue
: export當前組件類是繼承vue的
data()中定義數據
data中的數據由原來的data()
方法改成直接在對象中定義
export default class Test extends Vue { public message1: string = "heimayu"; public message2: string = "真好看"; }
props傳值
props的話就沒有data那麼舒服瞭,因為他需要使用裝飾器瞭,寫法如下
@Prop() propA:string @Prop() propB:number
$emit傳值
不帶參數
// 原來寫法:this.$emit('bindSend') // 現在直接寫 this.bindSend() // 多個定義 @Emit() bindSend():string{ return this.message }
方法帶參數
// 原來寫法:this.$emit('bindSend', msg) // 現在直接寫: this.bindSend(msg) // 多個下面的定義 @Emit() bindSend(msg:string){ // to do something }
emit帶參數
// 這裡的test是改變組件引用的@事件名稱這時候要寫@test 而不是@bindSend2 @Emit('test) private bindSend2(){ }
watch觀察數據
// 原來的寫法 watch:{} @Watch('propA',{ deep:true }) test(newValue:string,oldValue:string){ console.log('propA值改變瞭' + newValue); }
computed計算屬性
public get computedMsg(){ return '這裡是計算屬性' + this.message; } public set computedMsg(message:string){ }
完整代碼案例
<template> <div class="test-container"> {{message}} <input type="button" value="點擊觸發父級方法" @click="bindSend"/> <input type="button" value="點擊觸發父級方法" @click="handleSend"/> <input type="button" value="點擊觸發父級方法" @click="bindSend2"/> <!-- <Hello></Hello> --> </div> </template> <script lang="ts"> import { Component, Prop, Vue, Watch, Emit } from "vue-property-decorator"; import Hello from "./HelloWorld.vue"; // 註明此類為一個vue組件 @Component({ components: { Hello } }) export default class Test extends Vue { // 原有data中的數據在這裡展開編寫 public message: string = "asd"; //原有props中的數據展開編寫 @Prop({ type: Number, default: 1, required: false }) propA?: number @Prop() propB:string //原有computed public get computedMsg(){ return '這裡是計算屬性' + this.message; } public set computedMsg(message:string){ } //原有的watch屬性 @Watch('propA',{ deep:true }) public test(newValue:string,oldValue:string){ console.log('propA值改變瞭' + newValue); } // 以前需要給父級傳值的時候直接方法中使用emit就行瞭,當前需要通過emit來處理 @Emit() private bindSend():string{ return this.message } @Emit() private bindSend1(msg:string,love:string){ // 如果不處理可以不寫下面的,會自動將參數回傳 // msg += 'love'; // return msg; } //原有放在methods中的方法平鋪出來 public handleSend():void { this.bindSend1(this.message,'love'); } // 這裡的emit中的參數是表明父級通過什麼接受,類似以前的$emit('父級定義的方法') @Emit('test') private bindSend2(){ return '這個可以用test接受'; } } </script>
到此這篇關於vue項目中使用ts(typescript)入門教程 的文章就介紹到這瞭,更多相關vue typescript入門內容請搜索WalkonNet以前的文章或繼續瀏覽下面的相關文章希望大傢以後多多支持WalkonNet!
推薦閱讀:
- Vue-cli3中使用TS語法示例代碼
- 如何在Vue項目中應用TypeScript類
- vue中使用typescript配置步驟
- vue中使用ts配置的具體步驟
- 關於Vue新搭檔TypeScript快速入門實踐