feat(navController): navController insert method

ionic/components/nav/nav-controller.ts

@@ -159,6 +159,27 @@ export class NavController extends Ion {
    * @param {TODO} [opts={}]  TODO
    * @returns {Promise} TODO
    */
+
+  insert(componentType, index) {
+    if (!componentType || index < 0) {
+      return Promise.reject();
+    }
+
+    // push it onto the end
+    if (index >= this.views.length) {
+      return this.push(componentType);
+    }
+
+    // create new ViewController, but don't render yet
+    let viewCtrl = new ViewController(this, componentType);
+    viewCtrl.state = CACHED_STATE;
+    viewCtrl.shouldDestroy = false;
+    viewCtrl.shouldCache = false;
+
+    this._incrementId(viewCtrl);
+    this.views.splice(index, 0, viewCtrl);
+  }
+
   setViews(components, opts = {}) {
     if (!components || !components.length) {
       return Promise.resolve();
@@ -668,10 +689,14 @@ export class NavController extends Ion {
    * @returns {TODO} TODO
    */
   add(view) {
-    view.id = this.id + '-' + (++this._ids);
+    this._incrementId(view);
     this.views.push(view);
   }
 
+  _incrementId(view) {
+    view.id = this.id + '-' + (++this._ids);
+  }
+
   /**
    * TODO
    * @param {TODO} viewOrIndex  TODO

ionic/components/nav/test/basic/index.ts

@@ -100,6 +100,7 @@ class SecondPage {
     <ion-content padding>
       <p>
         <button id="from3To2" (click)="pop()">Pop (Go back to 2nd)</button>
+        <button id="insert" (click)="insert()">Insert first page into history before this</button>
       </p>
       <div class="yellow"><f></f><f></f><f></f><f></f><f></f><f></f><f></f><f></f><f></f><f></f><f></f><f></f><f></f><f></f><f></f><f></f><f></f><f></f><f></f><f></f></div>
     </ion-content>
@@ -116,6 +117,10 @@ class ThirdPage {
     this.nav.pop()
   }
 
+  insert() {
+    this.nav.insert(FirstPage, 2);
+  }
+
 }