carbon-components-angular 5.21.1 → 5.22.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (65) hide show
  1. package/docs/documentation/components/SideNav.html +59 -15
  2. package/docs/documentation/components/SideNavItem.html +123 -44
  3. package/docs/documentation/components/SideNavMenu.html +67 -25
  4. package/docs/documentation/coverage.html +10 -10
  5. package/docs/documentation/js/menu-wc.js +3 -3
  6. package/docs/documentation/js/menu-wc_es5.js +1 -1
  7. package/docs/documentation/js/search/search_index.js +2 -2
  8. package/docs/documentation/modules/SideNavModule.html +2 -1
  9. package/docs/documentation/modules/ThemeModule/dependencies.svg +4 -4
  10. package/docs/documentation/modules/ThemeModule.html +4 -4
  11. package/docs/documentation/modules/TilesModule/dependencies.svg +101 -101
  12. package/docs/documentation/modules/TilesModule.html +101 -101
  13. package/docs/documentation/modules/TimePickerModule/dependencies.svg +17 -17
  14. package/docs/documentation/modules/TimePickerModule.html +17 -17
  15. package/docs/documentation/modules/ToggleModule/dependencies.svg +42 -46
  16. package/docs/documentation/modules/ToggleModule.html +42 -46
  17. package/docs/documentation/modules/TooltipModule/dependencies.svg +4 -4
  18. package/docs/documentation/modules/TooltipModule.html +4 -4
  19. package/docs/documentation/modules/TreeviewModule/dependencies.svg +35 -35
  20. package/docs/documentation/modules/TreeviewModule.html +35 -35
  21. package/docs/documentation.json +159 -66
  22. package/docs/storybook/{1325.5502bfb0.iframe.bundle.js → 1325.3c39c950.iframe.bundle.js} +1 -1
  23. package/docs/storybook/3348.4c108918.iframe.bundle.js +1 -0
  24. package/docs/storybook/{checkbox-checkbox-stories.ea872c08.iframe.bundle.js → checkbox-checkbox-stories.3aeae19d.iframe.bundle.js} +1 -1
  25. package/docs/storybook/{content-switcher-content-switcher-stories.2f8cdd41.iframe.bundle.js → content-switcher-content-switcher-stories.8f3aa078.iframe.bundle.js} +1 -1
  26. package/docs/storybook/{grid-css-grid-stories.f5c396e2.iframe.bundle.js → grid-css-grid-stories.c703f9de.iframe.bundle.js} +1 -1
  27. package/docs/storybook/{grid-grid-stories.0b935617.iframe.bundle.js → grid-grid-stories.f7a88c02.iframe.bundle.js} +1 -1
  28. package/docs/storybook/iframe.html +2 -2
  29. package/docs/storybook/index.json +1 -1
  30. package/docs/storybook/{layer-layer-stories.8fdeec80.iframe.bundle.js → layer-layer-stories.9fc41371.iframe.bundle.js} +1 -1
  31. package/docs/storybook/{layout-stack-stories.e9f0fa18.iframe.bundle.js → layout-stack-stories.799a681c.iframe.bundle.js} +1 -1
  32. package/docs/storybook/{link-link-stories.23f8a587.iframe.bundle.js → link-link-stories.9e3dd976.iframe.bundle.js} +1 -1
  33. package/docs/storybook/{list-list-stories.79350958.iframe.bundle.js → list-list-stories.e906cf67.iframe.bundle.js} +1 -1
  34. package/docs/storybook/{loading-loading-stories.9594d513.iframe.bundle.js → loading-loading-stories.261bc118.iframe.bundle.js} +1 -1
  35. package/docs/storybook/{main.503cfdea.iframe.bundle.js → main.d4ed0d37.iframe.bundle.js} +1 -1
  36. package/docs/storybook/{popover-popover-stories.e8d6e7c9.iframe.bundle.js → popover-popover-stories.cc1684df.iframe.bundle.js} +1 -1
  37. package/docs/storybook/project.json +1 -1
  38. package/docs/storybook/{runtime~main.386e82b8.iframe.bundle.js → runtime~main.2883decf.iframe.bundle.js} +1 -1
  39. package/docs/storybook/{skeleton-skeleton-stories.48ffb189.iframe.bundle.js → skeleton-skeleton-stories.77f9485f.iframe.bundle.js} +1 -1
  40. package/docs/storybook/{slider-slider-stories.f608c3ca.iframe.bundle.js → slider-slider-stories.0a70e102.iframe.bundle.js} +1 -1
  41. package/docs/storybook/stories.json +1 -1
  42. package/docs/storybook/tabs-tabs-stories.183f4129.iframe.bundle.js +1 -0
  43. package/docs/storybook/{theme-theme-stories.781e4fdc.iframe.bundle.js → theme-theme-stories.66e1727e.iframe.bundle.js} +1 -1
  44. package/docs/storybook/{toggle-toggle-stories.7b2e3bc9.iframe.bundle.js → toggle-toggle-stories.def6c644.iframe.bundle.js} +1 -1
  45. package/docs/storybook/toggletip-toggletip-stories.22e37008.iframe.bundle.js +1 -0
  46. package/docs/storybook/{tooltip-definition-tooptip-stories.57864d79.iframe.bundle.js → tooltip-definition-tooptip-stories.2e1a211c.iframe.bundle.js} +1 -1
  47. package/docs/storybook/{tooltip-tooltip-stories.b15c3310.iframe.bundle.js → tooltip-tooltip-stories.6a4a1383.iframe.bundle.js} +1 -1
  48. package/docs/storybook/ui-shell-ui-shell-stories.a1fb87a2.iframe.bundle.js +1 -0
  49. package/esm2020/ui-shell/sidenav/sidenav-item.component.mjs +55 -19
  50. package/esm2020/ui-shell/sidenav/sidenav-menu.component.mjs +11 -3
  51. package/esm2020/ui-shell/sidenav/sidenav.component.mjs +13 -3
  52. package/esm2020/ui-shell/sidenav/sidenav.module.mjs +5 -4
  53. package/fesm2015/carbon-components-angular-ui-shell.mjs +79 -25
  54. package/fesm2015/carbon-components-angular-ui-shell.mjs.map +1 -1
  55. package/fesm2020/carbon-components-angular-ui-shell.mjs +79 -25
  56. package/fesm2020/carbon-components-angular-ui-shell.mjs.map +1 -1
  57. package/package.json +1 -1
  58. package/ui-shell/sidenav/sidenav-item.component.d.ts +8 -4
  59. package/ui-shell/sidenav/sidenav-menu.component.d.ts +6 -2
  60. package/ui-shell/sidenav/sidenav.component.d.ts +5 -1
  61. package/ui-shell/sidenav/sidenav.module.d.ts +2 -1
  62. package/docs/storybook/3348.35ca85d6.iframe.bundle.js +0 -1
  63. package/docs/storybook/tabs-tabs-stories.db9e209e.iframe.bundle.js +0 -1
  64. package/docs/storybook/toggletip-toggletip-stories.1da8eaf1.iframe.bundle.js +0 -1
  65. package/docs/storybook/ui-shell-ui-shell-stories.70551d65.iframe.bundle.js +0 -1
