UI Control

Metodi che pilotano la UI del banner (banner first-layer, Consent Preference Center, lingua).

Method	Tier	Since
showPreferenceCenter(mode?)	1	1.0
closePreferenceCenter()	1	1.0
changeLanguage(lang)	1	1.0

💡 Per mount/unmount completo del banner vedi reload().

---

showPreferenceCenter

Apre il pannello di preferenze (secondo layer del banner, "CPC" — Consent Preference Center).

window.Avacy.showPreferenceCenter(target?: HTMLElement | string): Promise<void>

Parameters

Name	Type	Default	Description
target	HTMLElement | string (CSS selector)	—	Se omesso, il pannello viene mountato in modalità absolute (overlay modale sopra la pagina). Se passi un elemento (o un selector che lo identifica), il pannello viene mountato inline dentro quel container.

Returns

Promise<void> — risolta dopo che il pannello è mountato e triggerCustomization ha popolato privacySettings.

Examples

<!-- modalità absolute (default): overlay modale -->
<a href="#" onclick="window.Avacy.showPreferenceCenter(); return false;">
  Gestisci consenso
</a>

// modalità inline: il pannello viene mountato dentro un container specifico
// (utile in pagine "/privacy" dedicate o in pannelli laterali)
window.Avacy.showPreferenceCenter('#privacy-panel');
// o passando direttamente l'elemento:
window.Avacy.showPreferenceCenter(document.getElementById('privacy-panel'));

Side effects

Emette avacy:cpc-opened (detail vuoto).

See also

• closePreferenceCenter()
• Eventi avacy:cpc-opened / avacy:cpc-closed — vedi Events

---

closePreferenceCenter

Chiude il pannello di preferenze.

window.Avacy.closePreferenceCenter(): void

Example

window.Avacy.closePreferenceCenter();

Side effects

Emette avacy:cpc-closed (detail vuoto).

---

changeLanguage

Cambia la lingua attiva delle label CMP a runtime. Le label vengono rilette dalla customLabels config + prebundled words + remote labels (se configurato), e i framework propagano (es. TCF consentLanguage).

window.Avacy.changeLanguage(lang: LanguageCode): Promise<void>

Parameters

Name	Type	Description
lang	LanguageCode	Codice ISO 639-1 (es. 'it', 'en', 'de', 'fr').

Returns

Promise<void> — risolta quando label, glossario, customization e framework hanno propagato.

Example

await window.Avacy.changeLanguage('en');

Side effects

Emette avacy:language-changed { lang, prev }.

Auto-detection

Se in config autoLanguage: true, il CMP rileva la lingua iniziale da document.documentElement.lang e re-detecta su MutationObserver. In quel caso changeLanguage resta utile come override programmatico.

See also

• Config language / autoLanguage / customLabels in UserConfigType
• Evento avacy:language-changed — vedi Events