Couleurs, police et thème
Couleur de marque, accent, surfaces personnalisées, rayon des coins, police, thèmes clair et sombre, modèles et CSS personnalisé : comment le widget garde chaque texte lisible.
Le widget reprend la couleur de votre marque, votre police et, si vous le souhaitez, tout un ensemble de couleurs personnalisées. Il recalcule les couleurs pour que chaque texte reste lisible sur chaque surface. Vous choisissez votre couleur, le widget s’occupe du contraste.
Vous trouverez tous les réglages de cette page sous /app/projects/{id}, dans l’onglet Apparence, section Marque. Seule exception : le jeu de couleurs (clair, sombre, automatique) se trouve dans l’onglet Installation, sous Données de base.
L’assistant de design
En haut de la section Marque, un assistant vous guide en quatre étapes :
- Style – 18 modèles prêts à l’emploi, filtrables par Clair, Sombre, Professionnel, Ludique, Chaleureux, Froid et Minimal. Ils comprennent notamment Klar, Nacht, Boutique, Support-Desk, Minimal, Corporate, Ozean, Graphit et Espresso.
- Couleurs – couleur principale et accent, choix rapide parmi huit paires de couleurs et choix des surfaces : par défaut, claires, sombres ou personnalisées.
- Forme – style de la fenêtre, rayon des coins, forme et taille du bouton du chat.
- Terminé – un récapitulatif.
L’assistant n’enregistre rien lui-même. Il remplit seulement les champs situés en dessous ; rien n’est enregistré tant que vous n’appuyez pas sur Enregistrer. La miniature de l’assistant est une esquisse. Le véritable widget, avec vos valeurs, apparaît dans l’aperçu de la section Écran d’accueil du widget.
Pour affiner les réglages, développez Tous les réglages un par un. La police et le CSS personnalisé ne sont disponibles qu’à cet endroit.
Les champs
- Couleur principale – la couleur de votre marque au format
#rrggbb. Elle colore le bouton du chat, le bouton d’envoi, les liens, le focus et, par mélange, les bulles de vos visiteurs. Sans valeur personnalisée : violet#6D28D9en thème clair,#9B7BFFen thème sombre. - Accent – une seconde couleur au format
#rrggbb, par exemple pour les compteurs et les mises en évidence. Sans valeur personnalisée :#BE185Den clair,#FF6B8Aen sombre. - Rayon des coins (px) – de 0 à 28. Avec 0, les coins sont carrés. Valeur par défaut : 12.
- Famille de police (CSS) – une valeur CSS telle que
Inter, system-ui, sans-serif, de 120 caractères maximum. Le widget ne charge aucun fichier de police. Utilisez donc une police déjà chargée par votre page, ou une police système. Un champ vide signifie : les polices système de l’appareil. - Modèles – un clic remplit à la fois les couleurs, les surfaces, le rayon, le bouton du chat et le style. Rien n’est enregistré tant que vous n’appuyez pas sur Enregistrer.
Seules les couleurs au format #rrggbb à six chiffres sont valides. Les formes courtes comme #f00 ou rgb(…) sont ignorées et remplacées par la valeur par défaut.
Surfaces et texte
Sous Surfaces et texte, vous pouvez définir cinq autres couleurs si nécessaire. Chacune dispose d’une case couleur personnalisée :
- Arrière-plan – la surface de la fenêtre.
- Surface des bulles – les bulles de votre équipe et de l’assistant.
- Texte – la couleur du texte.
- Texte secondaire – heures, notes, secondes lignes.
- Séparateurs – lignes de séparation et bordures.
Sans cocher la case, le widget utilise l’ensemble de couleurs adapté au site, clair ou sombre. La valeur du champ est alors un point de départ, pas une mesure des couleurs utilisées. En cochant la case, vous appliquez votre couleur.
Si vous définissez seulement un arrière-plan personnalisé, le widget en déduit le reste : surface des bulles, texte, texte secondaire et séparateurs.
Lisibilité : ce que le widget recalcule
Les clients choisissent la couleur de leur marque, pas une couleur lisible. Le widget vérifie donc chaque combinaison de texte et de surface pour garantir un rapport de contraste d’au moins 4,5:1. C’est le seuil des WCAG 2.x pour le texte normal.
- Le texte sur la couleur de votre marque (par exemple dans le bouton d’envoi) est automatiquement blanc ou presque noir, selon la meilleure lisibilité.
- La couleur de votre marque utilisée pour le texte (liens, mises en évidence) est éclaircie ou assombrie par petites étapes jusqu’à atteindre 4,5:1. Les surfaces, c’est-à-dire le bouton du chat et le bouton d’envoi, gardent votre couleur inchangée.
- La bulle de vos visiteurs mélange la couleur de la marque et l’arrière-plan. Si le contraste est insuffisant, le widget réduit la proportion de la couleur de marque.
- Vos couleurs personnalisées de texte et de texte secondaire subissent le même contrôle, sur chaque surface où elles apparaissent.
Les éléments recalculés sont indiqués dans votre compte, juste sous le formulaire, à la ligne Recalculé pour que le texte reste lisible. Un jaune clair utilisé comme couleur de texte apparaît donc plus foncé dans le widget que la valeur saisie ; cette ligne vous en indique la raison.
Sur votre page, vous pouvez aussi consulter vous-même les valeurs mesurées :
ReactiveChat('brandCheck'); // list of pairings with measured and required contrast
ReactiveChat('brandTokens'); // the colours actually used in the widget
Clair, sombre ou comme le site
Sous Installation → Données de base → Jeu de couleurs du widget, choisissez :
- suivre le site (sinon le système du visiteur) – valeur par défaut. Le widget détermine si votre page est claire ou sombre et s’adapte.
- clair – toujours clair.
- sombre – toujours sombre.
En mode automatique, le widget examine les éléments suivants, dans cet ordre :
- la couleur d’arrière-plan de votre page au centre de l’écran,
- la valeur CSS
color-schemede<html>, si elle vaut exactementdarkoulight, - les indicateurs courants sur
<html>ou<body>, comme la classedarkoudata-theme="dark", - enfin, le réglage système du visiteur.
Si votre page passe du clair au sombre ou inversement, le widget suit ce changement. Il vérifie aussi de nouveau le thème à l’ouverture de la fenêtre.
Dans le code, vous définissez le thème dans le code d’intégration ou pendant l’exécution. Ce réglage prime sur celui du compte :
<script src="https://cdn.reactive.chat/loader.js"
data-rc-site-key="SITE_KEY"
data-rc-theme="dark"
async></script>
ReactiveChat('setTheme', 'dark'); // 'light', 'dark' or 'auto'
Avec setTheme, le widget mémorise le choix dans le navigateur du visiteur. setTheme('auto') le supprime. Cela convient à un sélecteur clair/sombre que vous proposez sur votre page.
Définir les couleurs dans le code
Pour certaines pages, par exemple une campagne, vous pouvez définir l’identité visuelle dans le code d’intégration ou pendant l’exécution. Les noms des champs sont :
primary,accent– couleur de marque et accent,bg,surface,text,textDim,line– les cinq couleurs de surfaces et de texte,onPrimary– couleur du texte sur la couleur de marque (automatique sinon),radius– de 0 à 28,font– valeur CSS de la police,launcheretstil– voir Le bouton du chat et La fenêtre de chat.
ReactiveChat('setBrand', { primary: '#0F766E', accent: '#F59E0B', radius: 8 });
setBrand recalcule immédiatement le contraste et les couleurs dérivées, sans reconstruire le widget. null supprime une valeur et rétablit la valeur par défaut.
Dans le code d’intégration, l’attribut s’appelle data-rc-brand et accepte du JSON :
<script src="https://cdn.reactive.chat/loader.js"
data-rc-site-key="SITE_KEY"
data-rc-brand='{"primary":"#0F766E","accent":"#F59E0B"}'
async></script>
Important – qui l’emporte, le code d’intégration ou le compte ? Le code généré par votre compte contient déjà la couleur de votre marque, le rayon, ainsi que la forme et la taille du bouton du chat. Il s’agit seulement de l’état initial, pour que le bouton apparaisse immédiatement dans la bonne couleur. Dès que le widget reçoit les réglages du serveur, ceux du compte s’appliquent intégralement.
Si vous ajoutez toutefois un champ supplémentaire, quel qu’il soit, à data-rc-brand, par exemple accent, stil ou un libellé, l’identité visuelle du code d’intégration devient propre à cette page. Elle prime alors sur votre compte. Seul le mode d’affichage « Uniquement via vos propres liens » défini dans votre compte reste applicable à cette page. De plus, cette page ne participe à aucun test A/B.
Si vous changez la couleur de marque dans votre compte, recopiez ensuite le code d’intégration sous Installation. Sinon, l’ancienne couleur apparaît brièvement au chargement de la page.
Le fonctionnement du code d’intégration et les autres possibilités (window.ReactiveChatSettings, ReactiveChat('boot', …)) sont décrits dans Intégration technique.
CSS personnalisé
Sous Tous les réglages un par un → CSS personnalisé, saisissez le CSS à appliquer en dernier, après toutes les autres règles.
- 20 000 caractères maximum.
@importest supprimé à l’enregistrement et dans le widget.- Le CSS agit uniquement à l’intérieur du widget. Il s’exécute dans une zone isolée (shadow DOM) et ne peut pas modifier votre page. Inversement, le CSS de votre page n’atteint pas le widget. C’est donc ici qu’il faut le définir.
- Le widget réimpose ensuite deux règles : l’indicateur de focus visible pour la navigation au clavier et le bouton de fermeture dans l’en-tête. Masquer la sortie du chat par le style piège les utilisateurs du clavier.
- Les noms de classes internes du widget ne constituent pas une interface garantie. Vérifiez votre CSS dans l’aperçu après toute modification.
.rc-launcher { box-shadow: 0 0 0 4px #fff; }
Dans le code, vous pouvez faire de même avec customCss, par exemple dans ReactiveChat('boot', { customCss: '…' }) ou avec l’attribut data-rc-custom-css.
Logo dans l’en-tête de la fenêtre
Le plus simple est de renseigner le logo dans votre compte : Projet → Apparence → Marque, champ Logo (adresse). Il apparaît alors dans l’en-tête de la fenêtre de chat, au plus tard une minute après l’enregistrement.
Dans le code, logo permet aussi de définir la hauteur, le texte alternatif et la position, par exemple dans le bouton du chat. Un logo défini dans le code prime sur le champ du compte :
<script src="https://cdn.reactive.chat/loader.js"
data-rc-site-key="SITE_KEY"
data-rc-logo='{"src":"https://www.example.com/logo.svg","alt":"Example Ltd","height":24,"placement":"header"}'
async></script>
src– une adresse avechttps://ou une image au formatdata:image/…. Un petit SVG sous forme d’adressedata:évite une requête.alt– texte alternatif.height– hauteur en pixels, de 12 à 40, 20 par défaut.placement–header(en-tête, par défaut),launcher(dans le bouton du chat) ouboth.
Le logo de l’écran d’accueil se définit facilement dans votre compte ; voir L’écran d’accueil du chat.
Si l’affichage ne correspond pas à vos attentes
- La couleur est plus sombre ou plus claire que la valeur saisie : c’est la protection du contraste. La ligne Recalculé sous le formulaire indique les éléments ajustés.
- Les modifications du compte ne sont pas appliquées : votre code contient-il un
data-rc-brandavec des champs supplémentaires ? Dans ce cas, le code d’intégration l’emporte. Prévoyez aussi jusqu’à une minute après l’enregistrement. - Une autre couleur apparaît brièvement au chargement : recopiez le code d’intégration après un changement de couleur.
- La police n’a aucun effet : votre page charge-t-elle cette police ? Le widget ne charge aucun fichier de police.
Última actualización: