> For the complete documentation index, see [llms.txt](https://docs.runrunweb.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.runrunweb.net/widgets/widget-form.md).

# \<rrw:form>

```markup
<rrw:form id="myform" data-rrw-recipient="recipient@address.email">
    <label for="fullname">Nom</label>
		<input type="text" name="fullname" data-rrw-validator="notempty" data-rrw-name="Expediteur">
    
    <label for="email">Email</label>
		<input type="email" name="email" data-rrw-validator="email" data-rrw-name="Email de l'expediteur">

    <label for="message">Message</label>
		<textarea name="message" rows="3" data-rrw-validator="notempty" data-rrw-name="Message"></textarea>

    <button type="submit" class="submit btn btn-default pull-right">Envoyer</button>
</rrw:form>
```

Les attributs disponibles sont :

* `id="xxx"`  **\[obligatoire]** L'identifiant unique du widget Form, caractères alphanumériques uniquement.
* `data-rrw-recipient="xxx"` **\[obligatoire]** définit l'adresse email du destinataire lors de l'envoi d'un formulaire.
* `data-rrw-sender="xxx"` *\[facultatif]* le nom du champ \<input> (la valeur de son attribut name) qui contient l'adresse email de l'expéditeur du formulaire. Cela permet de définir l'adresse de réponse à un formulaire directement à l'email émetteur.
* `data-rrw-subject="xxx"` *\[facultatif]* le sujet de l'email envoyé par le formulaire.
* `data-rrw-success="xxx"` *\[facultatif]* le message affiché si l'envoi du formulaire a réussi.
* `data-rrw-error="xxx"` *\[facultatif]* le message affiché si l'envoi du formulaire a échoué.

Lors de l'envoi d'un formulaire, RunRunWeb génère un email envoyé à l'adresse définit dans l'attribut `data-rrw-recipient` et qui contient chaque champ définit dans une balise `<input>`, `<select>` ou `<textarea>`.\
Par défaut c'est l'attribut name qui nomme la valeur du champ. L'attribut `data-rrw-name` permet de définir un nom plus explicite. Par ailleurs l'attribut `data-rrw-validator` permet de définir des règles sur la valeur du champ, `email` pour une adresse e-mail et `notempty` pour obliger un champ non vide.