Aller au contenu

Thèmes

Un thème est un plugin de type theme (capacité ui.theme). C'est de la donnée, jamais du code : variables CSS, feuille de style, logo, favicon.

Manifeste

name: mon-theme
type: theme
capabilities: [ui.theme]
theme:
  css: theme.css          # facultatif
  variables:              # facultatif : --nom: valeur
    --accent: "#0a7"
  logo: logo.svg          # png, jpg, gif, webp, svg
  favicon: favicon.png    # png, ico, svg…

Pas de point d'entrée, de secret, de réglage ni de domaine de sortie.

Règles du CSS

  • 64 Ko au plus, UTF-8.
  • Pas d'@import, @charset, @namespace, ni d'échappement \.
  • url() uniquement vers une image data: (png, jpeg, gif, webp en base64) ou un fragment #id.
  • Pas de fonction qui charge une ressource (image-set, src, element…), ni behavior, -moz-binding, expression().
  • Images : 256 Ko au plus, contenu conforme à l'extension, SVG sans script ni référence externe, aucun lien symbolique.

La CSP de l'instance n'est pas modifiée (style-src 'self') : le CSS est servi par l'instance elle-même (/theme/theme.css, /theme/logo, /theme/favicon). Le contrôle est refait à chaque lecture.

Activer

Réglage ui.theme (un seul thème actif) : default ou le nom d'un plugin thème installé et non désactivé. Si le thème est invalide ou disparaît, l'interface retombe sur le thème default embarqué. Le changement est visible en moins de 10 secondes.