该系列用于探索一些 Angular 中灵活或者新的用法。本文记录制作左侧菜单,并使用路由自动定位的过程。

调整配置

上一篇有些配置不是很合适,故这里我们先进行调整。

全局注入 jQuery

上篇我们是这样注入 jQuery 的:

// jquery
window["$"] = window["jQuery"] = require("./assets/js/jquery.min.js");

这样的全局注入其实可能会导致一些问题(不知道是不是配置不正确,导致本骚年的其他 jQuery 插件失效),所以我们还是用 webpack 来注入。 首先安装 jQuery 的依赖:

npm install jquery --save

然后在 webpack 的插件配置plugins中添加:

plugins: [
  new webpack.ProvidePlugin({
    $: "jquery",
    jQuery: "jquery"
  })
];

就可以挪掉上面不够优雅的注入方式了。

开启 source-map

之前我们的 webpack 配置中也添加了devtool: 'source-map',但是这个需要配合source-map-loader才能生效:

npm install -D source-map-loader

然后在 webpack 中添加 loader:

rules: [
  {
    test: /\.js$/,
    use: ["source-map-loader"],
    enforce: "pre",
    exclude: [
      path.join(__dirname, "node_modules", "@angular/compiler"),
      path.join(__dirname, "node_modules", "rxjs")
    ]
  }
];

这里我们需要排除@angular/compiler以及rxjs,可能还有其他一些依赖,不然会有 webpack 的warning。详细也可以查看类似的issue-Warnings displayed by webpack when using source-map-loader

压缩代码

webpack 自带了一个压缩插件UglifyJsPlugin,我们添加以下配置就可以生效:

plugins: [
  new webpack.optimize.UglifyJsPlugin({
    compress: {
      warnings: false
    }
  })
];

压缩后的代码体积大大减小,但会消耗一定的编译速度,故一般打包到生产环境才会使用。

分离代码

如果说我们需要分离其他的代码,像一些依赖的代码,或者是 css 代码,也可以通过配置实现。

  1. 抽离依赖vender.js文件
new CommonsChunkPlugin({
  name: "vendors",
  filename: "vendors.js",
  minChunks: function(module) {
    return isExternal(module);
  }
});

关于isExternal()函数,用了很简单的方式进行:

function isExternal(module) {
  var userRequest = module.userRequest;
  if (typeof userRequest !== "string") {
    return false;
  }
  return userRequest.indexOf("node_modules") >= 0; // 是否位于node_modules里
}
  1. 将样式从 js 中抽出,生成单独的.css样式文件。即把所以的 css 打包合并:
new ExtractTextPlugin("style.css", {
  allChunks: true // 提取所有的chunk(默认只提取initial chunk,而上面CommonsChunkPlugin已经把部分抽离了)
});

这些大家下来可以配置,本骚年就不在项目这使用了。

创建左侧菜单

添加配置文件

这里我们为了方便拓展,使用配置的方式来自定义菜单,这样每次我们需要修改的时候只需要调整配置文件就好了:

// sidebar.config.ts
export const menus = [
  {
    icon: "fa-home", // icon用于储存菜单对应的图标
    text: "页面管理", // text用于储存该菜单显示名称
    childMenus: [
      {
        link: "/home/page-setting", // link用于设定该菜单跳转路由
        text: "页面配置" // text用于储存该菜单显示名称
      },
      {
        link: "/home/page-rebuild",
        text: "页面重现"
      }
    ]
  },
  {
    icon: "fa-cubes",
    text: "使用说明",
    link: "/home/page-handbook"
  }
];

这里暂时限定我们最多为二级菜单,跟之前搭建管理项目的方式一致。

添加 html 文件

这里我们可以遍历配置文件生成菜单:

<div class="col-md-3 left_col menu_fixed">
  <div class="left_col scroll-view">
    <!-- 其他省略,重点在下面 -->

    <!-- sidebar menu -->
    <div class="main_menu_side hidden-print main_menu">
      <div class="menu_section">
        <!-- 其他省略,重点在下面 -->
        <ul class="nav side-menu metismenu" id="sidebar-menu">
          <li
            class="topper-menu"
            *ngFor="let menu of menus;"
            [ngClass]="menu.link && isActive(menu.link) ? 'active' : ''"
          >
            <a *ngIf="menu.link" [routerLink]="menu.link"
              ><i class="fa" [ngClass]="menu.icon"></i> {{menu.text}}</a
            >
            <a *ngIf="!menu.link" class="has-arrow"
              ><i class="fa" [ngClass]="menu.icon"></i> {{menu.text}}</a
            >
            <ul class="nav child_menu slide">
              <li
                *ngFor="let childMenu of menu.childMenus;"
                class="slide-item"
                routerLinkActive="current-page"
              >
                <a [routerLink]="childMenu.link">{{ childMenu.text }}</a>
              </li>
            </ul>
          </li>
        </ul>
      </div>
    </div>
    <!-- /sidebar menu -->
  </div>
