在 Mac OS 上使用 TypeScript 编写 ASP.NET 5 应用

Posted 2021-04-25 dotNET跨平台

tags:

篇首语：本文由小常识网(cha138.com)小编为大家整理，主要介绍了在 Mac OS 上使用 TypeScript 编写 ASP.NET 5 应用相关的知识，希望对你有一定的参考价值。

在 Mac OS 上，并没有时候编辑 ASP.NET 5 的 IDE，只有一个可用，这种情况下，编写后端代码是比较费劲的（对于习惯使用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 应用，请参考

安装 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 上有。

下载 d3.d.ts 文件，放在 wwwroot/ts-definitions 文件夹下。

注解

可以放在 wwwroot 的任何子文件夹内，但不建议放到 wwwroot/lib/d3 文件夹下，因为运行 bower install 会删除 d3.d.ts 。

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

注解

如果你更新了 .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 ></script>    <script ></script>}
<div id="svgdiv"></div>

注解

为了让浏览器能看懂脚本，必须引用 JavaScript 版而不是 TypeScript 版。