©
本文檔使用 php中文網手册 發布
AngularJS: API: ng/service/$sceDelegate
$sceDelegate
- - $sceDelegateProvider
- - service in module ng
$sceDelegate is a service that is used by the $sce service to provide Strict
Contextual Escaping (SCE) services to AngularJS.
Typically, you would configure or override the $sceDelegate instead of
the $sce service to customize the way Strict Contextual Escaping works in AngularJS. This is
because, while the $sce provides numerous shorthand methods, etc., you really only need to
override 3 core functions (trustAs, getTrusted and valueOf) to replace the way things
work because $sce delegates to $sceDelegate for these operations.
Refer $sceDelegateProvider to configure this service.
The default instance of $sceDelegate should work out of the box with little pain. While you
can override it completely to change the behavior of $sce, the common case would
involve configuring the $sceDelegateProvider instead by setting
your own whitelists and blacklists for trusting URLs used for loading AngularJS resources such as
templates. Refer $sceDelegateProvider.resourceUrlWhitelist and $sceDelegateProvider.resourceUrlBlacklist
用法
$sceDelegate();
方法
-
trustAs(Type, value);Returns an object that is trusted by angular for use in specified strict contextual escaping contexts (such as ng-bind-html, ng-include, any src attribute interpolation, any dom event binding attribute interpolation such as for onclick, etc.) that uses the provided value. See $sce for enabling strict contextual escaping.
参数
参数 类型 详述 type string The kind of context in which this value is safe for use.例如 url, resourceUrl, html, js and css.
value * The value that that should be considered trusted/safe.
返回值
* A value that can be used to stand in for the provided
valuein places where Angular expects a $sce.trustAs() return value. -
valueOf(value);If the passed parameter had been returned by a prior call to
$sceDelegate.trustAs, returns the value that had been passed to$sceDelegate.trustAs.If the passed parameter is not a value that had been returned by
$sceDelegate.trustAs, returns it as-is.参数
参数 类型 详述 value * The result of a prior
$sceDelegate.trustAscall or anything else.返回值
* The
valuethat was originally provided to$sceDelegate.trustAsifvalueis the result of such a call. Otherwise, returnsvalueunchanged. -
getTrusted(Type, maybeTrusted);Takes the result of a
$sceDelegate.trustAscall and returns the originally supplied value if the queried context type is a supertype of the created type. If this condition isn't satisfied, throws an exception.参数
参数 类型 详述 type string The kind of context in which this value is to be used.
maybeTrusted * The result of a prior
$sceDelegate.trustAscall.返回值
* The value the was originally provided to
$sceDelegate.trustAsif valid in this context. Otherwise, throws an exception.