**不要使用此 crate，这是一个为我在其他 crate（ibox）中使用的 CROSSTERM 的分支**。

跨平台终端操作库

Crossterm 是一个纯 Rust 的终端操作库，它使得编写跨平台的文本界面成为可能（见 功能）。它支持所有 UNIX 和 Windows 7 及以上版本的终端（并非所有终端都经过测试，更多信息请见 测试的终端）。

目录

• 功能
  • 测试的终端
• 入门指南
  • 功能标志
• 其他资源
• 使用情况
• 贡献

功能

• 跨平台
• 多线程（发送、同步）
• 详细的文档
• 依赖项少
• 完全控制输出缓冲区的写入和刷新
• 是 tty
• 光标
  • 移动光标 N 次（上、下、左、右）
  • 移动到上一行/下一行
  • 移动到列
  • 设置/获取光标位置
  • 存储光标位置并在以后恢复到它
  • 隐藏/显示光标
  • 启用/禁用光标闪烁（并非所有终端都支持此功能）
• 样式输出
  • 前景色（16种基本颜色）
  • 背景色（16种基本颜色）
  • 256（ANSI）颜色支持（仅限 Windows 10 和 UNIX）
  • RGB 颜色支持（仅限 Windows 10 和 UNIX）
  • 文本属性，如粗体、斜体、下划线、删除线等
• 终端
  • 清除（所有行、当前行、从光标向下和向上，直到新行）
  • 向上/向下滚动
  • 设置/获取终端大小
  • 退出当前进程
  • 备用屏幕
  • 原始屏幕
  • 设置终端标题
  • 启用/禁用自动换行
• 事件
  • 输入事件
  • 鼠标事件（按下、释放、位置、按钮、拖动）
  • 终端大小调整事件
  • 支持鼠标和键盘事件的高级修饰符（SHIFT | ALT | CTRL）和
  • futures Stream（特性 'event-stream'）
  • 轮询/读取 API

测试的终端

• 控制台主机
  • Windows 10（专业版）
  • Windows 8.1（N版）
• Ubuntu 桌面终端
  • Ubuntu 17.10
  • Pop!_OS（Ubuntu）20.04
• （Arch、Manjaro）KDE Konsole
• （Arch）Kitty
• Linux Mint
• （OpenSuse）Alacritty

此crate支持所有UNIX终端和Windows 7及以下版本的终端；然而，并非所有终端都经过测试。如果您在没有上述列表之外的终端上使用此库且没有问题，请随意将其添加到上述列表中 - 我非常感谢！

入门指南

请参阅示例目录和文档以获取更多高级示例。

[dependencies]
crossterm = "0.23"

use std::io::{stdout, Write};

use crossterm::{
    execute,
    style::{Color, Print, ResetColor, SetBackgroundColor, SetForegroundColor},
    ExecutableCommand, Result,
    event,
};

fn main() -> Result<()> {
    // using the macro
    execute!(
        stdout(),
        SetForegroundColor(Color::Blue),
        SetBackgroundColor(Color::Red),
        Print("Styled text here."),
        ResetColor
    )?;

    // or using functions
    stdout()
        .execute(SetForegroundColor(Color::Blue))?
        .execute(SetBackgroundColor(Color::Red))?
        .execute(Print("Styled text here."))?
        .execute(ResetColor)?;
    
    Ok(())
}

查看所有可能的命令列表。

功能标志

[dependencies.crossterm]
version = "0.23"
features = ["event-stream"] 

依赖项理由

其他资源

• API文档
• 已弃用的示例存储库

使用情况

• Broot
• Cursive
• TUI
• Rust-sloth
• Rusty-rain

贡献

我们非常感谢任何人对此crate的贡献。在您贡献之前，请阅读贡献指南。

作者

• Timon Post - 项目负责人 & 创始人

许可证

此项目，crossterm，包括crossterm_screen、crossterm_cursor、crossterm_style、crossterm_input、crossterm_terminal、crossterm_winapi、crossterm_utils均受MIT许可证许可 - 有关详细信息，请参阅LICENSE文件。