@@ -121,22 +121,37 @@
121
121
 
122
122
  <tr>
123
123
  <td class="col-md-3">template</td>
124
- <td class="col-md-9"><pre class="line-numbers"><code class="language-html">&lt;a
125
- class&#x3D;&quot;cds--side-nav__link&quot;
126
- [ngClass]&#x3D;&quot;{
124
+ <td class="col-md-9"><pre class="line-numbers"><code class="language-html">&lt;a *ngIf&#x3D;&quot;!useRouter; else sidenavItemRouterTpl&quot;
125
+ class&#x3D;&quot;cds--side-nav__link&quot;
126
+ [ngClass]&#x3D;&quot;{
127
127
  &#x27;cds--side-nav__item--active&#x27;: active
128
128
  }&quot;
129
- [href]&#x3D;&quot;href&quot;
130
- [attr.aria-current]&#x3D;&quot;(active ? &#x27;page&#x27; : null)&quot;
131
- [attr.title]&#x3D;&quot;title ? title : null&quot;
132
- (click)&#x3D;&quot;navigate($event)&quot;&gt;
129
+ [href]&#x3D;&quot;href&quot;
130
+ [attr.aria-current]&#x3D;&quot;(active ? &#x27;page&#x27; : null)&quot;
131
+ [attr.title]&#x3D;&quot;title ? title : null&quot;
132
+ (click)&#x3D;&quot;navigate($event)&quot;&gt;
133
+ &lt;ng-template [ngTemplateOutlet]&#x3D;&quot;sidenavItemContentTpl&quot;&gt;&lt;/ng-template&gt;
134
+ &lt;/a&gt;
135
+
136
+ &lt;ng-template #sidenavItemRouterTpl&gt;
137
+ &lt;a
138
+ [routerLink]&#x3D;&quot;route&quot;
139
+ routerLinkActive&#x3D;&quot;cds--side-nav__item--active&quot;
140
+ ariaCurrentWhenActive&#x3D;&quot;page&quot;
141
+ [attr.title]&#x3D;&quot;title ? title : null&quot;
142
+ class&#x3D;&quot;cds--side-nav__link&quot;&gt;
143
+ &lt;ng-template [ngTemplateOutlet]&#x3D;&quot;sidenavItemContentTpl&quot;&gt;&lt;/ng-template&gt;
144
+ &lt;/a&gt;
145
+ &lt;/ng-template&gt;
146
+
147
+ &lt;ng-template #sidenavItemContentTpl&gt;
133
148
  &lt;div *ngIf&#x3D;&quot;!isSubMenu&quot; class&#x3D;&quot;cds--side-nav__icon&quot;&gt;
134
149
  &lt;ng-content select&#x3D;&quot;svg, [icon]&quot;&gt;&lt;/ng-content&gt;
135
150
  &lt;/div&gt;
136
151
  &lt;span class&#x3D;&quot;cds--side-nav__link-text&quot;&gt;
137
152
  &lt;ng-content&gt;&lt;/ng-content&gt;
138
153
  &lt;/span&gt;
139
- &lt;/a&gt;
154
+ &lt;/ng-template&gt;
140
155
  </code></pre></td>
141
156
  </tr>
142
157
 
@@ -220,6 +235,9 @@
220
235
  <li>
221
236
  <a href="#title" >title</a>
222
237
  </li>
238
+ <li>
239
+ <a href="#useRouter" >useRouter</a>
240
+ </li>
223
241
  </ul>
224
242
  </td>
225
243
  </tr>
@@ -299,7 +317,7 @@
299
317
  </tr>
300
318
  <tr>
301
319
  <td class="col-md-4">
302
- <div class="io-line">Defined in <a href="" data-line="103" class="link-to-prism">src/ui-shell/sidenav/sidenav-item.component.ts:103</a></div>
320
+ <div class="io-line">Defined in <a href="" data-line="124" class="link-to-prism">src/ui-shell/sidenav/sidenav-item.component.ts:124</a></div>
303
321
  </td>
304
322
  </tr>
305
323
 
@@ -372,7 +390,7 @@
372
390
  </tr>
373
391
  <tr>
374
392
  <td class="col-md-2" colspan="2">
375
- <div class="io-line">Defined in <a href="" data-line="69" class="link-to-prism">src/ui-shell/sidenav/sidenav-item.component.ts:69</a></div>
393
+ <div class="io-line">Defined in <a href="" data-line="90" class="link-to-prism">src/ui-shell/sidenav/sidenav-item.component.ts:90</a></div>
376
394
  </td>
377
395
  </tr>
378
396
  <tr>
@@ -399,7 +417,7 @@
399
417
  </tr>
400
418
  <tr>
401
419
  <td class="col-md-2" colspan="2">
402
- <div class="io-line">Defined in <a href="" data-line="46" class="link-to-prism">src/ui-shell/sidenav/sidenav-item.component.ts:46</a></div>
420
+ <div class="io-line">Defined in <a href="" data-line="62" class="link-to-prism">src/ui-shell/sidenav/sidenav-item.component.ts:62</a></div>
403
421
  </td>
