Referencia rápida

Hoja de referencia de la biblioteca TUI Blessed.js

Guía rápida para Blessed.js, biblioteca de interfaz de terminal para Node.js: pantallas, cajas, etiquetas de estilo y teclas de evento.

· Publicado

Blessed es una biblioteca de interfaz de terminal de alto nivel para Node.js que aporta widgets ricos tipo ncurses a JavaScript moderno.

Inicialización de pantalla

const blessed = require('blessed');

const screen = blessed.screen({
  smartCSR: true,       // Optimizar parpadeo al redibujar la terminal
  autoPadding: true,
  title: 'My Dashboard'
});

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

// Gestionar salidas globales por teclado
screen.key(['escape', 'q', 'C-c'], (ch, key) => {
  return process.exit(0);
});

Elementos UI (Widget Box)

const box = blessed.box({
  top: 'center',
  left: 'center',
  width: '50%',
  height: '50%',
  content: '{bold}Hello{/bold} Blessed!',
  tags: true, // Habilitar etiquetas de formato en línea
  border: {
    type: 'line' // 'line' o 'bg'
  },
  style: {
    fg: 'white',
    bg: 'magenta',
    border: {
      fg: '#f0f0f0'
    },
    hover: {
      bg: 'green'
    }
  }
});

screen.append(box);

Etiquetas de formato

Cuando tags: true está configurado, los elementos interpretan formato en línea:

  • {bold}...{/bold}: Texto en negrita
  • {underline}...{/underline}: Texto subrayado
  • {center}...{/center}: Contenido centrado
  • {right}...{/right}: Texto alineado a la derecha
  • {|}: Separador horizontal izquierda/derecha
  • {#c0ff33-fg}...{/}: Color hexadecimal de primer plano personalizado

Escapa etiquetas en cadenas sin formato usando blessed.escape(str).

Temas relacionados