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 相关文章推荐
JS禁用浏览器退格键实现思路及代码
Oct 29 Javascript
js判断为空Null与字符串为空简写方法
Feb 24 Javascript
javascript中html字符串转化为jquery dom对象的方法
Aug 27 Javascript
IScroll5 中文API参数说明和调用方法
May 21 Javascript
14 个折磨人的 JavaScript 面试题
Aug 08 Javascript
微信小程序实现图片预加载组件
Jan 18 Javascript
JS使用ActiveXObject实现用户提交表单时屏蔽敏感词功能
Jun 20 Javascript
vue移动端UI框架实现QQ侧边菜单组件
Mar 09 Javascript
js删除对象/数组中null、undefined、空对象及空数组方法示例
Nov 14 Javascript
vue iview多张图片大图预览、缩放翻转
Jul 13 Javascript
JS实现动态星空背景效果
Nov 01 Javascript
js实现弹幕飞机效果
Aug 27 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
ASP和PHP都是可以删除自身的
2007/04/09 PHP
ThinkPHP写第一个模块应用
2012/02/20 PHP
深入解析Session是否必须依赖Cookie
2013/08/02 PHP
PHP过滤黑名单关键字的方法
2014/12/01 PHP
php使用parse_url和parse_str解析URL
2015/02/22 PHP
[原创]smarty简单模板变量输出方法
2016/07/09 PHP
PHP入门教程之图像处理技巧分析
2016/09/11 PHP
JavaScript 空位补零实现代码
2010/02/26 Javascript
onmouseover和onmouseout的一些问题思考
2013/08/14 Javascript
控制文字内容的显示与隐藏示例
2014/06/11 Javascript
Node.js环境下JavaScript实现单链表与双链表结构
2016/06/12 Javascript
Bootstrap编写一个兼容主流浏览器的受众门户式风格页面
2016/07/01 Javascript
vue双向绑定的简单实现
2016/12/22 Javascript
bootstrap 设置checkbox部分选中效果
2017/04/20 Javascript
JS验证码实现代码
2017/09/14 Javascript
React Native预设占位placeholder的使用
2017/09/28 Javascript
浅谈vue-router 路由传参的方法
2017/12/27 Javascript
浅谈Webpack多页应用HMR卡住问题
2019/04/24 Javascript
angular6开发steps步骤条组件
2019/07/04 Javascript
Vue filter 过滤当前时间 实现实时更新效果
2019/12/20 Javascript
原生js+canvas实现贪吃蛇效果
2020/08/02 Javascript
Python Queue模块详解
2014/11/30 Python
python提取内容关键词的方法
2015/03/16 Python
Python使用sftp实现上传和下载功能(实例代码)
2017/03/14 Python
Python 专题五 列表基础知识(二维list排序、获取下标和处理txt文本实例)
2017/03/20 Python
微信小程序python用户认证的实现
2019/07/29 Python
django正续或者倒序查库实例
2020/05/19 Python
Python实现微信表情包炸群功能
2021/01/28 Python
蛋白质世界:Protein World
2017/11/23 全球购物
js实现弹框效果
2021/03/24 Javascript
食品安全演讲稿
2014/09/01 职场文书
2015年行政人事部工作总结
2015/05/13 职场文书
单位考核鉴定意见
2015/06/05 职场文书
消防演习感想
2015/08/10 职场文书
深入理解margin塌陷和margin合并的解决方案
2021/06/26 HTML / CSS
asyncio异步编程之Task对象详解
2022/03/13 Python