Mise en forme

en cours

Attribuez à 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
L'orthographe est stricte ici. Contrairement aux autres directives, la mise en forme nécessite le préfixe exact -- 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ègleEffetExemple
number=NNombre à 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=PAfficher 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/FTexte 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/SMasquer 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=PExtraire un chemin JSON de la cellule.json=$.customer.name
template=TCellule 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;
SQLly
Une directive de formatage SQLly appliquée à une colonne de résultatUne directive de formatage SQLly appliquée à une colonne de résultat
Une directive de formatage appliquée à une colonne, avec les valeurs formatées affichées dans la grille.

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;