Улучшить эту документацию Просмотреть исходный код $sceDelegate
- $sceDelegateProvider
- сервис в модуле ng
$sceDelegate — это сервис, который используется сервисом $sce для предоставления сервисов строгого контекстного экранирования (SCE) для AngularJS.
Обычно, вы настраиваете или переопределяете $sceDelegate, а не $sce сервис, чтобы настроить работу строгого контекстного экранирования в AngularJS. Это потому, что, хотя $sce предоставляет множество сокращённых методов и т. д., вам действительно нужно переопределить только 3 основных функции (trustAs, getTrusted и valueOf), чтобы заменить работу, потому что $sce делегирует $sceDelegate для этих операций.
Для настройки этого сервиса обратитесь к $sceDelegateProvider.
Предварительно настроенный экземпляр $sceDelegate должен работать без проблем. Хотя вы можете полностью его переопределить, чтобы изменить поведение $sce, в распространённом случае вместо этого используется настройка $sceDelegateProvider путём задания собственных белых и чёрных списков для доверенных URL-адресов, используемых для загрузки ресурсов AngularJS, таких как шаблоны. Обратитесь к $sceDelegateProvider.resourceUrlWhitelist и $sceDelegateProvider.resourceUrlBlacklist.
Использование
$sceDelegate();
Методы
-
trustAs(type, value);
Возвращает объект, которому angular доверяет для использования в указанных контекстах строгого контекстного экранирования (например, ng-bind-html, ng-include, любой интерполяции атрибута src, любой интерполяции атрибута привязки к событиям DOM, например, для onclick и т. д.), который использует предоставленное значение. См. $sce для включения строгого контекстного экранирования.
Параметры
Параметр Тип Подробности type stringТип контекста, в котором это значение безопасно для использования. Например, url, resourceUrl, html, js и css.
value *Значение, которое должно считаться надёжным/безопасным.
Возвращаемое значение
*Значение, которое может использоваться для замены предоставленного
valueв местах, где Angular ожидает возвращаемого значения $sce.trustAs(). -
valueOf(value);
Если переданный параметр был возвращён предыдущим вызовом
$sceDelegate.trustAs, возвращает значение, которое было передано$sceDelegate.trustAs.Если переданный параметр не является значением, возвращённым
$sceDelegate.trustAs, возвращает его как есть.Параметры
Параметр Тип Подробности value *Результат предыдущего вызова
$sceDelegate.trustAsили что-либо ещё.Возвращаемое значение
*Значение
value, которое изначально было предоставлено$sceDelegate.trustAs, еслиvalueявляется результатом такого вызова. В противном случае возвращаетvalueбез изменений. -
getTrusted(type, maybeTrusted);
Принимает результат вызова
$sceDelegate.trustAsи возвращает исходное значение, если тип запрошенного контекста является супертипом созданного типа. Если это условие не выполняется, генерирует исключение.Параметры
Параметр Тип Подробности type stringТип контекста, в котором будет использоваться это значение.
maybeTrusted *Результат предыдущего вызова
$sceDelegate.trustAs.Возвращаемое значение
*Значение, которое было изначально предоставлено
$sceDelegate.trustAs, если оно допустимо в данном контексте. В противном случае генерируется исключение.
© 2010–2017 Google, Inc.
Licensed under the Creative Commons Attribution License 4.0.
https://code.angularjs.org/1.3.20/docs/api/ng/service/$sceDelegate