Typographie
Échelle de typographie, rôles de texte et hiérarchie utilisés dans l'interface utilisateur de PyColors.
Vue d’ensembleLien vers la section
La typographie est l'un des signaux les plus forts de la qualité du produit. Il donne à chaque interface une structure lisible avant que la couleur, l'espacement, le mouvement ou la décoration ne soient ajoutés.
PyColors traite la typographie comme un systèmePas comme style de page locale. L'objectif est de garder les tableaux de bord, la documentation, les pages de paramètres, les sections marketing, les formulaires et les flux de produits lisibles et cohérents à mesure que le produit se développe.
À la fin de cette page, vous comprendrez comment PyColors gère :
- rôles de police
- Hiérarchie des titres
- densité du corps du texte
- étiquettes et métadonnées
- Rôles sémantiques de texte
- règles d'utilisation de la production
Pourquoi cela compte
Un système de type faible rend un produit inachevé même lorsque les composants de l'interface utilisateur sont corrects. Une typographie stable améliore la numérisation, réduit le bruit visuel et rend l'interface plus délibérée.
Ce que vous allez définirLien vers la section
Rôles de police
Hiérarchie
Règles d'utilisation
ÉtapesLien vers la section
Utiliser les rôles de police au lieu des choix de policeLien vers la section
PyColors expose les polices en tant que variables et utilitaires CSS. Les composants doivent dépendre du rôle de la police et non d'une famille codée en dur.
import { Inter } from "next/font/google";
const inter = Inter({
subsets: ["latin"],
variable: "--font-sans", // highlight
});Les rôles communs sont :
| Rôle | Utilité | Objet |
|---|---|---|
| UI et contenu | font-sans | Interface par défaut et contenu lisible |
| Accent de marque | font-brand | Rubriques, sections de héros, identité premium |
| Valeurs techniques | font-mono | Code, identifiants, tokens, sortie CLI |
Note d ' exécution
La famille de polices exacte peut changer avec le temps. La partie importante est que les composants continuent de consommer des rôles de police stables.
Choisir la densité par surfaceLien vers la section
PyColors maintient la densité du texte simple. Les interfaces produits devraient rester efficaces, tandis que la documentation et le contenu marketing devraient être plus faciles à lire.
| Surface | Par défaut | Motif |
|---|---|---|
| UI et tableaux de bord SaaS | text-sm | Assez dense pour les workflows de produits |
| Docs, guides et marketing | text-base | Plus confortable pour la lecture |
| Étiquettes et métadonnées | text-xs | Contexte compact sans concurrence avec les titres |
Cette division maintient les tableaux de bord efficaces tout en rendant la documentation calme et premium.
Construire la hiérarchie avec une échelle limitéeLien vers la section
Les titres doivent rendre la structure évidente sans transformer chaque section en un événement visuel.
Titre de la page
Titre de section
Sous-section Titre
Rubrique mineure
Texte lisible avec suffisamment de rythme pour la documentation et la copie du produit.
Pourquoi c'est importantLien vers la section
La typographie est l’endroit où la qualité du produit devient visible. Les utilisateurs peuvent ne pas remarquer le système de type directement, mais ils remarquent lorsque le produit se sent plus difficile à numériser, moins structuré ou visuellement incohérent.
Sans un système de typographie stable, vous pourrez :
- inventer des tailles d'en-tête page par page
- surutiliser le poids de la police pour créer l'emphase
- rendre les tableaux de bord visuellement bruyants
- réduire la confiance dans les surfaces de produits et de documentation
- rendre les composants plus difficiles à réutiliser de manière cohérente
Avec un système stable, chaque page semble plus calme, plus intentionnelle et plus facile à comprendre.
Principe du produit
La typographie devrait réduire la charge cognitive. Il devrait guider le lecteur à travers le produit, pas rivaliser pour l'attention.
Rôles de texteLien vers la section
Le texte principal est utilisé pour le contenu principal qu'un utilisateur doit lire ou sur lequel il doit agir.
Le texte secondaire prend en charge le message principal avec des descriptions, une copie d'aide et des détails contextuels.
Les métadonnées sont réservées aux horodatages, aux étiquettes, aux indications de statut et aux informations secondaires compactes.
| Rôle | Utilité | Utilisation |
|---|---|---|
| Texte principal | text-foreground | Principaux contenus lisibles |
| Texte secondaire | text-muted-foreground | Descriptions, texte d'aide, copie d'appui |
| Marque ou texte d'action | text-primary | Liens et actions mises en avant |
| Texte destructeur | text-destructive | Erreurs, flux de suppression, messages dangereux |
| Texte technique | font-mono | Code, tokens, identifiants, valeurs CLI |
Règles d'utilisationLien vers la section
Utilisez des rôles de typographie pour créer des surfaces de produit cohérentes au lieu de styliser le texte à partir de zéro à chaque fois.
export function ProductSummary() {
return (
<section className="space-y-2">
<p className="text-xs font-medium uppercase tracking-wide text-muted-foreground">
Starter Pro
</p>
<h2 className="text-2xl font-semibold tracking-tight">
Production-shaped SaaS foundation
</h2>
<p className="max-w-prose text-sm leading-6 text-muted-foreground">
Use semantic text roles to keep product copy, labels, and descriptions
predictable across reusable surfaces.
</p>
</section>
);
}Guide de décisionLien vers la section
Utilisez ce système de typographie si :
- vous créez des tableaux de bord SaaS, des documents, des paramètres ou des pages marketing
- vous avez besoin d'une hiérarchie cohérente entre plusieurs domaines de produits
- vous voulez que les composants réutilisables soient cohérents sans surcharges locales
- vous vous souciez de la lisibilité en mode clair et sombre
Ne pas outrepasser si :
- le changement ne résout qu'une préférence visuelle locale
- le même besoin apparaît dans plusieurs endroits et devrait devenir un token
- la nouvelle taille, le poids ou la couleur affaiblit la cohérence hiérarchique
Prêt à passer du système de conception à la base du produit?
Starter Pro vous donne une base SaaS plus forte avec auth, facturation,
structure backend et flux adaptées à la production. /docs/starter-pro
Erreurs courantesLien vers la section
Préférez
- tailles de cap limitées
- Couleurs sémantiques du texte
- helper copy
- étiquettes pour les métadonnées
- Longueurs de ligne raisonnables
Éviter
- trop de tailles de police dans un seul panneau
- copie majuscule longue forme
- Valeurs de couleur brutes pour le texte
- tailles de titre aléatoires entre les pages
- Le poids au lieu de la structure