在 Mac OS 上使用 TypeScript 编写 ASP.NET 5 应用?
提示
本文更新时间:2015年12月24日.
在 Mac OS 上,并没有时候编辑 ASP.NET 5 的 IDE,只有一个 Visual Studio Code 可用, 这种情况下,编写后端代码是比较费劲的(对于习惯使用IDE的人来说),所以本文从前端的角度来介绍下。
本文将引导你创建一个 d3 数据变化曲线的展现过程。
什么是 TypeScript?
写过 JavaScript 的人都知道, JavaScript 只是一个脚本语言,并不适合写大型程序。 (至少几年前是这个样子的,现在会有很多的扩展来是 JavaScript 变得更强大。)
TypeScript 是 JavaScript 的超集,任何合法的 JavaScript 代码也是合法的 TypeScript 代码。
浏览器只支持 JavaScript ,不支持 TypeScript ;但是, TypeScript 可以在服务器端编译为 JavaScript ,因此可以在浏览器上运行。
注解
Angular 2.0 就是基于 TypeScript 开发的。
什么是 d3?
D3 是最流行的可视化库之一,它被很多其他的表格插件所使用。 它允许绑定任意数据到DOM,然后将数据驱动转换应用到Document中。 你可以使用它用一个数组创建基本的HTML表格,或是利用它的流体过度和交互,用相似的数据创建惊人的SVG条形图。
创建一个 ASP.NET 5 应用?
使用 yo aspnet
创建一个 ASP.NET 5 的 Web Application Basic 应用。
注解
如果你还没有在你的 Mac OS 上安装过 .NET 运行环境, 或者不会创建一个空的 ASP.NET 5 应用, 请参考 在 Mac OS 上创建并运行 ASP.NET 5 网站
安装 TypeScript?
在 Windows 下使用 Visual Studio 2015 开发的时候,默认已经安装了编译器,并且在保存 TypeScript 文件时会自动编译,但在 Mac OS 下,需要手动安装。
npm install -g typescript
添加 d3 的 bower 引用 & DefinitelyTyped?
打开 bower.json
, 添加如下的高亮行。
{
"name": "sample",
"private": true,
"dependencies": {
"bootstrap": "3.3.5",
"d3": "3.5.8",
"jquery": "2.1.4",
"jquery-validation": "1.14.0",
"jquery-validation-unobtrusive": "3.2.4"
}
}
在项目所在目录运行 bower install
下载安装 d3js 的类库。
截至目前,我们已经安装好了d3的 Javascript 类库,但是如果下想要使用 TypeScript 的高级功能, 必须对 d3 类库中的各种对象手动的声明类型,这是一个浩大的工程,好在已经有人帮我们搞定了,在 Github 上有 https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/d3 。
下载 d3.d.ts
文件,放在 wwwroot/ts-definitions 文件夹下。
注解
可以放在 wwwroot 的任何子文件夹内,但不建议放到 wwwroot/lib/d3 文件夹下,因为运行 bower install
会删除 d3.d.ts
。
编写 d3 代码?
小技巧
建议使用 Visual Studio Code 作为文本编辑器,会提供强大的智能感知。
在 wwwroot/js 文件夹下,新建文件 svgshow.ts
,扩展名为ts表示这是一个 TypeScript 文件。
部分内容如下,完整文件请前往 这里
///<reference path="../ts-definitions/d3/d3.d.ts" />
var margin = { top: 20, right: 120, bottom: 30, left: 50 },
width = Math.min(document.body.clientWidth, 1080) - margin.left - margin.right,
height = 800 - margin.top - margin.bottom - 20;
var xLinear = d3.scale.linear()
.range([0, width]);
var yLinear = d3.scale.linear()
.range([height, 0]);
var line = d3.svg.line()
.interpolate("basis")
.x((d: any) => xLinear(d.x))
.y((d: any) => yLinear(d.y));
第一行,以 //
开头,对于 JavaScript 来说是注释,但对于 TypeScript 来说,指明了引用的类型的定义文件。
使用 tsc wwwroot/js/svgshow.ts
命令进行编译,会在相同目录下生成 svgshow.js
文件,部分内容如下:
///<reference path="../ts-definitions/d3/d3.d.ts" />
var margin = { top: 20, right: 120, bottom: 30, left: 50 }, width = Math.min(document.body.clientWidth, 1080) - margin.left - margin.right, height = 800 - margin.top - margin.bottom - 20;
var xLinear = d3.scale.linear()
.range([0, width]);
var yLinear = d3.scale.linear()
.range([height, 0]);
var line = d3.svg.line()
.interpolate("basis")
.x(function (d) { return xLinear(d.x); })
.y(function (d) { return yLinear(d.y); });
可以看到 Typecript 中的 Lambda 表达式被编译为 JavaScript 的匿名函数了。
注解
如果你更新了 .ts 文件,记得使用 tsc
进行编译。
你可以使用 .vsocde/tasks.json
文件设置当按下 Command+Shift+B 后,自动调用 tsc
编译。
修改页面内容?
接下来,为了能在页面中看到这段代码的效果,我们修改 Views/Home/Index.cshtml 文件为以下内容:
@{
ViewData["Title"] = "Home Page";
}
@section scripts{
<style>
body {
font: 10px sans-serif;
}
.axis path,
.axis line {
fill: none;
stroke: #000;
shape-rendering: crispEdges;
}
.x.axis path {
display: none;
}
.line {
fill: none;
stroke: steelblue;
stroke-width: 1.5px;
}
</style>
<script src="~/lib/d3/d3.js"></script>
<script src="~/js/svgshow.js"></script>
}
<div id="svgdiv"></div>
注解
为了让浏览器能看懂脚本,必须引用 JavaScript 版而不是 TypeScript 版。
查看页面?
运行命令 dnx web
, 打开浏览器访问: http://localhost:5000
提示
由于JavaScript 需要加载数据,请把 这个csv文件 放到 wwwroot 目录中。