UI!: JSX-style template syntax with compile-time checksBeam: Component SystemLaser: Client Component working as WASM island (experimental)
With
simply organized API and codebase,
emitting efficient template rendering avoiding redundant memory allocations as smartly as possible,
and HTML completions and hovers in UI! by VSCode extension ( search "uibeam" from extension marketplace )
[dependencies]
uibeam = "0.3.0"use uibeam::UI;
fn main() {
let user_name = "foo";
let style = "
color: red; \
font-size: 20px; \
";
let ui: UI = UI! {
<p class="hello" style={style}>
"Welcome to the world of UIBeam!"
<br>
"こんにちは"
<a
class="user"
style="color: blue;"
data-user-id="123"
href="https://example-chatapp.com/users/123"
>
"@"{user_name}"!"
</a>
</p>
};
println!("{}", uibeam::shoot(ui));
}raw string literal ( r#"..."# ) or unsafe block contents are rendered without HTML-escape :
use uibeam::UI;
fn main() {
println!("{}", uibeam::shoot(UI! {
<html>
<body>
/* ↓ wrong here: scripts are html-escaped... */
<script>
"console.log('1 << 3 =', 1 << 3);"
</script>
<script>
{include_str!("index.js")}
</script>
/* ↓ scripts are NOT html-escaped, rendered as they are */
<script>
r#"console.log('1 << 3 =', 1 << 3);"#
</script>
<script>
unsafe {include_str!("index.js")}
</script>
<script>
unsafe {"console.log('1 << 3 =', 1 << 3);"}
</script>
</body>
</html>
}));
}{} at node-position in UI! can render, in addition to Display-able values, any impl IntoIterator<Item = UI>. This includes Option<UI> or any other iterators yielding UIs !
use uibeam::{UI, Beam};
struct Task {
id: u64,
title: String,
subtasks: Vec<String>,
completed: bool,
}
fn main() {
let t = Task {
id: 42,
title: "try uibeam".to_string(),
subtasks: vec![],
completed: false,
};
let ui = UI! {
<div id={format!("task-{}", t.id)}>
<h2>{t.title}</h2>
<h3>"subtasks"</h3>
<ul>
{t.subtasks.iter().map(|s| UI! {
<li>{s}</li>
})}
</ul>
{t.completed.then_some(UI! {
<i><strong>"completed"</strong></i>
})}
</div>
};
println!("{}", uibeam::shoot(ui));
}use uibeam::{Beam, UI};
struct Layout {
title: String,
children: UI, // `children` field
}
impl Beam for Layout {
fn render(self) -> UI {
UI! {
<html>
<head>
<title>{self.title}</title>
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/[email protected]/dist/tailwind.min.css">
</head>
<body class="bg-gray-100">
{self.children}
</body>
</html>
}
}
}
struct AdminPage {}
impl Beam for AdminPage {
fn render(self) -> UI {
UI! {
<main class="container mx-auto flex-grow py-8 px-4">
<section class="bg-white shadow-md rounded-lg p-6">
<h1 class="text-2xl font-bold text-gray-800 mb-6">
"Password"
</h1>
<form method="post" action="" class="w-full">
<div class="flex flex-col gap-4">
<div class="flex flex-col">
<label for="adminPassword" class="text-gray-700 text-sm font-bold mb-1">
"password"
</label>
<input
required
type="password"
id="adminPassword"
name="adminPassword"
class="py-2 px-3 border border-gray-400 rounded focus:outline-none focus:shadow-outline"
/>
</div>
</div>
<div class="mt-6">
<button
type="submit"
class="bg-purple-500 hover:bg-purple-700 text-white py-2 px-4 rounded focus:outline-none focus:shadow-outline"
>
"Send"
</button>
</div>
</form>
</section>
</main>
}
}
}
fn main() {
let ui = UI! {
<Layout title="admin page"> // title: ("admin page").into()
<AdminPage /> // children: (AdminPage {}).render()
</Layout>
};
println!("{}", uibeam::shoot(ui));
}Laser is experimental, Preact-based client component system in WASM.
Lasers work as WASM islands : initially rendered in server, sent with serialized props, and hydrated with deserialized props in client.
Signal, computed, effect are available in Lasers.
Currently Laser system is:
- experimantal.
- working with/based on
Preact. - NOT supported on WASM host like Cloudflare Workers.
working example: examples/counter
-
Activate
"laser"feature and addserdeto dependencies:[dependencies] uibeam = { version = "0.3.0", features = ["laser"] } serde = { version = "1", features = ["derive"] }
-
Create an UIBeam-specific library crate (e.g.
lasers) as a workspace member, and have allLasers in that crate.(of cource, no problem if including all
Beams not onlyLasers. then the name of this crate may becomponentsor something?)Make sure to specify
crate-type = ["cdylib", "rlib"]:[lib] crate-type = ["cdylib", "rlib"]
-
Build your
Lasers:use uibeam::{UI, Laser, Signal, callback}; use serde::{Serialize, Deserialize}; #[Laser] #[derive(Serialize, Deserialize)] struct Counter; impl Laser for Counter { fn render(self) -> UI { let count = Signal::new(0); // callback utility let increment = callback!( // dependent signals [count], // |args, ...| expression |_| count.set(*count + 1) ); /* expanded: let increment = { let count = count.clone(); move |_| count.set(*count + 1) }; */ let decrement = callback!([count], |_| { count.set(*count - 1) }); UI! { <p>"Count: "{*count}</p> <button onclick={increment}>"+"</button> <button onclick={decrement}>"-"</button> } } }
#[Laser(local)]ebables to build local Lasers:- not require
SerializeDeserializeand can have unserializable items in its fields such asfn(web_sys::Event). - only available as a
UIelement of a non-localLaseror other localLaser.
otherwise: not hydrated. currently this is silent behavior. (maybe rejected by compile-time check in future version)
- not require
-
Compile to WASM by
wasm-pack buildwith--target web --out-name lasers:# example when naming the crate `components` cd components wasm-pack build --target web --out-name lasers # or wasm-pack build components --target web --out-name lasers
and set up to serve the output directly (default:
pkg) at/.uibeam:/* axum example */ use axum::Router; use tower_http::services::ServeDir; fn app() -> Router { Router::new() .nest_service( "/.uibeam", ServeDir::new("./lasers/pkg") ) // ... }
(as a result, generated
lasers/pkg/lasers.jsis served at/.uibeam/lasers.jsand automatically loaded together with WASM by a Laser in the first hydration.) -
Use your
Lasers in anyUI!rendering:use lasers::Counter; use uibeam::UI; async fn index() -> UI { UI! { <Counter /> } }
This
UIis initially rendered as a static template, and later hydrated with the/.uibeamdirectory.
Enables UI to be returned as a HTML response.
Axum - by "axum" feature
use axum::{routing::get, Router};
use uibeam::UI;
async fn handler() -> UI {
UI! {
<h1>"Hello, Axum!"</h1>
}
}
#[tokio::main]
async fn main() {
let app = Router::new()
.route("/", get(handler));
let listener = tokio::net::TcpListener::bind("0.0.0.0:3000").await.unwrap();
axum::serve(listener, app).await.unwrap();
}Actix Web - by "actix-web" feature
use actix_web::{HttpServer, App, get};
use uibeam::UI;
#[get("/")]
async fn handler() -> UI {
UI! {
<h1>"Hello, Actix Web!"</h1>
}
}
#[actix_web::main]
async fn main() -> std::io::Result<()> {
HttpServer::new(||
App::new()
.service(handler)
)
.bind(("127.0.0.1", 8080))?
.run()
.await
}UIBeam is licensed under MIT LICENSE.