Files
ionic-framework/js/angular/directive/slide.js
Andrew 7ef9ad74cf fix(slidebox): refactor for performance and stability
Closes #2336. Closes #2317. Closes #2290. Closes #2228. Closes #2067.
Closes #1890. Closes #1865. Closes #1850. Closes #1755. Closes #1688.
Closes #1578. Closes #1501. Closes #1353. Closes #1342. Closes #782.
Closes #416. Closes #2288.

BREAKING CHANGE: The slideBox's API has undergone many changes.

- **`<ion-slide-box>`** attributes have changed (see
  [documentation](http://ionicframework.com/docs/api/directive/ionSlideBox)):

  * `active-slide` has changed to `selected`. Change your code from
  this:

    ```html
    <ion-slide-box active-slide="activeSlideIndex"></ion-slide-box>
    ```

    To this:

    ```html
    <ion-slide-box selected="activeSlideIndex"></ion-slide-box>
    ```

  * `does-continue` has changed to `loop`.  Change your code from this:

    ```html
    <ion-slide-box does-continue="shouldLoop"></ion-slide-box>
    ```

    To this:

    ```html
    <ion-slide-box loop="shouldLoop"></ion-slide-box>
    ```

  * `auto-play` and `slide-interval` have been merged into `auto-play`.
  Change your code from this:

    ```html
    <!-- autoPlay is on -->
    <ion-slide-box auto-play="true" slide-interval="1000">
    </ion-slide-box>
    <!-- autoPlay is off -->
    <ion-slide-box auto-play="false" slide-interval="1000">
    </ion-slide-box>
    ```

    To this:

    ```html
    <!-- autoPlay is on -->
    <ion-slide-box auto-play="1000"></ion-slide-box>
    <!-- autoPlay is off -->
    <ion-slide-box auto-play="false"></ion-slide-box>
    ```

  * `show-pager` and `pager-click` have been removed. Use
  a child `<ion-slide-pager>` element. See the [`ion-slide-pager`
  documentation](http://ionicframework.com/docs/api/directive/ionSlidePager).
  Change your code from this:

  ```html
  <!-- pager using default click action -->
  <ion-slide-box show-pager="true">
  </ion-slide-box>
  <!-- pager with custom click action -->
  <ion-slide-box show-pager="true" pager-click="doSomething(index)">
  </ion-slide-box>
  ```

  To this:

  ```html
  <ion-slide-box>
    <!-- pager using default click action -->
    <ion-slide-pager></ion-slide-pager>
  </ion-slide-box>
  <ion-slide-box>
    <!-- pager with custom click action -->
    <ion-slide-pager ng-click="doSomething(index)"></ion-slide-pager>
  </ion-slide-box>
  ```

- **`$ionicSlideBoxDelegate`** methods have changed (see
  [documentation](http://ionicframework.com/docs/api/service/$ionicSlideBoxDelegate)):

  - `update()` has been removed. slideBox updates on its own now.

  - `stop()` has been removed. See `autoPlay()` below.

  - `start()` hass been removed. See `autoPlay()` below.

  - `slide(newIndex[, speed])` has been renamed to `select(newIndex[,
    speed]);

  - `currentIndex()` has been renamed to `selected()`.

  - `slidesCount()` has been renamed to `count()`.

  - New method `$ionicSlideBoxDelegate.autoPlay()`. Change your code
    from this:

    ```js
    // stop auto sliding
    $ionicSlideBoxDelegate.stop();
    // later... start auto sliding
    $ionicSlideBoxDelegate.start();
    ```

    To this:

    ```js
    var autoPlaySpeed = 3000; //wait 3000 seconds between changing slide
    // stop auto sliding
    $ionicSlideBoxDelegate.autoPlay(false);
    // later... start auto sliding
    $ionicSlideBoxDelegate.autoPlay(autoPlaySpeed);
    ```

  - `previous()` now returns the index of the previous slide and does
    not select. Change your code from this:

    ```js
    // select previous slide
    $ionicSlideBoxDelegate.previous();
    ```

    To this:

    ```js
    // select previous slide
    $ionicSlideBoxDelegate.select( $ionicSlideBoxDelegate.previous() );
    ```
  - `next()` now returns the index of the next slide and does
    not select. Change your code from this:

    ```js
    // select next slide
    $ionicSlideBoxDelegate.next();
    ```

    To this:

    ```js
    // select next slide
    $ionicSlideBoxDelegate.select( $ionicSlideBoxDelegate.next() );
    ```
2014-10-08 11:09:15 -06:00

69 lines
1.8 KiB
JavaScript

/**
* @ngdoc directive
* @name ionSlide
* @parent ionic.directive:ionSlideBox
* @module ionic
*
* @description
* Displays a slide inside of a slidebox.
*
* For more complete examples, see {@link ionic.directive:ionSlideBox}.
*
* @usage
* ```html
* <ion-slide-box>
* <ion-slide>1</ion-slide>
* <ion-slide>2</ion-slide>
* </ion-slide-box>
* ```
*/
IonicModule
.directive('ionSlide', [function() {
return {
restrict: 'E',
controller: '$ionSlide',
scope: true,
require: ['^ionSlideBox', 'ionSlide'],
link: postLink
};
function postLink(scope, element, attr, ctrls) {
var slideBoxCtrl = ctrls[0];
var slideCtrl = ctrls[1];
element.addClass('slider-slide');
slideBoxCtrl.add(slideCtrl);
scope.$on('$destroy', function() {
slideBoxCtrl.remove(slideCtrl);
});
element.one('$animate:after', watchNgRepeatIndexOnInsertElement);
element.on('$animate:after', refreshStateOnInsertElement);
// If this element is inserted later by an ng-if or ng-repeat, remove it
// from the DOM again if it's irrelevant (not selected or adjacent).
function refreshStateOnInsertElement() {
var slideIndex = slideBoxCtrl.indexOf(slideCtrl);
if (!slideBoxCtrl.isRelevant(slideIndex)) {
slideCtrl.setState('detached');
}
}
// Move with ng-repeat if this slide is part of ng-repeat.
// scope.$index only appears after the first time ng-repaet inserts the element.
function watchNgRepeatIndexOnInsertElement() {
if (angular.isNumber(scope.$index)) {
scope.$watch('$index', function(newIndex, oldIndex) {
if (!isDefined(oldIndex)) return;
var difference = newIndex - oldIndex;
var currentIndex = slideBoxCtrl.indexOf(slideCtrl);
slideBoxCtrl.move(slideCtrl, currentIndex + difference);
});
}
}
}
}]);