404
422
  </tr>
405
423
  <tr>
@@ -431,7 +449,7 @@
431
449
  </tr>
432
450
  <tr>
433
451
  <td class="col-md-2" colspan="2">
434
- <div class="io-line">Defined in <a href="" data-line="77" class="link-to-prism">src/ui-shell/sidenav/sidenav-item.component.ts:77</a></div>
452
+ <div class="io-line">Defined in <a href="" data-line="98" class="link-to-prism">src/ui-shell/sidenav/sidenav-item.component.ts:98</a></div>
435
453
  </td>
436
454
  </tr>
437
455
  </tbody>
@@ -452,7 +470,7 @@
452
470
  </tr>
453
471
  <tr>
454
472
  <td class="col-md-2" colspan="2">
455
- <div class="io-line">Defined in <a href="" data-line="75" class="link-to-prism">src/ui-shell/sidenav/sidenav-item.component.ts:75</a></div>
473
+ <div class="io-line">Defined in <a href="" data-line="96" class="link-to-prism">src/ui-shell/sidenav/sidenav-item.component.ts:96</a></div>
456
474
  </td>
457
475
  </tr>
458
476
  <tr>
@@ -480,7 +498,7 @@ See: <a href="https://angular.io/api/router/Router#navigate">https://angular.io/
480
498
  </tr>
481
499
  <tr>
482
500
  <td class="col-md-2" colspan="2">
483
- <div class="io-line">Defined in <a href="" data-line="83" class="link-to-prism">src/ui-shell/sidenav/sidenav-item.component.ts:83</a></div>
501
+ <div class="io-line">Defined in <a href="" data-line="104" class="link-to-prism">src/ui-shell/sidenav/sidenav-item.component.ts:104</a></div>
484
502
  </td>
485
503
  </tr>
486
504
  <tr>
@@ -508,12 +526,44 @@ See: <a href="https://angular.io/api/router/Router#navigate">https://angular.io/
508
526
  </tr>
509
527
  <tr>
510
528
  <td class="col-md-2" colspan="2">
511
- <div class="io-line">Defined in <a href="" data-line="88" class="link-to-prism">src/ui-shell/sidenav/sidenav-item.component.ts:88</a></div>
529
+ <div class="io-line">Defined in <a href="" data-line="109" class="link-to-prism">src/ui-shell/sidenav/sidenav-item.component.ts:109</a></div>
512
530
  </td>
513
531
  </tr>
514
532
  <tr>
515
533
  <td class="col-md-4">
516
534
  <div class="io-description"><p>Title attribute of the anchor element.</p>
535
+ </div>
536
+ </td>
537
+ </tr>
538
+ </tbody>
539
+ </table>
540
+ <table class="table table-sm table-bordered">
541
+ <tbody>
542
+ <tr>
543
+ <td class="col-md-4">
544
+ <a name="useRouter"></a>
545
+ <b>useRouter</b>
546
+ </td>
547
+ </tr>
548
+ <tr>
549
+ <td class="col-md-4">
550
+ <i>Type : </i> <code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/boolean" target="_blank" >boolean</a></code>
551
+
552
+ </td>
553
+ </tr>
554
+ <tr>
555
+ <td class="col-md-4">
556
+ <i>Default value : </i><code>true</code>
557
+ </td>
558
+ </tr>
559
+ <tr>
560
+ <td class="col-md-2" colspan="2">
561
+ <div class="io-line">Defined in <a href="" data-line="77" class="link-to-prism">src/ui-shell/sidenav/sidenav-item.component.ts:77</a></div>
562
+ </td>
563
+ </tr>
564
+ <tr>
565
+ <td class="col-md-4">
566
+ <div class="io-description"><p>Use the routerLink attribute on <a> tag for navigation instead of using event handlers</p>
517
567
  </div>
518
568
  </td>
519
569
  </tr>
@@ -538,7 +588,7 @@ See: <a href="https://angular.io/api/router/Router#navigate">https://angular.io/
538
588
  </tr>
539
589
  <tr>
540
590
  <td class="col-md-2" colspan="2">
541
- <div class="io-line">Defined in <a href="" data-line="93" class="link-to-prism">src/ui-shell/sidenav/sidenav-item.component.ts:93</a></div>
591
+ <div class="io-line">Defined in <a href="" data-line="114" class="link-to-prism">src/ui-shell/sidenav/sidenav-item.component.ts:114</a></div>
542
592
  </td>
543
593
  </tr>
544
594
  <tr>
@@ -565,7 +615,7 @@ See: <a href="https://angular.io/api/router/Router#navigate">https://angular.io/
565
615
  </tr>
566
616
  <tr>
567
617
  <td class="col-md-2" colspan="2">
568
- <div class="io-line">Defined in <a href="" data-line="99" class="link-to-prism">src/ui-shell/sidenav/sidenav-item.component.ts:99</a></div>
618
+ <div class="io-line">Defined in <a href="" data-line="120" class="link-to-prism">src/ui-shell/sidenav/sidenav-item.component.ts:120</a></div>
569
619
  </td>
570
620
  </tr>
571
621
  <tr>
@@ -603,7 +653,7 @@ child sidenav item is active or not active.</p>
603
653
  </tr>
604
654
  <tr>
605
655
  <td class="col-md-4">
606
- <div class="io-line">Defined in <a href="" data-line="101" class="link-to-prism">src/ui-shell/sidenav/sidenav-item.component.ts:101</a></div>
656
+ <div class="io-line">Defined in <a href="" data-line="122" class="link-to-prism">src/ui-shell/sidenav/sidenav-item.component.ts:122</a></div>
607
657
  </td>
608
658
  </tr>
609
659
 
@@ -629,7 +679,7 @@ child sidenav item is active or not active.</p>
629
679
  </tr>
630
680
  <tr>
631
681
  <td class="col-md-4">
