Every component of the theme, its variants and props, where it comes from in Figma, what it is made of,
where it is used — and how it could become an Apostrophe module. Generated from the components' doc comments.
86 components
12 groups
47 with variants
636 props
49 interactive
390 Figma nodes
35 pages
Overview
Groups
Phase 1 = elements, phase 2 = the Figma component pages, phase 3 = parts found while building the page templates. Click a group to filter the list below.
Phase 1 · Atoms shared by every block: buttons, chips, badges, slider nav, block heads.
icon file name in assets/icons (variant icon / glass)
type
button | submit
for <button>
attrs
string
extra raw attributes (Alpine hooks, data-*, aria-*)
class
string
extra classes
Raw doc comment
Button — Figma: Elements › Button (430:6158)
Pill call-to-action in 6 styles (primary, outline, light, link, icon, glass) with Figma hover states.
props
label string required
url string renders <a> when set, <button> otherwise
variant primary | outline | light | link | icon | glass default: primary
icon string icon file name in assets/icons (variant icon / glass)
type button | submit for <button>
attrs string extra raw attributes (Alpine hooks, data-*, aria-*)
class string extra classes
Apostrophe: fields label/url/variant map 1:1 to a "button" widget or a link area.
item id (saved in localStorage until real accounts exist)
saved
bool
initial state
label
string
accessible name (default "Ajouter aux favoris") default Ajouter aux favoris
tone
light | dark
light = white outline (on photos, default) · dark = primary outline (on white)
disc
bool
sits in a 32px white circle (cards, offer hero) — implies tone dark
class
string
Raw doc comment
Favourite toggle — Figma: Elements › heart-icon (836:70270)
Outline heart → filled heart on hover / when saved.
props
id string item id (saved in localStorage until real accounts exist)
saved bool initial state
label string accessible name (default "Ajouter aux favoris")
tone light | dark light = white outline (on photos, default) · dark = primary outline (on white)
disc bool sits in a 32px white circle (cards, offer hero) — implies tone dark
class string
Apostrophe: swap the Alpine store for a call to the favourites API.
render as a toggle <button> (Alpine) instead of a static <span>
input
{ type: radio | checkbox, name, value }
render as a form control (label + hidden input) — used as a real filter (listing category bar); `selected` = checked
url
string
render as a link
Raw doc comment
Pastille (category chip) — Figma: Trips › Pastille category (419:4539)
Outlined chip with a category pictogram. "Selected" state = filled primary
(Label11–19 in Figma) — used as filter toggles.
props
category hotel | boat | itinerary | dive-zone | trip | roadtrip | campervan | cruise | excursion | dive-center
label string (defaults to the French category name)
selected bool filled state
toggle bool render as a toggle <button> (Alpine) instead of a static <span>
input { type: radio | checkbox, name, value } render as a form control (label + hidden input) —
used as a real filter (listing category bar); `selected` = checked
url string render as a link
shared block heading (title + intro + optional action on the right). Seen on every homepage block (Experiences, Destinations, Trip type, Featured trips…).
Variants
align
start
center
size
md
sm
sm — 24px title on mobile (Figma Trip cross-selling 1025:60830 & other mobile blocks)
paragraph under the title (optional, may contain HTML via | safe upstream)
align
start | center
inverse
bool
white text (on brand / photo backgrounds)
wide
bool
let the title run the full width (long titles)
size
md | sm
sm = 24px title on mobile (Figma Trip cross-selling 1025:60830 & other mobile blocks); default md (32 mobile) default md
id
string
id on the heading — use for aria-labelledby on the parent <section>
caller
caller
use {% call sectionHead({...}) %}…{% endcall %} to put an action (button, toggle) on the right
Raw doc comment
Section head — shared block heading (title + intro + optional action on the right).
Figma: block titles of Expériences 1124:109121, Destinations 103:3216, Type de voyage 1124:109198.
Seen on every homepage block (Experiences, Destinations, Trip type, Featured trips…).
props
eyebrow string small label above the title (optional)
title string required
level 2 | 3 heading level (default 2)
intro string paragraph under the title (optional, may contain HTML via | safe upstream)
align start | center
inverse bool white text (on brand / photo backgrounds)
wide bool let the title run the full width (long titles)
size md | sm sm = 24px title on mobile (Figma Trip cross-selling 1025:60830 & other mobile blocks); default md (32 mobile)
id string id on the heading — use for aria-labelledby on the parent <section>
caller — use {% call sectionHead({...}) %}…{% endcall %} to put an action (button, toggle) on the right
Bar-style pagination (left) + round prev/next arrows (right). Built with Splide's class names so it drops straight into any .splide root: Splide fills .splide__pagination and wires .splide__arrow buttons.
Slider navigation — Figma: Elements › Slider Nav (547:29219)
Bar-style pagination (left) + round prev/next arrows (right).
Built with Splide's class names so it drops straight into any .splide root:
Splide fills .splide__pagination and wires .splide__arrow buttons.
props
variant default | tertiary | on-blue colour of the bars
arrows bool (default true)
dots bool (default true)
size md | sm sm = 32px arrows ("Arrow Small")
align between | center center = arrows only, centred ("Arrow Default")
Blue-light band with the page title and quick actions (Button - Icon - Small). On offer / hotel pages it sticks to the top of the viewport once the hero has scrolled away. desktop only (≥ lg) — below that the hero's buttons become the quick-actions bar.
pinned to the viewport top, revealed after `offset` px of scroll (default false = in flow) default false
offset
number
scroll distance before it appears when fixed (default 600) default 600
class
—
Raw doc comment
CTA bar — Figma: Top CTA Bar [fixed] 2057:42955 (1512 × 92) · agency: Button Agency [fixed] 677:53439
Blue-light band with the page title and quick actions (Button - Icon - Small). On offer / hotel pages
it sticks to the top of the viewport once the hero has scrolled away.
align=center (agency page): no title, the actions spread over a centred 768px group (Figma 677:53441),
desktop only (≥ lg) — below that the hero's buttons become the quick-actions bar.
props
title string required unless align=center
actions [{ label, icon: quote|calendar|call, url }]
align default | center
fixed bool pinned to the viewport top, revealed after `offset` px of scroll (default false = in flow)
offset number scroll distance before it appears when fixed (default 600)
class
Apostrophe: fields title + array of actions on the offer/hotel page type; on the agency page the
actions are the hero buttons.
Tertiary band above the header; messages scroll automatically (marquee), pause on hover/focus, and become a static, wrapping list when the user prefers reduced motion.
Info banner (bandeau information) — Figma: Menu - Guides + Bandeau information 494:30776 (top band, 1512 × 60)
Tertiary band above the header; messages scroll automatically (marquee), pause on hover/focus,
and become a static, wrapping list when the user prefers reduced motion.
props
messages [{ text, url, linkLabel }] required — emojis allowed in text
duration number seconds for one full loop (default 40)
class
Apostrophe: global "bandeau" settings — array field of messages (+ on/off toggle).
default: base (white = on photos / brand backgrounds) default base
url
string
link target (default "{{ root }}home.html"); false = no link default {{ root }}home.html
label
string
accessible name (default "Ultramarina — Plongée à la carte, accueil") default Ultramarina — Plongée à la carte, accueil
class
string
Raw doc comment
Logo — Figma: ⚙️ Charte Web › Logo (2112:28731): "Logo base" 2112:28909, "Logo white" 2112:28733
Vector rebuilt from the Figma layers (assets/brand/logo.svg, logo-white.svg).
props
variant base | white default: base (white = on photos / brand backgrounds)
url string link target (default "{{ root }}home.html"); false = no link
label string accessible name (default "Ultramarina — Plongée à la carte, accueil")
class string
Size is set by the parent through --logo-w (default 195px = header desktop).
Apostrophe: global setting (logo image + alt), rendered by the header/footer templates.
One data-driven component: a sidebar of categories (level 2) + a panel per category (level 3) + an optional extra column when a level-3 link has children (level 4) + a reassurance bar. Panel type is inferred from the data: category.cards → "selection" grid of photo cards (4 per row) category.children → link columns, headed by "ctaLabel →" (link to category.url)
menu node { label, children: [category] } required (one entry of navigation.main)
reassurance
[string]
texts of the bottom bar (omit = no bar)
id
string
element id (aria-controls target)
activeIndex
number
category shown first (default 0) default 0
activeSub
number
index of the level-3 link whose children are shown (default none) default none
static
bool
render in-flow (demo / docs) instead of as a header dropdown
attrs
—
class
—
Raw doc comment
Mega-menu — Figma: MegaMenus 802:62520 (Destination - Selection), 802:62521 (Destination - Caraîbes),
802:62522 (Nos voyages), 802:62523 (Expériences), 802:62524 (Guides)
One data-driven component: a sidebar of categories (level 2) + a panel per category (level 3)
+ an optional extra column when a level-3 link has children (level 4) + a reassurance bar.
Panel type is inferred from the data:
category.cards → "selection" grid of photo cards (4 per row)
category.children → link columns, headed by "ctaLabel →" (link to category.url)
props
item menu node { label, children: [category] } required (one entry of navigation.main)
reassurance [string] texts of the bottom bar (omit = no bar)
id string element id (aria-controls target)
activeIndex number category shown first (default 0)
activeSub number index of the level-3 link whose children are shown (default none)
static bool render in-flow (demo / docs) instead of as a header dropdown
attrs, class
category { label, url, count, ctaLabel, columns, rows, cards: [{ title, url, image }], children: [link] }
link { label, url, ctaLabel, children: [{ label, url }] }
Link columns: `columns` (default ceil(n / 10), max 4) balanced like CSS columns; or `rows` = fixed
number of links per column, filled column by column (e.g. Caraïbes: 10 then 4); or `split` = explicit
links per column (e.g. Croisières [3, 2, 2]).
Main item `minHeight` (px) overrides the menu body min-height (Guides: 536, leaves room for the info banner);
each value needs its `.mega-menu__body[data-min-h="…"]` rule in _mega-menu.scss. Columns 1–8 / rows 1–20
are matched through data-cols / data-rows (no inline styles).
Interaction (mega-menu.js): hover / focus a category → its panel; hover / focus a link with children
→ its column; ↑/↓ move between categories, → jumps into the panel.
Apostrophe: the header widget passes one main-menu node; fields mirror navigation.json.
Desktop (≥ xl): top bar (utility dropdowns, icons, language) + floating white bar (logo, main nav, contact button) + mega-menu under the bar. Mobile: white bar (logo, icons, burger) + full-screen drawer with drill-down levels built from the same menu tree. The utility row sits flush right inside the 1464 box (no inset); its dropdown items are flex rows. Every variant uses the same geometry: top nav 16 and white…
Variants
variant
overlay
overlay-dark
solid
overlay — positioned over the hero
overlay-dark — over a light hero (Hero LIGHT Variante "Blue light"): overlay position
navigation tree (see src/data/navigation.json) { main, utility, actions, languages, contact, reassurance }
variant
overlay | overlay-dark | solid
default overlay overlay-dark = over a light hero (Hero LIGHT Variante "Blue light"): overlay position, primary top bar overlay = positioned over the hero, white top bar (Top Nav "Light") solid = in the page flow on a light background, primary top bar (Top Nav "Dark"); same 16 / 56 offsets as overlay (connexion, booking steps) default overlay
openIndex
number
mega-menu open on load (docs / demo only)
openCategory
number
category shown in that mega-menu (docs / demo only)
openSub
number
level-3 link expanded in that category (docs / demo only)
class
—
Raw doc comment
Site header — Figma: Header 836:71901 (default 417:2887, mega-menu open: Variante2 836:71902,
Variante3 836:72071, Variante4 836:72163, Variante5 836:72331) · Nav Item 836:70596 (default / open)
· Top Nav 418:2999 (Light / Dark) · page frames Menu - Destination 494:26761, Menu - Guides 494:30776
Mobile: Header - Smartphone 1044:52001 (default 983:46524, Primary 1044:52297, Destinations 1044:52002,
Nos voyages 1044:52179, Croisières 1044:52426, Caraibes 1044:52470)
Desktop (≥ xl): top bar (utility dropdowns, icons, language) + floating white bar (logo, main nav,
contact button) + mega-menu under the bar. Mobile: white bar (logo, icons, burger) + full-screen
drawer with drill-down levels built from the same menu tree.
The utility row sits flush right inside the 1464 box (no inset); its dropdown items are flex rows.
Every variant uses the same geometry: top nav 16 and white bar 56 from the top of the page, so the
solid header does not shift between pages (booking steps bar then starts at 208).
Figma: Top Nav 418:2889 (utility row, flush right) · solid header on Espace connexion 2134:31393,
Tunnel - Step 1 593:48584
props
menu navigation tree (see src/data/navigation.json) { main, utility, actions, languages, contact, reassurance }
variant overlay | overlay-dark | solid default overlay
overlay-dark = over a light hero (Hero LIGHT Variante "Blue light"): overlay position, primary top bar
overlay = positioned over the hero, white top bar (Top Nav "Light")
solid = in the page flow on a light background, primary top bar (Top Nav "Dark"); same
16 / 56 offsets as overlay (connexion, booking steps)
openIndex number mega-menu open on load (docs / demo only)
openCategory number category shown in that mega-menu (docs / demo only)
openSub number level-3 link expanded in that category (docs / demo only)
class
Apostrophe: header lives in the layout; `menu` = the navigation global (same shape as navigation.json).
Sub-menu (dropdown panel) — Figma: Sub-menu 1445:49464
White card with a vertical list of bold links. Used by the header top bar
(Pratique / Ultramarina / language switcher) but works standalone.
props
items [{ label, url, current, code }] required (code = language code → lang/hreflang)
id string element id (for aria-controls on the trigger)
label string aria-label of the list
class string
attrs string extra raw attributes (x-show, @click.outside…)
Apostrophe: an array field of links (label + url) on the parent menu node.
12px single line, "›"-style ">" separators, colour inherited from the hero (white on photo / primary, primary on blue-light). The last item is the current page (no link, aria-current).
Breadcrumb ("Fil ariane") — Figma: every Hero / Header (e.g. 530:55708, 494:23268, 754:43162)
12px single line, "›"-style ">" separators, colour inherited from the hero (white on photo /
primary, primary on blue-light). The last item is the current page (no link, aria-current).
props
items [{ label, url }] last item = current page
class string
Apostrophe: build `items` from page ancestors (data.page._ancestors) + the current page title.
white icon buttons (Agency) — desktop; on mobile they become the quick-actions Buttons Bar 1092:85317 (shortLabel, default Devis / RDV / Appel by icon) default Devis
Full-bleed photo + scrim, breadcrumb, H1, text, arrow button, and a frosted "destinations" panel (tab + 3 columns of links) bottom-right. No mobile mock-up: panel goes full width, 2 columns.
Full-bleed video with scrim, outlined frame (desktop), eyebrow + H1, search bar, copyright + play/pause pill, trust bar underneath (trust-bar component, footer group). The video can't be exported from Figma → media-placeholder until `video.src` is set.
optional — poster alone = still frame (Figma 547:26142 render); placeholder when both are empty
credit
string
copyright pill
search
object
searchBar props (types, destinations, action…)
trustItems
[{ label }]
reassurance claims (omit to hide the band)
Raw doc comment
Homepage hero — Figma: Homepage 494:25974 › Hero Home 547:26141 (bg video 547:26142)
mobile: Home - mobile › Hero / Header HOMEPAGE 977:38890 + Reassurance 977:39027
Full-bleed video with scrim, outlined frame (desktop), eyebrow + H1, search bar, copyright +
play/pause pill, trust bar underneath (trust-bar component, footer group).
The video can't be exported from Figma → media-placeholder until `video.src` is set.
props
eyebrow string "Voyage plongée"
title string H1 (\n = line break)
video { src, poster } optional — poster alone = still frame (Figma 547:26142 render);
placeholder when both are empty
credit string copyright pill
search object searchBar props (types, destinations, action…)
trustItems [{ label }] reassurance claims (omit to hide the band)
Header: overlays the hero; the content sits low in the frame so no extra top padding is needed.
Apostrophe: "home-hero" widget; video = attachment field, search options from pieces.
trip / hotel product hero. Desktop: sticky info column (left) + photos stacked (right). Mobile: Splide gallery (prev/next over the photo) then the content. The gallery is one Splide that is destroyed ≥ 1024px (photos stack).
pictograms (pastille category keys: cruise, hotel, boat, itinerary, campervan, roadtrip, dive-zone, dive-center, excursion). On the primary background (variant primary, and always on mobile) they use the cat-<key>-light.svg icons: light-blue #DDE9F4 circle, #183F65 glyph (Figma pastille 754:43716, instance I754:43964;754:43716); excursion has no light icon and falls back to cat-excursion.svg
facts
[string]
"Séjour plongée | Niveau Débutant | Hôtel 4*"
locationUrl
string
"(voir la localisation)" link after the last fact
description
string
price
{ label, amount, duration, durationInfo }
duration = "pour 7 jours", durationInfo = tooltip text
bookUrl
string
"Réserver"
actions
[{ label, url }]
outline buttons (Appeler un conseiller, Prendre RDV…) — desktop only
quickActions
[{ label, url, icon }]
mobile Buttons Bar 1092:85347 (default Devis / RDV / Appel); false = no bar default Devis
images
[{ src, alt }]
credit
string
optional photo credit (copyright pill) — Figma's OFFER heroes show none, so the site pages do not pass one
class
—
Raw doc comment
Hero / Header OFFER — trip / hotel product hero.
Figma: OFFER 754:43596 — Default 754:43400 (blue-light) · Primary 754:43597 (primary bg) · Variante3 770:45612
mobile: Hero / Header OFFER 1154:124973 (gallery slider on top, content on primary)
Desktop: sticky info column (left) + photos stacked (right). Mobile: Splide gallery (prev/next over the
photo) then the content. The gallery is one Splide that is destroyed ≥ 1024px (photos stack).
props
variant default | primary background (mobile is always primary)
priceLayout default | compact (default default) — default = price + "Réserver" arrow button (Default/Primary); compact = plain "Réserver" + stacked price (Variante3)
breadcrumb [{ label, url }]
title string (H1)
rating { score, count, url }
favId string favourite id (heart)
categories [{ category, label }] pictograms (pastille category keys: cruise, hotel, boat, itinerary, campervan,
roadtrip, dive-zone, dive-center, excursion). On the primary background
(variant primary, and always on mobile) they use the cat-<key>-light.svg
icons: light-blue #DDE9F4 circle, #183F65 glyph (Figma pastille 754:43716,
instance I754:43964;754:43716);
excursion has no light icon and falls back to cat-excursion.svg
facts [string] "Séjour plongée | Niveau Débutant | Hôtel 4*"
locationUrl string "(voir la localisation)" link after the last fact
description string
price { label, amount, duration, durationInfo } duration = "pour 7 jours", durationInfo = tooltip text
bookUrl string "Réserver"
actions [{ label, url }] outline buttons (Appeler un conseiller, Prendre RDV…) — desktop only
quickActions [{ label, url, icon }] mobile Buttons Bar 1092:85347 (default Devis / RDV / Appel);
false = no bar
images [{ src, alt }]
credit string optional photo credit (copyright pill) — Figma's OFFER heroes show none, so the
site pages do not pass one
class
Light pastille icons: cruise / hotel exported from Figma; boat / itinerary / campervan / roadtrip recoloured
from the -inverse icons; dive-zone / dive-center drawn in-house (Figma has no round version).
Apostrophe: fields come from the trip piece (rating, categories, facts, price…); images = gallery relationship.
stand-in for media that can't be exported from Figma (hero videos). Primary → secondary gradient with a faint centred play glyph + "Vidéo" label. Structured like a media slot: swap the inner markup for a real <video>/<img> (same .media-placeholder root keeps the cover positioning).
Media placeholder — stand-in for media that can't be exported from Figma (hero videos).
Primary → secondary gradient with a faint centred play glyph + "Vidéo" label.
Structured like a media slot: swap the inner markup for a real <video>/<img> (same .media-placeholder
root keeps the cover positioning).
props
type video | image default video
label string default "Vidéo" / "Image"
class string
mobile "Buttons Bar" (Devis / RDV / Appel). three small white icon pills. Hidden on desktop, where the hero shows its full-size buttons. Rendered by `hero-offer` and `hero` (agency) — not meant to be placed on its own.
default: Devis / RDV / Appel (global routes) default Devis
class
—
Raw doc comment
Quick actions — mobile "Buttons Bar" (Devis / RDV / Appel).
Figma: Buttons Bar 1092:85347 (trip page mobile 1011:58576) · 1092:85317 (agency page mobile 1011:61068)
pills = Button - Icon - Small 818:67866
Mobile only (< lg): blue-light bar pinned to the bottom of the viewport (same y in every mobile frame),
three small white icon pills. Hidden on desktop, where the hero shows its full-size buttons.
Rendered by `hero-offer` and `hero` (agency) — not meant to be placed on its own.
props
items [{ label, url, icon: quote|calendar|call }] default: Devis / RDV / Appel (global routes)
class
Apostrophe: no widget of its own — fields come from the hosting hero.
Frosted bar with three pill fields + white submit. Used inside hero-home, reusable on listing pages. The date field is a plain input with `data-datepicker` (basic Litepicker init in search-bar.js; the themed date picker lives in the trips group).
Search bar — Figma: Homepage › Search Bar (809:64995, desktop 960×100) · mobile 977:38923 (stacked)
Frosted bar with three pill fields + white submit. Used inside hero-home, reusable on listing pages.
The date field is a plain input with `data-datepicker` (basic Litepicker init in search-bar.js;
the themed date picker lives in the trips group).
props
action string form action (default "#")
types [{ value, label }] "Type de voyage" options
destinations [{ value, label }] "Destination" options
typeLabel, destinationLabel, dateLabel, submitLabel strings (French defaults)
class
Apostrophe: options come from the trip-type and destination pieces; action = the trips listing page.
Photo hero with white outline frame (open top), big white title and a frosted text box, followed by a row of 3 link panels (brand / plain / bordered). (not on the mobile mock-up — kept so the content isn't lost).
Ultramarina presentation — Figma: Homepage component › Ultramarina presentation (1124:120465)
mobile: Ultramarina presentation (1152:124516)
Photo hero with white outline frame (open top), big white title and a frosted text box,
followed by a row of 3 link panels (brand / plain / bordered).
Mobile: no frame, title top-left, frosted box bottom-right; link panels stacked
(not on the mobile mock-up — kept so the content isn't lost).
props
title string
text string
image string background photo path
links [{ titleStrong, titleLight, label, url, style: brand|plain|bordered }]
raw attributes — Alpine binding, e.g. ':aria-checked="showMap.toString()" @click="showMap = !showMap"'
class
string
Raw doc comment
Button Switch — Figma: Carte / Map › Button Switch (1977:39651)
default 1977:39650 (on: "Masquer la carte", primary thumb right)
Variante2 1977:39652 (off: "Afficher la carte", grey thumb left)
A role="switch" button; state = aria-checked. Both labels are rendered, CSS shows the matching one.
props
checked bool initial state
labelOn string label while checked (e.g. "Masquer la carte")
labelOff string label while unchecked (e.g. "Afficher la carte")
attrs string raw attributes — Alpine binding, e.g.
':aria-checked="showMap.toString()" @click="showMap = !showMap"'
class string
Title (+ optional "• subtitle"), description, divider, "dès" price tag + "Découvrir" link. Optional 90×74 thumbnail (list view). Active state (selected on the map) = primary fill. Inside destinations-map the card is wired to Alpine (selection ↔ map marker).
add the Alpine select hooks (used by destinations-map)
class
string
Raw doc comment
Destination card — Figma: Carte / Map › Destination card (inside Destination List 103:3501,
Block: Destinations (list) 1127:123933, mobile 1539:36638 / 1025:63254)
Title (+ optional "• subtitle"), description, divider, "dès" price tag + "Découvrir" link.
Optional 90×74 thumbnail (list view). Active state (selected on the map) = primary fill.
Inside destinations-map the card is wired to Alpine (selection ↔ map marker).
props
id string key used to link card ↔ marker
title string required
subtitle string e.g. country ("Mexique")
text string
price string formatted, e.g. "2 299 €"
priceLabel string default "dès"
url string
linkLabel string default "Découvrir"
image string optional thumbnail path
level 2-4 heading level (default 3)
active bool static active state (no Alpine)
selectable bool add the Alpine select hooks (used by destinations-map)
class string
Section head + "Masquer / Afficher la carte" switch (button-switch). Map shown: desktop = scrolling card column (448px, fixed 912px height) + static map; Map hidden: cards in a grid (3 cols desktop / 2 compact cols mobile), grouped by region when groupByRegion is on. Selecting a card highlights its marker (+ popup); clicking a marker selects and reveals its card. The map is a static basemap image with markers at…
Block: Destinations (map) — Figma: Carte / Map › Block: Destinations (map) 103:3216
List With Map 103:3497 · List 1977:39877 · Block: Destinations (list) 1127:123933
mobile: Block: Destinations (list) 1154:127350 (Default 1025:63254, Lists 1539:36447,
Lists with Map 1539:36638, With Map 1154:127351, Variante5 2134:44454)
Section head + "Masquer / Afficher la carte" switch (button-switch).
Map shown: desktop = scrolling card column (448px, fixed 912px height) + static map;
mobile = map on top, cards below.
Map hidden: cards in a grid (3 cols desktop / 2 compact cols mobile), grouped by region
when groupByRegion is on.
Selecting a card highlights its marker (+ popup); clicking a marker selects and reveals its card.
Mobile starts with nothing selected and navy markers (Figma 1154:127261); desktop starts on `active`.
The map is a static basemap image with markers at data-driven % coordinates of the IMAGE
(the image is cover-cropped, markers follow it). To move to Leaflet/Mapbox, replace
.dest-map__canvas: items already carry x/y (→ lng/lat) and the Alpine API (active, select()) stays.
props
title, intro strings
showMap bool initial switch state (default true)
groupByRegion bool group cards under region headings (shown when the map is hidden)
active string id of the initially selected destination (default: first)
mapImage string basemap image path
mapRatio string basemap aspect ratio "w / h" (e.g. "3024 / 1896")
mapAlt string
labelShowMap / labelHideMap switch labels (default "Afficher la carte" / "Masquer la carte")
mobileLimit number cards listed under the map on mobile (Figma 1154:127261 lists 7; the rest stay on desktop)
items [{ id, title, subtitle, region, text, price, url, image, x, y }]
x / y = marker tip position in % of the basemap image
id string anchor (default "destinations")
optional photo alt (decorative by default — the title labels the link) default —
tall
bool
spans two grid rows in the Experiences mosaic
Raw doc comment
Experience card — Figma: Homepage component › Experience card (873:35516)
default 873:35493 · Variante2 (hover) 873:35517 → CSS :hover (photo zooms, arrow circle turns primary)
Photo + primary 20% tint, frosted label bar (title + round arrow) pinned to the bottom.
props
title string required
url string link target
image string photo path (relative to site root)
alt string optional photo alt (decorative by default — the title labels the link)
tall bool spans two grid rows in the Experiences mosaic
Desktop: pages of 5 cards in a 3-column mosaic (3rd card of each page is tall), Splide pages + slider nav (bars + arrows) under the first two columns. The markup is rendered as desktop pages; experiences.js regroups the same cards (one per slide) below the lg breakpoint and remounts Splide on breakpoint change.
Block: Expériences — Figma: Homepage component › Block: Expériences (1124:109121)
mobile: Home - mobile › Block: Expériences (977:39035)
Desktop: pages of 5 cards in a 3-column mosaic (3rd card of each page is tall), Splide pages
+ slider nav (bars + arrows) under the first two columns.
Mobile: one card per slide (360×330), centred arrows only.
The markup is rendered as desktop pages; experiences.js regroups the same cards
(one per slide) below the lg breakpoint and remounts Splide on breakpoint change.
props
title string
intro string
items [{ title, url, image, alt }] repeater (5 per desktop page)
id string optional anchor
Blurred photo background, white title, groups of pill links. Desktop: thin white frame with the top-left corner open around the title. Mobile: no frame, everything stacked.
each group = one row of pills on desktop accent: bool — indigo label (2nd pill on the mock-up)
Raw doc comment
Block: Guide — Figma: Homepage component › Block: Guide (687:40295)
mobile: Block: Guide (1152:124450) / Section Guide (1154:125768)
Blurred photo background, white title, groups of pill links. Desktop: thin white
frame with the top-left corner open around the title. Mobile: no frame, everything stacked.
props
title string
image string background photo path
groups [{ links: [{ label, url, accent }] }] each group = one row of pills on desktop
accent: bool — indigo label (2nd pill on the mock-up)
Block: Type de voyage — Figma: Homepage component › Block: Type de voyage (1124:109198)
mobile: Block: Type de voyage (1147:124448)
Desktop: first row of 4 cards, following rows of 3 (12-col grid). Mobile: stacked bordered rows.
props
title string
intro string
items [{ title, url, image, alt }] repeater (4 + 3 on the mock-up)
id string optional anchor
Wraps Litepicker 2.0.12 (global `Litepicker`, loaded by the layout) — French locale, Monday first, DOM fully re-themed in _date-picker.scss. Month grid + flexibility chips are Alpine.
regular-weight end of the title ("thématique" in "Voyages liés à la thématique")
intro
string
layout
slider | grid | grid-slider
default: slider grid-slider = 4-col grid from lg (all offers visible), peek slider + centred arrows below lg (mobile frames of Page agence 1011:61068 / Reportage 1021:56223) default slider
background
alt | white
default: alt (slider) / white (grid) default alt
offers
array
offer-card props (see components/offer-card)
buttons
array
[{ label, url, variant: primary|outline }]
headSize
string
"sm" = section-head--sm (24px mobile title)
id
string
Raw doc comment
Featured trips — Figma: Block: Featured trips 162:10504
List of 4 offers 100:1447 (grey background, Splide slider: 4-up desktop, peek on mobile, 2 buttons)
List of 8 offers linked to a page / theme 475:11406 (white background, grid, title with a light part)
props
title string "Découvrez nos voyages"
titleLight string regular-weight end of the title ("thématique" in "Voyages liés à la thématique")
intro string
layout slider | grid | grid-slider default: slider
grid-slider = 4-col grid from lg (all offers visible), peek slider + centred arrows below lg
(mobile frames of Page agence 1011:61068 / Reportage 1021:56223)
background alt | white default: alt (slider) / white (grid)
offers array offer-card props (see components/offer-card)
buttons array [{ label, url, variant: primary|outline }]
headSize string "sm" = section-head--sm (24px mobile title)
id string
Desktop: stacked accordion panels + "Réinitialiser". Mobile (< lg): primary bar with a button that opens the same form as a bottom sheet (Alpine, Esc / backdrop closes, focus returns to the button).
text | email | tel | number | date | textarea | select | checkbox | radio | range
name
—
id
—
value
—
placeholder
—
required
—
disabled
—
label
string
visible label (text-like fields: above; checkbox/radio: right of the box)
hideLabel
bool
keep the label for screen readers only (placeholder-style fields like the Figma form)
size
md | sm
sm = 40px compact field (filter sidebar budget)
suffix
string
unit after the field ("€")
icon
string
icon file name shown at the right of a text field
options
array
select: [{ value, label, selected }]
rows
number
textarea (resize: none — the Figma boxes have no grip; long text scrolls)
checked
bool
checkbox / radio
count
number
checkbox / radio: "(12)" after the label
strong
bool
checkbox: bold label (top level of a tree)
range (two thumbs + two number fields)
min
—
max
—
step
—
valueMin
—
valueMax
—
unit
—
attrs
string
raw attributes on the control
class
string
Raw doc comment
Form field — generic inputs used by the filter sidebar, search and contact/quote forms.
Figma: Contact - Devis 511:51839 › Quote request form 523:52894 (pill inputs 56px, select ▼, textarea)
Filter Sidebar 653:41726 (radios 494:27058, checkbox tree 494:27081, number range + slider 737:54291)
props
type text | email | tel | number | date | textarea | select | checkbox | radio | range
name, id, value, placeholder, required, disabled
label string visible label (text-like fields: above; checkbox/radio: right of the box)
hideLabel bool keep the label for screen readers only (placeholder-style fields like the Figma form)
size md | sm sm = 40px compact field (filter sidebar budget)
suffix string unit after the field ("€")
icon string icon file name shown at the right of a text field
options array select: [{ value, label, selected }]
rows number textarea (resize: none — the Figma boxes have no grip; long text scrolls)
checked bool checkbox / radio
count number checkbox / radio: "(12)" after the label
strong bool checkbox: bold label (top level of a tree)
-- range (two thumbs + two number fields) --
min, max, step, valueMin, valueMax, unit
attrs string raw attributes on the control
class string
Hover states (shadow, light tab) are CSS. "With Dates" = the tab toggles a Date dispo panel (Alpine `offerCard`, assets/js/offer-card.js); one panel is open at a time. Outside a listing the panel opens inline in the card (tab reads "Fermer"). Inside a listing grid the panel is a separate block under the card (tab keeps its label): with 2+ columns it spans the whole row, one row gap below; horizontal (cruise)…
Offer card — Figma: Trips › Offer card 418:3200 and Cruises card 583:33239
Offer card: Par défaut 418:3199 · Hover 818:69011 · Variante4 677:51529 (tab hover) · With Dates 1492:49510
Bon plan 418:3201 · Variante7 818:67937 (saved, no tab) · Variante9 983:48548 (hover, no tab)
CTA 583:33127 · CTA TYPO SCRIPT 737:40898 · Two Buttons 780:48511
Cruises card (= layout "horizontal"): Par défaut 435:9178 · Hover 818:69758 · Variante3 677:51704
CTA 583:33240 · Variante4 737:54607 (CTA script)
Hover states (shadow, light tab) are CSS. "With Dates" = the tab toggles a Date dispo panel (Alpine `offerCard`,
assets/js/offer-card.js); one panel is open at a time. Outside a listing the panel opens inline in the card
(tab reads "Fermer"). Inside a listing grid the panel is a separate block under the card (tab keeps
its label): with 2+ columns it spans the whole row, one row gap below; horizontal (cruise) cards
always use the separate panel, at every width (desktop 20 under the card; mobile framed panel 18 under, card
width). That panel is framed (1px stroke inside the 24px padding → 486 tall) with a 16px bold title.
On resize only the open card re-places its panel.
Figma: row panel 666:45410 · cruise panel 494:27249
Figma mobile: cruise panel 1210:39841 / 1492:57836
props
layout vertical | horizontal horizontal = Cruises card (stacks on mobile)
variant offer | cta cta = blurred photo + title + text + buttons
image, imageAlt path relative to the site root ("assets/img/…")
url string link on the title (stretched over the card)
badges array [{ label, variant: default|promo }]
country string
title string
level number number of level pictograms (0 = hidden)
summary string bold first line ("Niveau - 7 nuits - Hôtel 4*")
description string
priceLabel string default "à partir de"
price string "2 299 €" — omit and set priceText for "Prix sur demande"
priceText string
favId string favourite id (heart) · saved bool
datesLabel string bottom tab ("Voir les dates disponibles", "Départs sur mesure"); omit to hide the tab
closeLabel string tab label while an inline panel is open (default "Fermer")
datesUrl string tab as a link (when no dates array)
dates array departures → tab expands a Date dispo panel (see date-dispo props and the panel notes above)
open bool dates panel initially open (Figma listing frames show the first card open)
datesMoreUrl string
-- cta variant --
ctaScript bool title in Meow Script ("CTA TYPO SCRIPT")
text string
buttons array [{ label, url, variant: primary|outline }] (stacked, right-aligned)
default light · light = white frosted panel (Par défaut); dark = black 20% glass + blur 27 (Variante2/3 and with Button), token --banner-glass-dark; dark is used by every site page (agence · contenu-avance · croisieriste · destination-croisiere · destination-indonesie · experience · reportage). Below lg both render the light glass panel (Figma mobile: light glass everywhere) default light
label
string
optional white tab above the panel (Variante3 "Libellé facultatif")
button
{ label, url }
optional white arrow button in the panel ("with Button")
Banner — Figma: Content / Media › Banner with Text [section] (547:29397)
Par défaut 530:58275 · Variante2 547:29398 · Variante3 547:29491 · with Button 547:30773
Banner with CTA (547:29406) = this banner + the CTA strip (cta-strip component) underneath.
Dark panel on the site pages: 754:44427 (instance I754:44427 — black 20% + backdrop blur 27)
Full-width photo, thin white outline frame, big title top-left, frosted text panel bottom-right.
props
image string file in assets/img (required)
imageAlt string
title string bold part of the title
titleLight string regular-weight end of the title ("voyage")
text string panel text
variant light | dark default light · light = white frosted panel (Par défaut); dark = black 20% glass + blur 27 (Variante2/3 and
with Button), token --banner-glass-dark; dark is used by every site page (agence ·
contenu-avance · croisieriste · destination-croisiere · destination-indonesie · experience ·
reportage). Below lg both render the light glass panel (Figma mobile: light glass everywhere)
label string optional white tab above the panel (Variante3 "Libellé facultatif")
button { label, url } optional white arrow button in the panel ("with Button")
ctas [{ label, url, icon }] optional CTA strip below (Banner with CTA); icon: quote | call | calendar
level 2 | 3 heading level (default 2)
Apostrophe: "banner" widget — image relationship, variant select (dark on every site page), optional label /
button / ctas.
sm = 24px mobile title (section-head size; Figma mobile Destinations 1044:51026)
posts
[post-card props]
(contentPosts.json)
modalButton
{ label, url }
button at the bottom of the option drawer
layout
slider | grid
grid (featured variant) = every card visible in a 4-column grid from lg (desktop "Featured [section]" 530:59241, e.g. Bibliographie / Mise en avant); stays a peek slider below lg. Default slider. default slider.
Raw doc comment
Featured posts — Figma: Block: Featured Posts (475:14747)
whats-new Nouveauté (100:1902) grey bg, post cards with tag
destinations Destinations (475:14748) eyebrow + price
options Options (577:30286) arrow buttons
options-popup Options - Popup (666:47672) links open a drawer modal with the option detail
simple Simple (889:58077)
featured mobile Destinations/Featured (1021:55865): blue-light bg, bracketed title, photo + label cards
Splide: 3-up desktop (gap 20), 1-up below md; slider nav under the cards (arrows centred on mobile).
props
id string unique id (modal id for options-popup)
variant see above
title string bold part of the H2
titleLight string regular end of the H2 ("populaires")
intro string
headSize md | sm sm = 24px mobile title (section-head size; Figma mobile Destinations 1044:51026)
posts [post-card props] (contentPosts.json)
modalButton { label, url } button at the bottom of the option drawer
layout slider | grid grid (featured variant) = every card visible in a 4-column grid from lg
(desktop "Featured [section]" 530:59241, e.g. Bibliographie / Mise en avant);
stays a peek slider below lg. Default slider.
grid = 4-up 244px photos with captions (Splide only below lg), slider = 6-up 158px thumbnails + slider nav
images
[{ src, alt, caption }]
src = file in assets/img
mobile
full | peek
slider only, below md: full = full-bleed photo + arrows over it (1043:48426, default) peek = 158px thumbnails with the next one peeking + centred arrows (1021:56898)
lightbox
bool
default true default true
Raw doc comment
Gallery — Figma: Content / Media › 100% width gallery (530:55507, grid)
100% width gallery [slider] (530:58067)
mobile: 100% width gallery grid (1154:125353) → peek slider · Slider (1043:48426) → full-bleed slider
Every photo opens a full-screen lightbox (modal variant "lightbox" + Splide), starting on the clicked photo.
props
id string unique id (lightbox modal id = id ~ "-lightbox")
variant grid | slider grid = 4-up 244px photos with captions (Splide only below lg),
slider = 6-up 158px thumbnails + slider nav
images [{ src, alt, caption }] src = file in assets/img
mobile full | peek slider only, below md: full = full-bleed photo + arrows over it (1043:48426, default)
peek = 158px thumbnails with the next one peeking + centred arrows (1021:56898)
lightbox bool default true
Responsive 960×560 video / iframe with a poster + YouTube-style play button. The iframe is only injected on click (no third-party load before consent / interaction). Without a poster the conventional video placeholder (brand gradient + play glyph + "Vidéo") is shown.
iframe src (YouTube/Vimeo embed URL, autoplay is appended on click)
poster
string
file in assets/img (optional)
titlerequired
string
accessible title of the video (required for the iframe title)
caption
string
legend under the frame ("Légende de la vidéo")
Raw doc comment
Media embed — Figma: Content / Media › Iframe (530:57566)
Responsive 960×560 video / iframe with a poster + YouTube-style play button. The iframe is only
injected on click (no third-party load before consent / interaction). Without a poster the
conventional video placeholder (brand gradient + play glyph + "Vidéo") is shown.
props
embedUrl string iframe src (YouTube/Vimeo embed URL, autoplay is appended on click)
poster string file in assets/img (optional)
title string accessible title of the video (required for the iframe title)
caption string legend under the frame ("Légende de la vidéo")
optional list — numbered circles on mobile ("With List" 1025:58379), dots on desktop (1124:120570)
buttons
[{ label, url, variant }]
first = Full, others = Border by default
reverse
bool
text left / media right (50/50 text / media)
Raw doc comment
Media / text 50-50 — Figma: Media / Text › 50/50 - media / text (1124:120569), 50/50 - text / media (1124:120570)
mobile 50/50 (1025:58359): Par défaut 1020:47028 · With Buttons 1025:58360 · With List 1025:58379
Photo (682×448, radius 12, optional caption) + H2 / text / buttons or numbered list.
Mobile: photo on top, text below (both orders).
props
image string file in assets/img
imageAlt string
caption string "Légende de la photo" (optional)
title string H2
text string paragraph (plain text) — or html for rich content
html string rich text alternative to text (rendered | safe)
list [string] optional list — numbered circles on mobile ("With List" 1025:58379), dots on desktop (1124:120570)
buttons [{ label, url, variant }] first = Full, others = Border by default
reverse bool text left / media right (50/50 text / media)
Generic Alpine dialog reused by every popup of the theme. Open from anywhere: @click="$dispatch('open-modal', 'my-id')" or with data: @click="$dispatch('open-modal', { id: 'my-id', data: { title: '…' } })" → inside the caller content, `data` holds the payload (x-text="data.title", x-html="data.body"). Behaviour: Esc / overlay / close button close it, focus is trapped in the panel and restored to the trigger, page…
Variants
variant
drawer
center
lightbox
drawer — right panel 746px (Figma)
center — centred card
lightbox — full-screen dark (galleries) lightbox = full-screen dark (galleries)
Modal — Figma: Popup - Centre de plongée (754:43157) · Featured Posts › Options - Popup (666:47672)
Popup - Avis voyage (2271:35051) · gallery lightbox (530:55507)
Generic Alpine dialog reused by every popup of the theme.
Open from anywhere: @click="$dispatch('open-modal', 'my-id')"
or with data: @click="$dispatch('open-modal', { id: 'my-id', data: { title: '…' } })"
→ inside the caller content, `data` holds the payload (x-text="data.title", x-html="data.body").
Behaviour: Esc / overlay / close button close it, focus is trapped in the panel and restored
to the trigger, page scroll is locked while open.
props
id string required — DOM id + event key
variant drawer | center | lightbox drawer = right panel 746px (Figma), center = centred card,
lightbox = full-screen dark (galleries)
title string static heading (Medium 24 primary); use titleBind for a dynamic one
titleBind string Alpine expression for the heading, e.g. "data.title"
label string aria-label when there is no visible title
rows [{ label, value }] striped spec table ("Centre de plongée")
button { label, url } primary arrow button under the content
caller — free content: {% call modal({...}) %}…{% endcall %}
Pagination — Figma: Pagination instance (494:41208) used on the reviews page (Témoignages Variante3 494:41727)
and in Popup - Avis voyage (2271:35051). 32px round items, current = primary disc.
props
current number current page (1-based)
total number page count
url string page URL pattern, "{n}" replaced by the page number (default "?page={n}")
label string aria-label (default "Pagination")
several badges on the photo, e.g. ["Indonésie", "Phil Simha"] (reportage cards 931:40224); the PAYS / AUTEUR pills are 12px / 18 line height, black, 26 tall (Figma 931:40559, mobile 1021:54520) — a post-card rule, the shared badge is unchanged
eyebrow
string
country (destination)
title
string
excerpt
string
price
string
"2 299 €" (destination)
priceLabel
string
default "à partir de" default à partir de
link
{ label, url }
modalId
string
when set, the link/button opens that modal instead of navigating (Options - Popup)
modalData
object
payload passed to the modal ({ title, body })
level
—
heading level (default 3) default 3
Raw doc comment
Post card — Figma: Block: Featured Posts (475:14747) cards
post Nouveauté / What's new (100:1902): photo + tag badge, title, excerpt, underlined link
destination Destinations (475:14748) + mobile Price (1044:51090): country eyebrow, "à partir de" price chip
option Options (577:30286): title, excerpt, primary arrow button
simple Simple (889:58077): title, excerpt, link
feature mobile Destinations/Featured (1021:55865): photo + bold label + round arrow
Photo 448×320 (radius 12, primary 20% wash). Card itself is white, radius 12.
props
variant post | destination | option | simple | feature
image, imageAlt
tag string badge on the photo (post; destination on mobile)
tags [string] several badges on the photo, e.g. ["Indonésie", "Phil Simha"] (reportage cards 931:40224);
the PAYS / AUTEUR pills are 12px / 18 line height, black, 26 tall (Figma 931:40559,
mobile 1021:54520) — a post-card rule, the shared badge is unchanged
eyebrow string country (destination)
title string
excerpt string
price string "2 299 €" (destination)
priceLabel string default "à partir de"
link { label, url }
modalId string when set, the link/button opens that modal instead of navigating (Options - Popup)
modalData object payload passed to the modal ({ title, body })
level heading level (default 3)
Long-form CMS content, 960px column. Extends the base `.rte` class with the Figma heading scale (H2 36 bold navy · H3 32 medium secondary · H4 28 · H5 24 · H6 18 bold primary), primary dot bullets and numbered circles for ordered lists. Also used inside media-text and modals (class "rte rich-text").
rich text (Apostrophe rich-text widget output) — rendered | safe
buttons
[{ label, url, variant }]
optional buttons row (Button Full / Border)
narrow
bool
wrap in .container--narrow (default true when used as a section) default true
section
bool
render as its own <section class="section"> (default true) default true
class
string
extra class on the section (or on the text block when section is false) — page spacing hooks
variant
default | lead | interview
lead = 18px body, 27px paragraph spacing, H2 → text 24; interview = questions 36/42 primary, answer 30 under (Figma 530:59231) (offer pages: Boat content 884:55348 · centre 577:30811)
Raw doc comment
Rich text — Figma: Content / Media › 100% width content (859:88397) · mobile 100% content (1704:16060)
Long-form CMS content, 960px column. Extends the base `.rte` class with the Figma heading
scale (H2 36 bold navy · H3 32 medium secondary · H4 28 · H5 24 · H6 18 bold primary),
primary dot bullets and numbered circles for ordered lists.
Also used inside media-text and modals (class "rte rich-text").
props
html string rich text (Apostrophe rich-text widget output) — rendered | safe
buttons [{ label, url, variant }] optional buttons row (Button Full / Border)
narrow bool wrap in .container--narrow (default true when used as a section)
section bool render as its own <section class="section"> (default true)
class string extra class on the section (or on the text block when section is false) — page spacing hooks
variant default | lead | interview lead = 18px body, 27px paragraph spacing, H2 → text 24;
interview = questions 36/42 primary, answer 30 under (Figma 530:59231)
(offer pages: Boat content 884:55348 · centre 577:30811)
Blurred full-width photo, script title + intro with a top-right corner bracket, one 767px quote card per slide (Splide) with arrows on both sides and white/primary bars.
Staff testimonials — Figma: Staff testimonials (859:90101): Par défaut 530:58901 · Big title 859:90102
mobile 1021:56796 (1020:47584 "Nos collaborateurs témoignent", 1021:56797 "Notre conseil")
Blurred full-width photo, script title + intro with a top-right corner bracket, one 767px quote card
per slide (Splide) with arrows on both sides and white/primary bars.
props
title string script title ("Notre conseil")
intro string
image string background photo (assets/img)
variant default | big big = quote only, 24px bold (Big title)
items [{ quote, text, author, role, photo }]
Team — Figma: Media / Text › Team (530:56080): White BG 530:56011 · Blue BG 530:56081
Bracketed H2 + intro on the right, then a Splide slider of 331×398 portrait cards with a frosted
name plate and LinkedIn link.
Slider nav: desktop = bars + arrows; below lg the arrows only, centred (Figma mobile Slider Nav 1015:44046).
props
title string bold part ("Une équipe")
titleLight string regular part ("d'experts")
intro string
variant white | blue
members [{ name, role, photo, linkedin }] photo = file in assets/img
centred primary button under the reviews (only: "desktop") attrs = raw attributes, e.g. open the "Popup - Avis voyage" modal instead of navigating
pagination
{ current, total, url, only }
(masonry / list) — only: "mobile" hides it on desktop
columns
[[n | "cta"]]
masonry: explicit desktop columns (1-based review numbers, "cta" = next CTA card), as in Figma 530:56491. Mobile shows one column in review order with the CTAs after `ctaAfter`.
cta
{ title, text, image, buttons: [{ label, url }] }
CTA card inserted in the masonry (Full + CTA); title 24/32 at every width (Figma 780:48515)
ctaAfter
[number]
1-based review positions after which the CTA card is inserted (default [2, 9]) default [2
Raw doc comment
Testimonials — Figma: Block: Témoignages (100:979)
wall outside the reviews page (100:980) / popup state (2271:31282): blue-light bg, 331 | 683 | 331 wall
with a wide featured review in the middle, "Voir plus d'avis" button.
Mobile (1015:44949 General / Agency): centred head + Splide slider + button.
masonry reviews page Variante3 (494:41727) / Full + CTA (530:57035): grey bg, 3 masonry columns,
author + stars on top, rating pill top-right, optional CTA cards and pagination.
list Popup - Avis voyage (2271:35051): stacked full-width bordered cards (use inside a modal).
"Lire la suite" opens the review modal (modal component, id = id ~ "-review").
props
id string unique id
variant wall | masonry | list
title string
rating string "4.9"
count string "1200 avis"
countUrl string link to the reviews page
reviews [review] see review-card
button { label, url, attrs, only } centred primary button under the reviews (only: "desktop")
attrs = raw attributes, e.g. open the "Popup - Avis voyage" modal instead of navigating
pagination { current, total, url, only } (masonry / list) — only: "mobile" hides it on desktop
columns [[n | "cta"]] masonry: explicit desktop columns (1-based review numbers, "cta" = next CTA card),
as in Figma 530:56491. Mobile shows one column in review order with the CTAs after `ctaAfter`.
cta { title, text, image, buttons: [{ label, url }] } CTA card inserted in the masonry (Full + CTA);
title 24/32 at every width (Figma 780:48515)
ctaAfter [number] 1-based review positions after which the CTA card is inserted (default [2, 9])
Round 24px trigger; on hover / focus / tap a primary bubble (info icon + title + text) appears. Alpine component "tooltip" (tooltip.js): open on mouseenter + focus, close on mouseleave, blur, Esc, outside click; the bubble is nudged sideways to stay inside a scrolling parent (price matrix) or the viewport.
Tooltip — Figma: Tooltip (892:59905, "%" trigger) + Tooltip Discount (892:59947, bubble)
Round 24px trigger; on hover / focus / tap a primary bubble (info icon + title + text) appears.
Alpine component "tooltip" (tooltip.js): open on mouseenter + focus, close on mouseleave, blur, Esc,
outside click; the bubble is nudged sideways to stay inside a scrolling parent (price matrix) or the viewport.
props
title string bubble title (optional)
text string bubble text (required)
label string accessible name of the trigger (default "Plus d'informations")
icon promo | info trigger glyph (promo = "%" discount, default)
placement top | bottom default top
id string unique id (aria-describedby); auto from title when omitted
caller — optional custom trigger: {% call tooltip({...}) %}<span>…</span>{% endcall %}
a titled group of selectable cards in the booking funnel. Card: grey-50 background, 1px border, radius 12, 24px padding; title (bold 14) + description lines (12, grey) · optional price chip (blue-light) · control on the right: radio custom 24px radio (one choice per group, `name`) quantity − [n] + stepper (Alpine `quantityStepper`, min / max) A card may show flights instead of a title: [{ title, route, time,…
Variants
type
radio
quantity
radio — custom 24px radio (one choice per group, `name`)
optional soft notice under the cards (notice component)
class
—
Raw doc comment
Booking options — a titled group of selectable cards in the booking funnel.
Figma: Tunnel - Step 1 › Trip Plane 2089:41842 (flight choice) · Trip Meal 2069:41628 (quantity) ·
Trip Insurance 2069:41627 (radio) — same blocks in Tunnel - Step 2 (2125:30967 / 2125:30947)
Card: grey-50 background, 1px border, radius 12, 24px padding; title (bold 14) + description lines
(12, grey) · optional price chip (blue-light) · control on the right:
radio custom 24px radio (one choice per group, `name`)
quantity − [n] + stepper (Alpine `quantityStepper`, min / max)
A card may show flights instead of a title: [{ title, route, time, company }] with the plane pictogram.
props
title string group title ("Vols", "Repas", "Assurances")
name string form field name
type radio | quantity
items [{ value, title, lines: [string], flights: [...], price, checked, quantity, min, max }]
notice { title, html, text } optional soft notice under the cards (notice component)
class
Apostrophe: rendered by the booking templates from the trip / booking data (not an editable widget).
progress bar of the booking funnel ("Vols 1 · Options 2 · Coordonnées 3 · Paiement 4"). States: done = primary + white disc with a check (link back to the step) · current = primary + number · upcoming = blue-light + primary border + number. Below md the labels of the non-current steps are hidden.
nav aria-label (default "Étapes de la réservation") default Étapes de la réservation
class
—
Raw doc comment
Booking steps — progress bar of the booking funnel ("Vols 1 · Options 2 · Coordonnées 3 · Paiement 4").
Figma: Tunnel - Step 1 › Steps Bar 2069:41156 · Tunnel - Step 2 › Steps Bar 2125:30829
States: done = primary + white disc with a check (link back to the step) · current = primary + number ·
upcoming = blue-light + primary border + number. Below md the labels of the non-current steps are hidden.
props
steps [{ label, url }]
current number 1-based index of the active step
label string nav aria-label (default "Étapes de la réservation")
class
Apostrophe: rendered by the booking page templates (not an editable widget).
sidebar recap of the trip being booked (sticky on desktop). Photo 384×251 · country + trip title · meta lines with pictograms (dates, duration, travellers) · collapsible sections separated by rules (Hôtel, Repas, Vols, Options — +/− toggles) · "Prix" total with a blue-light chip + info tooltip · small legal text.
[{ title, open, lines: [{ text, strong, small }], flights: [{ title, route, time, company }] }]
a section without lines / flights shows a "+" and stays closed (e.g. Options)
total
{ title ("Prix"), label ("Total"), amount, info }
legal
string
class
—
Raw doc comment
Booking summary — sidebar recap of the trip being booked (sticky on desktop).
Figma: Tunnel - Step 1 › Sidebar Booking 2069:41418 · Tunnel - Step 2 › 2125:30865
Photo 384×251 · country + trip title · meta lines with pictograms (dates, duration, travellers) ·
collapsible sections separated by rules (Hôtel, Repas, Vols, Options — +/− toggles) ·
"Prix" total with a blue-light chip + info tooltip · small legal text.
props
image string file in assets/img imageAlt string
country string
title string
meta [{ icon: calendar | clock | users, text }]
sections [{ title, open, lines: [{ text, strong, small }], flights: [{ title, route, time, company }] }]
a section without lines / flights shows a "+" and stays closed (e.g. Options)
total { title ("Prix"), label ("Total"), amount, info }
legal string
class
Apostrophe: rendered by the booking templates from the booking session (not an editable widget).
accommodation block of a trip page: one or several hotels, each with a photo slider, name, star rating, location, summary, "Voir la localisation" link and a detailed description (rich text + titled sub-sections: rooms accordion, restaurant, activities, services tags).
default: "list" when there are 2+ hotels, else "single" default list
hotels
[{ name, stars ("★★★★"), location, summary, locationUrl, locationLabel, images: [{ src, alt }], html rich text under the header (string, rendered | safe) sections [{ title, size: "large" | (default), html, rooms: [accordion items], tags: [string] }] open bool detail initially open (list variant) mobileFirst bool shown first on mobile (list variant; Figma mobile 1000:50754 puts a collapsed hotel first) }]
moreLabel
string
"Voir le détail" lessLabel string "Fermer le détail"
class
—
Raw doc comment
Hotels — accommodation block of a trip page: one or several hotels, each with a photo slider,
name, star rating, location, summary, "Voir la localisation" link and a detailed description
(rich text + titled sub-sections: rooms accordion, restaurant, activities, services tags).
Figma: Page d'un voyage 1 › Accordion 494:27721 ("Titre section 1 hôtel" — single hotel, open, on the page bg)
Page d'un voyage 2 › Hotel content 873:35028 ("Titre section 2 et + hôtels" — white cards,
detail collapsed behind "Voir le détail" / "Fermer le détail", hotels separated by a rule)
mobile 1011:58576 / 1000:50754 (photo on top, text below; room photo under the room text)
props
id string section id (anchor target, e.g. "hotel")
title string H2
variant single | list default: "list" when there are 2+ hotels, else "single"
hotels [{
name, stars ("★★★★"), location, summary, locationUrl, locationLabel,
images: [{ src, alt }],
html rich text under the header (string, rendered | safe)
sections [{ title, size: "large" | (default), html, rooms: [accordion items], tags: [string] }]
open bool detail initially open (list variant)
mobileFirst bool shown first on mobile (list variant; Figma mobile 1000:50754 puts a collapsed hotel first)
}]
moreLabel string "Voir le détail" lessLabel string "Fermer le détail"
class
Apostrophe: "hotels" widget — relationship to hotel pieces (fields above); rooms = array on the piece.
day-by-day programme with a vertical timeline. Each day: "Jour n" pill · bold day title · text · optional row of 150×114 photos. With a map (≥ lg): the day list scrolls inside a box the height of the map (thin custom scrollbar); the layout sits 8px inside the container: 746.6 map · 15 gap · list + 8 scrollbar. The map is hidden below lg (the mobile mock-ups have none).
static map image (file in assets/img) — omit for the narrow layout
days
[{ label, title, text, images: [{ src, alt }] }]
label defaults to "Jour n"
class
—
Raw doc comment
Itinerary — day-by-day programme with a vertical timeline.
Figma: Page d'un voyage 1 › "Day-by-day program Map" 494:27682 (map left 746px + scrolling day list right)
Page d'un voyage 2 › "Day-by-day program" 494:28148 (no map, 960px column)
mobile: Page d'un voyage 1/2 (1011:58576 / 1000:50754) — no map, full-width list
Each day: "Jour n" pill · bold day title · text · optional row of 150×114 photos.
With a map (≥ lg): the day list scrolls inside a box the height of the map (thin custom scrollbar);
the layout sits 8px inside the container: 746.6 map · 15 gap · list + 8 scrollbar.
The map is hidden below lg (the mobile mock-ups have none).
props
id string section id (anchor target, e.g. "programme")
title string bold part of the H2 ("Programme")
titleLight string regular end ("du voyage")
intro string optional
map { src, alt } static map image (file in assets/img) — omit for the narrow layout
days [{ label, title, text, images: [{ src, alt }] }] label defaults to "Jour n"
class
Apostrophe: "itinerary" widget — days = array field, images = relationship to attachments;
map can later become an interactive map (same slot).
section title + intro, then a one-at-a-time slider of photo / text slides (photo 682×448 left, title + text + "Découvrir" button right; slider nav under the photo). Used for the dive centre(s) linked to a trip; works for any list of linked pieces (boats, hotels…).
Media slider — section title + intro, then a one-at-a-time slider of photo / text slides
(photo 682×448 left, title + text + "Découvrir" button right; slider nav under the photo).
Figma: "Dive centers" 653:42404 / 754:40468 (Page d'un voyage 1 & 2 — "Centre de plongée")
mobile Page d'un voyage 1 1011:58576 (photo, centred arrows, then the text)
Used for the dive centre(s) linked to a trip; works for any list of linked pieces (boats, hotels…).
props
id string section id (anchor target)
title string bold part of the H2 ("Centre de")
titleLight string regular end ("plongée")
intro string
background soft | none default soft (blue-light band)
slides [{ image, imageAlt, title, text, button: { label, url } }]
class
Apostrophe: "media-slider" widget — relationship to dive-centre pieces (image, title, excerpt, url).
Page intro — "← Retour" link, H1 and intro paragraph, on the page background (no hero).
Figma: Tunnel - Step 1/2 › Intro Content 2069:41174 / 2125:30858
Reusable for any form / funnel page that starts without a hero.
props
back { label, url } back link (label default "Retour")
title string H1
intro string
class
CSS aspect-ratio of the photo (default "331 / 251") default 331 / 251
class
—
Raw doc comment
Photo slider — small rounded photo carousel with 32px prev/next buttons over the photo.
Figma: "Placeholder image/Default" + "Frame 6417" arrows (884:55327) in the hotel cards (873:35035)
and room accordions (494:27736) of Page d'un voyage 1/2.
A single photo renders without arrows.
props
images [{ src, alt }] files in assets/img
label string accessible name (default "Photos")
ratio string CSS aspect-ratio of the photo (default "331 / 251")
class
Apostrophe: an images relationship rendered by this macro inside other widgets.
Blue-light block: title (bold + light part) + intro, then a slider of dive centres (photo 682×448 + name / text / "Découvrir"). "Découvrir" opens the centre's spec sheet in the drawer modal (Popup - Centre de plongée). Below lg: photo on top, text under it. Desktop: the intro sits 18px under the title; in each slide the text column is centred 20.5px above the photo's centre.
[{ image, imageAlt, name, text, buttonLabel ("Découvrir"), url (fallback link when there are no details), details: [{ label, value }] → modal rows detailButton: { label, url } → modal button ("Découvrir le centre de plongée") }]
Raw doc comment
Dive centers — Figma: Dive centers 653:42488 (Par défaut 653:42401 · Popup 653:42489)
Blue-light block: title (bold + light part) + intro, then a slider of dive centres
(photo 682×448 + name / text / "Découvrir"). "Découvrir" opens the centre's spec sheet in the
drawer modal (Popup - Centre de plongée). Below lg: photo on top, text under it.
Desktop: the intro sits 18px under the title; in each slide the text column is centred 20.5px above
the photo's centre.
Figma: Popup - Centre de plongée 754:43157 · desktop text column 653:42401 / 494:27774
props
id string required (slider + modal ids)
title string "Centre de"
titleLight string "plongée" (regular weight, same line)
intro string
tone soft | white background (default soft = blue-light)
centers array [{ image, imageAlt, name, text,
buttonLabel ("Découvrir"), url (fallback link when there are no details),
details: [{ label, value }] → modal rows
detailButton: { label, url } → modal button ("Découvrir le centre de plongée") }]
Apostrophe: "dive-centers" widget — centres = relationship to dive-centre pieces (fields map 1:1).
results page body: optional category bar, search box, filter sidebar or tabs, card grid / list, results count, client-side filter + sort + pagination, empty state. Spacing: `list` layout = 20px between cruise cards from lg. With a filter sidebar, below lg: 18px between cards, every offer card 331 wide and centred, results count 48 under the hero and 18 above the first card (the filters become a fixed bar /…
list = one column of horizontal cards (Cruises), 20px apart from lg
columns
number
desktop columns of the grid (default 3; 4 for full-width pages) default 3
gap
md | lg | xl
row gap 24 / 40 / 54 (default md; 18 below lg with a sidebar) default md
items
array
card props + filters/sort objects. `card: "post"` renders a post-card, otherwise an offer-card.
promos
array
[{ position, positionMobile, card }] CTA offer-cards inserted after `position` results on each page; below lg `positionMobile` is used instead when set (0 = not on mobile). A promo without `position` is mobile-only (Figma Page des croisières 1154:130646: promos after 5 and 10)
perPage
number
0 = no pagination
perPageMobile
number
results per page below lg (default perPage) — Figma mobile croisières: 10 (desktop 8) default perPage
openFirst
bool
first card shows its departures panel open (Figma Liste des voyages / croisières state)
categories
array
desktop pastille bar [{ category, label, url, selected }] (page-type navigation) — or, with `value` on each item, a FILTER bar: radio (default) / checkbox chips named `<categoriesName>[]` matched against item.filters.<categoriesName> ("" = all)
default "résultats" (countLabelOne: singular, default = countLabel without the final "s") default résultats
sortName
string
default "tri" default tri
favourites
bool
favourites mode (see above) · seedFavourites bool | [ids]: on a first visit (no stored list) save every item / these ids, so the demo page is not empty
empty
{ title, text, button: { label, url } }
empty state (button without url resets the filters)
Listing — results page body: optional category bar, search box, filter sidebar or tabs, card grid / list,
results count, client-side filter + sort + pagination, empty state.
Figma: Liste des voyages 494:29838 (Filters bar 737:52003 · Filter Sidebar 653:41727 · Trips list 666:43534)
Liste des croisières 494:27245 (horizontal Cruises cards) · Recherche 494:27502 (Search Bar 511:50224,
Ancres 511:49037) · Favoris 2069:35191 (Trips List 2069:39283)
mobile: Page des voyages 983:46525 · Page des croisières 1154:130646
Spacing: `list` layout = 20px between cruise cards from lg. With a filter sidebar, below lg: 18px between
cards, every offer card 331 wide and centred, results count 48 under the hero and 18 above the first card
(the filters become a fixed bar / sheet). Pages wrap the listing in `.listing-band`
(src/scss/pages/_listing-pages.scss): grey band from lg, white below lg (the mobile lists are on white).
Figma: cruise list 494:27250
Filtering is generic and driven by data attributes rendered from each item's `filters` / `sort` objects:
item.filters = { zone: "asie-pacifique indonesie", niveau: "n1 n2", budget: 2299 } → data-f-zone="…" …
item.sort = { price: 2299, new: 1 } → data-s-price="…" …
Rules (Alpine `listing`, every <form> inside the component is read):
checkbox / radio named "x[]" → item's data-f-x must contain one of the checked values (empty value = all)
fields named "x_min" / "x_max" → numeric data-f-x must be in range (items without data-f-x pass)
radio named `sortName` ("tri") → "field-asc" | "field-desc" | "field" (desc) on data-s-field; unknown = original order
field named "q" → case/accent-insensitive text match on the card
favourites: true → only items whose favId is in localStorage "um:favourites" (fav-button);
un-hearting a card removes it, empty state when none are left.
props
id string required (unique per page)
layout grid | list list = one column of horizontal cards (Cruises), 20px apart from lg
columns number desktop columns of the grid (default 3; 4 for full-width pages)
gap md | lg | xl row gap 24 / 40 / 54 (default md; 18 below lg with a sidebar)
items array card props + filters/sort objects. `card: "post"` renders a post-card, otherwise an offer-card.
promos array [{ position, positionMobile, card }] CTA offer-cards inserted after `position` results on each
page; below lg `positionMobile` is used instead when set (0 = not on mobile). A promo without
`position` is mobile-only (Figma Page des croisières 1154:130646: promos after 5 and 10)
perPage number 0 = no pagination
perPageMobile number results per page below lg (default perPage) — Figma mobile croisières: 10 (desktop 8)
openFirst bool first card shows its departures panel open (Figma Liste des voyages / croisières state)
categories array desktop pastille bar [{ category, label, url, selected }] (page-type navigation)
— or, with `value` on each item, a FILTER bar: radio (default) / checkbox chips named
`<categoriesName>[]` matched against item.filters.<categoriesName> ("" = all)
categoriesType radio | checkbox (filter mode) single or multiple selection
categoriesName string (filter mode) filter key, default "categorie"
filters object filter-sidebar props (resultsCount is filled in) → sidebar layout
tabs object { name, items: [{ value, label, checked }] } pill filter tabs (Recherche)
search object { placeholder, value, buttonLabel, label } search box above the results (Recherche)
showCount bool results count (default true)
countLabel string default "résultats" (countLabelOne: singular, default = countLabel without the final "s")
sortName string default "tri"
favourites bool favourites mode (see above) · seedFavourites bool | [ids]: on a first visit (no stored list) save
every item / these ids, so the demo page is not empty
empty { title, text, button: { label, url } } empty state (button without url resets the filters)
caller optional content above the results ({% call listing({...}) %}{{ notice(...) }}{% endcall %})
Sign-in card (email, password, forgotten-password link, submit) + "no account yet" footer. When `signup` is set, "S'inscrire" swaps the card to a sign-up panel in place (Alpine, no reload); without it, the footer button links to `signupUrl`.
Login form — Figma: Espace connexion 2134:31393 › Login Form 2134:31416 (576px white card)
Sign-in card (email, password, forgotten-password link, submit) + "no account yet" footer.
When `signup` is set, "S'inscrire" swaps the card to a sign-up panel in place (Alpine, no reload);
without it, the footer button links to `signupUrl`.
props
id string default "login"
action string form action (POST)
title string "Se connecter à votre compte"
emailLabel, emailPlaceholder, passwordLabel, passwordPlaceholder strings
forgot { label, url } "Mot de passe oublié ?"
submitLabel string "Se connecter"
signupText string "Vous n'avez pas encore de compte ?"
signupLabel string "S'inscrire"
signupUrl string link when there is no inline sign-up panel
signup object inline sign-up panel:
{ title, action, fields: [form-field props], consent (label), submitLabel, loginText, loginLabel }
Apostrophe: login page template — action → /api/v1/@apostrophecms/login/login (or the site's auth route).
stacked white panels with a +/− toggle; body = optional sub-title, text and a photo. Header 77px, bold 18 title, 24px icon; open body: text (16/24) + 390×251 photo on the right (stacked under the text on mobile). Each panel toggles on its own (several may be open).
prefix for the aria ids (default "accordion") default accordion
items
[{ title, heading, text, html, image, imageAlt, open }]
heading = Medium 24 secondary sub-title in the body ("Titre du bloc") text = plain paragraph · html = rich text (rendered | safe) · image = file in assets/img
headingLevel
number
level of the item titles (default 3) default 3
class
—
Raw doc comment
Accordion — stacked white panels with a +/− toggle; body = optional sub-title, text and a photo.
Figma: Page d'un bateau › "Les cabines" 579:32980 (Group 6500 open · Frame 103/104 closed)
FAQ 530:58066 (questions) · mobile FAQ 2 [section] 1154:124796 (photo under the text)
Header 77px, bold 18 title, 24px icon; open body: text (16/24) + 390×251 photo on the right
(stacked under the text on mobile). Each panel toggles on its own (several may be open).
props
id string prefix for the aria ids (default "accordion")
items [{ title, heading, text, html, image, imageAlt, open }]
heading = Medium 24 secondary sub-title in the body ("Titre du bloc")
text = plain paragraph · html = rich text (rendered | safe) · image = file in assets/img
headingLevel number level of the item titles (default 3)
class
Apostrophe: "accordion" widget — array field items { title, heading, text (rich), image (relationship), open }.
in-page navigation box under an offer hero (links + round chevron). Desktop: centred white box, primary 1px border, radius 12, 32/24 padding, 24px between items. The current section's link turns bold (Alpine `anchorNav`, registered by components/hero/hero.js).
nav aria-label (default "Sur cette page") default Sur cette page
class
—
Raw doc comment
Anchor bar — in-page navigation box under an offer hero (links + round chevron).
Figma: Anchor bar 577:30744 (variant 673:47795) — Page centre plongée, Page d'un bateau
mobile: Anchor bar 1154:124974 (full-width white strip, links scroll horizontally)
Desktop: centred white box, primary 1px border, radius 12, 32/24 padding, 24px between items.
The current section's link turns bold (Alpine `anchorNav`, registered by components/hero/hero.js).
props
items [{ label, url }] url = "#section-id"
label string nav aria-label (default "Sur cette page")
class
Apostrophe: "anchor-bar" widget — array field items { label, url } (or generated from the page's areas).
"Météo lié à ce voyage" + optional "Guide des formalités" spec table. Month grid (12 columns) with temperature rows and a weather-pictogram row, bordered primary 16px radius.
12 short month labels (default J F M A M J J A S O N D) default J
monthNames
[string]
accessible full month names (default janvier…décembre) default janvier…décembre
rows
[{ label, values: [number|string] }]
temperature rows (T° air max, T° air min, T° eau)
climate
{ label, values: [sun | cloud-sun | cloud] }
pictogram row
note
string
footnote under the grid (info icon)
guide
{ title, rows: [{ label, value, html }] }
"Guide des formalités" → spec-table (labelWidth sm)
class
—
Raw doc comment
Climate table — "Météo lié à ce voyage" + optional "Guide des formalités" spec table.
Figma: Climate table 530:58314 (Page de contenu avancé, Destination Indonésie, Destination + croisière)
mobile: Meteo [section] 1025:62291
Month grid (12 columns) with temperature rows and a weather-pictogram row, bordered primary 16px radius.
Mobile: the grid scrolls horizontally with the row labels pinned on the left.
props
id string anchor id (default "meteo")
title string bold part of the H2 ("Météo lié à ce")
titleLight string regular end ("voyage")
intro string
monthLabel string first header cell (default "Mois")
months [string] 12 short month labels (default J F M A M J J A S O N D)
monthNames [string] accessible full month names (default janvier…décembre)
rows [{ label, values: [number|string] }] temperature rows (T° air max, T° air min, T° eau)
climate { label, values: [sun | cloud-sun | cloud] } pictogram row
note string footnote under the grid (info icon)
guide { title, rows: [{ label, value, html }] } "Guide des formalités" → spec-table (labelWidth sm)
class
Apostrophe: "climate-table" widget — rows as array fields, climate as array of select values,
guide as an optional object (or a separate spec-table widget).
default "Réserver" rows[].filters { <filterName>: "value" | "v1 v2" } values this row matches for each filter (space-separated = matches any of them). A row without a value for a filter matches every option of that filter. default Réserver
visible
number
rows shown before "Voir plus de dates" (default: all) default all
moreLabel
string
default "Voir plus de dates" default Voir plus de dates
emptyLabel
string
empty-state text when no row matches the filters
resetLabel
string
empty-state reset button (default "Réinitialiser les filtres") default Réinitialiser les filtres
class
—
Raw doc comment
Departures — dated departure list with filters (cruise / boat price block).
Figma: Page d'un bateau › Pricing Block 585:30542 (Header · Filter Bar · Table rows 585:30571 · Footer)
White card (shadow, radius 24): H2, 4 select filters, rows alternating grey / white
(dates + nights · itinerary · departure / arrival · price + availability · "Réserver"),
"Voir plus de dates" outline button. Rows beyond `visible` are revealed by that button (Alpine).
Filters work client-side (departures.js): each select filters rows by their data-filter-<name>;
the first `visible` matching rows show, "Voir plus de dates" reveals the rest, empty-state row if none.
Mobile: filters 2 per row, each row wraps into a 2-column card.
props
id string anchor id (default "prix")
title string H2 ("Prix")
filters [{ name, label, options: [{ value, label }] }]
rows [{ dates, nights, itineraryLabel, itinerary, routeLabel, route, price, availability, bookUrl }]
bookLabel string default "Réserver"
rows[].filters { <filterName>: "value" | "v1 v2" } values this row matches for each filter
(space-separated = matches any of them). A row without a value for a filter
matches every option of that filter.
visible number rows shown before "Voir plus de dates" (default: all)
moreLabel string default "Voir plus de dates"
emptyLabel string empty-state text when no row matches the filters
resetLabel string empty-state reset button (default "Réinitialiser les filtres")
class
Apostrophe: "departures" widget — rows come from the boat's departures (relationship / pieces).
accordion items [{ title, text, html, image, imageAlt, open }]
class
—
Raw doc comment
FAQ — "Foire aux questions": bracketed title + intro + button on the left (sticky on desktop),
accordion of questions on the right.
Figma: FAQ 530:58066 (Page de contenu avancé, Destination Indonésie, Destination + croisière, Croisiériste)
mobile: FAQ 2 [section] 1154:124796 (title / intro / button stacked above the questions)
props
id string anchor id (default "faq")
title string bold part ("Foire aux")
titleLight string regular end ("questions")
intro string
button { label, url } primary button ("Contactez un expert")
items accordion items [{ title, text, html, image, imageAlt, open }]
class
Apostrophe: "faq" widget — title fields + button + array of questions (or a relationship to FAQ pieces).
"Découvrez nos guides": bracketed title, intro, category filter pills and photo tiles (frosted title bar + white arrow), ending with an "Afficher plus" primary tile. Alpine (guideList): active category, filters the tiles client-side; mobile prev/next scroll the row.
initially selected value (default: first category; "" = all) default first
guides
[{ title, url, image, imageAlt, category }]
image = file in assets/img
more
{ label, url }
last tile ("Afficher plus")
class
—
Raw doc comment
Guide list — "Découvrez nos guides": bracketed title, intro, category filter pills and photo tiles
(frosted title bar + white arrow), ending with an "Afficher plus" primary tile.
Figma: Guide list (with filters) 494:29728 (Page de contenu avancé) · tile 743:63018
mobile: Guide with filters 1154:126504 (pills scroll, one tile per view + prev/next)
Alpine (guideList): active category, filters the tiles client-side; mobile prev/next scroll the row.
props
id string anchor id (default "guides")
title string bold part ("Découvrez nos")
titleLight string regular end ("guides")
intro string
categories [{ value, label }]
activeCategory string initially selected value (default: first category; "" = all)
guides [{ title, url, image, imageAlt, category }] image = file in assets/img
more { label, url } last tile ("Afficher plus")
class
Apostrophe: "guide-list" widget — categories = guide-category pieces, guides = relationship to guide pages.
aria role (default "note"; use "status" for live messages) default note
variant
soft | primary
primary = white text on primary (Page d'un bateau › "À savoir" 884:55349, icon defaults to icon-info-white.svg) — added by pages-destination
class
—
Raw doc comment
Notice — Figma: Favoris 2069:35191 › Notice 2069:40962
Blue-light message box: info icon + bold title, then a line of text (links allowed).
props
title string "Attention"
text string plain text
html string rich text alternative (links: "<a href='connexion.html'>connectez-vous</a>") — rendered | safe
icon string icon file in assets/icons (default icon-info-sm.svg)
width narrow | full narrow = 960px centred (Figma), default narrow
role string aria role (default "note"; use "status" for live messages)
variant soft | primary primary = white text on primary (Page d'un bateau › "À savoir" 884:55349,
icon defaults to icon-info-white.svg) — added by pages-destination
class
Apostrophe: "notice" widget — title, rich text (links only), icon select.
Related links — "Découvrez les contenus lié à cette page": primary band, outlined frame whose
top-left corner is cut by the title, white pill links on the right.
Figma: Guide CTA 494:29705 (Page de contenu avancé) · mobile Related content 1025:63166
(bracketed title, pills scroll horizontally)
props
title string
links [{ label, url }]
id, class
Apostrophe: "related-links" widget — title + array of links (or relationship to pages / guides).
white card with select filters + "Réinitialiser" above a listing. Desktop: 960px card centred, pill selects (54px) side by side + grey 150px reset pill. The section that follows directly gets a reduced top padding (48px) so the card sits close to the list.
when set, reset is a link (clears the query string server-side)
autoSubmit
bool
submit the form when a select changes (default true) default true
background
alt | white
default alt (grey page background) default alt
Raw doc comment
Filter bar — white card with select filters + "Réinitialiser" above a listing.
Figma: Liste reportage sous-marins › Search Bar (2063:43071, Destination / Auteur) ·
Avis clients (530:56481, Destination only) · mobile Search Bar 2137:45436 (stacked, primary reset)
Desktop: 960px card centred, pill selects (54px) side by side + grey 150px reset pill.
Mobile: fields stacked, full-width primary reset button.
The section that follows directly gets a reduced top padding (48px) so the card sits close to the list.
props
id string form id
action string form action (default "" = same page, GET)
fields [{ name, label, options: [{ value, label, selected }], value }]
resetLabel string default "Réinitialiser"
resetUrl string when set, reset is a link (clears the query string server-side)
autoSubmit bool submit the form when a select changes (default true)
background alt | white default alt (grey page background)
Apostrophe: options come from the filtered piece type (destinations, authors…); field names map to
query parameters of the index page.
article listing (reportages, author pages, blog archives). Plain grid of post cards (no slider): 3 columns desktop (gap 54 × 20), 2 on tablet, 1 on mobile, then optional centred pagination or button.
see pagination component — adds `--paginated`: 92px under the pagination on mobile (reportages, Figma 1021:54171), 32 from lg
button
{ label, url }
Raw doc comment
Post grid — article listing (reportages, author pages, blog archives).
Figma: Liste reportage sous-marins › Feature articles list (494:41119) · Reportages - Auteur ›
Feature articles list on an author page (931:40551) · mobile 1021:54166 / 1021:54946
Plain grid of post cards (no slider): 3 columns desktop (gap 54 × 20), 2 on tablet, 1 on mobile,
then optional centred pagination or button.
props
id string anchor id on the section
title string optional section title (bold part)
titleLight string regular-weight end of the title
intro string
posts [post-card props] { image, imageAlt, tags, tag, eyebrow, title, excerpt, price, link }
cardVariant post | destination | simple | option default post
columns number desktop columns (default 3)
background alt | white | soft default alt (grey, cards are white)
pagination { current, total, url } see pagination component — adds `--paginated`: 92px under the pagination
on mobile (reportages, Figma 1021:54171), 32 from lg
button { label, url }
Apostrophe: "post-grid" widget fed by a piece query (reportage pieces, filtered by author / destination);
pagination comes from the index page.
optional end of the title forced onto a 2nd line from lg ("en agence") — see bracket-title
titleLight
string
optional regular part
intro
string
button
{ label, url, variant }
buttonArrow (variant default "primary" for cards, "soft" for rows) default primary
layout
cards | rows
cards head left, 2 columns of cards (name · phone · divider · "Découvrir l'agence ›") — Générique. Agencies are given in reading order (row by row) and rendered column-major; desktop fills by column (CSS columns: 2, 20 gap, 12 between cards), mobile stacks in that order: Nantes, Lyon, Villeneuve, Paris, Genève (Figma 511:51838 / mobile 1021:50002) rows stacked: head, one 56px row per agency (name left, phone right), button last — Classique
Agency list — Figma: Contact - Générique › "Agency contact" (511:51838) + head (511:51484, button 511:51489)
Contact - classique › rows (511:52320 …) + head (511:52395, button 511:52400)
mobile: Page contact - générique 1021:49961 (cards 1021:50002) · Page contact - classique 1020:47614
Bracket title + intro + optional button, and a list of agencies with phone + link.
props
title string bracket title ("Contactez l'un de nos experts")
titleLine2 string optional end of the title forced onto a 2nd line from lg ("en agence") — see bracket-title
titleLight string optional regular part
intro string
button { label, url, variant } buttonArrow (variant default "primary" for cards, "soft" for rows)
layout cards | rows
cards head left, 2 columns of cards (name · phone · divider · "Découvrir l'agence ›") — Générique.
Agencies are given in reading order (row by row) and rendered column-major; desktop fills
by column (CSS columns: 2, 20 gap, 12 between cards), mobile stacks in that order:
Nantes, Lyon, Villeneuve, Paris, Genève (Figma 511:51838 / mobile 1021:50002)
rows stacked: head, one 56px row per agency (name left, phone right), button last — Classique
linkLabel string default "Découvrir l'agence" (cards)
agencies [{ name, phone, url }]
id, class
Apostrophe: "agency-list" widget — relationship to agency pieces (name, phone, _url); title / titleLine2 /
titleLight / intro = string fields.
optional bold end set on its own line from lg (forced break, Figma 511:51487 / 511:52398 "Contactez l’un de nos experts⏎en agence"); below lg it simply follows the title (no break)
desktop: bracket hangs 20px under a one-line l title (Candidature spontanée 530:56195)
id
—
class
—
Raw doc comment
Bracket title — heading with the rounded corner bracket on its left
(Figma "Rectangle 96 (Stroke)" 115×63, e.g. Recrutement › Candidature spontanée 530:56195,
Job openings list 530:55947, Contact › "Contactez l'un de nos experts en agence" 511:51486).
props
title string bold part
titleLight string regular-weight end ("d'emplois")
titleLine2 string optional bold end set on its own line from lg (forced break, Figma 511:51487 / 511:52398
"Contactez l’un de nos experts⏎en agence"); below lg it simply follows the title (no break)
level 2 | 3 heading level (default 2)
size l | xxl l = 32px (forms / contact blocks, default) · xxl = 48px (section titles)
inverse bool white (on primary background)
low bool desktop: bracket hangs 20px under a one-line l title (Candidature spontanée 530:56195)
id, class
Apostrophe: fragment used inside widgets — title / titleLight / titleLine2 map to string fields of the widget
that renders it (agency-list, contact-form, job-list…).
generic data-driven form (sections → fieldsets of fields) built on form-field + date-picker. Client-side validation (Alpine `contactForm`): required / email / tel / file type+size, inline errors under each field (aria-invalid + aria-describedby), focus on the first error, then a success state. action "#" (or empty) = demo: success is simulated. Any other action: POST via fetch (FormData), success on 2xx.
with {% call %}: the caller content becomes a side column (565px) — default start default start
class
—
Raw doc comment
Contact form — generic data-driven form (sections → fieldsets of fields) built on form-field + date-picker.
Figma: Recrutement › General application form 653:41020 · Détail offre d'emploi (same form)
Contact - Devis › Quote request form 523:52894 · Contact - classique › Contact form 523:52822
mobile: Page recrutement 1015:45938 · Détail offre 1021:50851 · Contact Devis 1020:49542 · Classique 1020:47614
Client-side validation (Alpine `contactForm`): required / email / tel / file type+size, inline errors under
each field (aria-invalid + aria-describedby), focus on the first error, then a success state.
action "#" (or empty) = demo: success is simulated. Any other action: POST via fetch (FormData), success on 2xx.
props
id string form id (required when several forms are on a page)
action string default "#"
method string default "post"
sections [{ title, fields: [field] }] each section = <fieldset> with a bold <legend>
field: type text | email | tel | number | textarea | select | checkbox | file | date
name, label, required
placeholder string default: label (+ " *" when required) — labels are visually hidden like the Figma
width half | full default full (half = 2 per row from md)
options select: [{ value, label }]
rows, minHeight (px) textarea
autocomplete string
accept file: ".doc,.docx,.pdf" maxSize file: MB (default 2)
help string file: "(.doc, .docx, .pdf de 2Mo)"
dropLabel file: default "Déposer un fichier ou" (+ underlined "parcourir")
mode date: single | range (default single) caret date: ▼ instead of the calendar icon
sections[].compact bool Figma Contact - Devis 523:52895: legend and full-width fields 12px apart (rows 18)
sections[].plainLegend bool regular-weight legend 9px above its field ("Message", 523:52908)
consent { name, label (html allowed), required } optional RGPD checkbox above the submit
submit { label } default "Envoyer"
legal string (html) RGPD notice under the button (scrollable 82px box)
success { title, text } success state
messages { required, email, tel, fileType, fileSize, error } override the French defaults
asidePosition start | end with {% call %}: the caller content becomes a side column (565px) — default start
class
Apostrophe: maps to @apostrophecms/form — sections = form groups, fields = form widgets
(string / email / textarea / select / checkbox / file / date), consent = boolean field, success = thank-you message.
Primary band: bracket title + intro, then a 4-column grid of job cards (white, radius 12): title (18 bold) · pastille tags (CDI, location) · short text · "Découvrir l'offre →" link.
show only the first 4 offers on phones (Figma mobile 1020:47395)
jobs
[{ title, tags: [string], text, url }]
Raw doc comment
Job list — Figma: Recrutement › Job openings list (1127:123713) · mobile Page recrutement 1015:45938
Primary band: bracket title + intro, then a 4-column grid of job cards (white, radius 12):
title (18 bold) · pastille tags (CDI, location) · short text · "Découvrir l'offre →" link.
props
id string section id (anchor target, e.g. "offres")
title string bold part ("Nos offres")
titleLight string regular part ("d'emplois")
intro string
variant brand | light brand = primary band (default) · light = grey background, white cards
linkLabel string default "Découvrir l'offre"
emptyText string shown when jobs is empty
mobileLimit bool show only the first 4 offers on phones (Figma mobile 1020:47395)
jobs [{ title, tags: [string], text, url }]
Apostrophe: "job-list" widget (title fields + relationship to "job" pieces → jobs).
No component matches.
Relationships
How it fits together
Every page extends layouts/page.html (header + footer from globals). The page itself is a list of blocks; blocks are made of cards and parts; everything bottoms out in elements. Below: the layers, then the real tree of each page template, generated from its imports.
Reference page: every other page follows this pattern (page layout + component macros + data). Apostrophe: home-page type; each block below = one area widget in the "main" area.
Hero STANDARD "Agency" (buttons + hours/address/phone) · team · key figures · coup de cœur trips (grid) · popular destinations · Banner with CTA. Apostrophe: agency piece show page (hero fields from the piece, blocks in the "main" area).
Apostrophe progress (dev only): what is built in the Apostrophe project so far. Content: src/data/apostropheProgress.jsonapostrophe-progress.html · 0 blocks · 0 components
(intro, specs, activities, cabins accordion, life on board, diving + specs + "À savoir"), No dedicated mobile frame: blocks follow their mobile components. Apostrophe: boat piece page; content blocks = widgets of the "main" area.
Long-form editorial page: every content widget of the theme in one flow. Apostrophe: default content page type; each block = one widget of the "main" area.
Hero LIGHT (Blue Primary) + notice + 4-col grid of saved offers. Wired to the fav-button store (localStorage "um:favourites"): only saved offers are shown, un-hearting removes the card, empty state when none. First visit (no stored list) is seeded with 12 offers so the page matches the mock-up. Apos
Steps bar · intro · flights (radio) + info notice · meals (quantity) · insurance (radio) · next button, booking summary sidebar (sticky on desktop, under the form on mobile). Apostrophe: booking module templates (data from the booking session, not editable widgets).
Steps bar (Vols done) · intro · meals (quantity) · insurance (radio) · next button, booking summary sidebar (sticky on desktop, under the form on mobile). Apostrophe: booking module templates (data from the booking session, not editable widgets).
Playground = src/js/section-proposal.js (Alpine). Dev-only, not in the docs menu — delete with src/scss/pages/_section-proposal.scss, src/js/section-proposal.js and the @use line in main.scss.
layouts/base.html
Page d'un voyage 2 (sans carte et + 2 hôtels)voyage-2.html · 12 blocks · 35 components
Same template as voyage.html with: "Bons plans" row under the hero, itinerary without map, several hotels (detail collapsed behind "Voir le détail"). Apostrophe: trip-page type (piece "trip").
piece templates, page templates and internal fragments. Content: src/data/widgetPlan.json. "Used on" is computed from componentDocs (npm run docs) so it stays in sync with the pages.
layouts/base.html
Maintenance
Doc quality
Doc comments the parser could not read fully. Fix the comment in the component's .html, then run npm run docs.