Qokit Ontwerprichtlijnen
Open ontwerpcodes gericht op platformintegratie, extensieontwikkeling en componentgebruik.
Qokit Ontwerprichtlijnen
Deze Qokit Ontwerprichtlijnen zijn bedoeld voor toekomstige platformintegrators, extensieontwikkelaars en frontendteams. Ze maken de merkbasiselementen, componentinterfaces, visuele hiërarchie, responsieve vereisten en compatibiliteitsstrategieën openbaar die op lange termijn betrouwbaar zijn.
Hier wordt beschreven "waar ontwikkelaars op kunnen vertrouwen". Interne productroutes, AI-prompts, repositorybesluitvormingsprocessen en niet-openbare implementaties zijn hierin niet opgenomen.
Snelle integratie
import { Button, Card } from '@qokit/components/ui';
import { platformButtonSkin, platformCardSkin } from '@qokit/components/skins/platform';
export function IntegrationAction() {
return (
<Card layer="shell" skin={platformCardSkin}>
<Button skin={platformButtonSkin} type="button" variant="primary">
连接 Qokit
</Button>
</Card>
);
}Selecteer bij integratie de mogelijkheden in de volgende volgorde:
- Kies basiscomponenten zoals Button, Card en Dialog uit
@qokit/components/ui; - Kies stabiele productcombinaties uit
@qokit/components/patterns; - Pas de doelinterface aan met
@qokit/components/skins/platform,siteofadmin; - Gebruik gedeelde CSS Tokens; kopieer geen basisstijlen van componenten;
- Valideer desktop-, mobiel-, toetsenbord- en lange-tekststatussen.
Gidskaart
| Wat u moet weten | Document |
|---|---|
| Merkkleuren, lettertypes, spaties en Tokens | foundations.md |
| Responsiviteit, toetsenbord en toegankelijkheid | accessibility.md |
| Componentimport, publieke contracten voor Skeleton/Skin en upgradeprocessen | component-integration.md |
| Button en IconButton | button-component-rules.md |
| Card, Shell, overlays en materialen | card-surface-materials.md |
| Openbare kwaliteitsstandaarden gegenereerde sites | generated-site-quality.md |
| Contractwijzigingen en upgradehistorie | changelog.md |
Openbaar contract
- Componentstructuur, attributen en toegankelijkheidsgedrag worden beheerd door gedeelde componenten;
- Skin wijzigt alleen class-slots en CSS-variabelen, niet het bedrijfs gedrag;
- Semantische Tokens behouden dezelfde verantwoordelijkheid in lichte, donkere en gegenereerde thematische achtergronden;
- Brekende wijzigingen moeten worden geregistreerd in de Changelog, vergezeld van migratie-instructies;
- Bij verschillen tussen documentatie en code heeft de gepubliceerde component-API voorrang, en wordt de documentatie binnen dezelfde versie gecorrigeerd.