632
- <div class="io-line">Defined in <a href="" data-line="58" class="link-to-prism">src/ui-shell/sidenav/sidenav-item.component.ts:58</a></div>
682
+ <div class="io-line">Defined in <a href="" data-line="79" class="link-to-prism">src/ui-shell/sidenav/sidenav-item.component.ts:79</a></div>
633
683
  </td>
634
684
  </tr>
635
685
 
@@ -655,7 +705,7 @@ child sidenav item is active or not active.</p>
655
705
  </tr>
656
706
  <tr>
657
707
  <td class="col-md-4">
658
- <div class="io-line">Defined in <a href="" data-line="62" class="link-to-prism">src/ui-shell/sidenav/sidenav-item.component.ts:62</a></div>
708
+ <div class="io-line">Defined in <a href="" data-line="83" class="link-to-prism">src/ui-shell/sidenav/sidenav-item.component.ts:83</a></div>
659
709
  </td>
660
710
  </tr>
661
711
 
@@ -683,15 +733,15 @@ child sidenav item is active or not active.</p>
683
733
  </tr>
684
734
  <tr>
685
735
  <td class="col-md-4">
686
- <code>navigate(event)</code>
736
+ <code>navigate(event: MouseEvent)</code>
687
737
  </td>
688
738
  </tr>
689
739
 
690
740
 
691
741
  <tr>
692
742
  <td class="col-md-4">
693
- <div class="io-line">Defined in <a href="" data-line="113"
694
- class="link-to-prism">src/ui-shell/sidenav/sidenav-item.component.ts:113</a></div>
743
+ <div class="io-line">Defined in <a href="" data-line="134"
744
+ class="link-to-prism">src/ui-shell/sidenav/sidenav-item.component.ts:134</a></div>
695
745
  </td>
696
746
  </tr>
697
747
 
@@ -706,12 +756,16 @@ child sidenav item is active or not active.</p>
706
756
  <thead>
707
757
  <tr>
708
758
  <td>Name</td>
759
+ <td>Type</td>
709
760
  <td>Optional</td>
710
761
  </tr>
711
762
  </thead>
712
763
  <tbody>
713
764
  <tr>
714
765
  <td>event</td>
766
+ <td>
767
+ <code>MouseEvent</code>
768
+ </td>
715
769
 
716
770
  <td>
717
771
  No
@@ -748,15 +802,15 @@ child sidenav item is active or not active.</p>
748
802
  </tr>
749
803
  <tr>
750
804
  <td class="col-md-4">
751
- <code>ngOnChanges(changes)</code>
805
+ <code>ngOnChanges(changes: SimpleChanges)</code>
752
806
  </td>
753
807
  </tr>
754
808
 
755
809
 
756
810
  <tr>
757
811
  <td class="col-md-4">
758
- <div class="io-line">Defined in <a href="" data-line="107"
759
- class="link-to-prism">src/ui-shell/sidenav/sidenav-item.component.ts:107</a></div>
812
+ <div class="io-line">Defined in <a href="" data-line="128"
813
+ class="link-to-prism">src/ui-shell/sidenav/sidenav-item.component.ts:128</a></div>
760
814
  </td>
761
815
  </tr>
762
816
 
@@ -771,12 +825,16 @@ child sidenav item is active or not active.</p>
771
825
  <thead>
772
826
  <tr>
773
827
  <td>Name</td>
828
+ <td>Type</td>
774
829
  <td>Optional</td>
775
830
  </tr>
776
831
  </thead>
777
832
  <tbody>
778
833
  <tr>
779
834
  <td>changes</td>
835
+ <td>
836
+ <code>SimpleChanges</code>
837
+ </td>
780
838
 
781
839
  <td>
782
840
  No
@@ -831,7 +889,7 @@ child sidenav item is active or not active.</p>
831
889
  </tr>
832
890
  <tr>
833
891
  <td class="col-md-4">
834
- <div class="io-line">Defined in <a href="" data-line="103" class="link-to-prism">src/ui-shell/sidenav/sidenav-item.component.ts:103</a></div>
892
+ <div class="io-line">Defined in <a href="" data-line="124" class="link-to-prism">src/ui-shell/sidenav/sidenav-item.component.ts:124</a></div>
835
893
  </td>
836
894
  </tr>
837
895
 
@@ -872,7 +930,7 @@ child sidenav item is active or not active.</p>
872
930
  </tr>
873
931
  <tr>
874
932
  <td class="col-md-4">
875
- <div class="io-line">Defined in <a href="" data-line="101" class="link-to-prism">src/ui-shell/sidenav/sidenav-item.component.ts:101</a></div>
933
+ <div class="io-line">Defined in <a href="" data-line="122" class="link-to-prism">src/ui-shell/sidenav/sidenav-item.component.ts:122</a></div>
876
934
  </td>
877
935
  </tr>
878
936
 
@@ -901,7 +959,7 @@ child sidenav item is active or not active.</p>
901
959
  </tr>
902
960
  <tr>
903
961
  <td class="col-md-4">
904
- <div class="io-line">Defined in <a href="" data-line="54" class="link-to-prism">src/ui-shell/sidenav/sidenav-item.component.ts:54</a></div>
962
+ <div class="io-line">Defined in <a href="" data-line="70" class="link-to-prism">src/ui-shell/sidenav/sidenav-item.component.ts:70</a></div>
905
963
  </td>
906
964
  </tr>
907
965
 
@@ -912,7 +970,7 @@ child sidenav item is active or not active.</p>
912
970
  </tr>
913
971
  <tr>
914
972
  <td class="col-md-4">
915
- <div class="io-line">Defined in <a href="" data-line="46" class="link-to-prism">src/ui-shell/sidenav/sidenav-item.component.ts:46</a></div>
973
+ <div class="io-line">Defined in <a href="" data-line="62" class="link-to-prism">src/ui-shell/sidenav/sidenav-item.component.ts:62</a></div>
916
974
  </td>
917
975
  </tr>
918
976
  <tr>
@@ -972,7 +1030,7 @@ child sidenav item is active or not active.</p>
972
1030
  </tr>
973
1031
  <tr>
974
1032
  <td class="col-md-4">
