angular-ui-router-styles

This is a simple module for AngularJS that provides the ability to have route-specific CSS stylesheets, by integrating with Angular uiRouter.

What does it do?

It allows you to declare partial-specific or route-specific styles for your app using Angular's ui-router $stateProvider service. This solves that problem by allowing you to do something like this:

app.config(['$stateProvider', function($stateProvider){
    $stateProvider

      .state('state1', {
        url: '/state1',
        controller: 'State1controller',
        template: '<div ui-view></div>',
        data: {
          css: 'styles/custom-state1-override.css'
        }
      })

      .state('state1.state12', {
        url: '/:id',
        controller: 'State12Controller',
        templateUrl: 'views/my-template.html'
      })

      .state('state2', {
        url: '/state2',
        controller: 'State2Controller',
        templateUrl: 'views/another-template.html',
        data: {
          css: ['styles/custom-state2-override.css', 'another.css']
        }
      })
        // more states can be declared here
}]);

Note that state1.state12 will have the parent file styles/custom-state1-override.css injected; redefine the css array for override it.

How to install:

Install it with Bower via bower install angular-ui-router-styles --save
Ensure that your application module specifies uiRouterStyles as a dependency: angular.module('myApplication', ['uiRouterStyles'])
Add css file(s) relative path to the state data object

.state('state1', {
  url: '/state',
  controller: 'StateCtrl',
  templateUrl: 'views/my-template.html',
  data: {
    css: 'styles/some-overrides.css'
  }
})

Things to notice:

Specifying a css property on the route is completely optional. If the state doesn't have a css property, the service will simply do nothing for that route.
You can even have multiple page-specific stylesheets per state, where the css property is an array of relative paths to the stylesheets needed for that route.
If a parent state exists the data object is inherited.

This directive does the following things:

It compiles (using $compile) an html string that creates a set of tags for every item in the data.css state property using ng-repeat and ng-href.
It appends that compiled set of <link /> elements to the <head> tag.
It then uses the $rootScope to listen for '$stateChangeStart' events. For every '$stateChangeStart' event, it cleans all css appended before and adds the new css file(s) to the <head> tag if there are any.

ricky52529 / angular-ui-router-styles Goto Github PK