Menu
CoddyTech

Formulários em ação

Parte da seção Essenciais do Next.js do Journey de React da Coddy. Lição 30 de 47.

No HTML puro, o action de um formulário é uma URL para a qual enviar uma requisição POST. No Next.js, você pode passar uma função no lugar:

import { addItem } from './actions';

<form action={addItem}>
    <input name="text" />
    <button type="submit">Add</button>
</form>

Ao enviar, o React faz três coisas para você: impede o envio normal do navegador, que recarrega a página, reúne os campos nomeados do formulário em um objeto FormData e chama sua ação com ele.

Observe o que não está presente: nenhum onSubmit, nenhum event.preventDefault(), nenhum estado. E esta página ainda é um Server Component: a ação é um dado que está sendo passado adiante, não um manipulador de eventos, então ela atravessa a fronteira sem problemas.

Uma coisa para se preparar: o item foi salvo, mas a lista na tela ainda não vai mudar. A página já foi renderizada no servidor, e nada pediu para ela atualizar. Daqui a duas lições, você vai corrigir isso com uma linha.

challenge icon

Desafio

Iniciante

A lista de compras tem um campo de entrada e um botão, mas nada os conecta ao servidor. A ação já está escrita para você em app/actions.js.

  1. Em app/page.jsx, importe addItem de './actions'.
  2. Envolva o campo de entrada e o botão em um <form> com id="add-form".
  3. Defina action={addItem} nesse formulário.

Não altere o name="text" do campo de entrada: a ação lê o campo por esse nome.

Experimente você mesmo

import './globals.css';

export const metadata = {
    title: 'My App',
};

export default function RootLayout({ children }) {
    return (
        <html lang="en">
            <body>
                {children}
            </body>
        </html>
    );
}
quiz iconTeste seus conhecimentos

Esta lição inclui um quiz rápido. Comece a lição para respondê-lo e acompanhar seu progresso.

Todas as lições de Essenciais do Next.js