Collecte d'informations sur l'élément PA déplaçable

Lorsque vous associez le comportement Tirer l'élément PA à un objet, Dreamweaver insère la fonction MM_dragLayer() dans la section d'en-tête (head) de votre document. (La fonction conserve l'ancienne convention d'attribution de nom pour les éléments PA (anciennement, calques) de façon à ce que les calques créés dans les versions précédentes de Dreamweaver restent modifiable.) Cette fonction enregistre l'élément PA comme déplaçable et définit trois propriétés pour chaque élément PA déplaçable, MM_LEFTRIGHT, MM_UPDOWN et MM_SNAPPED, que vous pouvez utiliser dans vos propres fonctions JavaScript pour déterminer les positions horizontale et verticale de l'élément PA et s'il a atteint la cible de dépôt.

Par exemple, la fonction suivante affiche la valeur de la propriété MM_UPDOWN (la position verticale actuelle de l'élément PA) dans un champ de formulaire appelé curPosField. Les champs de formulaires servent à afficher des informations pouvant être continuellement mises à jour, parce qu'ils sont dynamiques. Ainsi, vous pouvez modifier leur contenu après le chargement de la page.

function getPos(layerId){ 
    var layerRef = document.getElementById(layerId); 
    var curVertPos = layerRef.MM_UPDOWN; 
    document.tracking.curPosField.value = curVertPos; 
}

Au lieu d'afficher la valeur des propriétés MM_UPDOWN ou MM_LEFTRIGHT dans un champ de formulaire, vous pouvez utiliser ces valeurs de différentes manières. Par exemple, vous pouvez écrire une fonction qui affiche un message dans ce champ selon la distance qui reste à parcourir jusqu'à la cible, ou appeler une autre fonction pour afficher ou masquer un élément PA selon la valeur de cette distance.

Il est particulièrement utile de tester la propriété MM_SNAPPED lorsque vous disposez, sur une page, de plusieurs éléments PA qui doivent tous atteindre leur cible pour que l'utilisateur puisse passer à la page ou à la tâche suivante. Par exemple, vous pouvez écrire une fonction qui compte le nombre d'éléments PA ayant la valeur MM_SNAPPED définie sur true et l'appeler chaque fois qu'un élément PA est déposé. Lorsque le nombre d'éléments PA arrivés sur leur cible atteint le nombre désiré, vous pouvez envoyer l'utilisateur à la page suivante ou afficher un message de félicitations.

 Aide des communautés (adobe.fr)