Angular 如何使用第三方库的方法


Posted in Javascript onApril 18, 2018

Angular 的组件与模块看似好像与现有各种第三方类库(例如:lodash、moment 等)使用上有点格格不入,这很大的原因是 TypeScript 造成的假象。三足鼎立的前端其实都是雷同的,不管是哪种前端框架都可以使用到这些第三方类库。

以下我将从另一个视角解释 Angular 如何使用第三方类库的一种经验做法。

一、写在前面

在开始之前,需要先了解一下 TypeScript 模块系统 ——模块是指在其自身作用域里执行,而不是在全局作用域里;模块间是依靠 export 和 import 建立关系。编译器在编译过程中,也是依赖这种关系来定位需要编译的文件。

TypeScript 依然还是以 JavaScript 文件的形式发布类库,这会导致类型无法表述,需要配合声明文件对其进行类型描述;因此声明文件成了类库一个必不可少的组成部分。

二、分类

Angular 使用 TypeScript 语言开发,诚如上一小节讲来说,要想让一个类库被运用,要件是有没有声明文件。

有声明文件

要分清类库是否有声明文件 *.d.ts,可以从两个方面来确认这件事:

1、类库自带

从 Npm 安装一个依赖包后,可以直接检查其库的 package.json 是否包含 typings 节点,例如 moment:

"typings": "./moment.d.ts"

2、TypeSearch检索

TypeScript 提供了一个叫 TypeSearch 网站,可以直接输入关键词检查是否包含该类库的声明文件。

例如 lodash 可以在列表中点击会跳转至 npm 网站,并且会看到这样的一个命令:

npm install --save @types/lodash

无声明文件

这类情况还蛮常见,例如早一点时间 G2 就没有声明文件,这种情况下只能自行编写声明文件。

Angular Cli 创建的项目会包含一个 src/typings.d.ts 声明文件,它会自动包含在全局声明定义中,而把这些类库的声明信息写在这里面再好不过。

一般而言自己很难对一个类库写一个完整的声明文件,这对于成本来说太不合算,因此往往都是只对部分全局对象做一个 any (表示忽略该静态类型检查)亦可,例如:

// src/typings.d.ts
declare var G2: any;

三、如何使用?

声明文件是纽带,依然以这种方式来划分如何使用。

对于有声明文件,无需额外做什么,只需在需要模块的地方使用 import 来导入即可,例如:

import * as moment from 'moment';

moment(); // 当前时间

无声明文件

重要来看无声明文件时怎么做,前面说到使用 any 来表示忽略静态类型检查,意味者无法享受声明文件带来的智能提示快感。

像 G2 ,我们可以在项目的任意位置直接使用它,但也仅仅只能识别 G2 变量,而实例的方法或属性是不可知的。

// app.component.ts

const g2 = new G2();
g2. // 输入 `.` 后是不会有任何方法或属性

除此之外 TypeScript 编译过程中也不会对 G2 做任何类型检查,G2 是否真的存在只能由自己把握。对于 Angular 而言,是需要额外在 .angular-cli.json 的 scripts 节点上明确加载这些模块。

// .angular-cli.json
"scripts": [
  "../node_modules/@antv/g2/dist/g2.min.js"
]

TypeScript 编译后依然还是 JavaScript 代码,假如不手动加载 G2 相关 JavaScript 文件,自然在运行过程中会提供未找到 G2 的错误。

总结

从 TypeScript 的视角来看如何使用第三方类库,会有不同的感觉,只是一个简单的非靠谱但有效的描述。希望懂得多的人手下留情。

这里无意黑 G2 的意思,现 G2 已经提供了声明文件了。

以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持三水点靠木。

