ZigTUI

ไลบรารี TUI ข้ามแพลตฟอร์มสำหรับภาษา Zig ได้แรงบันดาลใจจาก Ratatui

คุณสมบัติ

• ข้ามแพลตฟอร์ม — Windows, Linux, macOS
• การเรนเดอร์ที่มีประสิทธิภาพ — ใช้การเปรียบเทียบแบบเซลล์ วาดใหม่เฉพาะส่วนที่เปลี่ยนแปลง
• วิดเจ็ต — Block, Paragraph, List, Gauge, Table
• ธีมในตัว 15 แบบ — Nord, Dracula, Gruvbox, Catppuccin, Tokyo Night...
• Kitty Graphics Protocol — แสดงภาพ (พร้อมตัวเลือกยูนิโค้ดหากไม่รองรับ)
• ไม่มีการจัดสรรหน่วยความจำที่ซ่อนอยู่ — จัดการหน่วยความจำอย่างชัดเจน

ข้อกำหนด

• Zig 0.15.0+
• Windows 10+ / Linux / macOS

การติดตั้ง

zig fetch --save git+https://github.com/adxdits/zigtui.git

// build.zig
const zigtui = b.dependency("zigtui", .{ .target = target, .optimize = optimize });
const exe = b.addExecutable(.{
    .name = "myapp",
    .root_module = b.createModule(.{
        .root_source_file = b.path("src/main.zig"),
        .target = target,
        .optimize = optimize,
        .imports = &.{
            .{ .name = "zigtui", .module = zigtui.module("zigtui") },
        },
    }),
});

git submodule add https://github.com/adxdits/zigtui.git libs/zigtui

const zigtui_module = b.addModule("zigtui", .{
    .root_source_file = b.path("libs/zigtui/src/lib.zig"),
});

เริ่มต้นอย่างรวดเร็ว

const std = @import("std");
const tui = @import("zigtui");
pub fn main() !void {
    var gpa = std.heap.GeneralPurposeAllocator(.{}){};
    defer _ = gpa.deinit();
    const allocator = gpa.allocator();
    var backend = try tui.backend.init(allocator);
    defer backend.deinit();
    var terminal = try tui.terminal.Terminal.init(allocator, backend.interface());
    defer terminal.deinit();
    try terminal.hideCursor();
    defer terminal.showCursor() catch {};
    var running = true;
    while (running) {
        const event = try backend.interface().pollEvent(100);
        if (event == .key) {
            if (event.key.code == .esc or (event.key.code == .char and event.key.code.char == 'q'))
                running = false;
        }
        try terminal.draw({}, struct {
            fn render(_: void, buf: *tui.render.Buffer) !void {
                tui.widgets.Block{
                    .title = "Hello ZigTUI — press 'q' to quit",
                    .borders = tui.widgets.Borders.all(),
                    .border_style = .{ .fg = .cyan },
                }.render(buf.getArea(), buf);
            }
        }.render);
    }
}

วิดเจ็ต

// Block — container with border/title
tui.widgets.Block{ .title = "Panel", .borders = tui.widgets.Borders.all() }
// Paragraph — text display
tui.widgets.Paragraph{ .text = "Hello!", .wrap = true }
// List — scrollable items
tui.widgets.List{ .items = &items, .selected = 0, .highlight_style = .{ .bg = .blue } }
// Gauge — progress bar
tui.widgets.Gauge{ .ratio = 0.75, .label = "75%" }
// Table — tabular data
tui.widgets.Table{ .header = &columns, .rows = &rows }

Themes

const theme = tui.themes.catppuccin_mocha;
tui.widgets.Block{
    .title = "Dashboard",
    .style = theme.baseStyle(),
    .border_style = theme.borderFocusedStyle(),
};

ที่มีให้เลือก: default, nord, dracula, monokai, gruvbox_dark, gruvbox_light, solarized_dark, solarized_light, tokyo_night, catppuccin_mocha, catppuccin_latte, one_dark, cyberpunk, matrix, high_contrast

รันคำสั่ง zig build run-themes เพื่อดูตัวอย่างธีมทั้งหมด

ตัวอย่าง

zig build run-dashboard   # System monitor demo
zig build run-kitty       # Image display demo  
zig build run-themes      # Theme showcase

กราฟิกของ Kitty

แสดงภาพในเทอร์มินัลที่รองรับ โปรโตคอลกราฟิก Kitty โดยจะใช้บล็อก Unicode เป็นตัวสำรองโดยอัตโนมัติ

var gfx = tui.Graphics.init(allocator);
defer gfx.deinit();
var bmp = try tui.graphics.bmp.loadFile(allocator, "image.bmp");
const image = tui.Image{ .data = bmp.data, .width = bmp.width, .height = bmp.height, .format = .rgba };
if (gfx.supportsImages()) {
    if (try gfx.drawImage(image, .{ .x = 0, .y = 0 })) |seq| try backend.write(seq);
} else {
    gfx.renderImageToBuffer(image, buffer, area); // Unicode fallback
}

รองรับ: Kitty, WezTerm, foot, Konsole (บางส่วน) สำรอง: Windows Terminal, iTerm2, Terminal.app

การรองรับแพลตฟอร์ม

| แพลตฟอร์ม | เทอร์มินัล | หมายเหตุ | |------------|------------|----------| | Windows 10+ | Windows Terminal, WezTerm | Native Console API | | Linux | เทอร์มินัลที่รองรับ ANSI | POSIX termios | | macOS | Kitty, WezTerm, Terminal.app | POSIX termios |

ใบอนุญาต

MIT

การมีส่วนร่วม

ยินดีรับข้อเสนอแนะและการดึงคำขอ (PRs).

--- Tranlated By Open Ai Tx | Last indexed: 2026-02-06 ---