1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
//! # Light — реактивный графический интерфейс для Rust
//!
//! Light — библиотека со **своим окном** (winit + программная отрисовка)
//! и реактивностью в духе Vue 3:
//!
//! * атрибут `#[proxy]` превращает структуру в реактивный класс: свойства
//! читаются и записываются через геттеры/сеттеры, которые уведомляют
//! обозревателя;
//! * атрибут `#[template("...")]` компилирует HTML-шаблон с директивами
//! (`{{ … }}`, `v-model`, `@click`, `v-if`, `:disabled`, `<include>`)
//! на этапе сборки — шаблон **полностью замещает** форму компонента;
//! * отрисовка построена на виртуальном дереве: каждое изменение свойства
//! приводит к пересборке дерева и сравнению с предыдущим
//! ([`vdom::diff`]), в результате чего обновляются **только реально
//! изменившиеся элементы** — неизменённые узлы не перерисовываются;
//! * шаблоны могут включать другие шаблоны через `<include src="...">` —
//! так главная форма собирается из внутренних страниц и разделов.
//!
//! ## Компоненты
//!
//! Ядро библиотеки — крейт [`light-fw-core`](light_fw_core). Дополнительные
//! возможности подключаются как отдельные компоненты и фичи:
//!
//! * [`light-fw-element-form`](light_fw_element_form) (фича `elements-form`) —
//! элементы `<checkbox>`, `<radio>`, `<select>`/`<option>`;
//! * [`light-fw-behavior-validation`](light_fw_behavior_validation)
//! (фича `validation`) — `required`, `:validator` и `@validate`.
//!
//! ## Пример
//!
//! ```no_run
//! use light::prelude::*;
//!
//! #[template("templates/doc_example.html")]
//! #[proxy]
//! struct App {
//! title: String,
//! count: i64,
//! name: String,
//! show_greeting: bool,
//! }
//!
//! impl App {
//! fn increment(&self) {
//! self.set_count(self.count() + 1);
//! }
//!
//! fn is_zero(&self) -> bool {
//! self.count() == 0
//! }
//!
//! fn reset(&self) {
//! self.set_count(0);
//! }
//!
//! fn toggle_greeting(&self) {
//! self.set_show_greeting(!self.show_greeting());
//! }
//! }
//!
//! # #[cfg(not(feature = "window"))]
//! # fn main() {}
//! # #[cfg(feature = "window")]
//! fn main() -> light::Result<()> {
//! light::run(App::new())
//! }
//! ```
//!
//! Шаблон `templates/doc_example.html`:
//!
//! ```html
//! <div>
//! <text>{{ title }}</text>
//! <button @click="increment" :disabled="is_zero">+1 ({{ count }})</button>
//! <button @click="reset">Сброс</button>
//! </div>
//! ```
// Позволяет генерируемому коду обращаться к `::light::…` изнутри самой библиотеки.
extern crate self as light;
pub use *;
pub use light_fw_behavior_validation;
pub use light_fw_element_form;