---
title: Events and forms
description: "Respond to clicks and keys with on… attributes, keep form fields in state, and send a form."
section: Learn
order: 5
---

# Events and forms

Events are attributes that start with `on`. A form field shows a value from state and changes it as it's typed in.

**In this lesson**

- how to respond to a click or a key;
- how to keep a field in step with state;
- how to work with switches, checkboxes and choices;
- how to send a form.

## Events

```tsx try
import { useState } from "react";
import { Button } from "@/components/ui/button";

export default function App() {
  const [said, setSaid] = useState("Nothing yet.");
  return (
    <div className="grid gap-3" onKeyDown={(e) => setSaid(`You pressed ${e.key}.`)} tabIndex={0}>
      <div className="flex gap-2">
        <Button onClick={() => setSaid("You clicked.")}>Click</Button>
        <Button variant="outline" onDoubleClick={() => setSaid("You double-clicked.")}>Double-click</Button>
      </div>
      <p className="text-sm text-muted-foreground">{said} (Focus here and press a key.)</p>
    </div>
  );
}
```

The handler gets the event: `e.key`, `e.target`, `e.preventDefault()`. Hand over a function, `onClick={() => save()}`, not its result: `onClick={save()}` would run it while drawing.

## Fields that follow state

A field shows what state holds, and changes it as it's typed in:

```tsx try
import { useState } from "react";
import { Input } from "@/components/ui/input";
import { Label } from "@/components/ui/label";

export default function App() {
  const [name, setName] = useState("");
  return (
    <div className="grid gap-2">
      <Label htmlFor="name">Your name</Label>
      <Input id="name" value={name} onChange={(e) => setName(e.target.value)} />
      <p className="text-sm text-muted-foreground">{name ? `Hello, ${name}.` : "Type your name."}</p>
    </div>
  );
}
```

## Switches, checkboxes and choices

The components take `checked` and `onCheckedChange`, or `value` and `onValueChange`:

```tsx try
import { useState } from "react";
import { Switch } from "@/components/ui/switch";
import { Checkbox } from "@/components/ui/checkbox";
import { Label } from "@/components/ui/label";
import { RadioGroup, RadioGroupItem } from "@/components/ui/radio-group";

export default function App() {
  const [email, setEmail] = useState(true);
  const [wrap, setWrap] = useState(false);
  const [plan, setPlan] = useState("monthly");
  return (
    <div className="grid gap-3">
      <Label className="flex items-center gap-2"><Switch checked={email} onCheckedChange={setEmail} /> Email me when it ships</Label>
      <Label className="flex items-center gap-2"><Checkbox checked={wrap} onCheckedChange={setWrap} /> Gift wrap</Label>
      <RadioGroup value={plan} onValueChange={setPlan}>
        <Label className="flex items-center gap-2"><RadioGroupItem value="monthly" /> Pay monthly</Label>
        <Label className="flex items-center gap-2"><RadioGroupItem value="yearly" /> Pay yearly</Label>
      </RadioGroup>
      <p className="text-sm text-muted-foreground">{email ? "Emailed" : "Not emailed"}, {wrap ? "wrapped" : "not wrapped"}, paid {plan}.</p>
    </div>
  );
}
```

## Sending a form

`onSubmit` on the form takes Enter and the button alike. `e.preventDefault()` keeps the page where it is.

```tsx try
import { useState } from "react";
import { Button } from "@/components/ui/button";
import { Input } from "@/components/ui/input";

export default function App() {
  const [email, setEmail] = useState("");
  const [sent, setSent] = useState("");
  const send = (e) => {
    e.preventDefault();
    setSent(`We'll write to ${email}.`);
  };
  return (
    <form className="grid gap-2" onSubmit={send}>
      <Input type="email" required aria-label="Email" placeholder="you@example.com" value={email} onChange={(e) => setEmail(e.target.value)} />
      <Button type="submit">Subscribe</Button>
      {sent && <p role="status" className="text-sm">{sent}</p>}
    </form>
  );
}
```

In an app, the form sends to the server with a [`"use server"` function](/docs/server-functions) or [the client](/docs/client): `await sluurp.collection("subscribers").create({ email })`.

Next: give components values and content from outside, in [Props and children](/docs/learn/props).
