Giter Club home page Giter Club logo

angular-wait's Introduction

Overview

This Angular directive enables a "loading" view while performing asynchronous requests. The directive watches a specific value you may be interested in. For example, your controller:

angular.module('your app')
  .controller('ExampleCtrl', function ($scope, $timeout) {
    $timeout(function() {
        $scope.myAsyncValue = 'hello from the server'; 
    }, 2000)
  });

And in your view:

    <wait until-not-undefined="myAsyncValue">
      <wait-loading>loading...</wait-loading>
      <wait-done>{{myAsyncValue}}</wait-done>
    </wait>

Here's what would happen:

  1. "Loading" would initially appear
  2. Two seconds later, "hello from the server" would show

Why is this better than ng-if="variableName"?

This directive helps remove potentially complex condition checking from the view since standard falsey checks in the view can't always distinguish between incomplete requests and empty responses. This illustrates the example better; see this controller:

angular.module('your app')
  .controller('ExampleCtrl', function ($scope, $timeout) {
    $timeout(function() {
      $scope.myAsyncValue = null; 
    }, 2000)
  });

And in your view:

<wait until-not-undefined="myAsyncValue">
  <wait-loading>loading...</wait-loading>
  <wait-done>
    <div ng-if="myAsyncValue">{{myAsyncValue}}</div>
    <div ng-if="!myAsyncValue">No result</wait-done>
</wait>

This would yield:

  1. "Loading" would initially appear
  2. Two seconds later, "No result" would show

Any nested directives (if any) in wait-done, would not be processed until the until condition is met (see technical notes).

Requirements

Tested in IE8+, latest Chrome, and latest Safari. Angular 1.2+.

Installing

bower install -S angular-wait

Include the script and then Integrate into your app:

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

Usage

Simply define the wait directive with wait-loading (mandatory) and wait-done nodes inside it as shown below:

<wait until-not-false="someVariable">
  <wait-loading>shown while waiting</wait-loading>
  <wait-done>shown when finished</wait-done>
</wait>
 
<wait until-not-null="someVariable">
  <wait-loading>shown while waiting</wait-loading>
  <wait-done>shown when finished</wait-done>
</wait>

<wait until-not-undefined="someVariable">
  <wait-loading>shown while waiting</wait-loading>
  <wait-done>shown when finished</wait-done>
</wait>

Wait Until _____

All three available attributes to the directive watch the passed condition or variable until its value matches the asked state. For example the following uses all immediately render the wait-done nodes:

<wait until-not-null="null">
  <wait-loading>not shown</wait-loading>
  <wait-done>SHOWS IMMEDIATELY</wait-done>
</wait>
 
<wait until-not-false="false">
  <wait-loading>not shown</wait-loading>
  <wait-done>SHOWS IMMEDIATELY</wait-done>
</wait>

<wait until-not-undefined="1">
  <wait-loading>not shown</wait-loading>
  <wait-done>SHOWS IMMEDIATELY</wait-done>
</wait>

Note that the matching is using triple equals (===). This means that falsey values for the until-not-null do not necessarily trigger it. The following example illustrates this:

<wait until-not-null="false">
  <wait-loading>SHOWN</wait-loading>
  <wait-done>not shown</wait-done>
</wait>
 
<wait until-not-false="null">
  <wait-loading>SHOWN</wait-loading>
  <wait-done>not shown</wait-done>
</wait>

<wait until-not-undefined="false">
  <wait-loading>SHOWN</wait-loading>
  <wait-done>not shown</wait-done>
</wait>

Technical notes

The inner contents are using transclusion can handle child directives. Inner directives are not processed at all (compile or controller methods) until the wait-done node renders.

Releases

  • 1.0.2 Aug 23, 2014 - Inner directives not processed until done node shows
  • 1.0.1 Aug 23, 2014 - Support for minification by using ngAnnotate
  • 1.0.0 Aug 23, 2014 - Initial Release

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.