Style du bloc (style.less)
Comment style.less est compilé : variables issues des propriétés, variables d'arrière-plan, conditions, portée par classe d'instance, couches CSS et priorité dans l'éditeur et l'export, taille de police de base, boutons et liens, CSS du thème ou CSS du bloc.
Vue d'ensemble#
style.less est le style d'un bloc. Le programme le compile avec LESS 4.9.1 à chaque dessin du bloc, donc à chaque modification d'une valeur dans le panneau des propriétés. À la place de style.less, le fichier peut s'appeler style.css ; il passe par le même compilateur.
padding-top: (@abstand * 1rem);
background: @kartenFarbe;
.titel { color: @akzent; }
@media (max-width: 767px) { padding-top: 0; }Trois choses distinguent ce fichier d'un LESS ordinaire :
- Variables : chaque propriété de
<vn-parameters>est disponible comme variable@name, plus@bg-type,@bg-value,@bg-parallaxet une série de variables de thème. - Racine : le programme enveloppe tout le contenu dans
.<classe d'instance> { … }. Les déclarations sans sélecteur valent donc pour l'élément racine, chaque règle seulement pour les éléments dans le bloc. - Priorité : dans l'éditeur, le CSS se trouve dans une couche à part ; les règles correspondantes figurent plus bas.
Variables issues des propriétés#
Pour chaque champ nommé, le programme déclare une variable avant votre LESS. La valeur dépend du type de champ :
| Type de champ | Valeur LESS | Exemple @name | Utilisation |
|---|---|---|---|
range | nombre sans unité | 4 | padding-top: (@abstand * 1rem); |
color | couleur | #4f46e5 | background: @akzent;, fade(@akzent, 20%) |
checkbox | true ou false | true | & when (@schatten) { … } |
select, text, textarea, image | texte entre apostrophes | 'center' | & when (@ausrichtung = 'center') { … }, url(@foto) |
| Widget d'arrière-plan | pas de variable @bg, mais les variables d'arrière-plan |
Une valeur range vide donne 0, une couleur vide #000000. Dans le texte, ' et @{ sont neutralisés pour qu'une saisie quelconque ne casse pas le LESS.
Sortir des valeurs comme texte en CSS#
Comme le texte arrive en tant que texte LESS (avec guillemets), aspect-ratio: @ratio; donne la sortie invalide aspect-ratio: '16/9';. Il y a trois façons d'obtenir la valeur nue (toutes vérifiées) :
aspect-ratio: ~"@{ratio}"; // valeur de propriété sans guillemets
@cls: e(@mode); // noms pour sélecteurs : .grid-x, &.is-grid
.@{cls}-x { … }
&.ansicht-@{cls} { … }| Notation | Résultat avec @mode: 'grid' |
|---|---|
@mode comme valeur | 'grid' (avec guillemets) |
~"@{mode}" | grid |
e(@mode) | grid |
.@{mode}-x (sans e()) | .'grid'-x (invalide) |
Les textes dans content ou url(…) fonctionnent directement : content: "@{label}"; et url(@foto) (les deux vérifiés).
Comparaisons et conditions#
Avec & when (…) { … }, on inclut des règles selon les valeurs (gardes LESS).
& when (@schatten) { box-shadow: 0 8px 24px rgba(0, 0, 0, .2); }
& when not (@schatten) { box-shadow: none; }
& when (@ansicht = 'liste') { .karten { display: block; } }
& when (@anzahl > 2) and (@schatten) { … }Ce qui fonctionne dans une condition (vérifié)
| Notation | Résultat |
|---|---|
when (@checkbox) | vrai si activé |
when (@checkbox = true) | vrai si activé |
when (@checkbox = false) | vrai si désactivé |
when not (@checkbox) | vrai si désactivé |
when (@texte = 'abc') et when (@texte = "abc") | vrai en cas d'égalité |
when (@texte = abc) (sans guillemets) | jamais vrai |
when (@nombre > 2), when (@nombre = 2) | comparaison avec le nombre |
when (@nombre = "2") | jamais vrai (nombre contre texte) |
when (@a) and (@b), when (@a), (@b) | et, ou |
when (default()) | erreur : seulement autorisé dans les gardes de mixins, tout le CSS du bloc est perdu |
Calculer#
- La multiplication n'a pas besoin de parenthèses :
@n * 1rem,@n * 10%,2 * @n; les parenthèses ne nuisent pourtant jamais ((@n * 1rem)), et c'est la norme dans les blocs. - La division seulement entre parenthèses :
(@n / 2). Le programme met lui-même entre parenthèses@variable / nombreet@variable / @variable(line-height: @n / 2;donne1.5). Une division de littéraux n'est pas réécrite :10px / 2reste tel quel,(10px / 2)donne5px. - Vous ajoutez les unités :
(@n * 1px),(@n * 1%),(@n * 1vw). - Les fonctions CSS avec variables s'écrivent comme texte LESS :
font-size: ~"clamp(1rem, @{n}vw, 3rem)";,width: ~"calc(100% - @{n}rem)";.min()etmax()avec calcul entre parenthèses marchent aussi directement :min((@n * 10px), 50%). - Les fonctions de couleur de LESS sont disponibles :
fade,lighten,darken,mix,contrast(vérifié).
Variables d'arrière-plan#
Si le bloc possède un widget d'arrière-plan, ces variables s'ajoutent (bg représente le nom du widget ; les noms @bg-type, @bg-value, @bg-parallax sont fixes, indépendamment du nom du champ) :
| Variable | Valeur | Signification |
|---|---|---|
@bg-type | 'color', 'image' ou 'video' | type choisi |
@bg-value pour une couleur | couleur, p. ex. #f3f4f6 | pas de guillemets |
@bg-value pour une image | texte, l'adresse de l'image | url(@bg-value) donne url("…") |
@bg-value pour une vidéo | texte, l'adresse de la vidéo | |
@bg-parallax | true ou false | interrupteur « Effet de parallaxe » (activé seulement pour une image) |
Modèle (tiré de themes/vn-studio-src/components/header1, complété par la parallaxe)
& when (@bg-type = 'color') { background-color: @bg-value; }
& when (@bg-type = 'image') {
background-image: url(@bg-value);
background-size: cover;
background-position: center;
& when (@bg-parallax = true) { background-attachment: fixed; }
}Pour une image avec parallaxe activée, le programme ajoute en plus une règle propre .<classe d'instance> { background-attachment: fixed; }. La parallaxe fonctionne donc même si votre LESS n'interroge jamais @bg-parallax.
Variables de thème#
En plus des champs, chaque LESS connaît ces variables, afin que les blocs issus de paquets de thème n'échouent pas sur une variable manquante sans leur thème :
| Variables | Valeur par défaut |
|---|---|
@primaryColor | #3B7DDD |
@secondaryColor | #6C757D |
@successColor | #28A745 |
@infoColor | #17A2B8 |
@warningColor | #FFC107 |
@dangerColor | #DC3545 |
@mainFont, @display1Font, @display2Font, @display4Font, @display5Font | Poppins |
@display7Font | Roboto |
@display1Size à @display7Size (1, 2, 4, 5, 7) | 4.25, 3, 0.875, 1.5, 1.06 |
@isRoundedButtons, @isGhostButtonBorder, @isAnimatedOnScroll, @isScrollToTopButton | false |
Si le bloc appartient à un paquet de thème dont params.json définit ses propres variables sous theme.settings, leurs valeurs remplacent celles par défaut, voir Propriétés du thème. Un champ du bloc portant le même nom écrase les deux.
Portée et racine#
Le programme enveloppe votre LESS ainsi :
@abstand: 4; // … toutes les variables
.vn-imp-meine-bloecke-bmw3s4eyec6ik { // classe d'instance
/* Ihr style.less */
}La classe d'instance est portée individuellement par chaque instance de bloc (vn-imp-<alias>-<ID du bloc>, voir Paquets) ; deux blocs du même type ne se gênent donc pas.
Ce qui en découle (tout vérifié)
| Vous écrivez | Résultat | Désigne |
|---|---|---|
padding: 2rem; | .racine { padding: 2rem; } | l'élément racine lui-même |
.titel { … } | .racine .titel { … } | les descendants dans le bloc |
&.aktiv { … } | .racine.aktiv { … } | l'élément racine avec une classe supplémentaire |
> .direkt { … } | .racine > .direkt { … } | les enfants directs |
.karte { &:hover { … } &-titel { … } } | .racine .karte:hover, .racine .karte-titel | imbrication LESS habituelle |
h1, h2 { … } et * { … } | .racine h1, .racine h2, .racine * | ne vaut qu'à l'intérieur du bloc |
@media (…) { … } | @media (…) { .racine … } | media query à l'extérieur, règle à l'intérieur |
@container, @layer, @supports | comme @media | |
@keyframes, @font-face | sans classe d'instance | valent pour toute la page |
body { … }, html { … }, :root { … } | .racine body { … } | ne touche jamais rien |
Deux particularités que le compilateur aplanit :
- Un repère de langue en tête, issu d'un code collé depuis une conversation (
css:ou une première lignecss), est retiré ; sinon LESS avalerait la première propriété. - Les commentaires de ligne
// …disparaissent à la sortie, les commentaires de bloc/* … */restent.
Erreurs dans le LESS#
Si la compilation échoue (erreur de syntaxe, variable inconnue, garde default()), voici ce qui se passe :
- Le bloc reçoit dans l'éditeur l'étiquette rouge « ⚠ Erreur CSS » ; le message figure dans l'info-bulle.
- Le CSS de ce bloc est vide (pas seulement la règle fautive). Les autres blocs ne sont pas touchés.
- Un avertissement apparaît dans la console des outils de développement.
Causes typiques : un nom avec tréma ou $ comme nom de propriété, @import, un bloc non fermé, when (default()).
Priorité : couches et ordre#
L'éditeur et l'export assemblent le CSS différemment. Il faut comprendre les deux lorsqu'un bloc a un autre aspect dans l'éditeur que sur la page terminée.
Dans l'éditeur#
Au démarrage, l'éditeur fixe l'ordre des couches CSS (les dernières l'emportent) :
@layer app-ui, bootstrap-base, theme-base, vn-blocks;| Couche | Contenu |
|---|---|
app-ui | l'interface du programme |
bootstrap-base | Bootstrap 5.0.1 pour la zone de travail (@scope (#canvas)) |
theme-base | CSS du thème du paquet (@scope (#canvas)), voir CSS du thème |
vn-blocks | le CSS de tous les blocs, compilé, avec classe d'instance, sans @scope |
| sans couche | règles des réglages du site (police, taille de police, typographie, style des liens) et « CSS personnalisé » |
Dans l'export#
Il n'y a ni couches ni @scope. La page charge vendor/bootstrap.min.css puis style.css. Dans style.css, dans cet ordre : CSS du thème (sans portée), CSS de tous les blocs, règles de police des réglages du site, règles d'aide fixes du programme (menu, liens, dialogues), enfin le « CSS personnalisé ». Ce sont les règles habituelles qui décident : importance, puis spécificité, puis ordre.
Qui l'emporte (mesuré)#
Toutes les lignes ont été mesurées dans le programme en marche (éditeur) et sur une page construite à partir de l'export (export).
| Cas | Éditeur | Export |
|---|---|---|
Règle du bloc contre Bootstrap, toutes deux sans !important | bloc (couche) | bloc (spécificité plus élevée, plus tard) |
Règle du bloc contre CSS du thème, toutes deux sans !important | bloc | bloc (plus tard) |
Bloc !important contre Bootstrap !important (p. ex. .text-white) | Bootstrap | bloc (spécificité plus élevée) |
Bloc !important contre CSS du thème !important | thème | spécificité, puis ordre |
Bloc !important contre un réglage du site ou « CSS personnalisé » avec !important | bloc | spécificité, puis ordre |
Bloc sans !important contre « CSS personnalisé » sans !important | CSS personnalisé (sans couche) | spécificité : le plus souvent bloc |
Bloc sans !important contre la taille de police du site (!important) | site | site |
La règle derrière : pour les déclarations ordinaires, la couche la plus tardive l'emporte, et l'absence de couche l'emporte sur toutes les couches. Pour !important, l'ordre s'inverse : la couche la plus ancienne l'emporte, et l'absence de couche perd. Une déclaration !important dans le bloc ne l'emporte donc, dans l'éditeur, sur aucune règle !important de Bootstrap ou du CSS du thème.
Le piège #canvas dans le CSS du thème#
Dans l'éditeur, le CSS du thème se trouve dans @scope (#canvas) { … }. À l'intérieur de @scope, #canvas est le nœud racine de la portée, et un sélecteur #canvas .x n'y trouve rien (vérifié). Pour des règles qui ne doivent valoir que dans l'éditeur, écrivez :scope#canvas .x.
| Notation dans le CSS du thème | Éditeur | Export |
|---|---|---|
.x { … } | touche .x dans la zone de travail | touche .x |
#canvas .x { … } | ne touche rien | ne touche rien (il n'y a pas de #canvas) |
:scope#canvas .x { … } | touche .x (éditeur seulement) | ne touche rien |
:scope { --farbe: red; } | pose la variable sur #canvas | la pose sur html |
html { … }, body { … }, :root { … } | sans effet | s'applique normalement |
Dans l'éditeur, les media queries utilisent la largeur de la fenêtre du programme, pas celle de la zone de travail. Vérifiez téléphone et tablette dans l'aperçu en direct (boutons « Tablette » et « Téléphone »).
Réglages du site qui écrasent votre CSS#
Certains réglages du projet produisent du CSS avec !important. Ils valent pour tous les blocs et agissent aussi sur le LESS de votre bloc :
| Réglage | Agit sur | Conséquence pour le LESS du bloc |
|---|---|---|
Taille de police du corps de texte (nouveaux projets : 1.2rem) | body, p, li, td, th, blockquote, figcaption, label et les classes de texte d'anciens paquets (Anciennes notations) | font-size sur ces éléments avec !important |
| Police du corps de texte et du menu, police des titres | textes, titres, menu, .btn | font-family |
| Typographie par élément (H1–H6, P, LI, boutons) | les éléments cités | font-family, font-size, font-weight, color, line-height avec !important |
| Coins de boutons globaux | .btn sans forme propre | border-radius avec !important |
| Style des liens | liens dans nav et en dehors | text-decoration (sans !important) |
Ce que cela signifie pour vous (mesuré, voir ci-dessus) :
p { font-size: 3rem; }dans le LESS du bloc reste sans effet tant que la taille de police du site est définie. Placez les tailles fines surdivouspan, ou posez!important(.klasse { font-size: 3rem !important; }).- La taille de police ne vaut que pour le corps de texte. Titres, menu, boutons et liens ne sont pas touchés.
Boutons et liens#
La règle pratique des blocs fournis : définir couleurs, bordures et police des boutons et liens dans le LESS du bloc avec !important.
.tz-text .btn-primary {
background-color: @akzent !important;
border-color: @akzent !important;
color: #fff !important;
}Mesuré : une règle de bouton sans !important l'emporte dans l'éditeur et dans l'export contre Bootstrap (voir le tableau ci-dessus). !important protège contre les règles qui ne l'emportent pas là : CSS du thème de spécificité plus élevée ou avec !important, et les règles de police du site. Pour !important contre Bootstrap !important, tenez compte de l'avertissement ci-dessus (l'éditeur et l'export divergent).
La boîte de dialogue de bouton pose la couleur sous forme de classe Bootstrap (btn-primary …). Si l'utilisateur choisit « Couleur personnalisée », la classe de couleur disparaît et les couleurs se trouvent sur l'élément comme style en ligne ordinaire (sans !important, vérifié dans le code). Visez donc avec !important la classe de couleur (.btn-primary), pas .btn : une règle !important sur .btn écrase la couleur personnalisée de l'utilisateur.
CSS du bloc ou CSS du thème ?#
Relève du LESS du bloc (style.less) | Relève du CSS du thème (plugins/theme/css/style.css) |
|---|---|
tout ce qui dépend des propriétés du bloc (@name) | règles sans variables que plusieurs blocs partagent (typographie de base du thème, classes d'aide communes) |
| l'aspect de ce bloc | formes de .btn et couleurs par défaut du thème |
@media, @container pour ce bloc | règles valables pour toute la page (body, :scope) |
@keyframes du bloc (avec préfixe dans le nom) | polices (@font-face) avec fichiers du paquet |
Le LESS du bloc est enregistré avec le bloc et n'est sorti à l'export que pour les blocs utilisés. Le CSS du thème est chargé une fois par projet ; une mise à jour ultérieure du paquet ne le modifie pas dans les projets existants (Une seule fois par projet). Une erreur dans le CSS du thème se corrige donc plus difficilement plus tard qu'une erreur dans le bloc.
Exemple#
L'exemple combine variables, conditions, variables d'arrière-plan, media query et la règle pratique pour les boutons. Il appartient au bloc teaser de Champs de saisie ; le modèle s'y trouve aussi.
position: relative;
padding-top: (@abstandOben * 1rem);
padding-bottom: (@abstandUnten * 1rem);
color: @textFarbe;
& when (@bg-type = 'color') { background-color: @bg-value; }
& when (@bg-type = 'image') {
background-image: url(@bg-value);
background-size: cover;
background-position: center;
& when (@bg-parallax = true) { background-attachment: fixed; }
}
.tz-inner { position: relative; z-index: 1; display: flex; gap: 2rem; align-items: center; }
.tz-foto { max-width: 40%; border-radius: 0.5rem; }
.tz-vorteile { white-space: pre-line; font-size: 1.1rem; }
&.tz-mitte .tz-inner { justify-content: center; text-align: center; }
.tz-text h2 { color: @akzent; }
.tz-text .btn-primary {
background-color: @akzent !important;
border-color: @akzent !important;
color: #fff !important;
}
@media (max-width: 767px) {
.tz-inner { flex-direction: column; }
.tz-foto { max-width: 100%; }
}Compilé, avec abstandOben = 4 et un arrière-plan en image, cela donne entre autres :
.vn-imp-beispiel-teaser-bmw3se032ai5q {
position: relative;
padding-top: 4rem;
padding-bottom: 4rem;
color: #1f2937;
background-image: url("assets/x.jpg");
background-size: cover;
background-position: center;
background-attachment: fixed;
}
.vn-imp-beispiel-teaser-bmw3se032ai5q .tz-inner { … }Liste de contrôle#
- Chaque variable
@namedu LESS est un champ de<vn-parameters>(ou une variable d'arrière-plan/de thème). @bg-…seulement s'il y a un widget d'arrière-plan, et seulement dans une condition sur@bg-type.- Comparez les valeurs de
selectcomme texte (@x = 'a'), dans les propriétés et les sélecteurs utilisez~"@{x}"oue(@x). - Pas de
body,html,:rootdans le LESS du bloc. - Pas de BOM, pas de
@import, pas dedefault(). - Noms dans
@keyframes/@font-faceavec un préfixe. !importantseulement là où il est nécessaire, puis vérifié dans l'aperçu en direct.