在 Mac OS 上使用 TypeScript 编写 ASP.NET Core 1.0 应用¶

警告

您当前查看的页面是未经授权的转载！
如果当前版本排版错误，请前往查看最新版本：http://www.cnblogs.com/qin-nz/p/aspnet5-using-typescript-on-mac-os.html

提示

更新时间：2016年01月20日。

在 Mac OS 上，并没有时候编辑 ASP.NET Core 1.0 的 IDE，只有一个 Visual Studio Code 可用，
这种情况下，编写后端代码是比较费劲的（对于习惯使用IDE的人来说），所以本文从前端的角度来介绍下。

本文将引导你创建一个 d3 数据变化曲线的展现过程。

什么是 TypeScript¶

写过 JavaScript 的人都知道， JavaScript 只是一个脚本语言，并不适合写大型程序。
（至少几年前是这个样子的，现在会有很多的扩展来是 JavaScript 变得更强大。）

TypeScript 是 JavaScript 的超集，任何合法的 JavaScript 代码也是合法的 TypeScript 代码。

浏览器只支持 JavaScript ，不支持 TypeScript ；但是， TypeScript 可以在服务器端编译为 JavaScript ，因此可以在浏览器上运行。

注解

Angular 2.0 就是基于 TypeScript 开发的。

Angular 2.0 Beta 已于圣诞节前发布。

什么是 d3¶

D3 是最流行的可视化库之一，它被很多其他的表格插件所使用。
它允许绑定任意数据到DOM，然后将数据驱动转换应用到Document中。
你可以使用它用一个数组创建基本的HTML表格，或是利用它的流体过度和交互，用相似的数据创建惊人的SVG条形图。

创建一个 ASP.NET Core 1.0 应用¶

使用 yo aspnet 创建一个 ASP.NET Core 1.0 的 Web Application Basic 应用。

注解

如果你还没有在你的 Mac OS 上安装过 .NET 运行环境，或者不会创建一个空的 ASP.NET Core 1.0 应用，
请参考在 Mac OS 上创建并运行 ASP.NET Core 1.0 网站

安装 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 目录中。

其他资源¶

AngularJs 2.0 （可能需要科学上网）

TypeScript

TypeScript中文教程

Data-Driven Documents (d3)

DefinitelyTyped

声明

在 Mac OS 上使用 TypeScript 编写 ASP.NET Core 1.0 应用由勤奋的小孩创作，采用知识共享署名-相同方式共享 4.0 国际许可协议进行许可。
本许可协议授权之外的使用权限可以从 http://space.cnblogs.com/msg/send/qin-nz 处获得。