Docs: hero zonder planning en hero-brede aan/uit (FR-05, BR-H07/BR-P01, aannamelijst 30, contract)
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
This commit is contained in:
@@ -57,7 +57,7 @@
|
||||
| FR-02 | Fields: `title` (required, one text, new lines allowed, max 200 chars), `tagline` (optional, max 120), `lead` (optional, max 600), `display` (`single` or `slideshow`, default `single`). Plain text only; the host and the sites encode it. |
|
||||
| FR-03 | 0 to 2 buttons, each with `label` (max 50) and `target` (max 500). Both required per button. Target must match exactly one of: `#anchor` (letters, digits, `-`, `_`), a site path starting with a single `/` (no `//`, no scheme, no backslash, no control characters), or an absolute `https://` address with a host and no credentials. Anything else is rejected with a clear message. |
|
||||
| FR-04 | 0 to n slides, each with: stable `id`, one image, `alt` text (required, max 300, or an explicit `decorative` flag instead), `order`, `isActive`. Inactive slides are not published. A reasonable maximum (for example 12) protects the page weight. |
|
||||
| FR-05 | Schedule: optional `startsAt` / `endsAt` for the hero as a whole (as banners). Outside the period the hero counts as not available (204). |
|
||||
| FR-05 | ~~Schedule~~ **Removed (Bryan, 2026-11-17).** No `startsAt`/`endsAt` and no hero-wide on/off (`isActive`): the hero is part of the design and always on; it is live as soon as it has a title, and without hero data the host writes nothing (the baked hero stays). Per-slide on/off stays. A schedule may come back later, then probably per slide. |
|
||||
| FR-06 | Text fields and slide data are stored so that a language can be added later without migrating existing rows (for example a language key or a translations structure with the current language as the default); only one language is exposed and edited now. |
|
||||
| FR-07 | Management needs role Administrator or higher (policy `AdminOnly`); the public read endpoint is anonymous and reachable through the availability gate (like the banner). |
|
||||
|
||||
|
||||
+1
-1
@@ -13,7 +13,7 @@ Input for Application Design. Source: message of "Andrea Slop Fotografie - ASF -
|
||||
| Lead | ASF does not render it; if present the site ignores it. |
|
||||
| Decorative | `decorative: true` renders `alt=""` and is not read aloud. |
|
||||
| Display | `single`: no arrows, pause button or progress bar (ASF already does that for one slide). |
|
||||
| 204 / schedule / error | The baked hero stays (fail-open). ASF shows the baked hero on 204, not nothing. If the host ever means "no hero at all", that must be said explicitly (not planned). |
|
||||
| 204 / no hero data / error | The baked hero stays (fail-open). ASF shows the baked hero on 204, not nothing. If the host ever means "no hero at all", that must be said explicitly (not planned). |
|
||||
| Image addresses | Same origin `/media/hero/<hash>/…`, immutable; the CSP `img-src` does not change. |
|
||||
| Markers | `<!--CMS:HERO-HTML-->…<!--/CMS:HERO-HTML-->` (title, tagline, button(s), the FIRST slide as `<picture>`), `<!--CMS:HERO-PRELOAD-->` in the head, key `hero` in `#cms-data` with all slides. Fail-open: no marker, 204 or an error leaves the baked page. |
|
||||
| Hydration | The region holds neutral HTML (fixed classes, no Chakra classes); React takes over with the same source after hydration; slides 2..n load afterwards. The first slide of the data block must equal the first slide the host wrote into the HTML (same source, same cache rule). |
|
||||
|
||||
Reference in New Issue
Block a user