The story behind _references.js 简译一下

_references.js背后的故事

_references.js是在VS的WEB项目中,提供智能提示的关键技术。

在VS2010发布之后,作者还是ASP.NET小组成员时,小组想把js编辑器的功能迁移到一个新的“客户端平台小组”。这个小组将要为VS2012创建一个全新的,现代的js编辑器,另一层目的就是为即将到来的Win8 App提供HTML/JS开发支持。而原来的js编辑器从vs中剥离,但它却在webMatrix中保存下来,包括之后的开发及更新。

既然要开发新的编辑器,正好是重新设计我们已经使用过的许多功能的机会。关键之一就是智能提示

有三个思路来智能提示:

1、All.js 。项目中所有的js自动加载到智能提示中

2、Only.js。只有页面中包含的js,才智能提示

3、让用户指定要智能提示的js文件。

第1种,肯定会带来负面影响。未引用的js也提示,那么运行时会报错;会带来性能问题;无法确定加载的顺序;与此同时,bundling, minification and dynamically loaded JavaScript这几种技术,都让ide无所适从。

最终,让用户手动添加引用文件,能消除性能 因素,防止解析html文件中的script标签。

总之每种方法都有赞成和反对的声音。

显示抑或隐式地引用呢?

既然决定新编辑器要使用第2、3两个方法。那么它只要解析页面上的<script>以及加载用户显示声明的三斜杠引用 。/// <reference path="../app/respond.js" />

把js文件从解决方案管理器拖动到页面上时,文档顶部自动插入一个三斜杠的引用。通过这种引用,ide就可能进行智能提示。

_references.js是全局的引用

通过上面显示的引用,用户不得不每个js文件都添加上三斜杠的引用,比如jquery,可能要在所有的文件中引用。这不爽,为了最大化不为降低用户的负担,必须要一个全局的引用缓存。

这于是约定 /scripts/_references.js会自动添加为全局智能提示。

改变引用文件的名称

一些人不喜欢用scripts文件夹,或不喜欢_references的名字。假设一些人要用/js/globals.js这样的名字

vs提供了相应的方法,去选项-》Text Editor->JavaScript->IntelliSense->References中,找到Reference Group中,选择相应的下拉项,会找到引用的文件(我现在安装的vs2015明显没有列出_references.js)

自动实现一切

以上这些功能都随着vs2012发布了,但到了vs2013,我们决定再次改进工作流程。

用户必须手动维护这个引用文件,当用户添加删除或改名后,很容易忘记还要去_references.js更正一下.更好的方法是加载所有的js文件,因为知道这有性能问题以及文件加载顺序的问题,所以必须让用户可以禁止此功能。

连vs都没有提供 默认的项目setting文件,我们不想额外地增加一个setting文件。于是我们引入了一个新的三斜杠的名称

/// <autosync enabled="true" />

同时IDE中,在_references.js文件上右键,会有自动同步和立即更新同步的功能。

自动同步为true时,ide会把你新添加、改名等都同步引用一下,并潜在会有引入顺序问题。

我个人认为不如手动的选择引入文件。

如果项目上没有这个文件,你要安装Web Essentials 2013,然后在/scripts上右键可以方便添加上这个文件。







转载于:https://my.oschina.net/u/1540190/blog/487565

  • 0
    点赞
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值