Comment connecter une Scrollbar à un widget Text dans Tkinter ?

La connexion est bidirectionnelle. Le widget Text reçoit yscrollcommand=scrollbar.set pour informer la barre de sa position. La Scrollbar reçoit command=zone_texte.yview pour transmettre les déplacements. Les deux paramètres sont obligatoires pour que le défilement fonctionne dans les deux sens.

Pourquoi ma Scrollbar Tkinter apparaît mais ne défile pas ?

Il manque probablement un des deux sens de connexion. Vérifiez que le widget défilable a bien yscrollcommand=scrollbar.set ET que la scrollbar a bien command=widget.yview. Si un seul côté est configuré, la barre s'affiche mais reste inactive.

Comment créer une Scrollbar horizontale dans Tkinter ?

On utilise orient='horizontal' et on connecte avec xscrollcommand et xview au lieu de yscrollcommand et yview. Pour un widget Text, il faut aussi définir wrap='none' pour désactiver le retour à la ligne automatique, sinon la scrollbar horizontale n'a rien à afficher.

Pourquoi faut-il packer la Scrollbar avant le widget principal ?

Avec pack(), les widgets sont placés dans l'ordre de leur appel à pack(). Si on packe le widget principal d'abord, il occupe tout l'espace disponible et la scrollbar se retrouve en dessous. En packant la scrollbar en premier avec side='right', elle réserve sa place sur le côté avant que le widget principal ne s'étale.

La Scrollbar fonctionne-t-elle avec Listbox et Canvas dans Tkinter ?

Oui. Le principe est identique pour Listbox, Canvas et Treeview. On passe yscrollcommand=scrollbar.set au widget et command=widget.yview à la scrollbar. Seuls les noms des méthodes de défilement changent selon le widget (yview, xview).

Peut-on utiliser grid() au lieu de pack() pour placer une Scrollbar Tkinter ?

Oui. Avec grid(), on place le widget principal en colonne 0 avec sticky='nsew' et la scrollbar en colonne 1 avec sticky='ns'. Il faut aussi configurer le poids des colonnes pour que le widget s'étire correctement. grid() est souvent plus précis que pack() pour ce type de mise en page.

Le widget Scrollbar Tkinter — barre de défilement en Python

OUJOOD.COM

Le widget Scrollbar n'est pas autonome : il ne fait que transmettre des commandes de défilement à un autre widget. Sans cette connexion bidirectionnelle, la barre apparaît mais ne fait rien. C'est le point que la plupart des débutants ratent la première fois.

Principe de connexion

La liaison entre une Scrollbar et un widget défilable (Text, Listbox, Canvas) repose sur deux paramètres :

Le widget défilable reçoit yscrollcommand=scrollbar.set — il informe la scrollbar de sa position actuelle. La scrollbar reçoit command=widget.yview — elle transmet les clics et glissements au widget. Les deux sens sont nécessaires.

Scrollbar verticale avec Text

Le cas le plus courant — déjà évoqué dans la page sur le widget Text, développé ici plus en détail :

📋 Copier le code

import tkinter as tk

fenetre = tk.Tk()
fenetre.title("Scrollbar + Text")
fenetre.geometry("440x260")

frame = tk.Frame(fenetre)
frame.pack(fill="both", expand=True, padx=10, pady=10)

# Scrollbar créée en premier — elle sera passée à Text
scrollbar = tk.Scrollbar(frame, orient="vertical")
scrollbar.pack(side="right", fill="y")

zone_texte = tk.Text(
    frame,
    width=50,
    height=10,
    yscrollcommand=scrollbar.set  # Text informe la scrollbar
)
zone_texte.pack(side="left", fill="both", expand=True)

scrollbar.config(command=zone_texte.yview)  # Scrollbar commande le Text

for i in range(1, 40):
    zone_texte.insert(tk.END, f"Ligne {i} — texte de démonstration\n")

fenetre.mainloop()

L'ordre de création importe peu, mais l'ordre de pack() oui : la scrollbar doit être packée avant le widget principal avec side="right", sinon elle se retrouve en dessous. C'est un comportement de pack() à connaître.

Scrollbar verticale avec Listbox

Le raccordement avec Listbox suit exactement le même schéma :

📋 Copier le code

import tkinter as tk

fenetre = tk.Tk()
fenetre.title("Scrollbar + Listbox")
fenetre.geometry("300x220")

frame = tk.Frame(fenetre)
frame.pack(padx=10, pady=10)

scrollbar = tk.Scrollbar(frame, orient="vertical")
scrollbar.pack(side="right", fill="y")

liste = tk.Listbox(frame, height=8, yscrollcommand=scrollbar.set)
liste.pack(side="left")

scrollbar.config(command=liste.yview)

villes = ["Paris", "Lyon", "Marseille", "Toulouse", "Nice",
          "Nantes", "Strasbourg", "Bordeaux", "Lille", "Rennes",
          "Reims", "Saint-Étienne", "Toulon", "Grenoble", "Dijon"]

for ville in villes:
    liste.insert(tk.END, ville)

fenetre.mainloop()

Scrollbar horizontale

Pour un défilement horizontal, on change orient et on utilise xscrollcommand / xview à la place :

📋 Copier le code

import tkinter as tk

fenetre = tk.Tk()
fenetre.title("Scrollbar horizontale")
fenetre.geometry("300x180")

frame = tk.Frame(fenetre)
frame.pack(padx=10, pady=10, fill="both", expand=True)

# Zone Text sans retour à la ligne automatique
zone = tk.Text(frame, wrap="none", height=6)
zone.pack(fill="both", expand=True)

scrollbar_h = tk.Scrollbar(frame, orient="horizontal", command=zone.xview)
scrollbar_h.pack(fill="x")

zone.config(xscrollcommand=scrollbar_h.set)

# Insérer des lignes très longues pour tester
for i in range(1, 8):
    zone.insert(tk.END, f"Ligne {i} — " + "contenu très long qui dépasse la largeur visible " * 3 + "\n")

fenetre.mainloop()

Le paramètre wrap="none" est indispensable ici : sans lui, le widget Text revient automatiquement à la ligne et la scrollbar horizontale n'a rien à montrer. Pour les Canvas et le widget Treeview, le raccordement fonctionne de la même façon.

Par carabde | Mis à jour le 30 avril 2025

← Le widget Text Tkinter

Sommaire

Le widget Spinbox Tkinter →