Angular 4/6 应用上的 Ui 组件库 --Ng-Bootstrap 解析

随着前端技术的不断发展,越来越多的优秀 UI 组件库出现在我们的视野中, Ng-Bootstrap 是一款基于 Angular 框架的 UI 组件库,它能够快速搭建 Angular 应用的用户界面。本文将深入解析 Ng-Bootstrap 的使用和实现原理,介绍其中常用的组件,并提供示例代码供大家参考。

Ng-Bootstrap 的基本介绍

Ng-Bootstrap 是 Angular 官方推荐的组件库之一,采用 Bootstrap4+Angular4 的组合,支持从 Angular 4.0.0 到 Angular 6.0.0,可以很好地配合 Angular CLI 进行开发。它提供了一系列常用的 UI 组件,例如模态框、轮播图、下拉菜单等等,使用起来非常方便,并且具有良好的兼容性和可扩展性。

安装与使用

在开始使用 Ng-Bootstrap 之前,我们需要先安装它。首先全局安装 bootstrap 和 jquery:

然后我们需要安装 Ng-Bootstrap:

在 Angular 项目中引入 Ng-Bootstrap 非常简单,只需要在 app.module.ts 中导入 NgbModule 模块就可以了:

import { BrowserModule } from '@angular/platform-browser';
import { NgModule } from '@angular/core';
import { NgbModule } from '@ng-bootstrap/ng-bootstrap';

import { AppComponent } from './app.component';

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

上面的代码中,我们导入 NgbModule 并调用 forRoot 方法进行初始化。然后就可以在应用中使用 Ng-Bootstrap 的组件了。

Ng-Bootstrap 组件解析

模态框(Modal)

模态框是 Web 应用中非常常见的一种交互形式,它能够很好地实现用户与应用之间的互动。例如我们可以用模态框来显示登录、注册、忘记密码等表单,让用户更加方便地完成相关操作。在 Ng-Bootstrap 中,我们可以轻松地实现模态框功能。

首先,我们需要在 HTML 文件中添加一个按钮,用来触发打开模态框的操作:

<button class="btn btn-outline-primary" (click)="open(content)">Open dialog</button>

然后在组件中定义变量和方法:

import { Component, ViewChild, TemplateRef } from '@angular/core';
import { NgbModal } from '@ng-bootstrap/ng-bootstrap';

@Component({
  selector: 'app-modal',
  templateUrl: './modal.component.html'
})
export class ModalComponent {
  @ViewChild('content') content: TemplateRef<any>;

  constructor(private modalService: NgbModal) {}

  open() {
    const modalRef = this.modalService.open(this.content);
    modalRef.result.then((result) => {
      console.log(`Closed with: ${result}`);
    }, (reason) => {
      console.log(`Dismissed ${reason}`);
    });
  }
}

我们使用 ViewChild 装饰器获取模板内容,然后在 open 方法中调用 NgbModal 服务的 open 方法来打开模态框。该方法会返回一个 NgbModalRef 对象,我们可以通过该对象的 result 属性获得模态框关闭时返回的结果。

最后在模板文件中定义模态框:

<ng-template #content let-modal>
  <div class="modal-header">
    <h4 class="modal-title">Modal title</h4>
    <button type="button" class="close" aria-label="Close" (click)="modal.dismiss('Cross click')">
      <span aria-hidden="true">×</span>
    </button>
  </div>
  <div class="modal-body">
    <p>One fine body…</p>
  </div>
  <div class="modal-footer">
    <button type="button" class="btn btn-outline-dark" (click)="modal.close('Save click')">Save changes</button>
  </div>
</ng-template>

上面的代码中,我们使用 ng-template 定义了模态框的 HTML 内容,其中标题、按钮等元素可以根据实际情况进行修改。模态框关闭时我们使用 modalRef 的 close 方法来返回结果,同时也可以用 dismiss 方法关闭模态框。

轮播图(Carousel)

轮播图是许多网站中常见的一种元素,可以用来展示图片等内容。在 Ng-Bootstrap 中,轮播图的实现非常简单,只需要在 HTML 文件中添加一些标签和样式就可以了。

首先,我们需要在 HTML 文件中定义轮播图并导入样式:

<ngb-carousel>
  <ng-template ngbSlide>
    <img class="d-block w-100" src="https://via.placeholder.com/500x200?text=First slide" alt="First slide">
  </ng-template>
  <ng-template ngbSlide>
    <img class="d-block w-100" src="https://via.placeholder.com/500x200?text=Second slide" alt="Second slide">
  </ng-template>
  <ng-template ngbSlide>
    <img class="d-block w-100" src="https://via.placeholder.com/500x200?text=Third slide" alt="Third slide">
  </ng-template>
</ngb-carousel>

<link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/bootstrap/4.0.0-beta.3/css/bootstrap.min.css">

轮播图的内容可以根据实际情况进行修改,如上面的代码中,我们定义了三张图片作为轮播图的内容。Ng-Bootstrap 会自动根据标签数量生成相应的轮播点和按钮。

下拉菜单(Dropdown)

下拉菜单是一个非常常见的 UI 元素,它可以用来展示选项,或进行操作。在 Ng-Bootstrap 中,我们可以轻松地实现下拉菜单功能。

首先,我们需要在 HTML 文件中添加一个下拉菜单按钮:

<div ngbDropdown class="d-inline-block">
  <button class="btn btn-outline-primary" id="dropdownMenuButton" ngbDropdownToggle>Dropdown</button>
  <div ngbDropdownMenu aria-labelledby="dropdownMenuButton">
    <button class="dropdown-item">Action - 1</button>
    <button class="dropdown-item">Action - 2</button>
    <button class="dropdown-item">Action - 3</button>
  </div>
</div>

然后在组件中定义事件和方法:

import { Component } from '@angular/core';

@Component({
  selector: 'app-dropdown',
  templateUrl: './dropdown.component.html'
})
export class DropdownComponent {
  onMenuClick(event: MouseEvent) {
    event.stopPropagation();
  }
}

我们使用 ngbDropdown 指令将按钮和下拉菜单关联起来,然后在 ngbDropdownMenu 中定义菜单项。最后我们可以为下拉菜单按钮添加事件,以防止菜单项点击冒泡到其他元素。

总结与建议

综上所述,Ng-Bootstrap 是一款非常强大的 Angular UI 组件库,它提供了许多常用的 UI 组件,且基于 Bootstrap4+Angular4 的组合,具有优秀的兼容性和可扩展性。我们可以根据实际需求使用 Ng-Bootstrap 中的组件,在提高开发效率的同时也能提供高质量的用户体验。

当然,在使用 Ng-Bootstrap 的过程中也需注意一些问题。例如,Ng-Bootstrap 中的组件和 CSS 样式可能与应用中的其他部分存在冲突,同时也可能存在一些性能上的问题。因此在使用时要注意选择合适的组件并进行必要的优化。

更多细节可以参考官方文档https://ng-bootstrap.github.io

示例代码:https://github.com/zhihaojiang/ng-bootstrap-example

来源:JavaScript中文网 ,转载请注明来源 本文地址:https://www.javascriptcn.com/post/65b46547add4f0e0ffd517d4