</div>

这里可以看到,我们使用*ngFor来进行遍历,然后我们大致可以得到我们的 component 需要以下功能:

  • [routerLink]: 链接跳转
  • routerLinkActive: 路由激活时样式
  • isChildMenuActived: 判断该菜单下是否有子菜单的路由处于激活状态

这里我们需要注意的是:

  1. 使用 angular 自带的常用指令,像*ngForngClass等,需要在注册@NgModule时引入CommonModule
  2. 使用 angular 里面路由常用指令,像[routerLink]routerLinkActive等,需要在注册@NgModule时引入RouterModule
  3. 使用 angular 里面表单常用指令,像[(ngModel)]等,需要在注册@NgModule时引入FormModule

像我们的HomeModule

import { NgModule } from "@angular/core";
import { FormsModule } from "@angular/forms";
import { RouterModule } from "@angular/router";
import { CommonModule } from "@angular/common";

import { HomeRoutes } from "./home.routes";
import { HomeComponent } from "./home.component";
import { SidebarComponent } from "./sidebar/sidebar.component";

@NgModule({
  declarations: [HomeComponent, SidebarComponent],
  imports: [FormsModule, CommonModule, RouterModule.forChild(HomeRoutes)],
  providers: []
})
export class HomeModule {}

添加 component

组件使用了简单的 jQuey 插件metisMenu,详细说明请参考文档,这里我们只需要知道调用$().metisMenu()的时候,若有<li class="active">则自动将该<li>设置为激活形式,此时我们在路由跳转结束的时候就可以获取对应激活路由然后初始化菜单状态了。

我们直接在代码中说明吧:

import {Component, ElementRef} from '@angular/core';
import {ActivatedRoute, Router, NavigationEnd} from '@angular/router';
import {menus} from './sidebar.config';
import 'rxjs/Rx';

@Component({
    selector: 'home-sidebar',
    templateUrl: './sidebar.component.html',
})
export class SidebarComponent {
    menus: any[] = menus;

    constructor(private route: ActivatedRoute, private router: Router, el: ElementRef) {
        this.router.events.subscribe(event => {
            // 判断路由结束
            if (event instanceof NavigationEnd) {
                const $menu = $(el.nativeElement).find('#sidebar-menu');
                this.menus.forEach((menu, index) => {
                    if (this.isChildMenuActived(menu)) {
                        // 将被激活的路由对应的li添加“active”的class
                        $menu.find('li.topper-menu').eq(index).addClass('active');
                    }
                });
                // 初始化菜单状态
                $menu.metisMenu();
            }
        });
    }

    // 判断路由是否激活状态
    isActive(url: string): boolean {
        return this.router.isActive(url, false);
    }

    // 判断菜单是否有子路由处于激活状态
    isChildMenuActived(menu: any): boolean {
        let hasOneActive = false;
        if (menu.childMenus) {
            // 遍历子路由看是否被激活
            menu.childMenus.forEach(child => {
                hasOneActive = hasOneActive || this.isActive(child.link);
            });
        }
        return hasOneActive;
    }
}

在 Angular2-release 版本里,一般路由的状态是通过事件监听获取的:

// 使用`ActivatedRoute`的API获取路由信息。
import { ActivatedRoute } from '@angular/router';
@Component({
    ... // 略
})
export class SidebarComponent {
    constructor(private route: ActivatedRoute) {}
   	ngOnInit() {
      this.route.params
        .subscribe((params) => {
          this.id = parseInt(params['id']); // 获取params
         ... // 其余代码
        });
    }
    ... // 其余代码
}

这里我们也可以使用filter()来过滤监听我们想要的事件:

// 监听导航事件变更完毕
router.events
  .filter(event => event instanceof NavigationEnd)
  .subscribe(event => {});

更多有关路由的我们上节也说过,可以点击回顾《3. 启用路由和添加静态资源》

最终效果图: image

结束语

这节主要讲了一些基础环境配置的调整,以及制作路由自动定位左侧菜单的过程,主要涉及的可能还是路由相关。
看菜单列表的内容,大家猜猜本骚年接下来想要做什么?就不告诉你,哈哈。
此处查看项目代码
此处查看页面效果

部分文章中使用了一些网站的截图,如果涉及侵权,请告诉我删一下谢谢~
温馨提示喵