Documentation

🚀 xlui:

Latest version Documentation Apache

     xlui是一个Rust的2D GUI库。目标是利用Rust语言原生构建GUI、体积小(最小第三方依赖),简单易用, 在保证性能的前提下尽量减少CPU的开销。

xlui的目标

适配情况 目标系统 平台UI 备注
Linux x11,wayland
Windows 10,11 有延时
⬜️ MacOS -
⬜️ Android 11+
⬜️ Web Wasm
HarmonyOS 暂无适配计划

示例

fn main() {
    XlUiApp::new().run();
}

struct XlUiApp {
    label: Label,
    count: i32,
}

impl XlUiApp {
    pub fn new() -> Self {
        Self {
            label: Label::new("hello".to_string()).width(100.0),
            count: 0,
        }
    }

    pub fn add(&mut self, ui: &mut Ui) {
        self.count += 1;
        self.label.set_text(format!("count: {}", self.count));
        self.label.update(uim);
    }

    pub fn reduce(&mut self, ui: &mut Ui) {
        self.count -= 1;
        self.label.set_text(format!("count: {}", self.count));
        self.label.update(uim);
    }
}

impl App for XlUiApp {
    fn draw(&mut self, ui: &mut Ui) {
        ui.add_mut(&mut self.label);
        ui.horizontal(|ui| {
            ui.add(Button::new("+".to_string()).width(30.0).height(30.0).connect(Self::add));
            ui.add(Button::new("-".to_string()).width(30.0).height(30.0).connect(Self::reduce));
        });
    }

    fn update(&mut self, ui: &mut Ui) {
        self.label.update(ui);
    }

    fn redraw(&mut self, ui: &mut Ui) {
        self.label.redraw(ui);
    }

    fn window_attributes(&self) -> WindowAttribute {
        WindowAttribute {
            inner_size: (800, 600).into(),
            ..Default::default()
        }
    }
}

控件(目前可用)

控件状态

✅ Label

fn draw(&mut self, ui: &mut Ui) {
    ui.label("hello label");
    //或者
    ui.add(Label::new("hello label"));
}

✅ Button

fn draw(&mut self, ui: &mut Ui) {
    ui.button("hello button").set_callback(Self::clicked);
    //或者
    ui.add(Button::new("hello label").connect(Self::clicked));
}

✅ Slider

fn draw(&mut self, ui: &mut Ui) {
    ui.slider(30.0, 0.0..100.0).set_callback(Self::slider);
    //或者
    ui.add(Slider::new(10.0).with_range(0.0..100.0).connect(Self::slider));
}

✅ SpinBox

fn draw(&mut self, ui: &mut Ui) {
    ui.spinbox(1.0, 0.5, 0.0..10.0).set_callback(Self::changed);
    //或者
    ui.add(SpinBox::new(1, 1, 1..10).connect(Self::changed));
}

✅ CheckBox

fn draw(&mut self, ui: &mut Ui) {
    ui.checkbox(true, "checkbox1").set_callback(Self::checked);
    //或者
    ui.add(CheckBox::new(false, "checkbox2").connect(Self::checked));
}

✅ Image

fn draw(&mut self, ui: &mut Ui) {
    ui.image("logo.jpg", (200.0, 200.0));
    //或者
    ui.add(Image::new("logo.jpg").with_size(200.0, 200.0));
}

✅ RadioButton

fn draw(&mut self, ui: &mut Ui) {
    ui.radio(true, "radiobutton").set_callback(Self::radio);
    //或者
    ui.add(RadioButton::new(false, "radiobutton").connect(Self::radio));
}

✅ ComboBox

fn draw(&mut self, ui: &mut Ui) {
    //或者
    let combo_data = vec!["item1", "item2", "item3", "item4"];
    ui.add(ComboBox::new(combo_data).connect(Self::combo_changed).with_popup_height(150.0));
}

✅ ScrollBar(垂直)

fn draw(&mut self, ui: &mut Ui) {
    ui.add(ScrollBar::new().with_size(20.0, 100.0));
}

✅ TextEdit


//文本变动监测
fn edit_changed(&mut self, ui: &mut Ui, text: &str) {
    self.label.set_text(format!("textedit: {}", text));
    self.label.update(ui);
}

fn draw(&mut self, ui: &mut Ui) {
    //创建TextEdit并添加ID,以便后续获取其文本
    ui.add(TextEdit::new("sdsd".to_string()).connect(Self::edit_changed));
}

⬜️ ListView(debug下流畅显示10w条数据)

use std::fmt::Display;

struct APP {
    listview: ListView<i32>,
}

impl APP {
    fn new() -> Self {
        APP {
            listview: ListView::new(vec![1, 2, 3]).with_size(300.0, 400.0)
        }
    }
    fn list_changed(&mut self, ui: &mut Ui) {
        if let Some(datum) = self.listview.current {
            println!("list: {}", self.list_view.current())
        }
    }
}

impl App for APP {
    fn draw(&mut self, ui: &mut Ui) {
        self.list_view.set_callback(Self::list_changed);
        self.list_view.show(ui, |ui, datum| {
            ui.image("logo.jpg", (30.0, 30.0));
            ui.vertical(|ui| {
                ui.label(datum.to_string());
                ui.horizontal(|ui| {
                    ui.label("00:00");
                    ui.label("200");
                    ui.label("HTTP/1.1");
                    ui.label("10 KB");
                    ui.label("10 KB");
                });
            });
        });
    }
}


⬜️ TableView(debug下流畅显示10w条数据)

布局

✅ Layout(垂直、水平)

fn draw(&mut self, ui: &mut Ui) {
    ui.horizontal(|ui| {
        //...
    });
    ui.vertical(|ui| {
        //...
    });
}

✅ ScrollArea(垂直)

fn draw(&mut self, ui: &mut Ui) {
    let area = ScrollArea::new().with_size(300.0, 400.0);
    area.show(ui, |ui| {
        ui.label("start");
        ui.vertical(|ui| {
            ui.label("sv1");
            ui.label("sv2");
            ui.button("sv3").connect(Self::click1);
        });
        ui.horizontal(|ui| {
            ui.label("sh1");
            ui.label("sh2");
            ui.button("sh3");
        });
        for i in 0..1000 {
            ui.label(format!("i{}", i));
        }
        ui.label("end");
    });
}

✅ Popup

⬜️ 自定义窗口