Hacktoberfest 2026: le issue che i maintainer hanno segnato per ottobre, aperte e adatte ai principianti. Sfoglia le issue Hacktoberfest

content: The IonSlides Angular migration guide should have "Notes" about the breaking change on Event handling

Aperta
  • Qualcosa non va?
#2,734 0 commenti 0 reazioni 0 assegnatari Vedi su GitHub

I maintainer di solito rispondono entro 1 giorno

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà
1/5
Tempo stimato
1-3 ore
Idoneità per principianti
48/100
Tipo di issue
Documentazione
Chiarezza
Specificata chiaramente
Stato di attività
Ferma
Stack tecnologico
angular
Ambito
documentation

Direzione di ricerca

Apri la guida alla migrazione di Angular nella sezione documentata „Events“ delle slide e confronta le indicazioni sulla gestione degli eventi con la documentazione collegata di Swiper Angular. Aggiungi una nota che descriva che gli eventi di Swiper vengono eseguiti al di fuori di NgZone e spieghi quando sono necessari ngZone.run o il rilevamento delle modifiche; il lavoro è completato quando la breaking change è chiara nella guida.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

content
URL

https://ionicframework.com/docs/angular/slides#events

Issue Description

When following the migration guide to switch using Swiper instead of IonSlides, I found one breaking change.
That is the triggered event is no longer part of NgZone.
This is also mentioned in the Swiper document.
https://swiperjs.com/angular#swiper-component-events

Note that Swiper Angular component all events emits outside of NgZone for better perfomance. Dont forget to use ngzone.run or ChangeDetector if you need to change view (e.g slides) in event handlers (e.g slideChange).

I think this should also be mentioned in the Ionic docs.

Below is a small sample:
In HTML, I put a testVariable both inside and outside of Swiper.

{{testVariable}}
  <swiper 
    [config]="config"
    (slideChangeTransitionEnd)="onSlideChange()">
    <ng-template swiperSlide>Slide1, {{testVariable}}</ng-template>
    <ng-template swiperSlide>Slide2 {{testVariable}}</ng-template>
    <ng-template swiperSlide>Slide3  {{testVariable}}</ng-template>
  </swiper>

In component code, if I don't surround the code with ngZone.run, only the testVariable inside Swiper is updating, the one outside of Swiper never changes. IonSlides doesn't have such behavior change.

  onSlideChange() {
    this.ngZone.run(() => {
      this.testVariable++;      
    });
  }
Lingua principale
MDX
Stelle
621
Fork
3.2k
Merge medio
1g 6h
PR unite (30g)
65

Preparare l'ambiente

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di ionic-team/ionic-docs

Tutte le issue di ionic-team/ionic-docs

Issue simili

Altre issue su Documentation

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.