反应服务器功能

Susan Sarandon原创: 2024-12-24 17:44:14167浏览

服务器函数是在客户端引用但在服务器上执行的函数。

这是一个例子：

'use client'

import { useActionState } from "react";

import { updateName } from "@/app/react-19-server-function/actions";


export default function Page() {

    const [error, submitAction, isPending] = useActionState(
        async (_previousState, formData) => {
            const error = await updateName(formData.get("name") as string);
            if (error) {
                return error;
            }

            return ""
        },
        "",
    );

    return <div>
        <h1>React 19: Server Functions</h1>
        <fieldset>
            <div>Name</div>

            <form action={submitAction}>
                <input type="text" name="name" />

                <button type="submit" disabled={isPending}>Save</button>
            </form>

            <div>
                {error && <p>{error}</p>}
            </div>
        </fieldset>
    </div>
}

查看我之前的帖子，了解有关 useActionState 的更多详细信息

注意 updateName 是如何导入的。

import { updateName } from "@/app/react-19-server-function/actions";

并传递给useActionState。

这意味着每当提交表单时，它都会运行submitAction，然后调用updateName。

现在，让我们看看 updateName:

"use server";

export async function updateName(name) {
  if (name?.length < 2) {
    return "Name must be at least 2 characters.";
  }

  return "";
}

这是一个非常简单的函数，用于检查名称的长度。如果少于2个字符，则返回错误；否则，它返回一个空字符串，意味着没有错误。

另一件事要注意的是指令：“使用服务器”。这告诉 React 该函数将在服务器上执行，因此它创建了客户端可以使用的引用。

用户界面非常简单，如下所示：

React Server Functions