Passer au contenu principal

Kit de design Figma

Concevoir avec les mêmes tokens votre application s’exécute sur

Le DWC Design Kit est la ressource Figma officielle pour concevoir des applications webforJ, afin que les designers et les développeurs utilisent les mêmes tokens et composants.

Composants
Chaque composant DWC, avec ses thèmes, dimensions et états
Jetons
Palettes, typographie, espacements et ombres sous forme de variables et de styles Figma
Modes
Clair et sombre, tels que l’application les affiche dans webforJ 26 et versions ultérieures

Variables

Les valeurs du kit Les valeurs sont-elles dans le code ?

Le kit stocke les jetons DWC sous forme de variables Figma. Dans l’application, ce sont des propriétés personnalisées CSS. Tout ce qui suit provient des variables --dwc-* utilisées par cette page, avec la valeur que le navigateur résout pour chacune. Passez le site en mode sombre : elles suivront, comme le mode sombre du kit.

Couleur

--dwc-color-{palette}-{step}

Sept palettes de 19 nuances, chacune générée à partir d’une seule couleur source. La nuance 5 est toujours la plus sombre et la nuance 95 la plus claire. Sélectionnez une nuance pour l’examiner.

Aa
Jeton
--dwc-color-primary-50
Valeur résolue
Texte dessus
--dwc-color-on-primary-text-50
primaryCouleur de votre marque
defaultNeutre, teinté de la couleur principale
successStatut
warningStatut
dangerStatut
infoEmphase secondaire
grayGris pur, sans teinte

Typographie

--dwc-font-size-{size}

Une échelle de tailles en rem, où m désigne la taille standard utilisée par la plupart des composants, et une échelle de graisse allant du plus fin au plus épais.

  • --dwc-font-size-3xsAffecter un conducteur
  • --dwc-font-size-2xsAffecter un conducteur
  • --dwc-font-size-xsAffecter un conducteur
  • --dwc-font-size-sAffecter un conducteur
  • --dwc-font-size-mAffecter un conducteur
  • --dwc-font-size-lAffecter un conducteur
  • --dwc-font-size-xlAffecter un conducteur
  • --dwc-font-size-2xlAffecter un conducteur
  • --dwc-font-size-3xlAffecter un conducteur
  • Agthin
  • Aglighter
  • Aglight
  • Agnormal
  • Agmedium
  • Agsemibold
  • Agbold
  • Agbolder
  • Agblack

Espacement et taille

--dwc-space-{size} --dwc-size-{size}

L’espacement définit l’espace entre les composants. La taille définit leur largeur et leur hauteur, m étant la valeur standard pour presque tous. Les barres d’espacement sont dessinées à quatre fois leur taille.

  • --dwc-space-3xs
  • --dwc-space-2xs
  • --dwc-space-xs
  • --dwc-space-s
  • --dwc-space-m
  • --dwc-space-l
  • --dwc-space-xl
  • --dwc-space-2xl
  • --dwc-space-3xl
  • 3xs
  • 2xs
  • xs
  • s
  • m
  • l
  • xl
  • 2xl
  • 3xl

Rayon

--dwc-border-radius-{size}

Chaque niveau est calculé à partir d’une seule valeur de base, --dwc-border-radius-seed. Modifiez cette valeur et tout le système de rayons de bordure s’adapte.

  • 2xs
  • xs
  • s
  • m
  • l
  • xl
  • 2xl
  • 3xl
  • 4xl

Ombres et surfaces

--dwc-shadow-{size} --dwc-surface-{level}

Les ombres indiquent ce qui est superposé. Trois surfaces structurent la hiérarchie, de la page à la boîte de dialogue. Les deux s’adaptent aux modes clair et sombre.

  • xs
  • s
  • m
  • l
  • xl
  • 2xl
--dwc-surface-1Arrière-plan de la page et du corps
--dwc-surface-2Barres d’outils, barres de menus, cartes
--dwc-surface-3Fenêtres, menus, fenêtres contextuelles, boîtes de dialogue

Du kit à l’application

