foundation-apps-modal v0.1.5

foundation-apps-modal

Zurb Foundation-apps modal with angular promises.

1. Install
2. Usage

Install

bower install foundation-apps-modal

Or

npm install foundation-apps-modal --save-dev

Reference the script:

<script src="bower_components\foundation-apps-modal\dist\foundation-apps-modal.js"></script>

Or

<script src="node_modules\foundation-apps-modal\dist\foundation-apps-modal.js"></script>

Add the module zfaModal as a dependency to your application:

var app = angular.module('myapp', ['zfaModal']);

Notice that if your app only depends on some foundations app modules but not the entire foundations app framework, use foundation-apps-modal.standalone.js isntead.

Usage

Modal

Custom modal:

app.controller('Controller', function($scope, zfaModal) {
  $scope.showModal = function() {
  	zfaModal.open('myModal',{
        template: '<div zf-modal=""><a class="close-button" zf-close="">×</a><h4>Hello!</h4>' +
            '<a ng-click="resolve()" class="button primary">OK</a><a ng-click="reject()" class="button secondary">Cancel</a></div>'
    })
        .then(function() { /* ... */ })
        .catch(function() { /* ... */ });
  };
});

Modal with controller:

app.controller('Controller', function($scope, zfaModal) {
  $scope.showModal = function() {
  	zfaModal.open('myModal',{
        controller: ['$scope', 'zfaModalDefer', 'message', 'zfaModal', function($scope, zfaModalDefer, message, zfaModal) {
            $scope.message = message;
        
            $scope.ok = function() {
                zfaModalDefer.resolve();
            };
            
            $scope.cancel = function() {
                zfaModalDefer.reject();
                // zfaModal.close('myModal');  // another way to close modal, using its id
            };

        }],
        template: '<div zf-modal=""><h4>{{message}}</h4><a class="close-button" zf-close="">×</a>' +
            '<a ng-click="ok()" class="button primary">OK</a><a ng-click="cancel()" class="button secondary">Cancel</a></div>',
        locals: {
            message: 'Hello!'
        }
    })
        .then(function() { /* ... */ })
        .catch(function() { /* ... */ });
  };
});

Modal options

• controller: Modal controller.
• templateUrl: Modal template url.
• template: Modal template.
• locals: Injection locals for modal controller.

Modal provider

Define the modal with the zfaModalProvider:

app.config(['zfaModalProvider', function(zfaModalProvider) {
  zfaModalProvider.register('myModal', {
        controller: ['$scope', 'message', function($scope, message) {
            $scope.message = message;
        }],
        template: '<div zf-modal=""><h4>{{message}}</h4><a class="close-button" zf-close="">×</a>' +
            '<a ng-click="resolve()" class="button primary">OK</a><a ng-click="reject()" class="button secondary">Cancel</a></div>',
        locals: {
            message: 'Hello!'
        }
  });
}]);

Then call modal from controller:

app.controller('Controller', function($scope, zfaModal) {
  $scope.showModal = function() {
  	zfaModal.open('myModal',{
        .then(function() { /* ... */ })
        .catch(function() { /* ... */ });
  };
});

Overwrite locals:

app.controller('Controller', function($scope, zfaModal) {
  $scope.showModal = function() {
  	zfaModal.open('myModal',{ message: "Bye!" })
        .then(function() { /* ... */ })
        .catch(function() { /* ... */ });
  };
});

Modal provider options

• controller: Modal controller.
• templateUrl: Modal template url.
• template: Modal template.
• locals: Injection locals for modal controller.

Predefined modals

Alert

zfaModal.open('alert',{ message: "Alert!!!" })
    .then(function() { /* ... */ })
    .catch(function() { /* ... */ });

locals:

• message: Alert message.
• ok: Ok button text.

Confirm

zfaModal.open('confirm',{ message: "Confirm?" })
    .then(function() { /* ... */ })
    .catch(function() { /* ... */ });

locals:

• message: Confirm message.
• ok: Ok button text.
• cancel: Cancel button text.

Prompt

zfaModal.open('prompt',{ message: "Type your text:" })
    .then(function(value) { /* ... */ })
    .catch(function() { /* ... */ });

locals:

• message: Prompt message.
• value: Input value.
• ok: Ok button text.
• cancel: Cancel button text.

Develop

Setup

1. clone this repo
2. npm install

simply run gulp to build and open demo application on the browser at localhost:8080. Run gulp build for building the project only.