Grund: vad module-banner är

module-banner är en minimal informationsrad som visas fixed i topp eller botten, avsedd för korta viktiga meddelanden och CTA-länkar.

Den har låg komplexitet, renderas direkt i template och kräver ingen tung modulruntime. Innehållet ligger i text_html och kan innehålla enkla länkar med trackingklass.

Modulen är bra för kampanjrad, kontaktuppmaning eller driftinfo som ska vara synlig utan att dominera sidans huvudsektioner.

Val 1: kärnnycklar och innehåll

Grundnycklarna är module_type, display, placement, aria_label, text_html och justify_content.

  • display styr om bannern renderas över huvud taget.
  • placement avgör topp eller botten.
  • text_html bär själva budskapet och kan innehålla <a>.
  • justify_content styr horisontell alignment i innehållscontainern.

Specialegenskap: bannern har ingen kortstruktur eller items-array, vilket gör datamodellen mycket enkel att underhålla.

Val 2: placement och första visning

I template sätts bannern med data-placement och kan ligga i toppen eller botten som fixed element. Det påverkar även hur menyknappen positioneras i scriptet.

Nuvarande HTML inkluderar data-show-on-first-scroll och data-delay-ms="2000". Scriptet väntar på första scroll och gör sedan en kontrollerad reveal med transition.

Det här betyder att bannern inte behöver visas direkt vid first paint, vilket kan ge lugnare initial vy på innehållstunga sidor.

Val 3: styling och appearance-tokens

Bannern tar banner.auto_class och banner.auto_style från appearance-parsern i builden. Färg och font kommer främst från design.background_colors.banner, design.text_colors.banner, design.text_colors.banner_link och design.font_sizes.banner.

Parsern hanterar i nuvarande core bland annat shadow, border(...), animate(...), hover(...), scale(...) och no-global.

Notera att dokumentationsexempel kan visa fler token-varianter. På en docs-sida är det bra att tydligt skilja mellan koncept i docs och exakt parserstöd i aktuell implementation.

Val 4: interaktion, länkar och tillgänglighet

Bannern renderas som role="region" med eget aria_label, vilket gör den begriplig i skärmläsare utan att behöva extra wrappers.

Länkar i text_html kan använda track-clicks för att fånga klick i den globala trackinglogiken. Linkfärgen styrs via CSS-variabeln --banner-link-color.

När prefers-reduced-motion är aktiv minskar transition-effekterna för first-scroll-varianten, vilket ger ett mer tillgängligt beteende för rörelsekänsliga användare.

Val 5: schema, SEO och AI-optimering

Bannerinnehåll bör normalt modelleras lätt, till exempel med WebPageElement. Vid larm/info av varningstyp kan SpecialAnnouncement vara mer korrekt. För rena kontaktuppmaningar kan ContactPoint vara lämpligt tillägg.

Håll schema kort och modul-lokalt: undvik att duplicera WebSite/Organization-noder här om de redan hanteras globalt.

SEO-mässigt fungerar bannern bäst som en tydlig kompletterande rad, inte som huvudcopy. Skriv därför kort, konkret text och använd länktext som faktiskt beskriver handlingen.