Scrivere un tema
Come cambiare l'aspetto di BeeBEEP modificando il suo file del tema, e che cosa controlla ogni token di quel file.
Per: sviluppatori · Da BeeBEEP 6.0.0 · Aggiornata il
L'intero aspetto di BeeBEEP -- ogni colore, raggio degli angoli, misura e dimensione del carattere, nella versione chiara e in quella scura -- sta in un solo file QML. Questa pagina è per un grafico o uno sviluppatore che vuole cambiare l'aspetto di BeeBEEP: dice dove si trova il file, come modificarlo in sicurezza e che cosa controlla ogni token. Non serve cambiare nessun codice.
Come funziona il tema
Il tema è il file assets/themes/beebeep-custom-theme.qml dell'albero dei sorgenti: un solo QtObject con una proprietà per ogni token. BeeBEEP lo legge quando si avvia, e ogni schermata prende da esso i propri colori e le proprie dimensioni.
Le due palette sono nello stesso file. Ogni colore è scritto con il valore scuro per primo e quello chiaro per secondo:
property color surfaceColor: dark ? "#171D23" : "#FFFFFF"
La proprietà dark è impostata da BeeBEEP, mai da te. Segue la scelta in Impostazioni > Aspetto > Tema: Segui il tema di sistema (il valore predefinito; cambia insieme al dispositivo), Chiaro o Scuro. Il cambiamento è immediato, senza riavvio. Per cambiare il tema chiaro modifica il secondo valore di una riga, per cambiare il tema scuro il primo.
Alcuni token hanno un solo valore che vale per entrambi i temi (il badge dei messaggi non letti, la schermata iniziale).
Dove si trova il file
BeeBEEP cerca beebeep-custom-theme.qml in una cartella chiamata themes accanto al suo eseguibile (su macOS, nella sua cartella dei dati: vedi sotto). Se il file è lì e si carica, viene usato; altrimenti BeeBEEP usa la copia dello stesso file incorporata nel programma.
Una compilazione dai sorgenti mette themes accanto all'eseguibile che produce, e aggiorna la copia da assets/themes ogni volta che quel file cambia (su macOS ricompila invece la copia incorporata nel programma).
Windows
Lo zip portatile contiene la cartella come themes accanto a beebeep.exe, nella cartella in cui l'hai estratto. L'installer e l'MSI la installano come C:\Program Files\BeeBEEP\themes\beebeep-custom-theme.qml, un file che per modificarlo richiede i diritti di amministratore, e ogni installazione successiva di una nuova versione rimette sopra al tuo il file di quella versione: tieni la tua copia fuori dalla cartella di BeeBEEP.
macOS
Un'app su macOS è firmata, e nulla al suo interno può essere modificato, quindi la cartella themes non è nell'app. Creala nella cartella dei dati di BeeBEEP, ~/Library/Preferences/MarcoMastroddiSW/BeeBEEP/themes, e copiaci il file (oppure nella cartella indicata con --data-folder, se BeeBEEP viene avviato con questa opzione).
Linux
Il pacchetto tar.gz contiene la cartella themes accanto all'eseguibile beebeep. Il pacchetto deb la installa come /usr/lib/beebeep/themes/beebeep-custom-theme.qml, che per essere modificato richiede i diritti di amministratore.
Modificare il tema
- Copia il file e conserva la copia: ti serve per tornare indietro.
- Modifica i valori dopo i due punti. Mantieni la forma di ogni riga: la parola
property, un tipo, il nome, i due punti e il valore. - Salva e avvia di nuovo BeeBEEP. Usa Impostazioni > Aspetto > Tema per guardare entrambe le palette.
Regole:
- Un colore è un nome che Qt conosce (
white,gray) oppure una stringa esadecimale,#RRGGBB, o#AARRGGBBcon la trasparenza per prima (#8814213A). - Un raggio o una dimensione è un numero di pixel.
- Una dimensione del carattere è in punti, scritta rispetto alla dimensione del testo del sistema (
baseFontPointSize + 9), così l'intera app segue la dimensione del testo impostata sul dispositivo. Non trasformarla in un numero fisso. - Non aggiungere, rimuovere o rinominare una proprietà, e non toccare
dark. Una nuova proprietà non fa nulla finché una schermata non la legge per nome. - Mantieni la riga
import QtQuicke ilQtObject { }più esterno.
Catalogo dei token
Ogni token del file, con il suo valore predefinito. Un token il cui valore predefinito è lo stesso nelle due colonne ha un solo valore per entrambi i temi.
Superfici
| Token | Chiaro | Scuro | Cosa colora |
|---|---|---|---|
backgroundColor | #F4F6F8 | #0F1418 | Lo sfondo della finestra, dietro a ogni schermata, e il fondo delle schede delle Impostazioni e del campo di ricerca. |
surfaceColor | #FFFFFF | #171D23 | Un elenco o una scheda sopra lo sfondo: le righe delle chat e dei contatti, le schede delle Impostazioni, i popup. |
headerColor | #FFFFFF | #1C242B | La cornice dell'app: le intestazioni delle schermate, la barra delle schede in basso, la barra laterale di una finestra larga, la barra di composizione dei messaggi. |
chatBackgroundColor | #EDF1F4 | #0F1418 | Lo sfondo dell'elenco dei messaggi, leggermente colorato perché un fumetto ricevuto risalti. |
dividerColor | #E3E7EB | #2A343D | Le sottili linee di separazione tra le righe di un elenco e sotto le intestazioni. |
dialogColor | #FFFFFF | #2B353E | Ciò che sta sopra a tutto il resto: una finestra di dialogo, il menu di un messaggio. Nel tema scuro è più chiaro di qualsiasi fumetto o scheda, così appare sollevato rispetto a loro. |
dialogBorderColor | #E3E7EB | #3A4651 | Il bordo di quelle finestre di dialogo e di quei menu. |
modalDimColor | #12000000 | #80000000 | Il velo che una finestra di dialogo stende sul resto della finestra; più forte nel tema scuro, altrimenti non si vedrebbe su un fondo quasi nero. |
Testo
| Token | Chiaro | Scuro | Cosa colora |
|---|---|---|---|
textPrimaryColor | #14202B | #E8EDF1 | Il testo normale da leggere: nomi, testo dei messaggi, titoli, icone delle intestazioni. |
textSecondaryColor | #5F6E7B | #98A6B3 | Il testo attenuato: orari, didascalie, stato di consegna, anteprime negli elenchi, segnaposto. |
textDisabledColor | #9AA6B1 | #5F6E7B | Il testo inattivo: l'etichetta di un controllo disattivato, l'anello di un pulsante di opzione non selezionato. |
Marchio
| Token | Chiaro | Scuro | Cosa colora |
|---|---|---|---|
accentColor | #0277BD | #4FC3F7 | Il blu di BeeBEEP: il pulsante più, i link, la scheda selezionata, la freccia del pulsante per saltare ai non letti, le spunte di lettura. |
accentStrongColor | #01579B | #81D4FA | L'accento mentre è premuto o sotto il puntatore. |
accentSoftColor | #E3F2FB | #123B52 | Un riempimento morbido con l'accento: la pillola della scheda selezionata, un filtro selezionato, il riquadro dell'icona di una riga delle Impostazioni, la scheda del file in un fumetto. |
textOnAccentColor | #FFFFFF | #0F1418 | Testo e icone disegnati sopra l'accento, come la freccia del pulsante di invio. |
honeyColor | #F5B301 | #FFC93C | Il colore miele, firma di BeeBEEP, usato con parsimonia: il chip della cifratura end-to-end, il pallino di attività sull'icona dei trasferimenti di file, la stella dei messaggi importanti, il badge di un messaggio vocale non ascoltato, il bordo della corrispondenza corrente di una ricerca. |
honeySoftColor | #FFF4D6 | #3A2E0F | Un riempimento morbido color miele: il chip della cifratura end-to-end. |
textOnHoneyColor | #3A2A00 | #FFE9A8 | Testo e icone disegnati sopra il riempimento morbido color miele. |
Fumetti dei messaggi
| Token | Chiaro | Scuro | Cosa colora |
|---|---|---|---|
bubbleOwnColor | #D7ECFA | #1D4B66 | Il riempimento di un messaggio che hai inviato. |
bubbleReceivedColor | #FFFFFF | #232C34 | Il riempimento di un messaggio inviato da qualcun altro. |
bubbleBorderColor | #E3E7EB | #2A343D | Il sottile bordo di un fumetto ricevuto; i tuoi fumetti non ne hanno. |
searchMatchColor | #FFD54F | #7A5C00 | Lo sfondo dietro una parola trovata dalla ricerca dentro una chat. |
Messaggi vocali
| Token | Chiaro | Scuro | Cosa colora |
|---|---|---|---|
voiceWaveformPlayedColor | #0277BD | #4FC3F7 | Le barre della forma d'onda già riprodotte, e il punto della posizione corrente. |
voiceWaveformUnplayedColor | #9DB2C2 | #5E7282 | Le barre della forma d'onda ancora da riprodurre. |
voiceBadgeUnplayedColor | #F5B301 | #FFC93C | Il badge con il microfono su un messaggio vocale ricevuto che nessuno ha ancora ascoltato. |
voiceBadgeUnplayedIconColor | #3A2A00 | #3A2A00 | Il simbolo del microfono su quel badge. |
voiceBadgePlayedColor | #E3E7EB | #2A343D | Il badge con il microfono dopo che il messaggio è stato ascoltato, e sempre sui tuoi messaggi. |
voiceBadgePlayedIconColor | #5F6B76 | #9AA7B2 | Il simbolo del microfono su quel badge. |
Stato
| Token | Chiaro | Scuro | Cosa colora |
|---|---|---|---|
successColor | #2E9E5B | #4CC276 | Uno stato completato, come un trasferimento terminato. |
warningColor | #E08A00 | #F2A93B | Un avviso o uno stato in corso, come un trasferimento ancora in attesa. |
dangerColor | #D64545 | #EF6B6B | Uno stato di errore, come un trasferimento fallito, e il banner di assenza di connessione. |
importantColor | #F5B301 | #FFC93C | La stella di un messaggio segnato come importante. |
Badge e presenza
| Token | Chiaro | Scuro | Cosa colora |
|---|---|---|---|
unreadBadgeColor | #0277BD | #0277BD | La pillola con il numero dei non letti su una riga di chat, sulla scheda Chat e sul pulsante per saltare ai non letti. |
textOnUnreadBadgeColor | #FFFFFF | #FFFFFF | Il numero dentro la pillola dei non letti. |
onlineStatusColor | #2E9E5B | #4CC276 | Il pallino accanto a un contatto online. |
offlineStatusColor | #C3CCD4 | #4A5866 | Il pallino accanto a un contatto offline, e la guida di un interruttore spento. |
notRespondingStatusColor | #8E99A4 | #7C8A97 | Il pallino di un contatto che è online ma ha smesso di rispondere. |
Campi di input e schede
| Token | Chiaro | Scuro | Cosa colora |
|---|---|---|---|
inputFieldColor | #FFFFFF | #232C34 | Il riempimento del campo di composizione dei messaggi e dei campi di testo. |
inputBorderColor | #D5DCE2 | #2A343D | Il bordo degli stessi. |
tabActiveColor | #0277BD | #4FC3F7 | L'icona e l'etichetta della scheda selezionata. |
tabInactiveColor | #6B7A87 | #8A98A5 | L'icona e l'etichetta di tutte le altre schede. |
Avatar
| Token | Chiaro | Scuro | Cosa colora |
|---|---|---|---|
colorSwatchBorderColor | #40000000 | #30FFFFFF | Il sottile bordo attorno a un avatar o a un campione di colore. |
Banner
| Token | Chiaro | Scuro | Cosa colora |
|---|---|---|---|
infoBannerColor | #E3F2FB | #123B52 | Lo sfondo di una barra di informazione o di azione: segna tutto come letto, la conferma della copia, la barra della selezione multipla, la barra della risposta, il banner dei trasferimenti di file. |
infoBannerBorderColor | #CFE4F5 | #1B4A63 | Il bordo delle stesse barre. |
pinnedBannerColor | #FFF4D6 | #3A2E0F | Lo sfondo della barra del messaggio fissato. |
pinnedBannerBorderColor | #F0E0B0 | #4A3C14 | Il bordo della barra del messaggio fissato. |
typingBannerColor | #F4F6F8 | #171D23 | Lo sfondo del banner di chi sta scrivendo. |
warningBannerColor | #FFF3E0 | #3A2A0F | Lo sfondo dell'avviso sulla chiave di sicurezza in cima a una chat privata. |
warningBannerBorderColor | #FFCC80 | #6B4E1A | Il bordo di quell'avviso. |
Schermata iniziale
| Token | Chiaro | Scuro | Cosa colora |
|---|---|---|---|
splashTopColor | #0B2A3F | #0B2A3F | La parte alta della sfumatura della schermata iniziale. |
splashBottomColor | #071A28 | #071A28 | La parte bassa della sfumatura della schermata iniziale. |
splashTextColor | #FFFFFF | #FFFFFF | Il nome e il testo principale della schermata iniziale. |
splashMutedTextColor | #9FB6C6 | #9FB6C6 | Lo slogan, la parola "Versione" e le righe più piccole della schermata iniziale; attenuato, il contorno di una cella di caricamento non ancora riempita. |
splashHoneyColor | #FFC93C | #FFC93C | Il miele della schermata iniziale: la seconda metà del nome, il bordo della cella dell'ape, le celle accese del favo, le celle di caricamento e il numero di versione. |
splashCombColor | #1C4A66 | #1C4A66 | Le sottili pareti del favo disegnato sul fondo della schermata iniziale. |
splashCellColor | #0F3852 | #0F3852 | L'interno della grande cella in cui sta l'ape. |
Dimensioni del carattere
| Token | Predefinito | Cosa imposta |
|---|---|---|
fontSizeCaption | system size - 1 | Il testo piccolo: orari, didascalie, etichette di stato, etichette delle schede. |
fontSizeBody | system size | Il testo normale: testo dei messaggi, titoli delle righe degli elenchi. |
fontSizeTitle | system size + 9 | Il grande titolo della schermata di una scheda. |
Forme
| Token | Predefinito | Cosa imposta |
|---|---|---|
bubbleRadius | 16 | Il raggio degli angoli di un fumetto di messaggio. |
cardRadius | 14 | Il raggio degli angoli di una scheda e della casella di input dei messaggi. |
chipRadius | 10 | Il raggio degli angoli di un chip: un filtro, la data in una chat, il chip della cifratura. |
iconTileRadius | 9 | Il raggio degli angoli del piccolo quadrato dietro l'icona di una riga delle Impostazioni. |
buttonRadius | 8 | Il raggio degli angoli di ogni pulsante con una parola: Apri, Accetta, Share, i pulsanti grandi di una pagina. |
buttonBorderWidth | 1 | Lo spessore del contorno di un pulsante; un pulsante che ha il focus della tastiera lo disegna due volte più spesso. |
Dimensioni
| Token | Predefinito | Cosa imposta |
|---|---|---|
touchTargetSize | 44 | La larghezza e l'altezza minime di tutto ciò che tocchi: i pulsanti delle intestazioni, il pulsante di invio. |
avatarListSize | 48 | Il diametro dell'avatar su una riga di un elenco. |
avatarHeaderSize | 40 | Il diametro dell'avatar nell'intestazione di una conversazione. |
avatarProfileSize | 104 | Il diametro dell'avatar nella schermata Tu. |
iconSize | 24 | La dimensione delle icone delle intestazioni e delle barre degli strumenti. |
tabIconSize | 26 | La dimensione delle icone della barra delle schede e della barra laterale. |