Faire un thème Recalbox

49 pages · 8 sections
⌕
FRENESDE Tout afficher Créer mon thème

Découper son thème : <include>

Un thème sérieux ne tient pas dans un seul fichier.

<include> charge un autre fichier à cet endroit précis, comme si son contenu était recopié là.

<include>${root}/views/system.xml</include>
<include path="${root}/views/detailed.xml" />

Les deux écritures fonctionnent : le chemin en contenu de la balise, ou en attribut path.

L’ordre compte

Deux composants de même nom se remplacent : le dernier lu gagne. Mais « le dernier lu » n’est pas « le dernier écrit » — dans un fichier, Recalbox traite d’abord toutes ses inclusions, puis seulement ses propres vues :

Les vues d’un fichier passent toujours par-dessus celles des fichiers qu’il inclut, même si l’<include> est écrit plus bas. Entre deux inclusions voisines, en revanche, c’est bien la dernière écrite qui gagne.

base.xml fond = bleu rouge.xml fond = rouge le fond est ROUGE lu de haut en bas : deux composants de même nom se remplacent, le DERNIER gagne c’est tout le mécanisme des surcouches — et donc des options

C’est tout le mécanisme des surcouches — et c’est ainsi que sont bâties les options du thème : chaque choix est un fichier chargé par-dessus, qui ne redéfinit que ce qui change. Voir Ce qu’est une option.

<include>${root}/views/base.xml</include>       <!-- pose le fond en bleu -->
<include>${root}/options/rouge.xml</include>     <!-- le repasse en rouge -->

Inclure sous condition

Un <include> accepte if=, comme un composant : le fichier n’est chargé que si la condition est vraie.

<include if="crt">${root}/views/system-crt.xml</include>

C’est ainsi qu’on sert une mise en page différente selon l’écran, sans dupliquer tout le reste. La liste des conditions est dans Afficher sous condition.