$app/forms
import { function applyAction<Success extends Record<string, unknown> | undefined, Failure extends Record<string, unknown> | undefined>(result: import("@sveltejs/kit").ActionResult<Success, Failure>): Promise<void>
This action updates the form
property of the current page with the given data and updates page.status
.
In case of an error, it redirects to the nearest error page.
applyAction, function deserialize<Success extends Record<string, unknown> | undefined, Failure extends Record<string, unknown> | undefined>(result: string): import("@sveltejs/kit").ActionResult<Success, Failure>
Use this function to deserialize the response from a form submission.
Usage:
import { deserialize } from '$app/forms';
async function handleSubmit(event) {
const response = await fetch('/form?/action', {
method: 'POST',
body: new FormData(event.target)
});
const result = deserialize(await response.text());
// ...
}
deserialize, function enhance<Success extends Record<string, unknown> | undefined, Failure extends Record<string, unknown> | undefined>(form_element: HTMLFormElement, submit?: import("@sveltejs/kit").SubmitFunction<Success, Failure>): {
destroy(): void;
}
This action enhances a <form>
element that otherwise would work without JavaScript.
The submit
function is called upon submission with the given FormData and the action
that should be triggered.
If cancel
is called, the form will not be submitted.
You can use the abort controller
to cancel the submission in case another one starts.
If a function is returned, that function is called with the response from the server.
If nothing is returned, the fallback will be used.
If this function or its return value isn’t set, it
- falls back to updating the
form
prop with the returned data if the action is on the same page as the form
- updates
page.status
- resets the
<form>
element and invalidates all data in case of successful submission with no redirect response
- redirects in case of a redirect response
- redirects to the nearest error page in case of an unexpected error
If you provide a custom function with a callback and want to use the default behavior, invoke update
in your callback.
It accepts an options object
reset: false
if you don’t want the <form>
values to be reset after a successful submission
invalidateAll: false
if you don’t want the action to call invalidateAll
after submission
enhance } from '$app/forms';
applyAction
Cette action met à jour la propriété form
de la page courante avec les données correspondantes et
met à jour page.status
.
Dans le cas d’une erreur, elle redirige vers la page d’erreur la plus proche.
function applyAction<
Success extends Record<string, unknown> | undefined,
Failure extends Record<string, unknown> | undefined
>(
result: import('@sveltejs/kit').ActionResult<
Success,
Failure
>
): Promise<void>;
deserialize
Utilisez cette fonction pour désérialiser la réponse à une soumission de formulaire.
Usage:
import { function deserialize<Success extends Record<string, unknown> | undefined, Failure extends Record<string, unknown> | undefined>(result: string): import("@sveltejs/kit").ActionResult<Success, Failure>
Use this function to deserialize the response from a form submission.
Usage:
import { deserialize } from '$app/forms';
async function handleSubmit(event) {
const response = await fetch('/form?/action', {
method: 'POST',
body: new FormData(event.target)
});
const result = deserialize(await response.text());
// ...
}
deserialize } from '$app/forms';
async function function handleSubmit(event: any): Promise<void>
handleSubmit(event: any
event) {
const const response: Response
response = await function fetch(input: string | URL | globalThis.Request, init?: RequestInit): Promise<Response> (+1 overload)
fetch('/form?/action', {
RequestInit.method?: string | undefined
A string to set request’s method.
method: 'POST',
RequestInit.body?: BodyInit | null | undefined
A BodyInit object or null to set request’s body.
body: new var FormData: new (form?: HTMLFormElement, submitter?: HTMLElement | null) => FormData
Provides a way to easily construct a set of key/value pairs representing form fields and their values, which can then be easily sent using the XMLHttpRequest.send() method. It uses the same format a form would use if the encoding type were set to “multipart/form-data”.
FormData(event: any
event.target)
});
const const result: ActionResult<Record<string, unknown> | undefined, Record<string, unknown> | undefined>
result = deserialize<Record<string, unknown> | undefined, Record<string, unknown> | undefined>(result: string): ActionResult<Record<string, unknown> | undefined, Record<string, unknown> | undefined>
Use this function to deserialize the response from a form submission.
Usage:
import { deserialize } from '$app/forms';
async function handleSubmit(event) {
const response = await fetch('/form?/action', {
method: 'POST',
body: new FormData(event.target)
});
const result = deserialize(await response.text());
// ...
}
deserialize(await const response: Response
response.Body.text(): Promise<string>
text());
// ...
}
function deserialize<
Success extends Record<string, unknown> | undefined,
Failure extends Record<string, unknown> | undefined
>(
result: string
): import('@sveltejs/kit').ActionResult<Success, Failure>;
enhance
Cette action améliore un élément <form>
sans laquelle il ne pourrait pas fonctionner en l’absence
de JavaScript.
La fonction submit
est appelée à la soumission avec le FormData
fourni et l’action
qui devrait
être déclenchée.
Si cancel
est appelée, le formulaire ne sera pas soumis.
Vous pouvez utiliser le controller
d’annulation pour annuler la soumission dans le cas où une
autre soumission démarré.
Si une fonction est renvoyée, cette fonction est appelée avec la réponse venant du serveur.
Si rien n’est renvoyé, le comportement par défaut sera utilisé.
Si cette fonction ou sa valeur de retour ne sont pas définies, enhance
va
- par défaut mettre à jour la prop
form
avec les données renvoyées si l’action est sur la même page que le formulaire - mettre à jour
page.status
- réinitialiser l’élément
<form>
et invalider toutes les données en cas de soumission réussie sans réponse de redirection - rediriger dans le cas d’une réponse de redirection
- rediriger vers la page d’erreur la plus proche dans le cas d’une erreur inattendue
Si vous fournissez une fonction personnalisée avec un callback et souhaitez utiliser le comportement
par défaut, invoquez la fonction update
dans votre callback.
Elle accepte un objet d’options
reset: false
si vous ne voulez pas que les valeurs de l’élément<form>
soient réinitialisées après une soumission réussieinvalidateAll: false
si vous ne voulez pas que l’action appelleinvalidateAll
après la soumission
function enhance<
Success extends Record<string, unknown> | undefined,
Failure extends Record<string, unknown> | undefined
>(
form_element: HTMLFormElement,
submit?: import('@sveltejs/kit').SubmitFunction<
Success,
Failure
>
): {
destroy(): void;
};
Modifier cette page sur Github llms.txt