Javascript 相关文章推荐
jQuery源码分析-05异步队列 Deferred 使用介绍
Nov 14 Javascript
jQuery隔行变色与普通JS写法的对比
Apr 21 Javascript
jQuery简单实现banner图片切换
Jan 02 Javascript
EasyUi datagrid 实现表格分页
Feb 10 Javascript
javascript常用正则表达式汇总
Jul 31 Javascript
一种新的javascript对象创建方式Object.create()
Dec 28 Javascript
JS组件系列之Bootstrap table表格组件神器【二、父子表和行列调序】
May 10 Javascript
在JS中a标签加入单击事件屏蔽href跳转页面
Dec 16 Javascript
ES6新数据结构Set与WeakSet用法分析
Mar 31 Javascript
js+html5实现复制文字按钮
Jul 15 Javascript
ES6知识点整理之对象解构赋值应用示例
Apr 17 Javascript
webpack自动打包和热更新的实现方法
Jun 24 Javascript
jQuery实现的淡入淡出与滑入滑出效果示例
Apr 18 #jQuery
浅谈mvvm-simple双向绑定简单实现
Apr 18 #Javascript
JS点击动态添加标签、删除指定标签的代码
Apr 18 #Javascript
jQuery实现的手动拖动控制进度条效果示例【测试可用】
Apr 18 #jQuery
浅谈vuepress 踩坑记
Apr 18 #Javascript
使用webpack-dev-server处理跨域请求的方法
Apr 18 #Javascript
详解webpack-dev-server 设置反向代理解决跨域问题
Apr 18 #Javascript
You might like
一次编写,随处运行
2006/10/09 PHP
一个ubbcode的函数,速度很快.
2006/10/09 PHP
PHP中str_replace函数使用小结
2008/10/11 PHP
php生成短网址示例
2014/05/05 PHP
windows下安装php的memcache模块的方法
2015/04/07 PHP
PHP上传Excel文件导入数据到MySQL数据库示例
2016/10/25 PHP
JavaScript中的闭包原理分析
2010/03/08 Javascript
Node.js环境下JavaScript实现单链表与双链表结构
2016/06/12 Javascript
微信小程序实现根据字母选择城市功能
2017/08/16 Javascript
JS实现匀加速与匀减速运动的方法示例
2017/09/04 Javascript
VUE重点问题总结
2018/03/19 Javascript
JavaScript中创建原子的方法总结
2018/08/26 Javascript
js getBoundingClientRect使用方法详解
2019/07/17 Javascript
vue封装swiper代码实例解析
2019/10/08 Javascript
基于JavaScript判断两个对象内容是否相等
2020/01/10 Javascript
一文秒懂JavaScript构造函数、实例、原型对象以及原型链
2020/08/25 Javascript
[44:39]2014 DOTA2国际邀请赛中国区预选赛 NE VS CNB
2014/05/21 DOTA
Python中用sleep()方法操作时间的教程
2015/05/22 Python
解析Python编程中的包结构
2015/10/25 Python
python将unicode转为str的方法
2017/06/21 Python
利用Python查看目录中的文件示例详解
2017/08/28 Python
python 调用c语言函数的方法
2017/09/29 Python
读取本地json文件,解析json(实例讲解)
2017/12/06 Python
python3正则提取字符串里的中文实例
2019/01/31 Python
Mac在python3环境下安装virtualwrapper遇到的问题及解决方法
2019/07/09 Python
Python爬取视频(其实是一篇福利)过程解析
2019/08/01 Python
Python @property及getter setter原理详解
2020/03/31 Python
keras 回调函数Callbacks 断点ModelCheckpoint教程
2020/06/18 Python
使用CSS3的box-sizing属性解决div宽高被内边距撑开的问题
2016/06/28 HTML / CSS
餐厅执行经理岗位职责范本
2014/02/26 职场文书
教师优秀党员事迹材料
2014/08/14 职场文书
2015年国庆节慰问信
2015/03/23 职场文书
小公司融资,商业计划书的8切记
2019/07/15 职场文书
小学秋季运动会加油口号及加油稿
2019/08/19 职场文书
SqlServer: 如何更改表的文件组?(进而改变存储位置)
2021/04/05 SQL Server
详解盒子端CSS动画性能提升
2021/05/24 HTML / CSS