Fenêtre modale Ionic


$ionicModal

$ionicModal peut se superposer à la zone de contenu de l'interface principale de l'utilisateur.

Vous pouvez intégrer le code suivant dans votre fichier index ou d'autres fichiers (le code à l'intérieur peut être modifié selon vos propres scénarios métier).

<script id="my-modal.html" type="text/ng-template">
  <ion-modal-view>
    <ion-header-bar>
      <h1 class="title">My Modal title</h1>
    </ion-header-bar>
    <ion-content>
      Hello!
    </ion-content>
  </ion-modal-view>
</script>

Vous pouvez ensuite injecter $ionicModal dans votre contrôleur, et appeler le template que vous venez d'écrire pour l'initialiser. Comme dans le code suivant :

angular.module('testApp', ['ionic'])
.controller('MyController', function($scope, $ionicModal) {
  $ionicModal.fromTemplateUrl('my-modal.html', {
    scope: $scope,
    animation: 'slide-in-up'
  }).then(function(modal) {
    $scope.modal = modal;
  });
  $scope.openModal = function() {
    $scope.modal.show();
  };
  $scope.closeModal = function() {
    $scope.modal.hide();
  };
  //Cleanup the modal when we're done with it!
  $scope.$on('$destroy', function() {
    $scope.modal.remove();
  });
  // Execute action on hide modal
  $scope.$on('modal.hidden', function() {
    // Execute action
  });
  // Execute action on remove modal
  $scope.$on('modal.removed', function() {
    // Execute action
  });
});

Méthodes

fromTemplate(templateString, options)
Parameters Type Détails
templateString String

Une chaîne de template utilisée comme contenu de la fenêtre modale.

options Object

options seront transmises à la méthode ionicModal#initialize.

Renvoie :Object, une instance du contrôleur ionicModal.

fromTemplateUrl(templateUrl, options)
Parameters Type Détails
templateUrl String

L'URL pour charger le template.

options Object

Un objet transmis via la méthode ionicModal#initialize.

Renvoie :Un objet promesse. L'objet Promises est une spécification proposée par le groupe de travail CommonJS, visant à fournir une interface unifiée pour la programmation asynchrone.


ionicModal

Instancié par le service $ionicModal.

Astuce : Lorsque vous avez terminé de nettoyer chaque modal, assurez-vous d'appeler la méthode remove() pour éviter les fuites de mémoire.

Remarque : une modale diffuse 'modal.shown' et 'modal.hidden' depuis sa portée initiale, en se passant elle-même comme argument.

Méthodes

initialize(可选)

Créez une nouvelle instance de contrôleur de fenêtre modale.

Parameters Type Détails
options Object

Un objet d'options avec les propriétés suivantes :

  • {object=} RangeLa portée de la modale. Par défaut : crée un enfant de $rootScope.
  • {string=} AnimationL'animation pour l'affichage et le masquage. Par défaut : 'slide-in-up'
  • {boolean=} The first input box gets focusIndique si le premier élément de saisie de la fenêtre modale reçoit automatiquement le focus lorsqu'elle est affichée. Par défaut : false.
  • {boolean=}`backdropClickToClose` - Indique si la fenêtre modale doit se fermer lorsque l'arrière-plan est cliqué. Par défaut : true.
show()

Affichez l'instance de fenêtre modale.

  • Valeur de retour :promiseUn objet promesse, résolu après que la fenêtre modale a terminé son animation.
hide()

Masquez la fenêtre modale.

  • Valeur de retour :promiseUn objet promesse, résolu après que la fenêtre modale a terminé son animation.
remove()

Supprimez l'instance de fenêtre modale du DOM et nettoyez.

  • Valeur de retour :promiseUn objet promesse, résolu après que la fenêtre modale a terminé son animation.
isShown()
  • Retourne : une valeur booléenne pour déterminer si la fenêtre modale est affichée.

Exemples

Code HTML

<html ng-app="ionicApp">
  <head>
    <meta charset="utf-8">
    <meta name="viewport" content="initial-scale=1, maximum-scale=1, user-scalable=no, width=device-width"> 
    
    <title>Example(example.com)</title>
    <link href="../static/ionic/css/ionic.min.css" rel="stylesheet">
    <script src="../static/ionic/js/ionic.bundle.min.js"></script>
  </head>
  <body ng-controller="AppCtrl">
    
    <ion-header-bar class="bar-positive">
      <h1 class="title">Contacts</h1>
      <div class="buttons">
        <button class="button button-icon ion-compose" ng-click="modal.show()">
        </button>
      </div>
    </ion-header-bar>
    <ion-content>
      <ion-list>
        <ion-item ng-repeat="contact in contacts">
          {{contact.name}}
        </ion-item>
      </ion-list>
    </ion-content>
    
    <script id="templates/modal.html" type="text/ng-template">
      <ion-modal-view>
        <ion-header-bar class="bar bar-header bar-positive">
          <h1 class="title">New Contact</h1>
          <button class="button button-clear button-primary" ng-click="modal.hide()">Cancel</button>
        </ion-header-bar>
        <ion-content class="padding">
          <div class="list">
            <label class="item item-input">
              <span class="input-label">First Name</span>
              <input ng-model="newUser.firstName" type="text">
            </label>
            <label class="item item-input">
              <span class="input-label">Last Name</span>
              <input ng-model="newUser.lastName" type="text">
            </label>
            <label class="item item-input">
              <span class="input-label">Email</span>
              <input ng-model="newUser.email" type="text">
            </label>
            <button class="button button-full button-positive" ng-click="createContact(newUser)">Create</button>
          </div>
        </ion-content>
      </ion-modal-view>
    </script>
    
  </body>
</html>

Code CSS

body {
  cursor: url('http://www.example.com/try/demo_source/finger.png'), auto;
}

Code JavaScript

angular.module('ionicApp', ['ionic'])

.controller('AppCtrl', function($scope, $ionicModal) {
  
  $scope.contacts = [
    { name: 'Gordon Freeman' },
    { name: 'Barney Calhoun' },
    { name: 'Lamarr the Headcrab' },
  ];

  $ionicModal.fromTemplateUrl('templates/modal.html', {
    scope: $scope
  }).then(function(modal) {
    $scope.modal = modal;
  });
  
  $scope.createContact = function(u) {        
    $scope.contacts.push({ name: u.firstName + ' ' + u.lastName });
    $scope.modal.hide();
  };

});

Autres extensions