Spec-Zone.ru › Angular.js 1.3

Улучшить эту документацию Просмотреть исходный код $sceDelegate

  1. $sceDelegateProvider
  2. сервис в модуле 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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API