Spec-Zone.ru › Angular.js 1.2

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

  1. $sceDelegateProvider
  2. сервис в модуле ng

$sceDelegate является сервисом, используемым сервисом $sce для предоставления услуг жесткого контекстного экранирования (SCE) для AngularJS.

Обычно для настройки или переопределения $sceDelegate вместо сервиса $sce, чтобы настроить работу жесткого контекстного экранирования в AngularJS. Это связано с тем, что, хотя $sce предоставляет многочисленные сокращённые методы и т.д., вам действительно нужно переопределить только 3 основных функции (trustAs, getTrusted и valueOf), чтобы заменить работу, потому что $sce делегирует эти операции $sceDelegate.

Для настройки этого сервиса обратитесь к $sceDelegateProvider.

Предварительно настроенный экземпляр $sceDelegate должен работать без проблем. Хотя вы можете полностью его переопределить, чтобы изменить поведение $sce, в общем случае рекомендуется настроить $sceDelegateProvider вместо этого, установив собственные списки разрешённых и запрещённых URL-адресов для доверенных 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.2.32/docs/api/ng/service/$sceDelegate

Spec-Zone.ru

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