SScale Themedocs

Système complet de sélection de variantes : swatches couleur et image, boutons, dropdown. Configuration par option, detection automatique et personnalisation avancee.

Options de variantes

Le bloc Variant Option de Scale Theme offre un système complet pour afficher les options de variantes de vos produits. Trois types de sélecteur sont disponibles -- boutons, swatches visuels (image) et dropdown -- chacun entièrement configurable pour s'adapter à votre catalogue.


Les 3 types de sélecteur

TypeRenduIdéal pour
Button (Bouton)Boutons rectangulaires avec texteTailles (S/M/L/XL), matériaux, options textuelles
Image (Swatch)Pastilles visuelles avec image ou couleurCouleurs, motifs, textures, configurations visuelles
DropdownMenu déroulantOptions tres nombreuses (20+), gain d'espace vertical

Button (Bouton)

Le type Button affiche chaque valeur d'option sous forme de bouton rectangulaire avec texte. C'est le choix le plus courant pour les tailles et les options textuelles.

Settings du type Button

SettingDescriptionOptions
DirectionDisposition des boutonsHorizontal (en ligne) / Vertical (empile)
Items par ligneNombre de boutons par ligne (mode horizontal)Auto / 2 / 3 / 4 / 5 / 6
Style de sélectionComment marquer la valeur activeBackground (fond coloré) / Border (bordure epaisse)
Border radiusArrondi des coins des boutons0 a 50px
TailleDimension des boutonsSmall / Medium / Large
Masquer le labelNe pas afficher le nom de l'option au-dessusOui / Non
💡Le mode Items par ligne est particulièrement utile pour les pointures (4 par ligne) ou les tailles avec beaucoup de valeurs. En mode Auto, les boutons s'adaptent naturellement en wrap.

Image / Swatch (Pastille visuelle)

Le type Image affiche des pastilles visuelles pour chaque valeur. Il fonctionne en deux modes : images (photos des variantes) ou couleurs (pastilles colorées détectées automatiquement).

Swatches avec images de variante

Quand chaque variante a sa propre image dans Shopify, le swatch affiche une miniature de cette image.

Swatches avec couleurs détectées

Quand les valeurs de l'option correspondent a des noms de couleur, Scale Theme génère automatiquement des pastilles colorées.

Detection automatique des couleurs

Scale Theme détecte les couleurs à partir du nom de l'option en francais et en anglais :

Nom détecte (FR / EN)Couleur générée
Noir / Black#000000
Blanc / White#FFFFFF
Rouge / Red#E53E3E
Bleu / Blue#3182CE
Bleu marine / Navy#1A365D
Vert / Green#38A169
Rose / Pink#ED64A6
Gris / Gray#A0AEC0
Beige#D4C5A9
Bordeaux / Burgundy#800020
Corail / Coral#FF6F61
+ 30 autres couleursAuto-détectées
ℹ️Si une couleur n'est pas détectée automatiquement (nom non standard comme "Bleu canard"), le swatch affichera les 2 premières lettres du nom en fallback. Associez une image de variante pour un rendu visuel.

Settings du type Image/Swatch

SettingDescriptionOptions
TailleDimension des swatchesSmall (24px) / Medium (32px) / Large (40px)
Forme circulaireSwatches en cercle au lieu de carreOui / Non
DirectionDisposition des swatchesHorizontal / Vertical
Items par ligneNombre de swatches par ligneAuto / 3 / 4 / 5 / 6
Style de sélectionComment marquer le swatch actifBackground (anneau coloré) / Border (bordure epaisse)
Masquer le labelNe pas afficher le nom de l'optionOui / Non

Le type Dropdown affiche les options dans un menu déroulant classique. Particulièrement utile quand l'option a de nombreuses valeurs ou que l'espace vertical est limité.

SettingDescriptionOptions
Masquer le labelNe pas afficher le nom de l'option au-dessusOui / Non
Marge inférieureEspace sous le bloc0 a 100px
💡Le Dropdown est recommande quand vous avez plus de 8 valeurs pour une option. En dessous, les boutons sont plus efficaces car toutes les options sont visibles en un coup d'oeil sans clic supplémentaire.

Source de l'option : Auto vs Custom

Chaque bloc Variant Option peut detecter automatiquement quelle option afficher, où vous pouvez specifier un nom précis.

Mode Auto

