Référence rapide

Aide-mémoire Bibliothèque TUI Blessed.js

Guide rapide pour Blessed.js, bibliothèque d’interface terminal pour Node.js : écrans, boîtes, balises de style et raccourcis clavier.

· Publié le

Blessed est une bibliothèque d’interface terminal de haut niveau pour Node.js, apportant des widgets riches type ncurses au JavaScript moderne.

Initialisation de l’écran

const blessed = require('blessed');

const screen = blessed.screen({
  smartCSR: true,       // Optimiser le scintillement au rafraîchissement du terminal
  autoPadding: true,
  title: 'My Dashboard'
});

screen.append(element);
screen.render();

// Gérer les sorties globales au clavier
screen.key(['escape', 'q', 'C-c'], (ch, key) => {
  return process.exit(0);
});

Éléments d’interface (Widget Box)

const box = blessed.box({
  top: 'center',
  left: 'center',
  width: '50%',
  height: '50%',
  content: '{bold}Hello{/bold} Blessed!',
  tags: true, // Activer les balises de mise en forme en ligne
  border: {
    type: 'line' // 'line' ou 'bg'
  },
  style: {
    fg: 'white',
    bg: 'magenta',
    border: {
      fg: '#f0f0f0'
    },
    hover: {
      bg: 'green'
    }
  }
});

screen.append(box);

Balises de mise en forme

Lorsque tags: true est activé, les éléments analysent le formatage en ligne :

  • {bold}...{/bold}: Texte en gras
  • {underline}...{/underline}: Texte souligné
  • {center}...{/center}: Contenu centré
  • {right}...{/right}: Texte aligné à droite
  • {|}: Séparateur d’alignement horizontal gauche/droite
  • {#c0ff33-fg}...{/}: Couleur hexadécimale d’avant-plan personnalisée

Échappez les balises dans les chaînes brutes avec blessed.escape(str).

Sujets associés