This is a simple module for AngularJS that provides the ability to have route-specific CSS stylesheets, by integrating with Angular uiRouter.
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.
-
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 thedata.css
state property usingng-repeat
andng-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.