En mode Auto, les blocs Variant Option se mappent aux options du produit dans l'ordre :

  • Le 1er bloc affiche la 1ere option du produit
  • Le 2eme bloc affiche la 2eme option
  • Le 3eme bloc affiche la 3eme option

Mode Custom

En mode Custom, vous spécifiez le nom exact de l'option Shopify a afficher dans ce bloc. Le nom doit correspondre exactement a celui défini dans l'admin Shopify.

SettingDescription
Nom de l'optionLe nom exact de l'option Shopify (ex : "Couleur", "Pointure", "Matiere")
ℹ️Le mode Auto fonctionne dans la majorité des cas. Utilisez le mode Custom uniquement si vous voulez : - Afficher les options dans un ordre différent de celui de l'admin Shopify - Utiliser des noms d'option non standards (ex : "Coloris" au lieu de "Couleur") - N'afficher que certaines options et pas toutes

Configuration multi-options

Vous pouvez configurer un type de sélecteur différent par option du produit en ajoutant plusieurs blocs Variant Option.

Exemple typique : Mode (vetements)

BlocOptionType recommandeRaison
Bloc 1CouleurImage / SwatchVisuel immediat des couleurs disponibles
Bloc 2TailleButtonToutes les tailles visibles d'un coup

Exemple typique : Chaussures

BlocOptionType recommandeRaison
Bloc 1CouleurImage / SwatchVisuel des coloris
Bloc 2PointureButton (4 par ligne)Grille organisée de pointures

Exemple typique : Électronique

BlocOptionType recommandeRaison
Bloc 1CouleurImage / SwatchVisuel des finitions
Bloc 2StockageButtonPeu d'options, toutes visibles
Bloc 3GarantieDropdownOptions textuelles longues

Gestion des variantes epuisees

Scale Theme gère intelligemment les variantes epuisees selon le type de sélecteur :

TypeVariante épuiséeComportement
ButtonBouton barre en diagonale, texte grise, non cliquableVisible mais désactivé
Image / SwatchSwatch avec opacité réduite et barreVisible mais désactivé
DropdownOption grisee avec mention "- Épuisé"Visible mais non selectionnable
💡Affichez toujours les variantes epuisees plutôt que de les cacher. Le client doit voir l'ensemble des options disponibles pour comprendre le produit. Une variante masquée peut créer de la confusion.

Mise à jour dynamique

Quand le client sélectionné une valeur, le système met à jour automatiquement et instantanément :

Élément mis à jourDescription
PrixLe prix change selon la variante sélectionnée
ImageLa galerie navigue vers l'image de la variante
StockL'indicateur de stock se met à jour
DisponibiliteLe bouton ATC devient "Épuisé" si nécessaire
Sticky ATCLa barre sticky se synchronise
URLL'URL est mise à jour avec le paramètre ?variant=
Autres optionsLes options incompatibles sont grisees (connected options)
ℹ️La mise à jour est instantanée (pas de rechargement de page). Le système utilise un objet JSON de variantes embarque dans la page pour calculer les changements côté client.

Bonnes pratiques

  1. Couleurs = Swatches : Utilisez toujours le type Image/Swatch pour les options de couleur. Les pastilles visuelles sont beaucoup plus efficaces que des noms textuels
  1. Tailles = Boutons : Les boutons sont preferes aux dropdowns pour les options avec moins de 8-10 valeurs. Toutes les options sont visibles d'un coup
  1. Beaucoup d'options = Dropdown : Au-dela de 10 valeurs (ex : pointures europeennes 36-47), utilisez le dropdown ou les boutons en grille (4 par ligne)
  1. Maximum 2 types : Évitez de mélanger plus de 2 types de sélecteur différents sur un même produit. Par exemple, Swatch + Button est un bon combo. Swatch + Button + Dropdown est trop heterogene
  1. Label visible : Gardez le label de l'option visible (ne masquez pas le label) pour que le client sache ce qu'il sélectionné, sauf si le contexte est evident
  1. Mobile : Les swatches et boutons s'adaptent automatiquement en wrap sur mobile. Vérifiez que les labels ne sont pas tronques et que les swatches restent assez grands pour être facilement cliquables au doigt
⚠️Si votre produit a 3 options et que vous n'ajoutez que 2 blocs Variant Option, la 3eme option sera invisible et le client ne pourra pas la sélectionner. Ajoutez autant de blocs que d'options.

Prochaines étapes