HTML-vejledning
Den enklest tænkelige start: kopiér semantisk HTML med Lilys klassekroge, tilføj ét typografiark, udgiv. Almindelige filer, der virker overalt, hvor HTML virker.
Det her bygger du
En lille kontaktformular — felter med etiketter, en send-knap, ægte tastatur- og skærmlæseradfærd — først nøgen, derefter formgivet, på omkring 10 minutter.
Før du går i gang
Du skal bruge en browser og en teksteditor. Det er alt. (git hjælper med at hente komponentfilerne, men du kan også kopiere dem fra GitHub i browseren.)
Trin 1 — Hent koden
git clone https://github.com/LilyDesignSystem/lily-design-system
cd lily-design-system/lily-design-system-html-headless
Hver komponent er en selvstændig fil i components/ —
button.html, text-input.html, og så videre — med en hovedkommentar, der dokumenterer dens HTML-tag, klassekrog, tastaturadfærd og tilgængelighedskontrakt. Filerne er biblioteket — kopiér det, du har brug for, og kør.
Trin 2 — Din første komponent
Åbn components/button.html, eller skriv bare markuppen — klassekrogen er kontrakten:
<button class="button" type="button">
Save
</button>
Fordi det er en ægte <button>er tastaturfokus, aktivering med Enter og Mellemrum og den implicitte knaprolle allerede korrekte.
Trin 3 — Sæt en lille formular sammen
<form class="form">
<div class="field">
<label class="label" for="name">Full name</label>
<input class="text-input" type="text" id="name" name="name" required />
</div>
<div class="field">
<label class="label" for="email">Email</label>
<input class="email-input" type="email" id="email" name="email" required />
</div>
<button class="button" type="submit">Save</button>
</form>
Læg mærke til mønsteret: hver kontrol knytter sin <label for>, bruger den mest specifikke input-type og bærer præcis én klassekrog i kebab-case.
Tjek dit arbejde: åbn siden i en browser. Den ser nøgen ud — præcis som tilsigtet: formgivningen kommer endnu. Tryk på Tab: fokus flytter sig gennem hver kontrol, etiketterne oplæses, og afsendelse virker. Adfærden er færdig; udseendet er dit og er næste skridt.
Trin 4 — Giv den stil
Skriv CSS mod krogene:
.button {
background: #2563eb;
color: #fff;
padding: 0.75rem 1.5rem;
border: 0;
border-radius: 0.5rem;
}
.text-input,
.email-input {
padding: 0.5rem 0.75rem;
border: 2px solid #6b7280;
border-radius: 0.25rem;
}
.label { display: block; font-weight: 600; margin-bottom: 0.25rem; }
Eller spring håndskrevet CSS helt over — link et af de 45 færdige temaer, og den samme markup lyser op:
<link rel="stylesheet" href="/themes/united-kingdom-national-health-service-england-for-patients.css" />
Trin 5 — Udforsk videre
- Repoets tests kører i rigtige browsere:
pnpm install && pnpm test(WebDriverIO). - Storybook for hver komponent:
pnpm run storybook. - HTML+CSS+JS eksempelapp viser alle 571 komponenter formgivet, søgbare og demonstreret.
Næste skridt
- Temaer — temaskift under kørsel med theme-picker.
- Indstillingshjælpere — sprog og tekststørrelse.
- Komponentkatalog — den fulde reference.
Spørgsmål undervejs? Siden Hjælp er fuld af svar — og hvis et trin kan blive tydeligere, så fortæl os det og vi forbedrer gerne vejledningen.