feat: add RouterLink

modules/@angular/router/src/directives/router_link.ts

@@ -0,0 +1,73 @@
+import {
+  Directive,
+  HostListener,
+  HostBinding,
+  Input
+} from '@angular/core';
+import {Router} from '../router';
+
+/**
+ * The RouterLink directive lets you link to specific parts of your app.
+ *
+ * Consider the following route configuration:
+
+ * ```
+ * [{ name: 'user', path: '/user', component: UserCmp }]
+ * ```
+ *
+ * When linking to this `User` route, you can write:
+ *
+ * ```
+ * <a [routerLink]="['/user']">link to user component</a>
+ * ```
+ *
+ * RouterLink expects the value to be an array of path segments, followed by the params
+ * for that level of routing. For instance `['/team', {teamId: 1}, 'user', {userId: 2}]`
+ * means that we want to generate a link to `/team;teamId=1/user;userId=2`.
+ *
+ * The first segment name can be prepended with `/`, `./`, or `../`.
+ * If the segment begins with `/`, the router will look up the route from the root of the app.
+ * If the segment begins with `./`, or doesn't begin with a slash, the router will
+ * instead look in the current component's children for the route.
+ * And if the segment begins with `../`, the router will go up one level.
+ */
+@Directive({selector: '[routerLink]'})
+export class RouterLink {
+  @Input() target: string;
+  private commands: any[]|null = null;
+  private absoluteUrl: string|null = null;
+
+  // the url displayed on the anchor element.
+  @HostBinding() href: string;
+
+  constructor(private router: Router) {}
+
+  @Input()
+  set routerLink(data: any[] | string) {
+    if (Array.isArray(data)) {
+      this.commands = data;
+      this.absoluteUrl = null;
+    } else {
+      this.commands = null;
+      this.absoluteUrl = data;
+    }
+    this.updateTargetUrlAndHref();
+  }
+
+
+  @HostListener("click")
+  onClick(): boolean {
+    // If no target, or if target is _self, prevent default browser behavior
+    if (!(typeof this.target === "string") || this.target == '_self') {
+      this.router.navigateByUrl(this.absoluteUrl);
+      return false;
+    }
+    return true;
+  }
+
+  private updateTargetUrlAndHref(): void {
+    if (this.absoluteUrl) {
+      this.href = this.absoluteUrl;
+    }
+  }
+}

modules/@angular/router/src/router.ts

@@ -66,6 +66,11 @@ export class Router {
   resetConfig(config: RouterConfig): void {
     this.config = config;
   }
+  
+  /**
+   * @internal
+   */
+  dispose(): void { this.locationSubscription.unsubscribe(); }
 
   private setUpLocationChangeListener(): void {
     this.locationSubscription = <any>this.location.subscribe((change) => {