Los componentes libres: extra="true" y <extras>
Por qué un componente que añades no se muestra — y las dos formas de declararlo.
Dos familias de componentes
En una vista, Recalbox distingue:
- los elementos que construye él mismo — el carrusel, la lista de juegos, la barra de ayuda, la carátula del juego… Tienen un nombre reservado, y el tema solo los ajusta;
- los componentes que tú añades — un texto, una imagen, un bloque de color, un vídeo. Son los componentes libres.
Un componente libre debe declararse como tal
Un componente libre colocado directamente en la vista no se dibuja: la máquina solo construye los elementos marcados extra. Dos escrituras posibles, y hacen exactamente lo mismo:
<image name="monLogo" extra="true">…</image><extras>
<image name="monLogo">…</image>
<text name="maMention">…</text>
</extras><extras> es un contenedor: cada uno de sus hijos recibe extra="true", de una vez. Es más corto y más legible en cuanto hay varios componentes — es lo que escribe el estudio.
Lo que hay que recordar
<extras>no es un componente: no se dibuja, no se posiciona.- No se mete dentro de sí mismo: un
<extras>dentro de un<extras>no tiene ningún efecto adicional. - Funciona en la vista Sistemas, la Lista de juegos y el Salvapantallas. ⚠️ No en el Menú: el motor no busca allí ningún componente libre. Un
<extras>escrito para la vista Menú se lee sin error… y nunca dibuja nada. - Los elementos de nombre reservado quedan fuera: ya existen, solo se ajustan.
En el estudio no tienes que hacer nada: los componentes que añades se escriben automáticamente dentro de
<extras>, y los elementos reservados fuera.