laxar-angular-adapter

laxar-angular-adapter

Write LaxarJS widgets and controls with AngularJS

Starting with LaxarJS 2, AngularJS is no longer supported (and included) by default. However, this widget-adapter for LaxarJS 2 allows to use widgets written in AngularJS 1.x with LaxarJS 2.

To use the adapter, install it using Bower or npm, and then pass it to laxar.bootstrap.

Note that AngularJS 1.x is not well suited to multiple LaxarJS application instances sharing a page. If you need this feature, be sure to pass the AngularJS dependencies of all instances as modules to the first laxar.bootstrap invocation.

Additionally provided injectable services

Most services available as injection for widgets are directly provided by the LaxarJS runtime (see http://laxarjs.org/docs/laxar-v2-latest/manuals/widget_services). In case of this adapter some services are only redefined as AngularJS services to be globally available for other AngularJS services and directives. The following list covers these:

• axConfiguration
• axGlobalEventBus
• axGlobalLog
• axGlobalStorage
• axHeartbeat
• axTooling

axWidgetServices

Additionally an axWidgetServices service is available, which can be used by directives to gain access to services that are only available in the context of a specific widget, such as axFeatures, axI18n or the decorated log for widgets (axLog). The axWidgetServices is a function, that must be called with scope of the directive and it returns the map of services that are available for the widget being the same as or a parent of the directive scope in the scope hierarchy. As a consequence an error is thrown if this service is used with a scope not being (a child of) a widget scope.

Example:

myModule.directive( 'myDirective', [ 'axWidgetServices', axWidgetServices => {
   return {
      link( scope ) {
         const widgetServices = axWidgetServices( scope );
         widgetServices.axLog.info( 'Here we are!' );
      }
   }
} ] );

$scope

As it is always the case for controllers, the $scope the controller is bound to can be injected. For AngularJS widgets this is exactly the same as the axContext injection. All widget scopes are child of one specific parent scope and don't copy the hierarchy or placement of widgets within a page, i.e. all widget scopes are siblings of each other.

Changelog

v2.0.0-alpha.0

• #25: fixed testability by running $rootScope.$digest on heartbeat
  • BREAKING CHANGE: see ticket for details
• #27: initialize $rootScope.i18n exactly once
• #34: project: updated dev-dependencies, upgraded to webpack 2
• #33: fixed imports of laxar-widget-service-mocks
• #32: adapted to laxar API change (LaxarJS/laxar#413)
  • BREAKING CHANGE: see ticket for details
• #31: Made patching Promise zone.js compatible
• #30: Made patching angular promises defensive