Mise en forme
en coursAttribuez à chaque colonne la présentation et la largeur qu'elle mérite, automatiquement à chaque exécution de la requête.
Les directives de formatage décrivent l'apparence d'une colonne - nombres, dates, booléens, texte et plus encore - et s'appliquent à chaque exécution de la requête. Faites un clic droit sur un en-tête de colonne et choisissez Format › Définir une exception de mise en forme… pour que SQLly écrive le commentaire pour vous, ou tapez-en un à la main si vous préférez.
Syntaxe
-- sqlly format: column=<name>; <rule>[; <option>...][; width=<n>dp]
-- sqlly format: column=<name>; width=<n>dp
-- sqlly format:: un espace après -- et un deux-points immédiatement après format. --sqlly format: ne seront pas appliqués, et l'éditeur vous en informera.Le premier segment est toujours column=<name>. Le second est la règle de format, un width=, ou les deux :
| Règle | Effet | Exemple |
|---|---|---|
number=N | Nombre à virgule fixe avec N décimales (respecte thousands=, style=). Les caractères décimaux et de milliers, le format négatif et l'alignement proviennent toujours des Paramètres, et la colonne n'est jamais abrégée. | number=2 |
date=P | Afficher une date, un datetime ou une valeur textuelle de type date avec le motif strftime P, dans le fuseau horaire d'affichage de la colonne. Les valeurs qui ne sont pas interprétables comme des dates, et les motifs avec des jetons inconnus, laissent la cellule telle quelle. | date=%Y-%m-%d |
boolean=T/F | Texte pour les valeurs vrai / faux. | boolean=Yes/No |
binary= | Afficher les valeurs binaires comme hex ou base64. | binary=hex |
text= | Casse : upper, lower, title, none. | text=upper |
mask=P/S | Masquer le milieu, en gardant P caractères au début et S à la fin. S'applique aussi aux copies et aux exports tant que Appliquer le formatage du masque aux copies et exportations est activé. | mask=0/4 |
epoch= | Entier Epoch vers date : auto, s, ou ms. | epoch=s |
json=P | Extraire un chemin JSON de la cellule. | json=$.customer.name |
template=T | Cellule générée par un modèle, avec des helpers de pipe. | template={value|upper} |
Options en fin de directive : thousands=true|false et style=fixed|percent|bytes affiner une number= règle. zone= définit le fuseau horaire d'affichage pour une date= ou epoch= règle (ou pour l'affichage de date ordinaire de la colonne lorsqu'il s'agit du seul paramètre) : UTC, local, stored (tel qu'envoyé par la base de données ; UTC pour les epochs), ou un nom de fuseau horaire tel que Europe/Berlin. Il l'emporte sur le réglage de la colonne, celui de la connexion et le réglage global. Un nom de zone que SQLly ne reconnaît pas fait ignorer la ligne entière.
-- sqlly format: column=created_at; epoch=s; zone=America/New_York
Largeur de colonne
width= définit la largeur de la colonne. Cela peut être le seul paramètre sur la ligne, ou se trouver à côté d'une règle :
-- sqlly format: column=Notes; width=60dp
-- sqlly format: column=Total; number=2; width=40dp
L'unité est dp, et elle suit la police de la grille : 1 dp correspond à un quart de la taille de la police de la grille de résultats. Avec une police de grille de 10 pt, 20dp fait 50 pixels ; avec 12 pt, le même
20dp fait 60 pixels. Alors quand vous changez la taille de la police ou le zoom, la colonne grandit ou rétrécit avec le texte et affiche toujours environ les mêmes caractères - environ 2,5 dp par caractère. C'est une approximation, pas un compte exact, car les lettres d'une police proportionnelle n'ont pas toutes la même largeur. Le suffixe dp est facultatif :
width=40 signifie width=40dp.
Une largeur donnée dans une directive l'emporte sur une largeur que vous avez glissée et que SQLly a mémorisée, ainsi que sur la taille automatique: la taille auto laisse cette colonne tranquille. Si vous faites glisser la colonne à une nouvelle largeur, la directive la rétablit à l'exécution suivante; pour garder la nouvelle largeur, cliquez sur le verrouiller
et SQLly réécrit le width= pour vous.
Plusieurs lignes pour une colonne
Vous pouvez écrire plus d'une ligne format: ligne pour la même colonne, et elles fusionnent. Une règle ultérieure remplace une règle antérieure, et une largeur ultérieure remplace une largeur antérieure, donc ces deux lignes donnent Total deux décimales et une largeur de 40 dp :
-- sqlly format: column=Total; number=2
-- sqlly format: column=Total; width=40dp
Exemples
-- sqlly format: column=Total; number=2
-- sqlly format: column=Qty; number=0; thousands=false
-- sqlly format: column=Created; date=%Y-%m-%d
-- sqlly format: column=IsActive; boolean=Yes/No
-- sqlly format: column=rate; number=1; style=percent
-- sqlly format: column=Card; mask=0/4
-- sqlly format: column=Notes; width=80dp
SELECT * FROM orders;


Chaque règle sauf mask= ne change que ce que la grille affiche : copier et exporter utilisent les valeurs propres à la base de données. Voir le masquage.
Mise en forme conditionnelle
format: détermine comment chaque valeur d'une colonne est écrite. Pour colorer les cellules selon
leurs valeurs - texte rouge pour Failed, un remplissage pour les soldes négatifs, une échelle de couleurs ou une barre de données, utilisez le conditional: directive, une règle par ligne à côté de vos format: lignes. Le guide complet, y compris la boîte de dialogue Mise en forme conditionnelle, est Résultats › Mise en forme conditionnelle.
-- sqlly format: column=Balance; number=2; width=36dp
-- sqlly conditional: column=Balance; when=< 0; fill=#FDE7E9
SELECT Account, Balance FROM ledger;