Explication détaillée de la fonction jQuery.submit()

La fonction

submit() est utilisée pour lier une fonction de gestionnaire à l'événement submit de chaque élément correspondant. Cette fonction peut également être utilisée pour déclencher l'événement de soumission. De plus, vous pouvez également transmettre des données supplémentaires à la fonction gestionnaire d'événements.

L'événement de soumission sera déclenché lorsque le formulaire sera soumis. Cet événement s'applique uniquement aux éléments

De plus, vous pouvez lier plusieurs gestionnaires d'événements en appelant cette fonction plusieurs fois pour le même élément. Lorsque l'événement de soumission est déclenché, jQuery exécutera les fonctions de traitement des événements liés dans l'ordre de liaison.

Pour supprimer un événement lié via submit(), utilisez la fonction unbind().

Cette fonction appartient à l'objet (instance) jQuery.

Syntaxe

jQueryObject.submit( [ [ data ,] handler ] )

Si au moins un paramètre est spécifié, cela signifie lier la fonction de gestionnaire de l'événement de soumission ; s'il n'est pas spécifié, tout paramètre signifie déclencher l'événement de soumission.

Paramètres

Description du paramètre

données Facultatif/tout type de données qui doivent être transmises à la fonction de traitement d'événement via event.data lorsqu'un événement est déclenché.

gestionnaire facultatif/fonction de gestion d'événements spécifiée par type de fonction.

Nouveau support de jQuery 1.4.3 : submit() prend en charge le paramètre data.

Ceci dans le gestionnaire de paramètres pointe vers l'élément DOM actuel. submit() transmettra également un paramètre au gestionnaire : l'objet Event représentant l'événement en cours.

Si la valeur de retour du gestionnaire de fonction est fausse, cela signifie empêcher le comportement par défaut de l'élément et empêcher l'événement de bouillonner dans l'arborescence DOM. Par exemple, si la fonction de gestionnaire de l'événement click du lien renvoie false, le comportement de saut d'URL par défaut du lien peut être empêché. La fonction de gestionnaire de l'événement submit du formulaire renvoie false, ce qui peut empêcher le comportement de soumission de formulaire par défaut du formulaire.

Valeur de retour

submit()La valeur de retour de la fonction est de type jQuery et renvoie l'objet jQuery actuel lui-même.

Exemple et description

Veuillez vous référer au code HTML initial suivant :

<form id="myForm" action="http://www.365mini.com" method="post">
    <input id="name" name="name" type="text" value="CodePlayer" /><br>
    <input id="age" name="age" type="text" value="20" /><br>
    <input type="submit" value="提交" />
</form>
<div id="msg"></div>

Maintenant, nous lions une fonction de gestionnaire à l'événement de soumission du element ( Plusieurs peuvent être liés et exécutés séquentiellement dans l'ordre de liaison lorsqu'ils sont déclenchés) :

$("form").submit( function(event){
    if( !$("#name").val() ){
        alert("姓名不能为空!");
        return false; // 返回值为false，将阻止表单提交
    }else if( !$("#age").val() ){
        alert("年龄不能为空!");
        return false; // 返回值为false，将阻止表单提交
    }
} );
// 触发form元素的submit事件
// $("form").submit( );

Nous pouvons également transmettre des données supplémentaires à la fonction de traitement des événements. De plus, grâce au paramètre Objet événement transmis par jQuery pour la fonction de traitement d'événement, nous pouvons obtenir des informations pertinentes sur l'événement en cours (telles que le type d'événement, l'élément DOM qui a déclenché l'événement, des données supplémentaires, etc.) :

var map = { name: "姓名", age: "年龄" };
$("form").submit( map, function(event){
    var labelMap = event.data;
    var label = '';
    // 循环验证所有text元素是否为空
    $(this).find(":text").each(function(){
        if( !this.value ){
            label = labelMap[this.name];
            return false;
        }       
    });    
    if( label ){
        alert( label + "不能为空!" );
        return false;
    }
} );

Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!