Conçu avec le kit, Créé à partir de composants webforJ

Les écrans en haut de cette page ont été conçus avec le kit. Un écran conçu avec le kit utilise les composants et les tokens rendus par l’application : le passage de la maquette au code Java ne consiste donc pas à traduire un langage visuel en un autre.

Parcourez la présentation

Concepteur et développeur

Un transfert, Mappé une fois

Les tokens sont le contrat entre le design et le code. Le designer transmet une couleur de marque et une échelle typographique du kit. Le développeur les associe une seule fois à une seed et à un token de taille de police, et tous les écrans en héritent.

  1. Dans Figma Une couleur de marqueDans le code--dwc-color-primary-seedLes 19 étapes de la palette sont toutes générées à partir de celle-ci.
  2. Dans Figma Une échelle typographiqueDans le code--dwc-font-size-{size}Tailles en rem, m est la taille standard.
  3. Dans Figma Un rythme d’espacementDans le code--dwc-space-{size}Espacement entre les composants, en rem.
  4. Dans Figma Clair et sombreDans le code@AppTheme("system")Suit la préférence du système.

Dans le kit

  • Chaque composant DWC tel qu’il apparaît dans webforJ 26 et les versions ultérieures, avec ses thèmes, dimensions et états.
  • Les palettes de couleurs, la typographie, les espacements et les tokens d’ombre sous forme de variables et de styles Figma.
  • Mode clair et sombre pour les composants et les jetons.
  • Espacement précis et contraste des couleurs respectueux de l’accessibilité, pour des interfaces au comportement prévisible.

Dans l’application

Définissez la marque une seule fois comme base. Les boutons, les liens et les contours de focus la reprennent, car ils utilisent la palette principale.

brand.css
:root {
--dwc-color-primary-seed: #2563eb;
}

html[data-app-theme="dark"] {
--dwc-color-primary-seed: #a855f7;
}

Enregistrez un thème clair et un thème sombre, puis laissez webforJ suivre le système d’exploitation de l’utilisateur.

MyApp.java
@AppTheme("system")
@AppLightTheme("light")
@AppDarkTheme("dark")
class MyApp extends App {
// app code
}

Créer avec l’IA

À partir du frame Figma vers l’écran Java

Connectez deux serveurs MCP à votre assistant de programmation : celui de Figma et celui de webforJ. L’un lit la maquette, l’autre connaît le framework, et l’assistant fait le lien entre les deux.

  1. 01Figma MCP server

    Lit le design

    Il transmet à votre assistant la frame que vous désignez : sa mise en page, ses composants et ses variables. Les variables du kit reprennent les noms des tokens DWC ; le design parle donc déjà le langage du code.

    var(--dwc-space-s)
  2. 02webforJ MCP server

    Le vérifie avec webforJ

    Il répond à partir du framework réel : quel composant utiliser, quelles possibilités de style il offre et si chaque jeton CSS existe.

    styles_validate_tokens
  3. 03Votre assistant

    Écrire l’écran en Java

    Une fois les deux connectés, la vue est générée à partir des composants webforJ et des mêmes jetons utilisés par le concepteur, puis vous comparez le résultat à la maquette.

    OrdersView.java
Un prompt pour commencer

Créez une vue webforJ à partir de ce cadre Figma. Consultez-le avec le serveur MCP Figma, choisissez les composants avec le serveur MCP webforJ et validez chaque token --dwc-* avant de terminer.

Obtenir le kit

Démarrez votre prochain écran dans Figma

Le DWC Design Kit est disponible sur Figma Community. webforJ est le framework Java full-stack pour les applications web métier : vous développez toute l’application, écrans compris, en Java.

  1. 1
    Ouvrir le kitRetrouvez le DWC Design Kit sur Figma Community.
  2. 2
    Concevez les écrans Utilisez ses composants et variables, et vérifiez chaque écran en mode clair et en mode sombre.
  3. 3
    Créez-les en Java.Utilisez les mêmes composants dans webforJ et définissez votre marque avec une seule graine.