AngularCSS

CSS on-demand for AngularJS

Optimize the presentation layer of your single-page apps by dynamically injecting stylesheets as needed.

AngularCSS listens for route (or states) change events, adds the CSS defined on the current route and removes the CSS from the previous route. It also works with directives in the same fashion with the compile and scope destroy events. See the code samples below for more details.

Read the Article

Introducing AngularCSS: CSS On-Demand for AngularJS

Demos

Angular's ngRoute Demo (source)

UI Router Demo (source)

Quick Start

Install and manage with Bower or jspm. A CDN is also provided by cdnjs.com

$ bower install angular-css
$ jspm install github:castillo-io/angular-css

1) Include the required JavaScript libraries in your index.html (ngRoute and UI Router are optional).

<script src="/libs/angularjs/1.5.6/angular.min.js"></script>
<script src="/libs/angularjs/1.5.6/angular-routes.min.js"></script>
<script src="/libs/angular-css/angular-css.min.js"></script>

2) Add angularCSS as a dependency for your app.

var myApp = angular.module('myApp', ['ngRoute','angularCSS']);

NOTE: The module name "door3.css" is now deprecated.

Examples

This module can be used by adding a css property in your routes values, directives or by calling the $css service methods from controllers and services.

The css property supports a string, an array of strings, object notation or an array of objects.

See examples below for more information.

In Components

myApp.component('myComponent', {
css: 'my-component/my-component.css' // <--- magic!
templateUrl: 'my-component/my-component.html',
});

In Directives

myApp.directive('myDirective', function () {
return {
restrict: 'E',
templateUrl: 'my-directive/my-directive.html',
/* Binding css to directives */
css: 'my-directive/my-directive.css'
}
});

In Controllers

myApp.controller('pageCtrl', function ($scope, $css) {

  // Binds stylesheet(s) to scope create/destroy events (recommended over add/remove)
$css.bind({
href: 'my-page/my-page.css'
}, $scope); // Simply add stylesheet(s)
$css.add('my-page/my-page.css'); // Simply remove stylesheet(s)
$css.remove(['my-page/my-page.css','my-page/my-page2.css']); // Remove all stylesheets
$css.removeAll(); });

