反應伺服器功能

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