975
- <div class="io-line">Defined in <a href="" data-line="58" class="link-to-prism">src/ui-shell/sidenav/sidenav-item.component.ts:58</a></div>
1033
+ <div class="io-line">Defined in <a href="" data-line="79" class="link-to-prism">src/ui-shell/sidenav/sidenav-item.component.ts:79</a></div>
976
1034
  </td>
977
1035
  </tr>
978
1036
 
@@ -994,7 +1052,7 @@ child sidenav item is active or not active.</p>
994
1052
  </tr>
995
1053
  <tr>
996
1054
  <td class="col-md-4">
997
- <div class="io-line">Defined in <a href="" data-line="62" class="link-to-prism">src/ui-shell/sidenav/sidenav-item.component.ts:62</a></div>
1055
+ <div class="io-line">Defined in <a href="" data-line="83" class="link-to-prism">src/ui-shell/sidenav/sidenav-item.component.ts:83</a></div>
998
1056
  </td>
999
1057
  </tr>
1000
1058
 
@@ -1012,7 +1070,8 @@ child sidenav item is active or not active.</p>
1012
1070
  Output,
1013
1071
  EventEmitter,
1014
1072
  OnChanges,
1015
- HostBinding
1073
+ HostBinding,
1074
+ SimpleChanges
1016
1075
  } from &quot;@angular/core&quot;;
1017
1076
  import { DomSanitizer } from &quot;@angular/platform-browser&quot;;
1018
1077
  import { Router } from &quot;@angular/router&quot;;
