Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / HTML

allow — funkce dostupné ve vloženém rámu

`allow` na `iframe` omezuje nebo deleguje funkce prohlížeče pomocí Permissions Policy; neuděluje souhlas uživatele.

Verze: HTML Living Standard

Syntaxe

<iframe allow="geolocation 'none'; camera 'none'"></iframe>

Hodnota obsahuje direktivy oddělené středníky, například geolocation 'none'; camera 'none'. Každá označuje funkci a povolené původy; 'none' ji zakazuje. Syntaxe se liší od HTTP hlavičky Permissions-Policy. Nejde o seznam prvků HTML.

Rám nemůže získat funkci zakázanou politikou nadřazeného dokumentu. Použití může navíc vyžadovat bezpečný kontext, aktivaci či oprávnění uživatele. allow nenahrazuje sandbox a neruší omezení přístupu mezi původy.

Příklad načte jen místní srcdoc a přečte účinnou politiku přes featurePolicy, dostupné v testovaném Chromium. Kamera a geolokace jsou zakázané. Neaktivují se senzory ani dotazy na oprávnění; diagnostické rozhraní není přenositelné do všech prohlížečů.

Příklady

<!doctype html><meta charset="utf-8">
<iframe id="frame" title="Restricted content" allow="geolocation 'none'; camera 'none'"
  srcdoc="<p>Local content</p>"></iframe>
<output id="result"></output>
<script>
document.querySelector('#frame').addEventListener('load', event => {
  const policy = event.target.contentDocument.featurePolicy;
  document.querySelector('#result').textContent =
    'geolocation=' + policy.allowsFeature('geolocation') +
    '; camera=' + policy.allowsFeature('camera');
});
</script>

Výsledek

geolocation=false; camera=false

Výsledek pochází z politiky dokumentu uvnitř rámu, ne pouze z textu atributu.

Zdroje