Cosa è successo all'opzione triggerOnce in Waypoint 3.0?

Question

Ho recentemente aggiornato jquery-waypoints da 2.x a 3.x nel mio progetto e ho scoperto che molto del mio codice si è rotto. Tutti i riferimenti a $(this) all'interno dei miei gestori dovevano essere cambiati in $(this.element) che, una volta che ho capito era la causa dei miei problemi, era abbastanza facile da risolvere.

Non sono stato in grado di capire cosa è successo all'opzione triggerOnce che impediva a un waypoint di sparare più volte. Qualche idea sul perché questo è stato rimosso e come posso ottenere la stessa funzionalità?

Answer 1

Ho trovato una soluzione. L'aggiunta di this.disable() alla fine del gestore disattiva il waypoint dopo che è stato attivato, impedendo che venga richiamato di nuovo. Penso davvero che questo dovrebbe essere documentato.

Answer 2

So che una risposta era già contrassegnata come corretta, ma mi piacerebbe espandermi oltre un semplice commento.

3.0, essendo una versione principale, ha apportato modifiche di rottura. Uno di questi è stata la rimozione di triggerOnce. È indicato nello changelog. Viene anche menzionato nello destroy docs dove viene utilizzato l'utilizzo di destroy alla fine del gestore come alternativa al vecchio triggerOnce.

In precedenza, triggerOnce in precedenza non era lo stesso di chiamare destroy perché tutti i metodi Waypoint venivano chiamati su oggetti jQuery. Gli elementi in quegli oggetti jQuery possono avere più waypoint collegati a loro, ma non c'era modo di separarli una volta creati. Se hai chiamato destroy tutti i waypoint su quell'elemento sono stati distrutti. L'opzione triggerOnce, tuttavia, funzionava su base waypoint individuale dietro le quinte. Ora che 3.0 restituisce direttamente le istanze della classe Waypoint e this all'interno del gestore è un riferimento all'istanza Waypoint anziché all'elemento, non c'è differenza tra triggerOnce e chiama this.destroy() per terminare un gestore. Quindi il codice è stato rimosso.

Answer 3

Se è necessario disabilitare un waypoint jQuery (v3.0):

$('.my-waypoint').waypoint(function(direction){ 
    // Do some stuff 
    this.destroy(); 
});