From 3510e9627732d3366a53559caef881a11999f285 Mon Sep 17 00:00:00 2001 From: Nivaldo Farias Date: Thu, 20 Mar 2025 12:03:59 -0300 Subject: [PATCH 01/20] Translate `useActionState.md` to Portuguese --- src/content/reference/react/useActionState.md | 75 +++++++++---------- 1 file changed, 37 insertions(+), 38 deletions(-) diff --git a/src/content/reference/react/useActionState.md b/src/content/reference/react/useActionState.md index f83f6bdc7..eda2773bc 100644 --- a/src/content/reference/react/useActionState.md +++ b/src/content/reference/react/useActionState.md @@ -4,7 +4,7 @@ title: useActionState -`useActionState` is a Hook that allows you to update state based on the result of a form action. +`useActionState` é um Hook que permite que você atualize o estado com base no resultado de uma action de formulário. ```js const [state, formAction, isPending] = useActionState(fn, initialState, permalink?); @@ -14,22 +14,21 @@ const [state, formAction, isPending] = useActionState(fn, initialState, permalin -In earlier React Canary versions, this API was part of React DOM and called `useFormState`. +Em versões anteriores do React Canary, esta API fazia parte do React DOM e era chamada de `useFormState`. - --- -## Reference {/*reference*/} +## Referência {/*reference*/} ### `useActionState(action, initialState, permalink?)` {/*useactionstate*/} {/* TODO T164397693: link to actions documentation once it exists */} -Call `useActionState` at the top level of your component to create component state that is updated [when a form action is invoked](/reference/react-dom/components/form). You pass `useActionState` an existing form action function as well as an initial state, and it returns a new action that you use in your form, along with the latest form state and whether the Action is still pending. The latest form state is also passed to the function that you provided. +Chame `useActionState` no nível raiz do seu componente para criar um estado de componente que é atualizado [quando uma action de formulário é invocada](/reference/react-dom/components/form). Você passa para o `useActionState` uma função de action de formulário existente, bem como um estado inicial, e ele retorna uma nova action que você usa no seu formulário, juntamente com o estado atual do formulário e se a Action ainda está pendente. O estado atual do formulário também é passado para a função que você forneceu. ```js import { useActionState } from "react"; @@ -49,40 +48,40 @@ function StatefulForm({}) { } ``` -The form state is the value returned by the action when the form was last submitted. If the form has not yet been submitted, it is the initial state that you pass. +O estado do formulário é o valor retornado pela action quando o formulário foi enviado pela última vez. Se o formulário ainda não foi enviado, é o estado inicial que você passa. -If used with a Server Function, `useActionState` allows the server's response from submitting the form to be shown even before hydration has completed. +Se usado com uma Server Function, `useActionState` permite que a resposta do servidor do envio do formulário seja exibida mesmo antes da conclusão da hidratação. -[See more examples below.](#usage) +[Veja mais exemplos abaixo.](#usage) -#### Parameters {/*parameters*/} +#### Parâmetros {/*parameters*/} -* `fn`: The function to be called when the form is submitted or button pressed. When the function is called, it will receive the previous state of the form (initially the `initialState` that you pass, subsequently its previous return value) as its initial argument, followed by the arguments that a form action normally receives. -* `initialState`: The value you want the state to be initially. It can be any serializable value. This argument is ignored after the action is first invoked. -* **optional** `permalink`: A string containing the unique page URL that this form modifies. For use on pages with dynamic content (eg: feeds) in conjunction with progressive enhancement: if `fn` is a [server function](/reference/rsc/server-functions) and the form is submitted before the JavaScript bundle loads, the browser will navigate to the specified permalink URL, rather than the current page's URL. Ensure that the same form component is rendered on the destination page (including the same action `fn` and `permalink`) so that React knows how to pass the state through. Once the form has been hydrated, this parameter has no effect. +* `fn`: A função a ser chamada quando o formulário é enviado ou o botão pressionado. Quando a função é chamada, ela receberá o estado anterior do formulário (inicialmente o `initialState` que você passa, subsequentemente seu valor de retorno anterior) como seu primeiro argumento, seguido pelos argumentos que uma ação de formulário normalmente recebe. +* `initialState`: O valor que você deseja que o estado seja inicialmente. Pode ser qualquer valor serializável. Este argumento é ignorado depois que a action é invocada pela primeira vez. +* **opcional** `permalink`: Uma `string` que contém a URL exclusiva da página que este formulário modifica. Para uso em páginas com conteúdo dinâmico (por exemplo: feeds) em conjunto com aprimoramento progressivo: se `fn` é uma [server function](/reference/rsc/server-functions) e o formulário é enviado antes que o bundle JavaScript seja carregado, o navegador navegará para a URL da permalink especificada, em vez da URL da página atual. Certifique-se de que o mesmo componente de formulário seja renderizado na página de destino (incluindo a mesma `action fn` e `permalink`) para que React saiba como passar o state. Depois que o formulário for hidratado, este parâmetro não terá efeito. {/* TODO T164397693: link to serializable values docs once it exists */} -#### Returns {/*returns*/} +#### Retorna {/*returns*/} -`useActionState` returns an array with the following values: +`useActionState` retorna um array com os seguintes valores: -1. The current state. During the first render, it will match the `initialState` you have passed. After the action is invoked, it will match the value returned by the action. -2. A new action that you can pass as the `action` prop to your `form` component or `formAction` prop to any `button` component within the form. The action can also be called manually within [`startTransition`](/reference/react/startTransition). -3. The `isPending` flag that tells you whether there is a pending Transition. +1. O estado atual. Durante a primeira renderização, ele corresponderá ao `initialState` que você passou. Depois que a action for invocada, ele corresponderá ao valor retornado pela action. +2. Uma nova action que você pode passar como a prop `action` para seu componente `form` ou a prop `formAction` para qualquer componente `button` dentro do formulário. A action também pode ser chamada manualmente dentro de [`startTransition`](/reference/react/startTransition). +3. A flag `isPending` que informa se existe uma Transition pendente. -#### Caveats {/*caveats*/} +#### Ressalvas {/*caveats*/} -* When used with a framework that supports React Server Components, `useActionState` lets you make forms interactive before JavaScript has executed on the client. When used without Server Components, it is equivalent to component local state. -* The function passed to `useActionState` receives an extra argument, the previous or initial state, as its first argument. This makes its signature different than if it were used directly as a form action without using `useActionState`. +* Quando usado com um framework que oferece suporte a React Server Components, `useActionState` permite que você torne os formulários interativos antes que o JavaScript tenha sido executado no cliente. Quando usado sem Server Components, é equivalente ao estado local do componente. +* A função passada para `useActionState` recebe um argumento extra, o estado anterior ou inicial, como seu primeiro argumento. Isso torna sua assinatura diferente do que se fosse usado diretamente como uma action de formulário sem usar `useActionState`. --- -## Usage {/*usage*/} +## Uso {/*usage*/} -### Using information returned by a form action {/*using-information-returned-by-a-form-action*/} +### Usando informações retornadas por uma action de formulário {/*using-information-returned-by-a-form-action*/} -Call `useActionState` at the top level of your component to access the return value of an action from the last time a form was submitted. +Chame `useActionState` no nível raiz do seu componente para acessar o valor de retorno de uma action da última vez que um formulário foi enviado. ```js [[1, 5, "state"], [2, 5, "formAction"], [3, 5, "action"], [4, 5, "null"], [2, 8, "formAction"]] import { useActionState } from 'react'; @@ -99,15 +98,15 @@ function MyComponent() { } ``` -`useActionState` returns an array with the following items: +`useActionState` retorna um array com os seguintes itens: -1. The current state of the form, which is initially set to the initial state you provided, and after the form is submitted is set to the return value of the action you provided. -2. A new action that you pass to `
` as its `action` prop or call manually within `startTransition`. -3. A pending state that you can utilise while your action is processing. +1. O estado atual do formulário, que é inicialmente definido como o estado inicial que você forneceu e, após o formulário ser enviado, é definido como o valor de retorno da action que você forneceu. +2. Uma nova action que você passa para o `` como sua prop `action` ou chama manualmente dentro de `startTransition`. +3. Um estado pendente que você pode utilizar enquanto sua action está processando. -When the form is submitted, the action function that you provided will be called. Its return value will become the new current state of the form. +Quando o formulário é enviado, a função action que você forneceu será chamada. Seu valor de retorno se tornará o novo estado atual do formulário. -The action that you provide will also receive a new first argument, namely the current state of the form. The first time the form is submitted, this will be the initial state you provided, while with subsequent submissions, it will be the return value from the last time the action was called. The rest of the arguments are the same as if `useActionState` had not been used. +A action que você fornece também receberá um novo primeiro argumento, ou seja, o estado atual do formulário. Na primeira vez que o formulário for enviado, este será o estado inicial que você forneceu, enquanto com envios subsequentes, será o valor de retorno da última vez que a action foi chamada. O restante dos argumentos são os mesmos de se `useActionState` não tivesse sido usado. ```js [[3, 1, "action"], [1, 1, "currentState"]] function action(currentState, formData) { @@ -116,11 +115,11 @@ function action(currentState, formData) { } ``` - + -#### Display form errors {/*display-form-errors*/} +#### Exibir erros de formulário {/*display-form-errors*/} -To display messages such as an error message or toast that's returned by a Server Function, wrap the action in a call to `useActionState`. +Para exibir mensagens como uma mensagem de erro ou toast que é retornado por uma Server Function, envolva a action em uma chamada para `useActionState`. @@ -182,9 +181,9 @@ form button { -#### Display structured information after submitting a form {/*display-structured-information-after-submitting-a-form*/} +#### Exibir informações estruturadas após o envio de um formulário {/*display-structured-information-after-submitting-a-form*/} -The return value from a Server Function can be any serializable value. For example, it could be an object that includes a boolean indicating whether the action was successful, an error message, or updated information. +O valor de retorno de uma Server Function pode ser qualquer valor serializável. Por exemplo, pode ser um objeto que inclui um booleano indicando se a action foi bem-sucedida, uma mensagem de erro ou informações atualizadas. @@ -259,14 +258,14 @@ form button { -## Troubleshooting {/*troubleshooting*/} +## Solução de problemas {/*troubleshooting*/} -### My action can no longer read the submitted form data {/*my-action-can-no-longer-read-the-submitted-form-data*/} +### Minha action não consegue mais ler os dados do formulário enviado {/*my-action-can-no-longer-read-the-submitted-form-data*/} -When you wrap an action with `useActionState`, it gets an extra argument *as its first argument*. The submitted form data is therefore its *second* argument instead of its first as it would usually be. The new first argument that gets added is the current state of the form. +Quando você envolve uma action com `useActionState`, ela recebe um argumento extra *como seu primeiro argumento*. Os dados do formulário enviado são, portanto, seu *segundo* argumento em vez de seu primeiro, como seria normalmente. O novo primeiro argumento que é adicionado é o estado atual do formulário. ```js function action(currentState, formData) { // ... } -``` +``` \ No newline at end of file From eeef5a189439fb11229850b4fba60a9e7ed5b52a Mon Sep 17 00:00:00 2001 From: Jhon Mike Date: Tue, 22 Apr 2025 02:58:02 -0300 Subject: [PATCH 02/20] Update src/content/reference/react/useActionState.md Co-authored-by: Fabiano Leite --- src/content/reference/react/useActionState.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/content/reference/react/useActionState.md b/src/content/reference/react/useActionState.md index eda2773bc..4bf479bcf 100644 --- a/src/content/reference/react/useActionState.md +++ b/src/content/reference/react/useActionState.md @@ -4,7 +4,7 @@ title: useActionState -`useActionState` é um Hook que permite que você atualize o estado com base no resultado de uma action de formulário. +`useActionState` é um Hook que permite que você atualize o estado com base no resultado de uma ação de formulário. ```js const [state, formAction, isPending] = useActionState(fn, initialState, permalink?); From e60b3f94abfe51abe4db8c06a374dfebe172ccd0 Mon Sep 17 00:00:00 2001 From: Jhon Mike Date: Tue, 22 Apr 2025 02:58:16 -0300 Subject: [PATCH 03/20] Update src/content/reference/react/useActionState.md Co-authored-by: Fabiano Leite --- src/content/reference/react/useActionState.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/content/reference/react/useActionState.md b/src/content/reference/react/useActionState.md index 4bf479bcf..16e27a667 100644 --- a/src/content/reference/react/useActionState.md +++ b/src/content/reference/react/useActionState.md @@ -28,7 +28,7 @@ Em versões anteriores do React Canary, esta API fazia parte do React DOM e era {/* TODO T164397693: link to actions documentation once it exists */} -Chame `useActionState` no nível raiz do seu componente para criar um estado de componente que é atualizado [quando uma action de formulário é invocada](/reference/react-dom/components/form). Você passa para o `useActionState` uma função de action de formulário existente, bem como um estado inicial, e ele retorna uma nova action que você usa no seu formulário, juntamente com o estado atual do formulário e se a Action ainda está pendente. O estado atual do formulário também é passado para a função que você forneceu. +Chame `useActionState` no nível superior do seu componente para criar um estado do componente que é atualizado [quando uma ação de formulário é invocada](/reference/react-dom/components/form). Você passa para o `useActionState` uma função de ação de formulário existente, bem como um estado inicial, e ele retorna uma nova ação que você usa no seu formulário, juntamente com o estado atual do formulário e se a ação ainda está pendente. O estado atual do formulário também é passado para a função que você forneceu. ```js import { useActionState } from "react"; From 973daf2bfc55ac1c493e6c19be61f12935eec872 Mon Sep 17 00:00:00 2001 From: Jhon Mike Date: Tue, 22 Apr 2025 02:58:24 -0300 Subject: [PATCH 04/20] Update src/content/reference/react/useActionState.md Co-authored-by: Fabiano Leite --- src/content/reference/react/useActionState.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/content/reference/react/useActionState.md b/src/content/reference/react/useActionState.md index 16e27a667..210596a07 100644 --- a/src/content/reference/react/useActionState.md +++ b/src/content/reference/react/useActionState.md @@ -48,7 +48,7 @@ function StatefulForm({}) { } ``` -O estado do formulário é o valor retornado pela action quando o formulário foi enviado pela última vez. Se o formulário ainda não foi enviado, é o estado inicial que você passa. +O estado do formulário é o valor retornado pela ação quando o formulário foi enviado pela última vez. Se o formulário ainda não foi enviado, é o estado inicial que você passa. Se usado com uma Server Function, `useActionState` permite que a resposta do servidor do envio do formulário seja exibida mesmo antes da conclusão da hidratação. From 1ad01fe741eb00393315c06a336e23aebec9374d Mon Sep 17 00:00:00 2001 From: Jhon Mike Date: Tue, 22 Apr 2025 02:58:34 -0300 Subject: [PATCH 05/20] Update src/content/reference/react/useActionState.md Co-authored-by: Fabiano Leite --- src/content/reference/react/useActionState.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/content/reference/react/useActionState.md b/src/content/reference/react/useActionState.md index 210596a07..763b09b12 100644 --- a/src/content/reference/react/useActionState.md +++ b/src/content/reference/react/useActionState.md @@ -50,7 +50,7 @@ function StatefulForm({}) { O estado do formulário é o valor retornado pela ação quando o formulário foi enviado pela última vez. Se o formulário ainda não foi enviado, é o estado inicial que você passa. -Se usado com uma Server Function, `useActionState` permite que a resposta do servidor do envio do formulário seja exibida mesmo antes da conclusão da hidratação. +Quando usado com uma Função de Servidor, `useActionState` permite que a resposta do servidor ao enviar o formulário seja exibida mesmo antes da hidratação ser concluída. [Veja mais exemplos abaixo.](#usage) From 163541ae03680a8a6044d94c1a8211df05970f8e Mon Sep 17 00:00:00 2001 From: Jhon Mike Date: Tue, 22 Apr 2025 02:58:42 -0300 Subject: [PATCH 06/20] Update src/content/reference/react/useActionState.md Co-authored-by: Fabiano Leite --- src/content/reference/react/useActionState.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/content/reference/react/useActionState.md b/src/content/reference/react/useActionState.md index 763b09b12..b2c5864e6 100644 --- a/src/content/reference/react/useActionState.md +++ b/src/content/reference/react/useActionState.md @@ -57,7 +57,7 @@ Quando usado com uma Função de Servidor, `useActionState` permite que a respos #### Parâmetros {/*parameters*/} * `fn`: A função a ser chamada quando o formulário é enviado ou o botão pressionado. Quando a função é chamada, ela receberá o estado anterior do formulário (inicialmente o `initialState` que você passa, subsequentemente seu valor de retorno anterior) como seu primeiro argumento, seguido pelos argumentos que uma ação de formulário normalmente recebe. -* `initialState`: O valor que você deseja que o estado seja inicialmente. Pode ser qualquer valor serializável. Este argumento é ignorado depois que a action é invocada pela primeira vez. +* `initialState`: O valor que você deseja que o estado seja inicialmente. Pode ser qualquer valor serializável. Este argumento é ignorado depois que a ação é invocada pela primeira vez. * **opcional** `permalink`: Uma `string` que contém a URL exclusiva da página que este formulário modifica. Para uso em páginas com conteúdo dinâmico (por exemplo: feeds) em conjunto com aprimoramento progressivo: se `fn` é uma [server function](/reference/rsc/server-functions) e o formulário é enviado antes que o bundle JavaScript seja carregado, o navegador navegará para a URL da permalink especificada, em vez da URL da página atual. Certifique-se de que o mesmo componente de formulário seja renderizado na página de destino (incluindo a mesma `action fn` e `permalink`) para que React saiba como passar o state. Depois que o formulário for hidratado, este parâmetro não terá efeito. {/* TODO T164397693: link to serializable values docs once it exists */} From 56fdb3339e9a8d8ccfe30c12cbe57aa88add04e2 Mon Sep 17 00:00:00 2001 From: Jhon Mike Date: Tue, 22 Apr 2025 02:59:11 -0300 Subject: [PATCH 07/20] Update src/content/reference/react/useActionState.md Co-authored-by: Fabiano Leite --- src/content/reference/react/useActionState.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/content/reference/react/useActionState.md b/src/content/reference/react/useActionState.md index b2c5864e6..9f1bb1bb8 100644 --- a/src/content/reference/react/useActionState.md +++ b/src/content/reference/react/useActionState.md @@ -62,7 +62,7 @@ Quando usado com uma Função de Servidor, `useActionState` permite que a respos {/* TODO T164397693: link to serializable values docs once it exists */} -#### Retorna {/*returns*/} +#### Retornos {/*returns*/} `useActionState` retorna um array com os seguintes valores: From f914fe525e57d71edb2044cec3fbfcd3bd7dafc3 Mon Sep 17 00:00:00 2001 From: Jhon Mike Date: Tue, 22 Apr 2025 02:59:29 -0300 Subject: [PATCH 08/20] Update src/content/reference/react/useActionState.md Co-authored-by: Fabiano Leite --- src/content/reference/react/useActionState.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/content/reference/react/useActionState.md b/src/content/reference/react/useActionState.md index 9f1bb1bb8..b038d3b02 100644 --- a/src/content/reference/react/useActionState.md +++ b/src/content/reference/react/useActionState.md @@ -58,7 +58,7 @@ Quando usado com uma Função de Servidor, `useActionState` permite que a respos * `fn`: A função a ser chamada quando o formulário é enviado ou o botão pressionado. Quando a função é chamada, ela receberá o estado anterior do formulário (inicialmente o `initialState` que você passa, subsequentemente seu valor de retorno anterior) como seu primeiro argumento, seguido pelos argumentos que uma ação de formulário normalmente recebe. * `initialState`: O valor que você deseja que o estado seja inicialmente. Pode ser qualquer valor serializável. Este argumento é ignorado depois que a ação é invocada pela primeira vez. -* **opcional** `permalink`: Uma `string` que contém a URL exclusiva da página que este formulário modifica. Para uso em páginas com conteúdo dinâmico (por exemplo: feeds) em conjunto com aprimoramento progressivo: se `fn` é uma [server function](/reference/rsc/server-functions) e o formulário é enviado antes que o bundle JavaScript seja carregado, o navegador navegará para a URL da permalink especificada, em vez da URL da página atual. Certifique-se de que o mesmo componente de formulário seja renderizado na página de destino (incluindo a mesma `action fn` e `permalink`) para que React saiba como passar o state. Depois que o formulário for hidratado, este parâmetro não terá efeito. +* **opcional** `permalink`: Uma string contendo a URL exclusiva da página que este formulário modifica. Para uso em páginas com conteúdo dinâmico (por exemplo: feeds) em conjunto com aprimoramento progressivo: se `fn` é uma [função de servidor](/reference/rsc/server-functions) e o formulário é enviado antes do carregamento do bundle JavaScript, o navegador navegará para a URL de permalink especificada, em vez da URL da página atual. Garanta que o mesmo componente de formulário seja renderizado na página de destino (incluindo a mesma `fn` de ação e `permalink`) para que o React saiba como passar o estado. Uma vez que o formulário tenha sido hidratado, este parâmetro não tem efeito. {/* TODO T164397693: link to serializable values docs once it exists */} From 8ca15430665ab705e5abdf345d8f2a1878097df5 Mon Sep 17 00:00:00 2001 From: Jhon Mike Date: Tue, 22 Apr 2025 02:59:36 -0300 Subject: [PATCH 09/20] Update src/content/reference/react/useActionState.md Co-authored-by: Fabiano Leite --- src/content/reference/react/useActionState.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/content/reference/react/useActionState.md b/src/content/reference/react/useActionState.md index b038d3b02..6cbd5c4ed 100644 --- a/src/content/reference/react/useActionState.md +++ b/src/content/reference/react/useActionState.md @@ -67,7 +67,7 @@ Quando usado com uma Função de Servidor, `useActionState` permite que a respos `useActionState` retorna um array com os seguintes valores: 1. O estado atual. Durante a primeira renderização, ele corresponderá ao `initialState` que você passou. Depois que a action for invocada, ele corresponderá ao valor retornado pela action. -2. Uma nova action que você pode passar como a prop `action` para seu componente `form` ou a prop `formAction` para qualquer componente `button` dentro do formulário. A action também pode ser chamada manualmente dentro de [`startTransition`](/reference/react/startTransition). +2. Uma nova ação que você pode passar como a prop `action` para seu componente `form` ou a prop `formAction` para qualquer componente `button` dentro do formulário. A ação também pode ser chamada manualmente dentro de [`startTransition`](/reference/react/startTransition). 3. A flag `isPending` que informa se existe uma Transition pendente. #### Ressalvas {/*caveats*/} From 3b3595c925bea8498d93b00f211509538ea4416e Mon Sep 17 00:00:00 2001 From: Jhon Mike Date: Tue, 22 Apr 2025 02:59:45 -0300 Subject: [PATCH 10/20] Update src/content/reference/react/useActionState.md Co-authored-by: Fabiano Leite --- src/content/reference/react/useActionState.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/content/reference/react/useActionState.md b/src/content/reference/react/useActionState.md index 6cbd5c4ed..82e45c5d0 100644 --- a/src/content/reference/react/useActionState.md +++ b/src/content/reference/react/useActionState.md @@ -73,7 +73,7 @@ Quando usado com uma Função de Servidor, `useActionState` permite que a respos #### Ressalvas {/*caveats*/} * Quando usado com um framework que oferece suporte a React Server Components, `useActionState` permite que você torne os formulários interativos antes que o JavaScript tenha sido executado no cliente. Quando usado sem Server Components, é equivalente ao estado local do componente. -* A função passada para `useActionState` recebe um argumento extra, o estado anterior ou inicial, como seu primeiro argumento. Isso torna sua assinatura diferente do que se fosse usado diretamente como uma action de formulário sem usar `useActionState`. +* A função passada para `useActionState` recebe um argumento extra, o estado anterior ou inicial, como seu primeiro argumento. Isso torna sua assinatura diferente do que se fosse usado diretamente como uma ação de formulário sem usar `useActionState`. --- From d8803e560fe6a8fc84f199d4df78b9348cd0475a Mon Sep 17 00:00:00 2001 From: Jhon Mike Date: Tue, 22 Apr 2025 02:59:54 -0300 Subject: [PATCH 11/20] Update src/content/reference/react/useActionState.md Co-authored-by: Fabiano Leite --- src/content/reference/react/useActionState.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/content/reference/react/useActionState.md b/src/content/reference/react/useActionState.md index 82e45c5d0..bbca764b3 100644 --- a/src/content/reference/react/useActionState.md +++ b/src/content/reference/react/useActionState.md @@ -79,7 +79,7 @@ Quando usado com uma Função de Servidor, `useActionState` permite que a respos ## Uso {/*usage*/} -### Usando informações retornadas por uma action de formulário {/*using-information-returned-by-a-form-action*/} +### Usando informações retornadas por uma ação de formulário {/*using-information-returned-by-a-form-action*/} Chame `useActionState` no nível raiz do seu componente para acessar o valor de retorno de uma action da última vez que um formulário foi enviado. From 2d0860a132850bf5cfeeced42895868867f9b0ef Mon Sep 17 00:00:00 2001 From: Jhon Mike Date: Tue, 22 Apr 2025 03:00:01 -0300 Subject: [PATCH 12/20] Update src/content/reference/react/useActionState.md Co-authored-by: Fabiano Leite --- src/content/reference/react/useActionState.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/content/reference/react/useActionState.md b/src/content/reference/react/useActionState.md index bbca764b3..d2e55a033 100644 --- a/src/content/reference/react/useActionState.md +++ b/src/content/reference/react/useActionState.md @@ -66,7 +66,7 @@ Quando usado com uma Função de Servidor, `useActionState` permite que a respos `useActionState` retorna um array com os seguintes valores: -1. O estado atual. Durante a primeira renderização, ele corresponderá ao `initialState` que você passou. Depois que a action for invocada, ele corresponderá ao valor retornado pela action. +1. O estado atual. Durante a primeira renderização, ele corresponderá ao `initialState` que você passou. Depois que a ação for invocada, ele corresponderá ao valor retornado pela action. 2. Uma nova ação que você pode passar como a prop `action` para seu componente `form` ou a prop `formAction` para qualquer componente `button` dentro do formulário. A ação também pode ser chamada manualmente dentro de [`startTransition`](/reference/react/startTransition). 3. A flag `isPending` que informa se existe uma Transition pendente. From dbfcad0d94de8d4a8c42a02c49f5986f1e0e748b Mon Sep 17 00:00:00 2001 From: Jhon Mike Date: Tue, 22 Apr 2025 03:00:09 -0300 Subject: [PATCH 13/20] Update src/content/reference/react/useActionState.md Co-authored-by: Fabiano Leite --- src/content/reference/react/useActionState.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/content/reference/react/useActionState.md b/src/content/reference/react/useActionState.md index d2e55a033..c5e2cd38c 100644 --- a/src/content/reference/react/useActionState.md +++ b/src/content/reference/react/useActionState.md @@ -100,7 +100,7 @@ function MyComponent() { `useActionState` retorna um array com os seguintes itens: -1. O estado atual do formulário, que é inicialmente definido como o estado inicial que você forneceu e, após o formulário ser enviado, é definido como o valor de retorno da action que você forneceu. +1. O estado atual do formulário, que é inicialmente definido como o estado inicial que você forneceu e, após o formulário ser enviado, é definido como o valor de retorno da ação que você forneceu. 2. Uma nova action que você passa para o `` como sua prop `action` ou chama manualmente dentro de `startTransition`. 3. Um estado pendente que você pode utilizar enquanto sua action está processando. From 06f06e098e5883bec3b69ce822d8560914cbc2ac Mon Sep 17 00:00:00 2001 From: Jhon Mike Date: Tue, 22 Apr 2025 03:00:15 -0300 Subject: [PATCH 14/20] Update src/content/reference/react/useActionState.md Co-authored-by: Fabiano Leite --- src/content/reference/react/useActionState.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/content/reference/react/useActionState.md b/src/content/reference/react/useActionState.md index c5e2cd38c..d19d3c25d 100644 --- a/src/content/reference/react/useActionState.md +++ b/src/content/reference/react/useActionState.md @@ -102,7 +102,7 @@ function MyComponent() { 1. O estado atual do formulário, que é inicialmente definido como o estado inicial que você forneceu e, após o formulário ser enviado, é definido como o valor de retorno da ação que você forneceu. 2. Uma nova action que você passa para o `` como sua prop `action` ou chama manualmente dentro de `startTransition`. -3. Um estado pendente que você pode utilizar enquanto sua action está processando. +3. Um estado pendente que você pode utilizar enquanto sua ação está processando. Quando o formulário é enviado, a função action que você forneceu será chamada. Seu valor de retorno se tornará o novo estado atual do formulário. From b9f6262221b5c8770449d71a14702f7cbab95ea9 Mon Sep 17 00:00:00 2001 From: Jhon Mike Date: Tue, 22 Apr 2025 03:00:21 -0300 Subject: [PATCH 15/20] Update src/content/reference/react/useActionState.md Co-authored-by: Fabiano Leite --- src/content/reference/react/useActionState.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/content/reference/react/useActionState.md b/src/content/reference/react/useActionState.md index d19d3c25d..7000a1c3c 100644 --- a/src/content/reference/react/useActionState.md +++ b/src/content/reference/react/useActionState.md @@ -101,7 +101,7 @@ function MyComponent() { `useActionState` retorna um array com os seguintes itens: 1. O estado atual do formulário, que é inicialmente definido como o estado inicial que você forneceu e, após o formulário ser enviado, é definido como o valor de retorno da ação que você forneceu. -2. Uma nova action que você passa para o `` como sua prop `action` ou chama manualmente dentro de `startTransition`. +2. Uma nova ação que você passa para o `` como sua prop `action` ou chama manualmente dentro de `startTransition`. 3. Um estado pendente que você pode utilizar enquanto sua ação está processando. Quando o formulário é enviado, a função action que você forneceu será chamada. Seu valor de retorno se tornará o novo estado atual do formulário. From 00f529c912ac1b74ff9bf1ec70317179cc1248cf Mon Sep 17 00:00:00 2001 From: Jhon Mike Date: Tue, 22 Apr 2025 03:00:29 -0300 Subject: [PATCH 16/20] Update src/content/reference/react/useActionState.md Co-authored-by: Fabiano Leite --- src/content/reference/react/useActionState.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/content/reference/react/useActionState.md b/src/content/reference/react/useActionState.md index 7000a1c3c..f0f46b774 100644 --- a/src/content/reference/react/useActionState.md +++ b/src/content/reference/react/useActionState.md @@ -81,7 +81,7 @@ Quando usado com uma Função de Servidor, `useActionState` permite que a respos ### Usando informações retornadas por uma ação de formulário {/*using-information-returned-by-a-form-action*/} -Chame `useActionState` no nível raiz do seu componente para acessar o valor de retorno de uma action da última vez que um formulário foi enviado. +Chame `useActionState` no nível superior do seu componente para acessar o valor de retorno de uma action da última vez que um formulário foi enviado. ```js [[1, 5, "state"], [2, 5, "formAction"], [3, 5, "action"], [4, 5, "null"], [2, 8, "formAction"]] import { useActionState } from 'react'; From 428a91939c4cdc06dcc9fe4725a400619c569be0 Mon Sep 17 00:00:00 2001 From: Jhon Mike Date: Tue, 22 Apr 2025 03:00:36 -0300 Subject: [PATCH 17/20] Update src/content/reference/react/useActionState.md Co-authored-by: Fabiano Leite --- src/content/reference/react/useActionState.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/content/reference/react/useActionState.md b/src/content/reference/react/useActionState.md index f0f46b774..62414b0a4 100644 --- a/src/content/reference/react/useActionState.md +++ b/src/content/reference/react/useActionState.md @@ -104,7 +104,7 @@ function MyComponent() { 2. Uma nova ação que você passa para o `` como sua prop `action` ou chama manualmente dentro de `startTransition`. 3. Um estado pendente que você pode utilizar enquanto sua ação está processando. -Quando o formulário é enviado, a função action que você forneceu será chamada. Seu valor de retorno se tornará o novo estado atual do formulário. +Quando o formulário é enviado, a função ação que você forneceu será chamada. Seu valor de retorno se tornará o novo estado atual do formulário. A action que você fornece também receberá um novo primeiro argumento, ou seja, o estado atual do formulário. Na primeira vez que o formulário for enviado, este será o estado inicial que você forneceu, enquanto com envios subsequentes, será o valor de retorno da última vez que a action foi chamada. O restante dos argumentos são os mesmos de se `useActionState` não tivesse sido usado. From 5183f82e1b51d7f9edd9902ee792052e98eaa3ff Mon Sep 17 00:00:00 2001 From: Jhon Mike Date: Tue, 22 Apr 2025 03:00:43 -0300 Subject: [PATCH 18/20] Update src/content/reference/react/useActionState.md Co-authored-by: Fabiano Leite --- src/content/reference/react/useActionState.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/content/reference/react/useActionState.md b/src/content/reference/react/useActionState.md index 62414b0a4..d57f01e5c 100644 --- a/src/content/reference/react/useActionState.md +++ b/src/content/reference/react/useActionState.md @@ -106,7 +106,7 @@ function MyComponent() { Quando o formulário é enviado, a função ação que você forneceu será chamada. Seu valor de retorno se tornará o novo estado atual do formulário. -A action que você fornece também receberá um novo primeiro argumento, ou seja, o estado atual do formulário. Na primeira vez que o formulário for enviado, este será o estado inicial que você forneceu, enquanto com envios subsequentes, será o valor de retorno da última vez que a action foi chamada. O restante dos argumentos são os mesmos de se `useActionState` não tivesse sido usado. +A ação que você fornece também receberá um novo primeiro argumento, ou seja, o estado atual do formulário. Na primeira vez que o formulário for enviado, este será o estado inicial que você forneceu, enquanto com envios subsequentes, será o valor de retorno da última vez que a action foi chamada. O restante dos argumentos são os mesmos de se `useActionState` não tivesse sido usado. ```js [[3, 1, "action"], [1, 1, "currentState"]] function action(currentState, formData) { From 6b4a840579fbaf59b887694a18cdc8ff7f5fd423 Mon Sep 17 00:00:00 2001 From: Jhon Mike Date: Tue, 22 Apr 2025 03:00:50 -0300 Subject: [PATCH 19/20] Update src/content/reference/react/useActionState.md Co-authored-by: Fabiano Leite --- src/content/reference/react/useActionState.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/content/reference/react/useActionState.md b/src/content/reference/react/useActionState.md index d57f01e5c..a66711577 100644 --- a/src/content/reference/react/useActionState.md +++ b/src/content/reference/react/useActionState.md @@ -119,7 +119,7 @@ function action(currentState, formData) { #### Exibir erros de formulário {/*display-form-errors*/} -Para exibir mensagens como uma mensagem de erro ou toast que é retornado por uma Server Function, envolva a action em uma chamada para `useActionState`. +Para exibir mensagens como uma mensagem de erro ou toast que é retornado por uma Server Function, envolva a ação em uma chamada para `useActionState`. From 602fb2f2bf0bd8b80812ddd293641610ff8d5c84 Mon Sep 17 00:00:00 2001 From: Jhon Mike Date: Tue, 22 Apr 2025 03:00:55 -0300 Subject: [PATCH 20/20] Update src/content/reference/react/useActionState.md Co-authored-by: Fabiano Leite --- src/content/reference/react/useActionState.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/content/reference/react/useActionState.md b/src/content/reference/react/useActionState.md index a66711577..ccf3406a3 100644 --- a/src/content/reference/react/useActionState.md +++ b/src/content/reference/react/useActionState.md @@ -183,7 +183,7 @@ form button { #### Exibir informações estruturadas após o envio de um formulário {/*display-structured-information-after-submitting-a-form*/} -O valor de retorno de uma Server Function pode ser qualquer valor serializável. Por exemplo, pode ser um objeto que inclui um booleano indicando se a action foi bem-sucedida, uma mensagem de erro ou informações atualizadas. +O valor de retorno de uma Server Function pode ser qualquer valor serializável. Por exemplo, pode ser um objeto que inclui um booleano indicando se a ação foi bem-sucedida, uma mensagem de erro ou informações atualizadas.