Skip to content

Angular ngRoute

Daniel Wright edited this page Sep 28, 2018 · 12 revisions

Angular ngRoute extension for at.js library uses promises (delayed objects) within routes to provide a "flicker-free" implementation on view changes. This approach could be used in an application using Angular's ngRoute module. Conveniently, this extension can be added to the application using DTM.

Prerequisites:

  1. at.js library
  2. Angular library
  3. Angular ngRoute module

Integration Instructions:

  1. Include at.js without the auto-created mbox
  2. Choose an appropriate extension distribution and include it. Note: at-angular-common extension is required by at-angular-ng-route extension, so if you'll be using only one of the Angular extensions in your project, it makes sense to include the +common version. Otherwise, you'll probably want to include the at-angular-common extension separately, and choose the distribution without +common.
  3. The extension should be added to your page after angular.js, angular-route.js and at.js OR it could be added to the end of at.js in the Target Tool configuration of DTM.
  4. Initialize with adobe.target.ext.angular.initRoutes method by passing your Angular module as an argument. In DTM you might need to include this as a Sequential Javascript snippet in a Page Load Rule triggered at the bottom of the relevant page.

Simple example:

adobe.target.ext.angular.initRoutes(app);  // where app is a required argument, reference to an Angular module, can be an object or a string name

Example with all available options:

adobe.target.ext.angular.initRoutes(app,     // Angular module, object reference or string, required 
    {
        params: {param1:'val1',param2:'val2'},     // Target mbox parameters, optional
        mbox: 'custom-mbox-name',            // Target mbox name, optional
        selector: 'body',                    // CSS selector to inject Target content to, optional
        timeout: 5000,                       // Target call timeout
        allowedRoutesFilter: [],             // Blank for all routes or restrict to specific routes: ['/','/about','/item/:id']
        disallowedRoutesFilter: []          // Exclude specific routes: ['/login','/privacy']
    });

##Demo Route Change Example

Clone this wiki locally