First window
This is the smallest icedtea program: a notes window. icedtea::run!
opens it. One Action named Save sits on the toolbar. ctrl+s or
that row writes the text length into the status line. The notes live
only in memory until you build Keep a task list.
The program is examples/hello.rs
in the repository. cargo run --example hello.
//! First window: Save writes the buffer into the status line.
use icedtea::a11y::{A11y, Role};
use icedtea::action::{Action, ActionTable};
use icedtea::i18n::Direction;
use icedtea::iced::widget::text_editor::Content;
use icedtea::key::{self, KeyContext};
use icedtea::pattern;
use icedtea::shortcut::Shortcut;
use icedtea::theme;
use icedtea::widget;
use icedtea::{Boot, Element, Task};
fn main() -> icedtea::iced::Result {
icedtea::run!(
Boot::new("Notes", "dev.example.hello").focus(A11y::new("notes", Role::TextBox).node_id()),
Hello::new,
Hello::update,
Hello::view,
Hello::theme,
)
}
struct Hello {
doc: Content,
status: String,
table: ActionTable<Message>,
}
#[derive(Clone)]
enum Message {
Edit(icedtea::iced::widget::text_editor::Action),
Save,
Quit,
Key(icedtea::iced::keyboard::Event),
}
impl From<icedtea::iced::keyboard::Event> for Message {
fn from(ev: icedtea::iced::keyboard::Event) -> Self {
Self::Key(ev)
}
}
impl Hello {
fn new() -> (Self, Task<Message>) {
let mut table = ActionTable::new();
table.insert(
Action::new("file.save", "Save", Message::Save)
.with_shortcut(Shortcut::parse("ctrl+s").unwrap()),
);
table.seed_quit(Message::Quit);
(
Self {
doc: Content::with_text("Notes"),
status: "Ready".into(),
table,
},
Task::none(),
)
}
fn update(&mut self, message: Message) -> Task<Message> {
match message {
Message::Edit(action) => self.doc.perform(action),
Message::Save => {
self.status = format!("Saved ({} chars)", self.doc.text().chars().count());
}
Message::Quit => return icedtea::iced::exit(),
Message::Key(ev) => {
if let Some(next) = key::handle(KeyContext::default(), &self.table, &ev) {
return self.update(next);
}
}
}
Task::none()
}
fn view(&self) -> Element<'_, Message> {
let tok = theme::named("dark").tokens;
icedtea::focus::cycle(
icedtea::iced::widget::column![
pattern::toolbar(self.table.iter(), tok, Direction::Ltr),
widget::textarea(
&self.doc,
Message::Edit,
tok,
icedtea::layout::FILL,
A11y::new("notes", Role::TextBox),
),
pattern::status_bar(&self.status, None, None, &self.table, tok, Direction::Ltr),
]
.spacing(8)
.padding(12)
.width(icedtea::layout::FILL)
.height(icedtea::layout::FILL)
.into(),
Some(icedtea::iced::widget::Id::from(
A11y::new("notes", Role::TextBox).node_id(),
)),
)
}
fn theme(&self) -> icedtea::iced::Theme {
theme::iced_theme("dark", theme::named("dark").tokens)
}
}
Message implements From<keyboard::Event> so run! can subscribe
key::listen. view wraps the column in focus::cycle so Tab
reaches the editor. seed_quit inserts app.quit on ctrl+q.
key::handle matches Save and Quit after the editor owns typing.
Boot is the window name, size, colors, and look (density, type
scale, corners, elevation). run! (and daemon!)
also pick an installed sans face for UI text (normal and bold) and a
fixed face for code. Load a named family on the iced application if
you want a specific font.
A compact tool sets size on Boot (.size(380.0, 560.0).min_size(...))
instead of calling iced window resize. See Compact tools.
When you want the list to survive quitting, go to Keep a task list.
bootstrap(&boot) is the same path without opening a window — use it
in tests. An overlay that hides and pops out uses daemon!
plus Prepared::open.
Crate docs: run!,
Boot.