<?xml version="1.0" encoding="UTF-8"?><rss xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:content="http://purl.org/rss/1.0/modules/content/" xmlns:atom="http://www.w3.org/2005/Atom" version="2.0" xmlns:cc="http://cyber.law.harvard.edu/rss/creativeCommonsRssModule.html">
    <channel>
        <title><![CDATA[Stories by Sébastien Perrot on Medium]]></title>
        <description><![CDATA[Stories by Sébastien Perrot on Medium]]></description>
        <link>https://medium.com/@sbastienperrot?source=rss-ee78da138ec3------2</link>
        <image>
            <url>https://cdn-images-1.medium.com/fit/c/150/150/0*FGiKLJlE4DiJpSAu.</url>
            <title>Stories by Sébastien Perrot on Medium</title>
            <link>https://medium.com/@sbastienperrot?source=rss-ee78da138ec3------2</link>
        </image>
        <generator>Medium</generator>
        <lastBuildDate>Fri, 20 Nov 2026 11:47:26 GMT</lastBuildDate>
        <atom:link href="https://medium.com/@sbastienperrot/feed" rel="self" type="application/rss+xml"/>
        <webMaster><![CDATA[yourfriends@medium.com]]></webMaster>
        <atom:link href="http://medium.superfeedr.com/" rel="hub"/>
        <item>
            <title><![CDATA[Comment mettre en place une scrollbar universelle en pur Javascript ?]]></title>
            <link>https://medium.com/@sbastienperrot/comment-mettre-en-place-une-scrollbar-universelle-en-pur-javascript-8af0f522cad6?source=rss-ee78da138ec3------2</link>
            <guid isPermaLink="false">https://medium.com/p/8af0f522cad6</guid>
            <category><![CDATA[javascript]]></category>
            <category><![CDATA[js]]></category>
            <category><![CDATA[scrollbar]]></category>
            <category><![CDATA[infinite-scroll]]></category>
            <category><![CDATA[html]]></category>
            <dc:creator><![CDATA[Sébastien Perrot]]></dc:creator>
            <pubDate>Fri, 18 Jan 2019 08:03:13 GMT</pubDate>
            <atom:updated>2019-11-21T07:44:30.602Z</atom:updated>
            <content:encoded><![CDATA[<figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*2OD8jnuI2c4UvB7yb47T5Q.png" /></figure><h3>Comment mettre en place une scrollbar universelle en pur Javascript ?</h3><p>Chez <a href="https://www.foreseeds.com/">Foreseeds</a>, nous développons sur MacOs, comme une grande partie des développeurs. Et lorsqu’on développe une webapp, on a tendance à oublier (volontairement ?) de tester l’application sur un environnement Windows... Or, Windows, ce n’est pas macOS. Surtout quand il s’agit de scrollbars !</p><p>Les deux OS ont des approches différentes: Windows affiche perpétuellement des barres de défilement dès lors que cela est nécessaire, tandis que par défaut sur macOS, les scrollbars apparaissent seulement lorsque l’utilisateur (ou le site) scroll volontairement dans la page. Ces deux paradigmes peuvent clairement jouer sur l’UI et l’UX de l’application ou du site concerné et perturber l’oeil de l’utilisateur. Chez foreseeds, nous avons été confrontés à ce problème, d’autant plus que l’application cible principalement des employés de grandes sociétés, qui, c’est bien connu, utilisent (quasiment) tous un PC tournant sur Windows…</p><h3>Une scrollbar cross-plateform s’il vous plaît !</h3><p>L’idée était donc pouvoir styliser les scrollbars de manière identique à travers toute l’application et sur tous les OS que nous avons ciblés (macOS et Windows). Après avoir testé quelques modules tout prêts, nous nous sommes décidés à développer notre propre module nous permettant ainsi d’avoir la main sur son paramétrage (notamment son style et certains comportements liés à notre logique applicative).</p><p>Commençons par notre fichier html contenant le bloc div qui doit scroller</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/850d147cbd52950d140b8075073ee9e4/href">https://medium.com/media/850d147cbd52950d140b8075073ee9e4/href</a></iframe><p>Et son fichier css associé:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/0dfa912c4892206e5f879ef1d467a1db/href">https://medium.com/media/0dfa912c4892206e5f879ef1d467a1db/href</a></iframe><p>La div native_scroll_container est stylisée de manière à ne pas dépasser 200px de hauteur, ce qui permet d’afficher une scrollbar (verticale) native laissant à l’utilisateur la possibilité de faire défiler son contenu.</p><p>Il est possible de styliser une scrollbar en utilisant des propriétés CSS issues du préfixeur webkit ou encore celles proposées par les navigateurs de Microsoft. Le problème étant qu’avec ces solutions, nous pourrons cibler uniquement les navigateurs Chrome, Safari, IE et Edge. Firefox ne propose pas de préfixe permettant de manipuler le style d’une scrollbar.</p><p>Pour correctement implémenter notre solution (qui je vous le rappelle doit être <em>universelle</em>) nous devons donc prendre ce fait en compte et par conséquent, créer une scrollbar artificielle qui émulera le comportement d’une scrollbar native. Celle-ci se comportera alors de la même manière sur tous les OS utilisés.</p><h3><strong>1. Cacher la scrollbar native</strong></h3><p>Pour commencer, il faut donc que nous cachions la scrollbar native afin de permettre à notre future scrollbar artificielle de prendre sa place. Pour ce faire, nous allons modifier notre fichier CSS et y ajouter les propriétés supportées par les navigateurs de Google, Apple et de Microsoft:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/b51a9adae0ced28cae15b4ba36206de0/href">https://medium.com/media/b51a9adae0ced28cae15b4ba36206de0/href</a></iframe><p>Nous passons donc de cet affichage</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*NjhYQ-Y7z3TSZrTOZ-i55Q.png" /><figcaption>`native_scroll_container` sans propriété CSS permettant de cacher la scrollbar native</figcaption></figure><p>à celui-ci:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*GDglbkNQPVrHVNmODGqHGg.png" /><figcaption>scrollbar native cachée par les propriétés CSS webkit et ms</figcaption></figure><h3>2. Ajouter la scrollbar artificielle</h3><p>Nous allons à présent ajouter un peu de JS afin de pouvoir injecter notre scrollbar artificielle là où il le faut.</p><p>Schématiquement, voilà à quoi ressemblera notre composant scrollable</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*fUVnO-gIirVHBQDHmKs7xQ.png" /></figure><p>Il se décompose en 4 parties:</p><ol><li><strong>Scrollable container: </strong>c’est le container “root” de notre composant, celui dans lequel se trouvent les autres sections qui suivent</li><li><strong>Scrollable: </strong>c’est la zone scrollable, celle dans laquelle le container native_scroll_container se situera</li><li><strong>Scrollbar: </strong>c’est le container de notre scrollbar artificielle, qui vient se placer sur la droite du Scrollable Container et qui prend toute la hauteur disponible</li><li><strong>Scrollbar fill: </strong>c’est l’<em>ascenseur</em> de la scrollbar, celui qui permet de situer l’utilisateur dans sa progression de défilement</li></ol><h3>Créer et injecter le module scrollable</h3><p>Dans le code qui suit, l’idée est d’ajouter au DOM de notre page, ces différentes parties et de venir y placer la div native_scroll_container.</p><p>Commençons donc par créer un dossier /js dans lequel nous créerons un autre dossier /scrollbar. C’est ici que se trouvera le code de notre scrollbar artificielle.</p><p>Ce dossier doit comporter les fichiers suivants:</p><ol><li>index.js : fichier contenant le code javascript de la scrollbar</li><li>style.css : fichier contenant le code CSS de la scrollbar</li></ol><p>N’oubliez pas d’importer ces fichiers dans votre index.html</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/4aea41889d10573418e38cbee31674b9/href">https://medium.com/media/4aea41889d10573418e38cbee31674b9/href</a></iframe><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/3a3a3609d450c16bc61a212005a4425f/href">https://medium.com/media/3a3a3609d450c16bc61a212005a4425f/href</a></iframe><p>La première étape va consister à injecter un nouvel élément à notre DOM et de venir remplacer le container scrollable (native_scroll_container)actuel.</p><p>Le script se lance en commençant par rechercher tous les éléments de la page ayant pour class scrollable. Ce sont ceux sur lesquels seront appliquer la scrollbar artificielle. Il faut donc modifier notre fichier HTML afin d’ajouter cette classe à la div native_scroll_container :</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/674fdec4a105eaaf280ac8cf000316ed/href">https://medium.com/media/674fdec4a105eaaf280ac8cf000316ed/href</a></iframe><p>Dans la fonction buildScrollableElement() se trouvant dans le fichier /js/scrollable/index.js, la section suivante permet de créer les 4 différentes parties évoquées plus haut:</p><pre>let containerDOM = document.createElement(“div”); containerDOM.className = ‘Scrollable’; </pre><pre>const markup = `<br>    &lt;div class=”Scrollable__scrollbar”&gt;&lt;/div&gt; <br>    &lt;div class=”Scrollable__scrollbar-fill”&gt;&lt;/div&gt;<br>`; </pre><pre>containerDOM.style.width = elt.offsetWidth + ‘px’; containerDOM.style.height = elt.style.height; </pre><pre>containerDOM.innerHTML = markup; </pre><pre>let scrollableContainerContent = document.createElement(“div”); scrollableContainerContent.className = ‘Scrollable__scrollable’;</pre><p>En plus de créer ces 4 sections de notre module scrollable, les deux lignes</p><pre>containerDOM.style.width = elt.offsetWidth + ‘px’; containerDOM.style.height = elt.style.height;</pre><p>permettent d’assigner la hauteur et la largeur du container historique, permettant ainsi de garder la cohérence visuelle de ce qui a été stylisé auparavant.</p><p>La section suivante permet quant à elle, de recréer l’élément DOM de base, à savoir, la div native_scroll_container.</p><pre>let scrollableContainerContentElement = document.createElement(elt.localName); </pre><pre>scrollableContainerContentElement.className = elt.className; scrollableContainerContentElement.id = elt.id; </pre><pre>scrollableContainerContentElement.innerHTML = elt.innerHTML;</pre><p>La première ligne permet de créer un nouvel élément DOM identique au type de elt, une div dans notre cas. Les lignes qui suivent, permettent de lui assigner class, id et innerHTML afin de recréer le bloc historique.</p><p>En rafraîchissant votre navigateur (autre que Firefox), vous aurez ce résultat:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*9q2gNZ6m_gwt--fx_tH4CA.png" /></figure><p>Notre scrollbar artificielle vient d’apparaître sur la droite du texte à faire défiler.</p><p>Le problème, c’est que ce texte est toujours scrollable, mais l’<em>ascenseur</em> (Scrollable__Fill) n’apparaît pas. Il va donc falloir le simuler: en taille et en position.</p><h3>Initialiser l’ascenseur ou le Scrollable__Fill</h3><p>Retournons sur le ficher js/scrollable/index.js, pour initialiser l’<em>ascenseur</em>.</p><p>Notre scrollbar étant déjà initialisée (positionnée en haut à gauche de l’espace scrollbar via ses propriétés position: absolute; top: 0; left: 0), nous allons gérer sa position, nous allons utiliser la propriété CSS transform: translate3D(x,y,z), où les axes x et z sont des constantes (valeur fixée à 0) et y en variable, afin de déplacer la scrollbar uniquement sur l’axe verticale.</p><p>Il est également possible d’utiliser la propriété transform: translateY(y), mais pour des questions d’optimisations, il est préférable d’utiliser translate3D(x,y,z) car cette propriété fait appel à des fonctions d’accélération matérielle (non présentes sur les propriétés de transformation 2D).</p><p>Pour ce qui est de sa taille (<em>hauteur</em>), il faut prendre en compte le ratio entre la <strong>boxSize</strong> et la <strong>scrollSize</strong>:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*PNJ25vMOtbIIwfkVzmRJ6Q.png" /></figure><p>Notre fichier devient donc :</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/7850ef950c2df373ddf20cf33ddf23f6/href">https://medium.com/media/7850ef950c2df373ddf20cf33ddf23f6/href</a></iframe><p>Pour que la taille soit correctement récupérée, il faut modifier également le fichier CSS principal en retirant la propriété overflow-y: scroll. Si nous la laissons, la <strong>boxSize</strong> et la <strong>scrollSize</strong> serait alors identique. Il faut volontairement laisser dépasser le contenu afin que le module puisse gérer à la fois son affichage (en appliquant l’overflow adéquat) et qu’il déduise correctement la taille de l’<em>ascenseur.</em></p><p>Voilà le résultat:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*0pM9-Vpuumi4rMEtZNshYA.png" /><figcaption>Scrollbar avec scrollbar fill correctement définit</figcaption></figure><p>Notre scrollbar à l’apparence souhaitée et l’<em>ascenseur</em> est correctement initialisé. Néanmoins, si vous tentez de scroller, le contenu défilera bien, mais l’<em>ascenseur</em> restera à sa position d’origine. Il faut donc à présent relier sa position avec celle de la scrollbar native.</p><h3>Synchroniser la scrollbar artificielle avec la native</h3><p>Javascript propose un event listener permettant de détecter un scroll sur un élément du DOM. Il suffit donc d’ajouter ce listener sur notre section scrollable (en l’occurence Scrollable , ou la classe Scrollable__scrollable) et d’y associer une fonction qui rafraîchit la position de l’<em>ascenseur</em> à chaque fois que l’évènement est lancé.</p><p>Modifiez votre fichier js/scrollable/index.js en ajoutant les dernières lignes:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/769213ed2b2b88fa2d3fac1efb1913ac/href">https://medium.com/media/769213ed2b2b88fa2d3fac1efb1913ac/href</a></iframe><p>Et voilà ! Nous avons notre scrollbar artificielle qui est à présent reliée à la scrollbar native du container.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/600/1*2nHhO5_vRj2h6oRVBoDoIg.gif" /></figure><p>Mais il reste des optimisations à faire et surtout, notre scrollbar n’est pas encore universelle puisqu’elle ne fonctionne correctement sur un navigateur Firefox.</p><h3>3. Adapter la scrollbar artificielle à Firefox</h3><p>Dans notre fichier JS, nous allons devoir apporter certaines modifications afin d’ajouter une logique particulière à notre module pour qu’il puisse fonctionner correctement sur Firefox. Rappelez-vous : FF ne propose pas de préfixeur particulier permettant de modifier/accéder aux scrollbars.</p><p>La technique va donc consister à faire disparaître cette scrollbar en la décalant vers la droite d’autant de px que sa largeur. Ceci la fera disparaître du champ de vision de l’utilisateur.</p><p><strong>Détecter Firefox</strong></p><p>La manière la plus sûre de détecter le type de navigateur qui exécute le script courant est appelée la “feature detection”. Il s’agit de vérifier si une fonctionnalité propre à un navigateur en particulier est instanciable ou non dans l’environnement courant.</p><p>Pour Firefox, il s’agit d’InstallTrigger (l’API Firefox permettant d’installer des add-ons au navigateur).</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/5961e6444df48d3ef1ca90039f20ee9e/href">https://medium.com/media/5961e6444df48d3ef1ca90039f20ee9e/href</a></iframe><p><strong>Déterminer la taille d’une scrollbar native</strong></p><p>Cette section est nécessaire pour faire fonctionner notre scrollbar pour Firefox, mais aussi pour les navigateurs s’ouvrant depuis un environnement Windows.</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/7e73c226c0dc4cd3688dfd036702935d/href">https://medium.com/media/7e73c226c0dc4cd3688dfd036702935d/href</a></iframe><p>Cette fonction ajoute virtuellement deux div au DOM courant. La première est une div n’ayant pas de scroll, tandis que la seconde en possède un. Nous fixons une largeur arbitraire de 100px pour ces deux blocs. Cette constante est certes aléatoire, mais permet tout de même de s’assurer que la scrollbar peut s’intégrer dans le bloc (en effet, une scrollbar n’ajoute pas de largeur à son container, au contraire, elle s’y loge avec ces contraintes).</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*_pFinsXO21u7NZLYTxueCQ.png" /></figure><p>Afin de mesurer la largeur de la scrollbar, il nous suffit de soustraire la largeur du container n’ayant pas de scroll ( container.clientWidth) avec celle du container qui en possède ( container2.clientWidth ).</p><p>Modifiez donc le fichier/js/scrollable/index.js par:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/b0cb593e6afae2f9c78fa48ae3ac8e62/href">https://medium.com/media/b0cb593e6afae2f9c78fa48ae3ac8e62/href</a></iframe><p>Ce qui donne le résultat suivant sur Firefox:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*OkMRn6GWH8TqmGtYfFU9nA.png" /></figure><p>On se rend compte que la scrollbar s’est correctement décalée à l’extérieur du container d’autant de px que sa largeur. Il ne reste à présent plus qu’à la camoufler définitivement.</p><p><strong>Cacher la scrollbar pour Firefox</strong></p><p>En modifiant simplement le style du container Scrollable dans le fichier /js/scrollable/style.css, il est possible de cacher la scrollbar native: overflow: hidden</p><p>Le résultat obtenu (sur tous les navigateurs):</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*EyStnni3e8ESTQ3fiwXmCg.png" /></figure><p>L’affichage est à présent universel. Tous les navigateurs, sur tous les OS afficheront notre scrollbar de cette manière ! Mais ce n’est pas encore totalement parfait… Accrochez-vous c’est la dernière section :)</p><h3>4. Ajouter les interactions avec la scrollbar</h3><p>Comme vous le savez, il est possible d’interagir avec la scrollbar. L’utilisateur peut cliquer n’importe où sur la scrollbar pour remonter ou descendre dans sa navigation ou même “drag&amp;dropper” directement l’ascenseur. Ces évènements sont natifs sur les scrollbars. Nous allons donc devoir les simuler sur notre scrollbar artificielle.</p><p><strong>a) Gérer le click sur la scrollbar</strong></p><p>Pour gérer le click de l’utilisateur sur la scrollbar, nous allons ajouter un nouvel évènement à cet élément( mousedown) et lui associer une fonction qui permettra à l’ascenseur de se placer correctement sur la scrollbar ainsi qu’à faire scroller le contenu. Ajoutez simplement les lignes suivantes à la fonction buildScrollbarElement :</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/680b44af760748fd666e2022516640d4/href">https://medium.com/media/680b44af760748fd666e2022516640d4/href</a></iframe><p><strong>b) Gérer le drag &amp; drop</strong></p><p>En suivant le même principe que pour la gestion du click sur la scrollbar, nous allons ajouter un nouvel évènement à l’ascenseur de notre scrollbar. La fonction associée calculera d’une part la position de départ de l’ascenseur puis ajoutera de nouveaux event listeners pour gérer les évènements mousemove (gérant le déplacement du curseur) et mouseup (moment où l’utilisateur relâche sa souris pour stopper le défilement). Pour cela, ajoutez les lignes suivantes à la fonction buildScrollbarElement :</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/290e1f6dbc040d9aef9cd3c944baa960/href">https://medium.com/media/290e1f6dbc040d9aef9cd3c944baa960/href</a></iframe><p>Finalement, nous pouvons donc à présent utiliser notre scrollbar artificielle exactement de la même manière qu’une scrollbar native, à la différence que celle-ci se comportera de la même manière sur tous les OS et tous les navigateurs utilisés.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/600/1*Q5Nl67t-DsibzGdIzmURuA.gif" /></figure><p>Libre à vous à présent de changer l’apparence de cette dernière en modifiant le fichier CSS lié à ce module, ou en surchargeant les classes associées.</p><p>Lien du repo gitlab: <a href="https://gitlab.com/SebPerrot/universal-scrollbar-part-1">https://gitlab.com/SebPerrot/universal-scrollbar-part-1</a></p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=8af0f522cad6" width="1" height="1" alt="">]]></content:encoded>
        </item>
    </channel>
</rss>