詳解AngularJs中$sce與$sceDelegate上下文轉(zhuǎn)義服務
一、嚴格的上下文轉(zhuǎn)義服務
嚴格的上下文轉(zhuǎn)義(SCE)是一種需要在一定的語境中導致AngularJS綁定值被標記為安全使用語境的模式。由用戶通過ng-bind-html綁定任意HTML語句就是這方面的一個例子。我們稱這些上下文轉(zhuǎn)義為特權(quán)或者SCE。
二、$sce
$sce 服務是AngularJs提供的一種嚴格上下文轉(zhuǎn)義服務。
下面代碼是簡化了的ngBindHtml實現(xiàn)(當然,這不是完整版ngBindHtml源碼):
var ngBindHtmlDirective = ['$sce', function($sce) {
return function(scope, element, attr) {
scope.$watch($sce.parseAsHtml(attr.ngBindHtml), function(value) {
element.html(value || '');
});
};
}];
支持哪些信任的上下文類型?
$sce.HTML 將HTML代碼安全的綁定到應用程序中。
$sce.CSS 將CSS樣式代碼安全的綁定到應用程序中。
$sce.URL 將URL安全的綁定到應用程序中并保證其可用。比如(href,src)
$sce.RESOURCE_URL 將RESOURCE_URL安全的綁定到應用程序中并保證其可用。比如(ng-href,ng-src)
$sce.JS 將JAVASCRIPT代碼安全的綁定到應用程序中。
如何使$sce服務可用或者不可用?
angular.module(“myApp”,[]).config([“$sceProvider”,function($sceProvider){
$sceProvider.enabled(true/false);
}]);
使用:$sce();
方法:
isEnabled();
返回一個boolean,指示是否可啟用SCE。
parseAs(type,expression);
將Angular表達式轉(zhuǎn)換為一個函數(shù)。這類似$parse解析并且當表達式是常量時是相同的。否則,它將調(diào)用$sce.getTrusted(type,result)將表達式包裝。
type:在SCE的上下文的使用的結(jié)果的類型。
expression:被編譯的字符串表達式。
trustAs(type,value);
代表$sceDelegate.trustAs。
type:上下文中能安全的被使用的值,如url,resourceUrl,html,js和css。
value:需要被認為是安全或者值的信賴的值。
trustAsHtml(value);
$sceDelegate.trustAs($sce.HTML,value)的快捷方式。
value:被信任的值。
trustAsUrl(value);
$sceDelegate.trustAs($sce.URL,value)的快捷方式。
value:被信任的值。
trustAsResourceUrl(value);
$sceDelegate.trustAs($sce.RESOURCE_URL,value)的快捷方式。
value:被信任的值。
trustAsJs(value);
$sceDelegate.trustAs($sce.JS,value)的快捷方式。
value:被信任的值。
getTrusted(type,maybeTrusted);
代表$sceDelegate.getTrusted。因此,得到了$sce的結(jié)果。如果查詢的上下文類型是一個創(chuàng)造型的類型,則調(diào)用trustAs()并且返回原來提供的值。如果這個條件不滿足,則拋出一個異常。
getTrustedHtml(value);
$sceDelegate.getTrusted ($sce.HTML,value)的快捷方式。
value:通過$sce.getTrusted執(zhí)行后的值。
getTrustedCss(value);
$sceDelegate.getTrusted ($sce.CSS,value)的快捷方式。
value:通過$sce.getTrusted執(zhí)行后的值。
getTrustedUrl(value);
$sceDelegate.getTrusted ($sce.URL,value)的快捷方式。
value:通過$sce.getTrusted執(zhí)行后的值。
getTrustedResourceUrl(value);
$sceDelegate.getTrusted ($sce.RESOURCE_URL,value)的快捷方式。
value:通過$sce.getTrusted執(zhí)行后的值。
getTrustedJs(value);
$sceDelegate.getTrusted ($sce.JS,value)的快捷方式。
value:通過$sce.getTrusted執(zhí)行后的值。
parseAsHtml(expression);
$sce.parseAs ($sce.HTML,value)的快捷方式。
value:被編譯的字符串表達式。
parseAsCss(expression);
$sce.parseAs ($sce.CSS,value)的快捷方式。
value:被編譯的字符串表達式。
parseAsUrl(expression);
$sce.parseAs ($sce.URL,value)的快捷方式。
value:被編譯的字符串表達式。
parseAsResourceUrl(expression);
$sce.parseAs ($sce.RESOURCE_URL,value)的快捷方式。
value:被編譯的字符串表達式。
parseAsJs(expression);
$sce.parseAs ($sce.JS,value)的快捷方式。
value:被編譯的字符串表達式。
使用方式:
<div ng-app="Demo" ng-controller="testCtrl as ctrl"> <textarea ng-model="ctrl.jsContext"></textarea> <pre ng-bind="ctrl.jsBody"></pre> <button ng-click="ctrl.runJs()">Run</button> <div ng-bind-html="ctrl.htmlText" class="myCss"></div> </div>
(function () {
angular.module('Demo', [])
.controller('testCtrl', ["$sce","$scope",testCtrl]);
function testCtrl($sce,$scope) {
var vm = this;
$scope.$watch("ctrl.jsContext",function(n){
vm.jsBody = n;
});
this.runJs = function() {
eval(vm.jsBody.toString());
};
vm.htmlText = "<h2>Hello World</h2>";
vm.htmlText =$sce.trustAsHtml(this.htmlText);
}
}());
放在filter使用:
<div ng-app="Demo" ng-controller="testCtrl as ctrl"> <div ng-bind-html="ctrl.htmlText | trust:'html'"></div> </div>
(function () {
angular.module('Demo', [])
.filter("trust",["$sce",trust])
.controller('testCtrl', testCtrl);
function trust($sce){
return function(value,type){
return $sce.trustAs(type,value);
}
};
function testCtrl() {
this.htmlText = "<h2>Hello World</h2>";
}
}());
上面是一個將不被Angular認定為信任的HTML代碼字符串通過$sce設置為信任的HTML代碼并且插入的例子,這里用了個小技巧,也就沒在controller進行這步操作了,直接放到一個filter服務內(nèi),只要在需要的地方過濾下即可,并且可指定類型,這里寫成統(tǒng)一動態(tài)選擇類型了。那么在啥時候需要用到這兩個服務呢?在當使用ng-bind-html綁定html時報錯:Error: [$sce:unsafe]Attempting to use an unsafe value in a safe context. 的時候使用。
三、$sceDelegate
$sceDelegate是一個AngularJs為$sce服務提供嚴格的上下文轉(zhuǎn)義服務的服務。
通常,你會配置或者重寫$sceDelegate去代替$sce服務以定制AngularJs中的嚴格的上下文轉(zhuǎn)義機制。當$sce提供眾多的快捷方式,你其實只需要重寫三個核心功能(trustAs,getTrusted和valueOf)來替代事件的工作方式,因為$sce代表了$sceDelegate的這些操作。
當你完成了重寫或配置$sceDelegate用來改變$sce的行為時,一般情況下,需要配置$sceDelegateProvider以代替你用于裝載可信任的AngularJs資源(如template)的白名單和黑名單。
使用:$sceDelegate();
方法:
trustAs(type,value);
返回一個在angular中作為指定的使用嚴格的上下文轉(zhuǎn)義服務上下文中的值的對象使用。
type:上下文中能安全的被使用的值,如url,resourceUrl,html,js和css。
value:需要被認為是安全或者值的信賴的值。
valueOf(value);
如果傳遞的參數(shù)被上一個$sceDelegate.trustAs調(diào)用返回,返回已通過$sceDelegate.trustAs的值。否則返回原先的值。
value:上一個$sceDelegate.trustAs調(diào)用的結(jié)果或者其他任何結(jié)果。
getTrusted(type,maybeTrusted);
如果查詢的上下文類型是一個創(chuàng)造型的類型,得到$sceDelegate調(diào)用的結(jié)果并返回最初提供的值。如果這個條件不滿意,拋出一個異常。
type:需要用到的值的類型。
value:上一個$sceDelegate.trustAs調(diào)用的結(jié)果或者其他任何結(jié)果。
使用代碼(配置白名單/黑名單):
angular.module('myApp', []).config([“$ sceDelegateProvider”,function($sceDelegateProvider) {
$sceDelegateProvider.resourceUrlWhitelist([“whitelist value”]);
$sceDelegateProvider.resourceUrlBlacklist([“blacklist value”]);
}]);
總結(jié)
以上就是這篇文章的全部內(nèi)容,希望能對大家的學習或者工作帶來一定的幫助,如果有疑問大家可以留言交流。
相關(guān)文章
AnjularJS中$scope和$rootScope的區(qū)別小結(jié)
這篇文章給大家整理了關(guān)于AnjularJS中$scope和$rootScope的區(qū)別,文中運用實例代碼介紹的很詳細,有需要的朋友們可以參考借鑒,下面來一起看看吧。2016-09-09
@angular前端項目代碼優(yōu)化之構(gòu)建Api Tree的方法
這篇文章主要介紹了@angular前端項目代碼優(yōu)化之構(gòu)建Api Tree的方法,小編覺得挺不錯的,現(xiàn)在分享給大家,也給大家做個參考。一起跟隨小編過來看看吧2018-12-12
AngularJS創(chuàng)建一個上傳照片的指令實例代碼
這篇文章主要介紹了AngularJS創(chuàng)建一個上傳照片的指令實例代碼,需要的朋友可以參考下2018-02-02
AngularJS獲取json數(shù)據(jù)的方法詳解
這篇文章主要介紹了AngularJS獲取json數(shù)據(jù)的方法,結(jié)合實例形式詳細分析了AngularJS獲取json數(shù)據(jù)的詳細步驟、操作技巧與相關(guān)注意事項,需要的朋友可以參考下2017-05-05
angularJS的radio實現(xiàn)單項二選一的使用方法
下面小編就為大家分享一篇angularJS的radio實現(xiàn)單項二選一的使用方法,具有很好的參考價值,希望對大家有所幫助。一起跟隨小編過來看看吧2018-02-02
AngularJS基礎 ng-model-options 指令簡單示例
本文主要介紹AngularJS ng-model-options 指令,這里對ng-model-options指令的基本資料進行整理,有需要的小伙伴可以參考下2016-08-08

