什么是 TypeScript¶

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

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

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

什么是 d3¶

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

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

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

安装 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 文件夹下。

编写 d3 代码¶

在 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 的匿名函数了。

修改页面内容¶

接下来，为了能在页面中看到这段代码的效果，我们修改 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 ></div>

查看页面¶

运行命令 dnx web ， 打开浏览器访问： http://localhost:5000

其他资源¶

AngularJs 2.0 （可能需要 F-Q ）

TypeScript

TypeScript中文教程

Data-Driven Documents (d3)

DefinitelyTyped