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

Recalbox lit de haut en bas, et deux composants de même nom se remplacent : le dernier gagne.

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.