For Routes (Angular's ngRoute)

Requires ngRoute as a dependency

myApp.config(function($routeProvider) {

  $routeProvider
.when('/page1', {
templateUrl: 'page1/page1.html',
controller: 'page1Ctrl',
/* Now you can bind css to routes */
css: 'page1/page1.css'
})
.when('/page2', {
templateUrl: 'page2/page2.html',
controller: 'page2Ctrl',
/* You can also enable features like bust cache, persist and preload */
css: {
href: 'page2/page2.css',
bustCache: true
}
})
.when('/page3', {
templateUrl: 'page3/page3.html',
controller: 'page3Ctrl',
/* This is how you can include multiple stylesheets */
css: ['page3/page3.css','page3/page3-2.css']
})
.when('/page4', {
templateUrl: 'page4/page4.html',
controller: 'page4Ctrl',
css: [
{
href: 'page4/page4.css',
persist: true
}, {
href: 'page4/page4.mobile.css',
/* Media Query support via window.matchMedia API
* This will only add the stylesheet if the breakpoint matches */
media: 'screen and (max-width : 768px)'
}, {
href: 'page4/page4.print.css',
media: 'print'
}
]
}); });

For States (UI Router)

Requires ui.router as a dependency

myApp.config(function($stateProvider) {

  $stateProvider
.state('page1', {
url: '/page1',
templateUrl: 'page1/page1.html',
css: 'page1/page1.css'
})
.state('page2', {
url: '/page2',
templateUrl: 'page2/page2.html',
css: {
href: 'page2/page2.css',
preload: true,
persist: true
}
})
.state('page3', {
url: '/page3',
templateUrl: 'page3/page3.html',
css: ['page3/page3.css','page3/page3-2.css'],
views: {
'state1': {
templateUrl: 'page3/states/page3-state1.html',
css: 'page3/states/page3-state1.css'
},
'state2': {
templateUrl: 'page3/states/page3-state2.html',
css: ['page3/states/page3-state2.css']
},
'state3': {
templateUrl: 'page3/states/page3-state3.html',
css: {
href: 'page3/states/page3-state3.css'
}
}
}
})
.state('page4', {
url: '/page4',
templateUrl: 'page4/page4.html',
views: {
'state1': {
templateUrl: 'states/page4/page4-state1.html',
css: 'states/page4/page4-state1.css'
},
'state2': {
templateUrl: 'states/page4/page4-state2.html',
css: ['states/page4/page4-state2.css']
},
'state3': {
templateUrl: 'states/page4/page4-state3.html',
css: {
href: 'states/page4/page4-state3.css'
}
}
},
css: [
{
href: 'page4/page4.css',
}, {
href: 'page4/page4.mobile.css',
media: 'screen and (max-width : 768px)'
}, {
href: 'page4/page4.print.css',
media: 'print'
}
]
}); });

Responsive Design

AngularCSS supports "smart media queries". This means that stylesheets with media queries will be only added when the breakpoint matches. This will significantly optimize the load time of your apps.

$routeProvider
.when('/my-page', {
templateUrl: 'my-page/my-page.html',
css: [
{
href: 'my-page/my-page.mobile.css',
media: '(max-width: 480px)'
}, {
href: 'my-page/my-page.tablet.css',
media: '(min-width: 768px) and (max-width: 1024px)'
}, {
href: 'my-page/my-page.desktop.css',
media: '(min-width: 1224px)'
}
]
});

Even though you can use the media property to specify media queries, the best way to manage your breakpoints is by settings them in the provider's default settings. For example:

myApp.config(function($routeProvider, $cssProvider) {

  angular.extend($cssProvider.defaults, {
breakpoints: {
mobile: '(max-width: 480px)',
tablet: '(min-width: 768px) and (max-width: 1024px)',
desktop: '(min-width: 1224px)'
}
}); $routeProvider
.when('/my-page', {
templateUrl: 'my-page/my-page.html',
css: [
{
href: 'my-page/my-page.mobile.css',
breakpoint: 'mobile'
}, {
href: 'my-page/my-page.tablet.css',
breakpoint: 'tablet'
}, {
href: 'my-page/my-page.desktop.css',
breakpoint: 'desktop'
}
]
}); });

Config

You can configure AngularCSS at the global or stylesheet level.

Configuring global options

These options are applied during your app's config phase or via $cssProvider.

myApp.config(function($cssProvider) {

  angular.extend($cssProvider.defaults, {
container: 'head',
method: 'append',
persist: false,
preload: false,
bustCache: false
}); });

Configuring CSS options

These options are applied at the stylesheet level.

css: {
href: 'file-path.css',
rel: 'stylesheet',
type: 'text/css',
media: false,
persist: false,
preload: false,
bustCache: false,
weight: 0
}

Support

AngularCSS is fully supported by AngularJS >= v1.3 && <= v1.5

There is partial support for AngularJS 1.2. It does not support css property via DDO (Directive Definition Object). The workaround is to bind (or add) the CSS in the directive's controller or link function via $css service.

myApp.directive('myDirective', function () {
return {
restrict: 'E',
templateUrl: 'my-directive/my-directive.html',
controller: function ($scope, $css) {
$css.bind('my-directive/my-directive.css', $scope);
}
}
});

Angular 2

Can I use AngularCSS in Angular 2?

AngularCSS is not necessary in Angular 2! Angular 2 ships with a similar feature out of the box. It's called styles andstyleUrls and it looks like this:

@Component({
selector: 'my-component',
templateUrl: 'app/components/my-component/my-component.html',
styleUrls: ['app/components/my-component/my-component.css'],
})

Browsers

Chrome, Firefox, Safari, iOS Safari, Android and IE9+

IE9 Does not support matchMedia API. This means that in IE9, stylesheets with media queries will be added without checking if the breakpoint matches.

Contributing

Please submit all pull requests the against master branch. If your pull request contains JavaScript patches or features, you should include relevant unit tests.

Copyright and license

The MIT License

Copyright (c) 2016 Alex Castillo

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in
all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
THE SOFTWARE.
文章来自:https://github.com/castillo-io/angular-css

AngularCSS--关于angularjs动态加载css文件的方法(仅供参考)的更多相关文章

  1. jQuery动态加载css文件实现方法

    $("<link>").attr({ rel: "stylesheet",type: "text/css",href: &quo ...

  2. 两种动态加载JavaScript文件的方法

    两种动态加载JavaScript文件的方法 第一种便是利用ajax方式,第二种是,动静创建一个script标签,配置其src属性,经过把script标签拔出到页面head来加载js,感乐趣的网友可以看 ...

  3. js动态加载css文件和js文件的方法

    今天研究了下js动态加载js文件和css文件的方法. 网上发现一个动态加载的方法.摘抄下来,方便自己以后使用 [code lang="html"] <html xmlns=& ...

  4. 用JavaScript动态加载CSS和JS文件

    本文转载自:http://www.cnblogs.com/xiaochaohuashengmi/archive/2011/11/14/2248451.html 今天项目中需要用到动态加载 CSS 文件 ...

  5. .NET Web后台动态加载Css、JS 文件,换肤方案

    后台动态加载文件代码: //假设css文件:TestCss.css #region 动态加载css文件 public void AddCss() { HtmlGenericControl _CssFi ...

  6. js实用方法记录-js动态加载css、js脚本文件

    js实用方法记录-动态加载css/js 附送一个加载iframe,h5打开app代码 1. 动态加载js文件到head标签并执行回调 方法调用:dynamicLoadJs('http://www.yi ...

  7. JavaScript动态加载CSS和JS文件

    var dynamicLoading = { css: function(path){ if(!path || path.length === 0){ throw new Error('argumen ...

  8. 动态加载css方法实现和深入解析

    一.方法引用来源和应用  此动态加载css方法 loadCss,剥离自Sea.js,并做了进一步的优化(优化代码后续会进行分析).  因为公司项目需要用到懒加载来提高网站加载速度,所以将非首屏渲染必需 ...

  9. [AngularJS] 使用AngularCSS动态加载CSS

    [AngularJS] 使用AngularCSS动态加载CSS 前言 使用AngularAMD动态加载Controller 使用AngularAMD动态加载Service 上列两篇文章里,介绍了如何如 ...

随机推荐

  1. 等差数列6《MAC》

    watermark/2/text/aHR0cDovL2Jsb2cuY3Nkbi5uZXQveXhzdGFycw==/font/5a6L5L2T/fontsize/400/fill/I0JBQkFCMA ...

  2. lucene简介 创建索引和搜索初步

    lucene简介 创建索引和搜索初步 一.什么是Lucene? Lucene最初是由Doug Cutting开发的,2000年3月,发布第一个版本,是一个全文检索引擎的架构,提供了完整的查询引擎和索引 ...

  3. sql datalength与len区别用法

    原文:sql datalength与len区别用法 len ( string_expression )参数:要计算的字符串 len() 函数len 函数返回文本字段中值的长度. sql len() 语 ...

  4. C#快速随机按行读取大型文本文件

    原文:C#快速随机按行读取大型文本文件 下面是我实现的一个数据文件随机读取类,可以随机读取大型文本文件的某一行.在我机器上对一个130MB的文本文件,读取第200000的速度从传统做法的400ms提高 ...

  5. 【转】视差滚动(Parallax Scrolling)效果的原理和实现

    原文:http://www.cnblogs.com/JoannaQ/archive/2013/02/08/2909111.html 视差滚动(Parallax Scrolling)是指让多层背景以不同 ...

  6. DDD实践2

    DDD实践切入点(二) 承前:大型系统的支撑,应用系统开发思想的变迁,DDD实践切入点(一) 从大比例结构入手已经开始了系统的建设,大家都知道需求是会不断变化不断深入的,刚开始自然是模糊的大比例结构对 ...

  7. SignalR1

    SignalR循序渐进(一) 前阵子把玩了一下SignalR,起初以为只是个real-time的web通讯组件.研究了几天后发现,这玩意简直屌炸天,它完全就是个.net的双向异步通讯框架,用它能做很多 ...

  8. Java编程思想笔记(第二章)

    第二章  一切都是对象 尽管Java是基于C++的,但相比之下,Java是一种更纯粹的面向对象程序设计语言. c++和Java都是杂合型语言(hybird language) 用引用(referenc ...

  9. WCF订阅替换轮训

    使用WCF订阅替换轮训 之前因为某些特定岗位的人不知道是不方便还是什么的原因,所以随便做了个独立于所有系统之外的邮件审批服务,功能是那些人在邮件里给待审批单据发个“同意”就自动审批通过,大致分为3部分 ...

  10. 【WCF系列二:如何调用WCF服务】WCF入门教程(图文)VS2012

    上一遍到现在已经有一段时间了,先向关注本文的各位“挨踢”同仁们道歉了.小生自认为一个ITer如果想要做的更好,就需要将自己的所学.所用积极分享出来,接收大家的指导和吐槽.网上也有很多WCF相关的教程, ...