Reactivity
Declare state
Update state
Templating
Minimal template
Styling
<h1.title>I am red</h1>
<button style={ "font-size": "10rem" }>I am a button</button>
<button class=scopedButton>I am a style-scoped button</button>
<style>
.title {
color: red;
}
</style>
<style/{ scopedButton }>
.scopedButton {
font-size: 10rem;
}
</style>
Loop
Event click
Dom ref
Conditional
static const TRAFFIC_LIGHTS = ["red", "orange", "green"];
<let/lightIndex=0>
<const/light=TRAFFIC_LIGHTS[lightIndex]>
<button onClick() { lightIndex = (lightIndex + 1) % TRAFFIC_LIGHTS.length }>
Next light
</button>
<p>Light is: ${light}</p>
<p>
You must
<if=light === "red">STOP</if>
<else if=light === "orange">SLOW DOWN</else>
<else>GO</else>
</p>
import { track } from "ripple";
const TRAFFIC_LIGHTS = ["red", "orange", "green"];
export default function TrafficLight() {
let &[lightIndex] = track(0);
let &[light] = track(() => TRAFFIC_LIGHTS[lightIndex]);
function nextLight() {
lightIndex = (lightIndex + 1) % TRAFFIC_LIGHTS.length;
}
return <>
<button onClick={nextLight}>"Next light"</button>
<p>"Light is "{light}</p>
<p>
"You must "
if (light === "red") {
<span>"STOP"</span>
} else if (light === "orange") {
<span>"SLOW DOWN"</span>
} else if (light === "green") {
<span>"GO"</span>
}
</p>
</>;
}
Lifecycle
On mount
<let/pageTitle="">
<script>pageTitle = document.title</script>
<p>Page title: ${pageTitle}</p>
On unmount
<let/time=new Date()>
<script>
const id = setInterval(() => time = new Date(), 1000);
$signal.onabort = () => clearInterval(id)
</script>
<p>Current time: ${time.toLocaleTimeString()}</p>
import { effect, track } from "ripple";
export default function Time() {
let &[time] = track(new Date().toLocaleTimeString());
effect(() => {
const timer = setInterval(() => {
time = new Date().toLocaleTimeString();
}, 1000);
return () => clearInterval(timer);
});
return <h1>"Current time: "{time}</h1>;
}
Component composition
Props
Emit to parent
<let/isHappy=true>
<p>Are you happy?</p>
<AnswerButton
onYes() { isHappy = true }
onNo() { isHappy = false }
/>
<p style={ "font-size": 50 }>${isHappy ? "😀" : "😥"}</p>
import { track } from "ripple";
import { AnswerButton } from "./AnswerButton.tsrx";
export function App() {
let &[isHappy] = track(true);
function onAnswerNo() {
isHappy = false;
}
function onAnswerYes() {
isHappy = true;
}
return <>
<p>"Are you happy?"</p>
<AnswerButton onYes={onAnswerYes} onNo={onAnswerNo} />
<p style={{ fontSize: "50px" }}>{isHappy ? "😀" : "😥"}</p>
</>;
}
Slot
Slot fallback
Context
<let/user={
id: 1,
username: "unicorn42",
email: "[email protected]",
}>
<const/updateUsername(newUsername) {
user = { ...user, username: newUsername };
}>
<h1>Welcome back, ${user.username}</h1>
<context={ ...user, updateUsername }>
<UserProfile />
</context>
import { RippleObject } from "ripple";
import { UserContext } from "./UserContext.tsrx";
import { UserProfile } from "./UserProfile.tsrx";
export function App() {
const user = new RippleObject({
id: 1,
username: "unicorn42",
email: "[email protected]",
});
UserContext.set(user);
return <>
<h1>"Welcome back, "{user.username}</h1>
<UserProfile />
</>;
}
Form input
Input text
Checkbox
<input#is-available
type="checkbox"
checked:=input.isAvailable
>
<label for="is-available">Is available</label>
Radio
<let/picked="red">
<div>Picked: ${picked}</div>
<input#blue-pill
type="radio"
value="blue"
checkedValue:=picked
>
<label for="blue-pill">Blue pill</label>
<input#red-pill
type="radio"
value="red"
checkedValue:=picked
>
<label for="red-pill">Red pill</label>
import { bindGroup, track } from "ripple";
export default function PickPill() {
let &[picked, pickedTracked] = track("red");
return <>
<div>"Picked: "{picked}</div>
<input
id="blue-pill"
type="radio"
value="blue"
ref={bindGroup(pickedTracked)}
/>
<label for="blue-pill">"Blue pill"</label>
<input
id="red-pill"
type="radio"
value="red"
ref={bindGroup(pickedTracked)}
/>
<label for="red-pill">"Red pill"</label>
</>;
}
Select
static const colors = [
{ id: 1, text: "red" },
{ id: 2, text: "blue" },
{ id: 3, text: "green" },
{ id: 4, text: "gray", isDisabled: true },
];
<let/selectedColorId=2>
<select value:=selectedColorId>
<for|{ id, isDisabled, text }| of=colors>
<option value=id disabled=isDisabled>
${text}
</option>
</for>
</select>
import { bindValue, track } from "ripple";
const colors = [
{ id: 1, text: "red" },
{ id: 2, text: "blue" },
{ id: 3, text: "green" },
{ id: 4, text: "gray", isDisabled: true },
];
export default function ColorSelect() {
let &[selectedColorId, selectedColorIdTracked] = track(2);
return <select ref={bindValue(selectedColorIdTracked)}>
for (const color of colors; key color.id) {
<option value={color.id} disabled={color.isDisabled}>
{color.text}
</option>
}
</select>;
}
Webapp features
Render app
Fetch data
<try>
<await|{ results: users }|=fetch("https://randomuser.me/api/?results=3").then(res => res.json())>
<ul>
<for|{ picture, name }| of=users>
<li>
<img src=picture.thumbnail alt="user">
<p>${name.first} ${name.last}</p>
</li>
</for>
</ul>
</await>
<@placeholder>
<p>Fetching users...</p>
</@placeholder>
<@catch|error|>
<p>An error occurred while fetching users</p>
</@catch>
</try>
import { useFetchUsers } from "./useFetchUsers.tsrx";
export function App() {
const data = useFetchUsers();
return <>
if (data.isLoading) {
<p>"Fetching users..."</p>
} else if (data.error) {
<p>"An error occurred while fetching users"</p>
} else if (data.users) {
<ul>
for (const user of data.users; key user.login.uuid) {
<li>
<img src={user.picture.thumbnail} alt="user" />
<p>{user.name.first}" "{user.name.last}</p>
</li>
}
</ul>
}
</>;
}