Angular 文档简介
当前文档基于有一定MVVM理解和认知的同学,需要快速上手angular框架而编写的个人学习文档,这份 Angular 文档会帮助你学习和使用 Angular 框架与开发平台,从你的第一个应用开始,一直到优化复杂的企业级单页面应用。
一、安装Angular相关开发环境
[图片上传失败...(image-41814a-1686550070247)]
- 全局安装脚手架工具:安装命令(只需要安装一次)
npm install -g @angular/cli
或者
cnpm install -g @angular/cli --推荐使用速度较快
- 检测是否按照成功
[图片上传失败...(image-e4ec6c-1686550070246)]
二、通过Angular脚手架创建一个新的项目
-
打开自己要创建的文件夹,shift+右键打开命令行窗口
-
ng new MyNgProject(项目名称)
[图片上传失败...(image-3187ed-1686550070246)]
注意:如果是针对个别的项目,可以新建一个文件夹然后npm install @angular/cli@**
- 点击ng serve,脚手架启动成功
[图片上传失败...(image-f4046f-1686550070246)]
[图片上传失败...(image-6d74e6-1686550070246)]
三、目录讲解
说明 ```javascript |-- 文件名 // 说明 |-- 首层目录 |-- e2e // 自动化集成测试目录 |-- node_modules // npm/cnpm第三方依赖包存放目录 |-- src // 应用源代码目录 |-- .editorconfig // 不同编译器统一代码风格 |-- .gitignore // git中的忽略文件列表 |-- angular.json // Angular的配置文件 |-- browserslist // 配置浏览器兼容性的文件 |-- karma.conf.js // 自动化测试框架Karma的配置文件 |-- package-lock.json // 依赖包版本锁定文件 |-- package.json // 标准的npm工具的配置文件 |-- README.md // 项目说明的MakeDown文件 |-- tsconfig.app.json // app项目的TypeScript的配置文件 |-- tsconfig.json // 整个工作区的TypeScript配置文件 |-- tsconfig.spec.json // 用于测试的TypeScript配置文件 |-- tslint.json // TypeScript的代码静态扫描配置
|-- src目录 |-- app // 工程源码目录 |-- assets // 资源目录 |-- environments // 环境配置目录 |-- favicon.ico // header里的icon |-- index.html // 单页应用的宿主HTML |-- main.ts // 入口ts文件 |-- polyfills.ts // 不同浏览器兼容脚本加载 |-- karma.conf.js // 自动化测试框架Karma的配置文件 |-- style.css // 整个项目的全局css |-- test.ts // 测试入口
|-- app目录 |-- app-routing.module.ts // app路由 |-- app.component.css // app的css |-- app.component.html // app的html |-- app.component.spec.ts // app的测试 |-- app.component.ts // app的组件 |-- app.module.ts // app的模块 |-- environments目录 |-- environments.prod.ts // 生产环境 |-- environments.ts // 开发环境 ```
具体内容
.editorconfig
[图片上传失败...(image-9490d-1686550070246)]
angular.json **** javascript |-- angular.json // Angular的配置文件 |--首层目录 // 说明 |--"$schema": "" // 架构关键字:指出如何形式描述XML文档的元素 |--"version": 1, // 版本 |--"newProjectRoot": "projects", // 新项目路径:多项目开发 |--"projects": {} |--"defaultProject": "scrollable-tab" // 默认项目 |--"projects": {} |--"scrollable-tab":{} // 项目scrollable-tab |--"projectType": "application", |--"schematics": {}, |--"root": "", |--"sourceRoot": "src", // 项目根路径 |--"prefix": "app", // 安装应用的指定目录 |--"architect": {} // 架构目录 |--"build": {} // 搭建命令文件目录 |--"serve": {} // 服务命令文件目录 |--"extract-i18n": {} // 语言翻译目录 |--"test": {} // 测试目录 |--"lint": {} // 代码规范目录 |--"e2e": {} // 测试目录 |--"builder": "@angular-devkit/build-angular:" // AG开发搭建路径 |--"options": {} // 相关可选文件目录 |--"configurations": {} // 配置文件目录
browserslist **** JavaScript // 只支持市场占有率>0.5%的浏览器 > 0.5% last 2 versions Firefox ESR not dead // 不支持IE 9-11 not IE 9-11 # For IE 9-11 support, remove 'not'.
### package-lock.json&package.json **** JavaScript |-- package-lock.json // 依赖包版本锁定文件 |--"name": "scrollable-tab", // 包的名称 //包锁:必须与package.json内容匹配 |--"version": "0.0.0", // 包的版本 //包锁:必须与package.json内容匹配 |--"lockfileVersion": 1, // 整数版本,1从此文档的版本号开始,在生成此版本时使用其语义package-lock.json |--"requires": true, // 是否必需 |--"dependencies"{} // 包的依赖目录 |-- package.json // 依赖包版本文件 |--"name": "scrollable-tab", // 包的名称 //包锁:必须与package.json内容匹配 |--"version": "0.0.0", // 包的版本 //包锁:必须与package.json内容匹配 |--"scripts": {}, // 运行脚本命令目录 |--"ng": "ng", // 全局命令 |--"start": "ng serve", // 开发环境项目启动命令 |--"start.prod": "ng serve --aot", // 生产环境项目启动命令 |--"build": "ng build", // 项目打包命令 |--"test": "ng test", // 项目测试命令 |--"lint": "ng lint", // 项目静态编译检测语法命令 |--"e2e": "ng e2e", // 测试命令语句 |--"ivy": "ivy-ngcc" // 兼容性编译器命令语句 |--"private": true, // 是否必需 |--"dependencies"{} // 生产环境下包的依赖目录 8//大版本.0//小版本.0//补丁版本 |--"@angular/animations": "~8.0.0", // ~:锁定大版本与小版本,补丁版本可变动 |--"tslib": "^1.9.0", // ^:锁定大版本,小版本与补丁版本可变动 |--"protractor": "5.4.0", // :严格锁定在该版本,全部版本都不可变动 |--"devDependencies"{} // 开发环境下包的依赖目录
app-routing.module.ts // app路由 **** TypeScript // 变量导入路径 import { NgModule } from '@angular/core'; import { Routes, RouterModule } from '@angular/router'; // 声明路由 const routes: Routes = [{ // 默认路由路径 path : '', // 默认路由组件 component : HomeComponent }]; // @angular/cli 打包的最小单位 /** * @angular/cli 会检查所有 @NgModule 和路由配置,如果你配置了异步模块,cli 会自动把模块切分成独立的 chunk(块) * 其它框架基本上都需要你自己去配置 webpack,自己定义切分 chunck 的规则而Angular 里面,打包和切分的动作是 @angular/cli 自动处理的,不需要你干预 * @NgModule 元数据类型图表 * */ @NgModule({ // 导入模块 imports: [RouterModule.forRoot(routes)], // 导出模块 exports: [RouterModule] }) // 导出控制器 export class AppRoutingModule { } |--@NgModule元数据说明 |--declarations: [] // 属于该模块的可声明对象(组件、指令和管道)的列表 |--providers: [] // 依赖注入提供商的列表 |--imports: [] // 被导入的模块列表 |--exports: [] // 可导出的模块的可声明对象(组件、指令、管道类)列表 |--bootstrap: [AppComponent] // 自动启动的组件列表,应用根组件才有 |--entryComponents: [] // 可动态加载进视图的组件列表
[图片上传失败...(image-731c27-1686550070245)]
四、路由与导航
一).路由的创建
创建路由有三个基本的构建块。
首先检查把 AppRoutingModule 导入 AppModule 并把它添加到 imports 数组中。
[图片上传失败...(image-b92f7f-1686550070245)]
1. 把 RouterModule 和 Routes 导入到你的路由模块中。如果你有使用anglular cli,那么cli会自动执行这一步CLI ,还为你的路由设置了 Routes 数组,并为 @NgModule() 配置了 imports 和 exports 数组。
[图片上传失败...(image-398d2a-1686550070245)]
2.在 Routes 数组中定义你的路由。这个数组中的每个路由都是一个包含两个属性的 JavaScript 对象。第一个属性 path 定义了该路由的 URL 路径。第二个属性 component 定义了要让 Angular 用作相应路径的组件。
[图片上传失败...(image-5d0b7-1686550070245)]
3.把这些路由添加到你的应用中。和vue一样,也有routerLink
[图片上传失败...(image-3f1fd-1686550070245)]
二).路由的跳转方式和传参
[图片上传失败...(image-8b0f25-1686550070245)]
- 通过点击事件传参
定义点击事件:
<button nz-button nzType="primary" (click)="linkTo(item.id)">点击事件编辑</button>
方法实现:
linkTo(uuid: string): void {
this.router.navigate(['/menu_list/detailes'], {
queryParams:{ id: uuid },
});
}
注意:前提要引入Router
import{ Router} from '@angular/router';
constructor(
public router: Router
) { }
- 通过a标题跳转
(1) 定义a标签点击事件即可
<a [routerLink]="['/menu_list/detailes']" [queryParams]="{id:item.id}">
a标签编辑
</a>
- 获取传入的参数
import{ ActivatedRoute, Params} from '@angular/router';
constructor(
public router: ActivatedRoute,
) {}
ngOnInit(): void {
this.router.queryParams.forEach((params: Params) => {
if (params.id) {
console.log(params.id); // =1
}
});
}
五、组件的创建与使用
- 组件的创建
你在哪个.module下使用当前组件,就在哪个文件夹下右键打开命令行,然后执行,他会自动创建,文件名称规范:xxx.component.ts
ng generate component xxx
Ex:ng generate component test
通过快速创建你会得到以下内容
[图片上传失败...(image-4cd785-1686550070244)]
- 组件说明
这个文件就是负责写css样式的
test.component.css
这个文件就是写html的
est.component.html
这个文件就是写js的
test.component.ts
可以参考微信小程序编辑生成的文件格式,一个意思
这里详细说下ts文件
import{ Component, OnInit} from '@angular/core';
@Component({
//组件的唯一标识,使用也是这个格式,app-xxxx格式
selector: 'app-test',
//这就是html,跟html文件名一样
templateUrl: './test.component.html',
//这里是个数组,意思就是可以引入多个css,注意,后一个会将前一个样式覆盖
【1.css,2.css】===2的样式如果跟1的名字一样,就会覆盖
styleUrls: ['./test.component.css']
})
export class TestComponent implements OnInit {
constructor() { }
ngOnInit(): void {
}
}
- 使用,只要注册在了module里,所在module里的任何组件都可以调用
[图片上传失败...(image-7bdef2-1686550070244)]
六、组件直接传参(父传子,子传父)
其实原理有点像vue的event up, props down,只是语法不一样而已
- 父传子
父组件:先将子组件引入,app-child-new即是子组件在selector里声明的,唯一标示id
[图片上传失败...(image-96912f-1686550070244)]
通过父组件点击事件,讲parentNum++,传入到子组件中,如上,需要用[]包裹变量,当前包裹的名称即为子组件接受的名称,这里我写的是一样的,可以不一样
[图片上传失败...(image-ea3182-1686550070244)]
子组件中:@Input()即为子组件接受父组件传入的变量值,接收即可
[图片上传失败...(image-8d4f1a-1686550070244)]
当前parentNum即为父传入的数据
[图片上传失败...(image-6c7188-1686550070244)]
点击父按钮,调用方法后,传入的值就会发生变化
[图片上传失败...(image-b51624-1686550070244)]
- 子传父
子组件中:先在子组件声明一个点击事件
[图片上传失败...(image-88a846-1686550070244)]
然后childNumChange就是父组件传入的方法,在点击子组件toggle方法时,调用childNumChange.emit方法,将num传入到父组件中。
[图片上传失败...(image-34a25-1686550070244)]
父组件中:childNumChange即为传入子组件的方法名称,而childCallBack即为在父组件来接收子组件传入的方法,$event即为传入的值,语法就是这样写
[图片上传失败...(image-f56d36-1686550070244)]
在父组件接收传入的值后,可进行后续其他操作,比如点击了子组件某个方法后,父组件某些值也要改变,逻辑就是在返回的callback方法中执行即可
[图片上传失败...(image-36bbd-1686550070244)]
- 父组件调用子组件方法
有时候我们需要在父组件里,调用到子组件里面相关方法,比如当我们点击保存的时候,保存按钮在父组件,但是校验的方法在子组件,于是我们需要在点击保存的时候,调用到子组件校验方法
父组件中:给组件添加唯一标识,语法#xxx
[图片上传失败...(image-d637b0-1686550070244)]
然后在父组件ts中,首先导入子组件,然后,引入anglular的Api(ViewChild),固定语法@ViewChild(‘xxxx’),这里的xxx就是上面在组件上标识的唯一标识childNew,然后声明一个变量叫childNew(此名称自定义命名),将组件NewChildCoponent组件指向到当前变量childNew,即下面框框内容。这样就相当于是把子组件引入到了父组件中,当前访问this.childNew,即可访问到子组件相关方法。
[图片上传失败...(image-19dbb1-1686550070244)]
网友评论