Angular 2 拖放库 ng2-dnd 使用指南

本指南旨在帮助开发者快速了解并开始使用 ng2-dnd，这是一个专为 Angular 2 及以上版本设计的无依赖拖放库。

1. 目录结构及介绍

ng2-dnd 的仓库遵循典型的 Angular 应用结构，其主要目录结构如下：

• src
  主要源代码存放目录。

  • public_api.ts
    定义了对外公开的 API。
  • dnd.module.ts
    包含核心的 DndModule，是应用中引入的关键模块。

• demo
  提供示例应用，通常包括 Webpack 和 SystemJS两种环境下的示例。

• config
  配置相关文件，可能用于构建或测试设置。

• style.css
  默认的 CSS 样式文件，用于支持拖放组件的基本样式。

• package.json, npmignore, travis.yml, LICENSE, README.md
  标准的 NPM 包管理文件、构建脚本配置、持续集成配置、许可证文件以及项目说明文档。

• tsconfig.json, tslint.json
  TypeScript 编译配置和代码风格检查配置。

2. 项目启动文件介绍

虽然 ng2-dnd 本身不提供直接运行的应用，其“启动”更多指的是在你的 Angular 项目中集成后的启动过程。但如果你希望查看或测试 ng2-dnd 示例，你可以从 demo 目录开始：

• 对于 Webpack 示例，你可能需要运行对应的构建命令来启动服务。
• 对于 SystemJS 示例，则需正确配置系统加载器，并通过指定入口点来启动。

实际开发中，你会在自己的 Angular 应用中导入 DndModule 来“启动”拖放功能，这并不涉及到 ng2-dnd 库内部的特定启动文件，而是通过以下方式进行：

import { NgModule } from '@angular/core';
import { BrowserModule } from '@angular/platform-browser';
import { DndModule } from 'ng2-dnd';

@NgModule({
    imports: [
        BrowserModule,
        DndModule.forRoot()
    ],
    bootstrap: [AppComponent]
})
export class AppModule { }

3. 项目的配置文件介绍

package.json

这是 Node.js 项目的元数据文件，包含了项目的依赖信息、脚本命令等。当你执行 npm install 命令时，它将依据这里的依赖列表安装所有必要的库。

tsconfig.json

TypeScript 配置文件，指定了编译 TypeScript 文件到 JavaScript 的规则，包括编译目标、模块解析方式等。

tslint.json

定义了 TypeScript 代码风格的检查规则，确保代码质量的一致性。

.gitignore

列出不应被 Git 版本控制系统追踪的文件或目录，如 IDE 生成的文件、构建产物等。

为了正式整合 ng2-dnd 到项目中，你需要主要关注 package.json（进行安装操作），app.module.ts 或其他模块文件（以正确导入和配置 DndModule），以及可选地调整 tsconfig.json 和 tslint.json 来匹配你的开发偏好。记得也要在项目的 HTML 中添加 ng2-dnd 的样式文件以确保视觉效果正确显示。