@@ -1023,22 +1082,37 @@ import { Router } from &quot;@angular/router&quot;;
1023
1082
  @Component({
1024
1083
  selector: &quot;cds-sidenav-item, ibm-sidenav-item&quot;,
1025
1084
  template: &#x60;
1026
- &lt;a
1027
- class&#x3D;&quot;cds--side-nav__link&quot;
1028
- [ngClass]&#x3D;&quot;{
1085
+ &lt;a *ngIf&#x3D;&quot;!useRouter; else sidenavItemRouterTpl&quot;
1086
+ class&#x3D;&quot;cds--side-nav__link&quot;
1087
+ [ngClass]&#x3D;&quot;{
1029
1088
  &#x27;cds--side-nav__item--active&#x27;: active
1030
1089
  }&quot;
1031
- [href]&#x3D;&quot;href&quot;
1032
- [attr.aria-current]&#x3D;&quot;(active ? &#x27;page&#x27; : null)&quot;
1033
- [attr.title]&#x3D;&quot;title ? title : null&quot;
1034
- (click)&#x3D;&quot;navigate($event)&quot;&gt;
1090
+ [href]&#x3D;&quot;href&quot;
1091
+ [attr.aria-current]&#x3D;&quot;(active ? &#x27;page&#x27; : null)&quot;
1092
+ [attr.title]&#x3D;&quot;title ? title : null&quot;
1093
+ (click)&#x3D;&quot;navigate($event)&quot;&gt;
1094
+ &lt;ng-template [ngTemplateOutlet]&#x3D;&quot;sidenavItemContentTpl&quot;&gt;&lt;/ng-template&gt;
1095
+ &lt;/a&gt;
1096
+
1097
+ &lt;ng-template #sidenavItemRouterTpl&gt;
1098
+ &lt;a
1099
+ [routerLink]&#x3D;&quot;route&quot;
1100
+ routerLinkActive&#x3D;&quot;cds--side-nav__item--active&quot;
1101
+ ariaCurrentWhenActive&#x3D;&quot;page&quot;
1102
+ [attr.title]&#x3D;&quot;title ? title : null&quot;
1103
+ class&#x3D;&quot;cds--side-nav__link&quot;&gt;
1104
+ &lt;ng-template [ngTemplateOutlet]&#x3D;&quot;sidenavItemContentTpl&quot;&gt;&lt;/ng-template&gt;
1105
+ &lt;/a&gt;
1106
+ &lt;/ng-template&gt;
1107
+
1108
+ &lt;ng-template #sidenavItemContentTpl&gt;
1035
1109
  &lt;div *ngIf&#x3D;&quot;!isSubMenu&quot; class&#x3D;&quot;cds--side-nav__icon&quot;&gt;
1036
1110
  &lt;ng-content select&#x3D;&quot;svg, [icon]&quot;&gt;&lt;/ng-content&gt;
1037
1111
  &lt;/div&gt;
1038
1112
  &lt;span class&#x3D;&quot;cds--side-nav__link-text&quot;&gt;
1039
1113
  &lt;ng-content&gt;&lt;/ng-content&gt;
1040
1114
  &lt;/span&gt;
1041
- &lt;/a&gt;
1115
+ &lt;/ng-template&gt;
1042
1116
  &#x60;,
1043
1117
  styles: [&#x60;
1044
1118
  :host {
@@ -1062,6 +1136,11 @@ export class SideNavItem implements OnChanges {
1062
1136
  return this.domSanitizer.bypassSecurityTrustUrl(this._href) as string;
1063
1137
  }
1064
1138
 
1139
+ /**
1140
+ * Use the routerLink attribute on &lt;a&gt; tag for navigation instead of using event handlers
1141
+ */
1142
+ @Input() useRouter &#x3D; true;
1143
+
1065
1144
  @HostBinding(&quot;class.cds--side-nav__item&quot;) get sideNav() {
1066
1145
  return !this.isSubMenu;
1067
1146
  }
@@ -1111,13 +1190,13 @@ export class SideNavItem implements OnChanges {
1111
1190
 
1112
1191
  constructor(protected domSanitizer: DomSanitizer, @Optional() protected router: Router) {}
1113
1192
 
1114
- ngOnChanges(changes) {
1193
+ ngOnChanges(changes: SimpleChanges) {
1115
1194
  if (changes.active) {
1116
1195
  this.selected.emit(this.active);
1117
1196
  }
1118
1197
  }
1119
1198
 
1120
- navigate(event) {
1199
+ navigate(event: MouseEvent) {
1121
1200
  if (this.router &amp;&amp; this.route) {
1122
1201
  event.preventDefault();
1123
1202
  const status &#x3D; this.router.navigate(this.route, this.routeExtras);
@@ -1165,7 +1244,7 @@ export class SideNavItem implements OnChanges {
1165
1244
  <script src="../js/libs/htmlparser.js"></script>
1166
1245
  <script src="../js/libs/deep-iterator.js"></script>
1167
1246
  <script>
1168
- var COMPONENT_TEMPLATE = '<div><a class="cds--side-nav__link" [ngClass]="{ \'cds--side-nav__item--active\': active }" [href]="href" [attr.aria-current]="(active ? \'page\' : null)" [attr.title]="title ? title : null" (click)="navigate($event)"> <div *ngIf="!isSubMenu" class="cds--side-nav__icon"> <ng-content select="svg, [icon]"></ng-content> </div> <span class="cds--side-nav__link-text"> <ng-content></ng-content> </span></a> </div>'
1247
+ var COMPONENT_TEMPLATE = '<div><a *ngIf="!useRouter; else sidenavItemRouterTpl" class="cds--side-nav__link" [ngClass]="{ \'cds--side-nav__item--active\': active }" [href]="href" [attr.aria-current]="(active ? \'page\' : null)" [attr.title]="title ? title : null" (click)="navigate($event)"> <ng-template [ngTemplateOutlet]="sidenavItemContentTpl"></ng-template></a><ng-template #sidenavItemRouterTpl> <a [routerLink]="route" routerLinkActive="cds--side-nav__item--active" ariaCurrentWhenActive="page" [attr.title]="title ? title : null" class="cds--side-nav__link"> <ng-template [ngTemplateOutlet]="sidenavItemContentTpl"></ng-template> </a></ng-template><ng-template #sidenavItemContentTpl> <div *ngIf="!isSubMenu" class="cds--side-nav__icon"> <ng-content select="svg, [icon]"></ng-content> </div> <span class="cds--side-nav__link-text"> <ng-content></ng-content> </span></ng-template> </div>'
1169
1248
  var COMPONENTS = [{'name': 'Accordion', 'selector': 'cds-accordion, ibm-accordion'},{'name': 'AccordionItem', 'selector': 'cds-accordion-item, ibm-accordion-item'},{'name': 'ActionableNotification', 'selector': 'cds-actionable-notification, ibm-actionable-notification'},{'name': 'AlertModal', 'selector': 'cds-alert-modal, ibm-alert-modal'},{'name': 'BaseIconButton', 'selector': ''},{'name': 'BaseNotification', 'selector': ''},{'name': 'BaseTabHeader', 'selector': ''},{'name': 'Breadcrumb', 'selector': 'cds-breadcrumb, ibm-breadcrumb'},{'name': 'BreadcrumbItemComponent', 'selector': 'cds-breadcrumb-item, ibm-breadcrumb-item'},{'name': 'ButtonSet', 'selector': 'cds-button-set, ibm-button-set'},{'name': 'Checkbox', 'selector': 'cds-checkbox, ibm-checkbox'},{'name': 'ClickableTile', 'selector': 'cds-clickable-tile, ibm-clickable-tile'},{'name': 'CodeSnippet', 'selector': 'cds-code-snippet, ibm-code-snippet'},{'name': 'ComboBox', 'selector': 'cds-combo-box, ibm-combo-box'},{'name': 'ContainedList', 'selector': 'cds-contained-list, ibm-contained-list'},{'name': 'ContainedListItem', 'selector': 'cds-contained-list-item, ibm-contained-list-item'},{'name': 'ContentSwitcher', 'selector': 'cds-content-switcher, ibm-content-switcher'},{'name': 'ContextMenuComponent', 'selector': 'cds-context-menu, ibm-context-menu'},{'name': 'ContextMenuDividerComponent', 'selector': 'cds-context-menu-divider, ibm-context-menu-divider'},{'name': 'ContextMenuGroupComponent', 'selector': 'cds-context-menu-group, ibm-context-menu-group'},{'name': 'ContextMenuItemComponent', 'selector': 'cds-context-menu-item, ibm-context-menu-item'},{'name': 'DatePicker', 'selector': 'cds-date-picker, ibm-date-picker'},{'name': 'DatePickerInput', 'selector': 'cds-date-picker-input, ibm-date-picker-input'},{'name': 'Dialog', 'selector': 'cds-dialog, ibm-dialog'},{'name': 'Documentation', 'selector': 'cds-documentation'},{'name': 'Dropdown', 'selector': 'cds-dropdown, ibm-dropdown'},{'name': 'DropdownList', 'selector': 'cds-dropdown-list, ibm-dropdown-list'},{'name': 'ExpandableTile', 'selector': 'cds-expandable-tile, ibm-expandable-tile'},{'name': 'FileComponent', 'selector': 'cds-file, ibm-file'},{'name': 'FileUploader', 'selector': 'cds-file-uploader, ibm-file-uploader'},{'name': 'Hamburger', 'selector': 'cds-hamburger, ibm-hamburger'},{'name': 'Header', 'selector': 'cds-header, ibm-header'},{'name': 'HeaderAction', 'selector': 'cds-header-action, ibm-header-action'},{'name': 'HeaderGlobal', 'selector': 'cds-header-global, ibm-header-global'},{'name': 'HeaderItem', 'selector': 'cds-header-item, ibm-header-item'},{'name': 'HeaderMenu', 'selector': 'cds-header-menu, ibm-header-menu'},{'name': 'HeaderNavigation', 'selector': 'cds-header-navigation, ibm-header-navigation'},{'name': 'IconButton', 'selector': 'cds-icon-button, ibm-icon-button'},{'name': 'InlineLoading', 'selector': 'cds-inline-loading, ibm-inline-loading'},{'name': 'Label', 'selector': 'cds-label, ibm-label'},{'name': 'ListColumn', 'selector': 'cds-list-column, ibm-list-column'},{'name': 'ListHeader', 'selector': 'cds-list-header, ibm-list-header'},{'name': 'ListRow', 'selector': 'cds-list-row, ibm-list-row'},{'name': 'Loading', 'selector': 'cds-loading, ibm-loading'},{'name': 'Modal', 'selector': 'cds-modal, ibm-modal'},{'name': 'ModalFooter', 'selector': 'cds-modal-footer, ibm-modal-footer'},{'name': 'ModalHeader', 'selector': 'cds-modal-header, ibm-modal-header'},{'name': 'Notification', 'selector': 'cds-notification, cds-inline-notification, ibm-notification, ibm-inline-notification'},{'name': 'NumberComponent', 'selector': 'cds-number, ibm-number'},{'name': 'OverflowMenu', 'selector': 'cds-overflow-menu, ibm-overflow-menu'},{'name': 'OverflowMenuCustomPane', 'selector': 'cds-overflow-custom-menu-pane, ibm-overflow-custom-menu-pane'},{'name': 'OverflowMenuOption', 'selector': 'cds-overflow-menu-option, ibm-overflow-menu-option'},{'name': 'OverflowMenuPane', 'selector': 'cds-overflow-menu-pane, ibm-overflow-menu-pane'},{'name': 'Overlay', 'selector': 'cds-overlay, ibm-overlay'},{'name': 'Pagination', 'selector': 'cds-pagination, ibm-pagination'},{'name': 'PaginationNav', 'selector': 'cds-pagination-nav, ibm-pagination-navm'},{'name': 'PaginationNavItem', 'selector': 'cds-pagination-nav-item, ibm-pagination-nav-item'},{'name': 'PaginationOverflow', 'selector': 'cds-pagination-overflow, ibm-pagination-overflow'},{'name': 'Panel', 'selector': 'cds-panel, ibm-panel'},{'name': 'Placeholder', 'selector': 'cds-placeholder, ibm-placeholder'},{'name': 'PopoverContent', 'selector': 'cds-popover-content, ibm-popover-content'},{'name': 'ProgressBar', 'selector': 'cds-progress-bar, ibm-progress-bar'},{'name': 'ProgressIndicator', 'selector': 'cds-progress-indicator, ibm-progress-indicator'},{'name': 'Radio', 'selector': 'cds-radio, ibm-radio'},{'name': 'RadioGroup', 'selector': 'cds-radio-group, ibm-radio-group'},{'name': 'Search', 'selector': 'cds-search, ibm-search'},{'name': 'Select', 'selector': 'cds-select, ibm-select'},{'name': 'SelectionTile', 'selector': 'cds-selection-tile, ibm-selection-tile'},{'name': 'SideNav', 'selector': 'cds-sidenav, ibm-sidenav'},{'name': 'SideNavItem', 'selector': 'cds-sidenav-item, ibm-sidenav-item'},{'name': 'SideNavMenu', 'selector': 'cds-sidenav-menu, ibm-sidenav-menu'},{'name': 'SkeletonPlaceholder', 'selector': 'cds-skeleton-placeholder, ibm-skeleton-placeholder'},{'name': 'SkeletonText', 'selector': 'cds-skeleton-text, ibm-skeleton-text'},{'name': 'Slider', 'selector': 'cds-slider, ibm-slider'},{'name': 'StructuredList', 'selector': 'cds-structured-list, ibm-structured-list'},{'name': 'SwitcherList', 'selector': 'cds-switcher-list, ibm-switcher-list'},{'name': 'SwitcherListItem', 'selector': 'cds-switcher-list-item, ibm-switcher-list-item'},{'name': 'Tab', 'selector': 'cds-tab, ibm-tab'},{'name': 'TabHeaderGroup', 'selector': 'cds-tab-header-group, ibm-tab-header-group'},{'name': 'TabHeaders', 'selector': 'cds-tab-headers, ibm-tab-headers'},{'name': 'Table', 'selector': 'cds-table, ibm-table'},{'name': 'TableBody', 'selector': '[cdsTableBody], [ibmTableBody]'},{'name': 'TableCheckbox', 'selector': '[cdsTableCheckbox], [ibmTableCheckbox]'},{'name': 'TableContainer', 'selector': 'cds-table-container, ibm-table-container'},{'name': 'TableData', 'selector': '[cdsTableData], [ibmTableData]'},{'name': 'TableExpandButton', 'selector': '[cdsTableExpandButton], [ibmTableExpandButton]'},{'name': 'TableExpandedRow', 'selector': '[cdsTableExpandedRow], [ibmTableExpandedRow]'},{'name': 'TableHead', 'selector': '[cdsTableHead], [ibmTableHead]'},{'name': 'TableHeadCell', 'selector': '[cdsTableHeadCell], [ibmTableHeadCell]'},{'name': 'TableHeadCheckbox', 'selector': '[cdsTableHeadCheckbox], [ibmTableHeadCheckbox]'},{'name': 'TableHeader', 'selector': 'cds-table-header, ibm-table-header'},{'name': 'TableHeadExpand', 'selector': '[cdsTableHeadExpand], [ibmTableHeadExpand]'},{'name': 'TableRadio', 'selector': '[cdsTableRadio], [ibmTableRadio]'},{'name': 'TableRowComponent', 'selector': '[cdsTableRow], [ibmTableRow]'},{'name': 'TableToolbar', 'selector': 'cds-table-toolbar, ibm-table-toolbar'},{'name': 'TableToolbarActions', 'selector': 'cds-table-toolbar-actions, ibm-table-toolbar-actions'},{'name': 'TableToolbarContent', 'selector': 'cds-table-toolbar-content, ibm-table-toolbar-content'},{'name': 'TableToolbarSearch', 'selector': 'cds-table-toolbar-search, ibm-table-toolbar-search'},{'name': 'Tabs', 'selector': 'cds-tabs, ibm-tabs'},{'name': 'TabSkeleton', 'selector': 'cds-tabs-skeleton, ibm-tabs-skeleton'},{'name': 'Tag', 'selector': 'cds-tag, ibm-tag'},{'name': 'TagFilter', 'selector': 'cds-tag-filter, ibm-tag-filter'},{'name': 'TextareaLabelComponent', 'selector': 'cds-textarea-label, ibm-textarea-label'},{'name': 'TextInputLabelComponent', 'selector': 'cds-text-label, ibm-text-label'},{'name': 'Tile', 'selector': 'cds-tile, ibm-tile'},{'name': 'TileGroup', 'selector': 'cds-tile-group, ibm-tile-group'},{'name': 'TimePicker', 'selector': 'cds-timepicker, ibm-timepicker'},{'name': 'TimePickerSelect', 'selector': 'cds-timepicker-select, ibm-timepicker-select'},{'name': 'Toast', 'selector': 'cds-toast, ibm-toast'},{'name': 'Toggle', 'selector': 'cds-toggle, ibm-toggle'},{'name': 'Toggletip', 'selector': 'cds-toggletip, ibm-toggletip'},{'name': 'Tooltip', 'selector': 'cds-tooltip, ibm-tooltip'},{'name': 'TooltipDefinition', 'selector': 'cds-tooltip-definition, ibm-tooltip-definition'},{'name': 'TreeNodeComponent', 'selector': 'cds-tree-node'},{'name': 'TreeViewComponent', 'selector': 'cds-tree-view'}];
1170
1249
  var DIRECTIVES = [{'name': 'AbstractDropdownView', 'selector': '[cdsAbstractDropdownView], [ibmAbstractDropdownView]'},{'name': 'ActionableButton', 'selector': '[cdsActionableButton], [ibmActionableButton]'},{'name': 'ActionableSubtitle', 'selector': '[cdsActionableSubtitle], [ibmActionableSubtitle]'},{'name': 'ActionableTitle', 'selector': '[cdsActionableTitle], [ibmActionableTitle]'},{'name': 'BaseModal', 'selector': '[cdsBaseModal], [ibmBaseModal]'},{'name': 'Button', 'selector': '[cdsButton], [ibmButton]'},{'name': 'ColumnDirective', 'selector': '[cdsCol], [ibmCol]'},{'name': 'ContentSwitcherOption', 'selector': '[cdsContentOption], [ibmContentOption]'},{'name': 'DialogDirective', 'selector': '[cdsDialog], [ibmDialog]'},{'name': 'ExpandableTileAboveFoldDirective', 'selector': '[cdsAboveFold], [ibmAboveFold]'},{'name': 'ExpandableTileBelowFoldDirective', 'selector': '[cdsBelowFold], [ibmBelowFold]'},{'name': 'ExpandedRowHover', 'selector': '[cdsExpandedRowHover], [ibmExpandedRowHover]'},{'name': 'GridDirective', 'selector': '[cdsGrid], [ibmGrid]'},{'name': 'IconDirective', 'selector': '[cdsIcon], [ibmIcon]'},{'name': 'LayerDirective', 'selector': '[cdsLayer], [ibmLayer]'},{'name': 'Link', 'selector': '[cdsLink], [ibmLink]'},{'name': 'List', 'selector': '[cdsList], [ibmList]'},{'name': 'ListItemDirective', 'selector': '[cdsListItem], [ibmListItem]'},{'name': 'ModalContent', 'selector': '[cdsModalContent], [ibmModalContent]'},{'name': 'ModalContentText', 'selector': '[cdsModalContentText], [ibmModalContentText]'},{'name': 'ModalHeaderHeading', 'selector': '[cdsModalHeaderHeading], [ibmModalHeaderHeading]'},{'name': 'ModalHeaderLabel', 'selector': '[cdsModalHeaderLabel], [ibmModalHeaderLabel]'},{'name': 'NotificationSubtitle', 'selector': '[cdsNotificationSubtitle], [ibmNotificationSubtitle]'},{'name': 'NotificationTitle', 'selector': '[cdsNotificationTitle], [ibmNotificationTitle]'},{'name': 'OptGroup', 'selector': 'optgroup'},{'name': 'Option', 'selector': 'option'},{'name': 'OverflowMenuDirective', 'selector': '[cdsOverflowMenu], [ibmOverflowMenu]'},{'name': 'PopoverContainer', 'selector': '[cdsPopover], [ibmPopover]'},{'name': 'RowDirective', 'selector': '[cdsRow], [ibmRow]'},{'name': 'ScrollableList', 'selector': '[cdsScrollableList], [ibmScrollableList]'},{'name': 'StackDirective', 'selector': '[cdsStack], [ibmStack]'},{'name': 'TabHeader', 'selector': '[cdsTabHeader], [ibmTabHeader]'},{'name': 'TableDirective', 'selector': '[cdsTable], [ibmTable]'},{'name': 'TableHeadCellLabel', 'selector': '[cdsTableHeadCellLabel], [ibmTableHeadCellLabel]'},{'name': 'TableHeaderDescription', 'selector': '[cdsTableHeaderDescription], [ibmTableHeaderDescription]'},{'name': 'TableHeaderTitle', 'selector': '[cdsTableHeaderTitle], [ibmTableHeaderTitle]'},{'name': 'TextArea', 'selector': '[cdsTextArea], [ibmTextArea]'},{'name': 'TextInput', 'selector': '[cdsText], [ibmText]'},{'name': 'ThemeDirective', 'selector': '[cdsTheme], [ibmTheme]'},{'name': 'ToastCaption', 'selector': '[cdsToastCaption], [ibmToastCaption]'},{'name': 'ToastSubtitle', 'selector': '[cdsToastSubtitle], [ibmToastSubtitle]'},{'name': 'ToastTitle', 'selector': '[cdsToastTitle], [ibmToastTitle]'},{'name': 'ToggletipAction', 'selector': '[cdsToggletipAction], [ibmToggletipAction]'},{'name': 'ToggletipButton', 'selector': '[cdsToggletipButton], [ibmToggletipButton]'},{'name': 'ToggletipContent', 'selector': '[cdsToggletipContent], [ibmToggletipContent]'},{'name': 'ToggletipLabel', 'selector': '[cdsToggletipLabel], [ibmToggletipLabel]'}];
1171
1250
  var ACTUAL_COMPONENT = {'name': 'SideNavItem'};