jQuery UI API - Interaction souris

Catégorie

Interactions | Utilitaires

Utilisation

Description :Couche d'interaction de base.

Dépendances :

Notes :etjQuery.WidgetDe même, Mouse Interaction n'est pas destiné à une utilisation directe. Il s'agit d'une couche de base purement destinée à être héritée par d'autres widgets. Cette page comporte des ajouts à lajQuery.Widgetdocumentation, mais elle contient des méthodes internes qui ne peuvent pas être redéfinies. L'API publique est_mouseStart()、_mouseDrag()、_mouseStop()et_mouseCapture()。

Navigation rapide

Options Méthodes Événements

Options Type Description Default
annulation Sélecteur Empêche les interactions de démarrer sur les éléments spécifiés.

Exemple de code :

Initialiser avec lescanceloptions pour la souris :

$( ".selector" ).mouse({ cancel: ".title" });
    

Après l'initialisation, obtenir ou définir l'canceloption:

// getter
var cancel = $( ".selector" ).mouse( "option", "cancel" );
 
// setter
$( ".selector" ).mouse( "option", "cancel", ".title" );
    
"input, textarea, button, select, option"
delay Number Le temps en millisecondes après l'appui de la souris jusqu'au démarrage de l'interaction. Cette option peut être utilisée pour éviter les interactions indésirables lors d'un clic sur un élément.

Exemple de code :

Initialiser avec lesdelayoptions pour la souris :

$( ".selector" ).mouse({ delay: 300 });
    

Après l'initialisation, obtenir ou définir l'delayoption:

// getter
var delay = $( ".selector" ).mouse( "option", "delay" );
 
// setter
$( ".selector" ).mouse( "option", "delay", 300 );
    
0
distance Number La distance en pixels dont la souris doit se déplacer après l'appui de la souris et avant le démarrage de l'interaction. Cette option peut être utilisée pour éviter les interactions indésirables lors d'un clic sur un élément.

Exemple de code :

Initialiser avec lesdistanceoptions pour la souris :

$( ".selector" ).mouse({ distance: 10 });
    

Après l'initialisation, obtenir ou définir l'distanceoption:

// getter
var distance = $( ".selector" ).mouse( "option", "distance" );
 
// setter
$( ".selector" ).mouse( "option", "distance", 10 );
    
1

Méthodes Renvoie Description
_mouseCapture() Boolean Détermine si l'interaction doit démarrer en fonction de la cible d'événement de l'interaction. L'implémentation par défaut renvoie toujourstrue。
  • Cette méthode n'accepte aucun argument.

Exemple de code :

Appelez la méthode _mouseCapture :

$( ".selector" ).mouse( "_mouseCapture" );
    
_mouseDelayMet() Boolean Déterminedelaysi l'option est satisfaite pour l'interaction actuelle.
  • Cette méthode n'accepte aucun argument.

Exemple de code :

Invoquez la méthode _mouseDelayMet :

$( ".selector" ).mouse( "_mouseDelayMet" );
    
_mouseDestroy() jQuery (plugin uniquement) Détruit les gestionnaires d'événements d'interaction. Cela doit être appelé depuis la méthode du widget dérivé_destroy()méthode.
  • Cette méthode n'accepte aucun argument.

Exemple de code :

Invoquez la méthode _mouseDestroy :

$( ".selector" ).mouse( "_mouseDestroy" );
    
_mouseDistanceMet() Boolean Déterminedistancesi l'option est satisfaite pour l'interaction actuelle.
  • Cette méthode n'accepte aucun argument.

Exemple de code :

Invoquez la méthode _mouseDistanceMet :

$( ".selector" ).mouse( "_mouseDistanceMet" );
    
_mouseDown() jQuery (plugin uniquement) Gère le début de l'interaction. Confirme que l'événement est associé au bouton principal de la souris et garantit quedelayetdistanceest satisfaite avant que l'interaction ne commence. Lorsque l'interaction est prête à démarrer, elle appelle la méthode du widget dérivé_mouseStartméthode.
  • Cette méthode n'accepte aucun argument.

Exemple de code :

Invoquez la méthode _mouseDown :

$( ".selector" ).mouse( "_mouseDown" );
    
_mouseDrag() jQuery (plugin uniquement) Le widget qui étend doit implémenter une_mouseDrag()méthode pour gérer chaque déplacement de l'interaction. Cette méthode reçoit l'événement de souris associé au mouvement de la souris.
  • Cette méthode n'accepte aucun argument.

Exemple de code :

Appeler la méthode _mouseDrag :

$( ".selector" ).mouse( "_mouseDrag" );
    
_mouseInit() jQuery (plugin uniquement) Initialise les gestionnaires d'événements d'interaction. Cela doit être appelé depuis le widget qui étend_create()méthode.
  • Cette méthode n'accepte aucun argument.

Exemple de code :

Appeler la méthode _mouseInit :

$( ".selector" ).mouse( "_mouseInit" );
    
_mouseMove() jQuery (plugin uniquement) Gère chaque déplacement de l'interaction. Appelle la méthode_mouseDragdu widget qui étend.
  • Cette méthode n'accepte aucun argument.

Exemple de code :

Appeler la méthode _mouseMove :

$( ".selector" ).mouse( "_mouseMove" );
    
_mouseStart() jQuery (plugin uniquement) Le widget qui étend doit implémenter une_mouseStart()méthode pour gérer le début de l'interaction. Cette méthode reçoit l'événement de souris associé au début de l'interaction.
  • Cette méthode n'accepte aucun argument.

Exemple de code :

Invoquez la méthode _mouseStart :

$( ".selector" ).mouse( "_mouseStart" );
    
_mouseStop() jQuery (plugin uniquement) Le widget qui étend doit implémenter une_mouseStop()méthode pour gérer la fin de l'interaction. Cette méthode reçoit l'événement de souris associé à la fin de l'interaction.
  • Cette méthode n'accepte aucun argument.

Exemple de code :

Invoquez la méthode _mouseStop :

$( ".selector" ).mouse( "_mouseStop" );
    
_mouseUp() jQuery (plugin uniquement) Gère la fin de l'interaction. Appelle la méthode_mouseStopdu gestionnaire du widget qui étend.
  • Cette méthode n'accepte aucun argument.

Exemple de code :

Invoquez la méthode _mouseUp :

$( ".selector" ).mouse( "_mouseUp" );
Autres extensions