مرجع سريع

ورقة غش مكتبة واجهة الطرفية Blessed.js

دليل مرجعي سريع لمكتبة Blessed.js لبناء واجهات الطرفية (TUI) في Node.js: الشاشات، والصناديق، ووسوم التنسيق، ومفاتيح الأحداث.

· تاريخ النشر

Blessed هي مكتبة واجهة طرفية عالية المستوى لـ Node.js، تجلب قدرات العناصر الغنية الشبيهة بـ ncurses إلى JavaScript الحديثة.

تهيئة الشاشة

const blessed = require('blessed');

const screen = blessed.screen({
  smartCSR: true,       // تحسين وميض إعادة رسم الطرفية
  autoPadding: true,
  title: 'My Dashboard'
});

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

// معالجة مفاتيح الخروج العامة
screen.key(['escape', 'q', 'C-c'], (ch, key) => {
  return process.exit(0);
});

عناصر الواجهة (أداة Box)

const box = blessed.box({
  top: 'center',
  left: 'center',
  width: '50%',
  height: '50%',
  content: '{bold}Hello{/bold} Blessed!',
  tags: true, // تفعيل وسوم التنسيق المضمنة
  border: {
    type: 'line' // 'line' أو 'bg'
  },
  style: {
    fg: 'white',
    bg: 'magenta',
    border: {
      fg: '#f0f0f0'
    },
    hover: {
      bg: 'green'
    }
  }
});

screen.append(box);

وسوم التنسيق

عند ضبط tags: true، تحلل العناصر التنسيقات المضمنة:

  • {bold}...{/bold}: نص عريض
  • {underline}...{/underline}: نص مسطر
  • {center}...{/center}: محتوى في المنتصف
  • {right}...{/right}: نص بمحاذاة اليمين
  • {|}: فاصل محاذاة أفقي يسار/يمين
  • {#c0ff33-fg}...{/}: لون أمامي سداسي عشري مخصص

قم بتهريب الوسوم في النصوص الخام باستخدام blessed.escape(str).

موضوعات ذات صلة