Bestimmt die Gültigkeit-"Tiefe" der WebTML-Option für per <tml:
include> eingebundene WebTML-Module.
Aus verschiedenen Gründen kann es ratsam sein, die Gültigkeits-"Tiefe" von WebTML-Optionen zu begrenzen:
- Verhindern der Beeinflussung untergeordneter WebTML-Module, für welche die Optionen nicht bestimmt sind, die jedoch eventuell gleichnamige Optionen aus anderen Gründen benutzen
- Reduzieren des Kommunikationsvolumens bei AJAX-aktivierten Portlets: Da alle für ein Portlet gültigen WebTML-Optionen für AJAX-Requests wiederhergestellt werdenist es ratsam nur die Optionen zum Portlet durchdringen zu lassen, welche auch für es bestimmt sind
Daher kann der "Scope" einer WebTML-Option zwischen "global" und "lokal" gewählt werden. Der Scope "global" entspricht dem Standardverhalten von WebTML-Optionen. Sie sind darüber dem kompletten WebTML-Code in der untergeordneten Tag-Hierarchie verfügbar.
Der Scope "local" schränkt die Gültigkeits-Tiefe insofern ein, dass die WebTML-Option nur noch für das unmittelbar betroffene WebTML-Modul gültig ist. Dieses ist:
- Das aktuell einzubindende WebTML-Modul, wenn die WebTML-Option im Include-Tag definiert wurde
- Das aktuelle WebTML-Modul in welchem sich der Option-Tag befindet, wenn die WebTML-Option im laufenden WebTML-Code definiert wurde
Weitere WebTML-Module, welche in diesem unmittelbar betroffenen WebTML-Modul eingebunden werden, erhalten lokale WebTML-Optionen normalerweise nicht. Sie können sich jedoch dafür entscheiden, gezielt einzelne lokale WebTML-Optionen von ihrem übergeordneten WebTML-Modul zu übernehmen. Dazu wird das Attribut
keepoptions verwendet.
scope
