Event Options
ElementEventOptions on monipuolinen webforJ-työkalu, joka on suunniteltu kapseloimaan ja hallitsemaan Element-tapahtumien konfiguraatioasetuksia webforJ-sovelluksissa. Se toimii erilaisten vaihtoehtojen säiliönä, mikä mahdollistaa kehittäjille tarkasti määritellä, miten elementteihin liittyviä tapahtumia tulisi käsitellä.
Tapahtumadata
Tapahtumadata on keskeinen ominaisuus ElementEventOptions:ssa, joka antaa kehittäjille mahdollisuuden liittää tiettyjä tietoja tapahtuma-asetuksiin. Tämä toiminnallisuus helpottaa räätälöidyn datan siirtämistä asiakkaalta palvelimelle tapahtuman muodostuessa. Tämä kyky on tärkeä ylimääräisen kontekstin tai tapahtumaan liittyvien parametrien välittämisessä, ja se mahdollistaa tiedon käytön ilman lisämatkoja asiakkaalle.
Esimerkiksi, kuvitelkaamme tilanne, jossa sinulla on napin klikkaustapahtuma ja haluat siirtää nykyisen käyttäjän käyttäjätunnuksen tapahtuman mukana. Sen sijaan, että kysyisit käyttäjän käyttäjätunnusta asiakkaalta jokaisella kerralla, lähetä tämä tieto tapahtuman myötä datana.
Lisätietoja on saatavilla tapahtumista ja asiakkaan/palvelimen vuorovaikutuksesta -sivuilla.
Lisätäksesi tietoa tapahtuma-asetuksiin, voit käyttää addData()-metodia.
JavaScriptin suorittaminen
ElementEventOptions -luokka antaa kehittäjille mahdollisuuden määrittää JavaScript-koodia, joka arvioidaan asiakaspuolella ennen liittyvän tapahtuman laukaisevaa tapahtumaa. Tämä ominaisuus mahdollistaa asiakkaille tapahtumadatan valmistelun tai lisätapahtumien laukaisemisen tarpeen mukaan. Tämä on hyödyllistä monissa tapauksissa, esimerkiksi kun halutaan validoida lomakedataa asiakaspuolella ennen kuin se lähetetään lomakkeen lähetys-tapahtuman kautta.
Käyttö
Asettaaksesi tapahtumakoodin, käytä setCode()-metodia.
Tapahtumien suodatus
ElementEventOptions sisältää ominaisuuden suodatustilauksen määrittämiseksi, joka arvioidaan asiakkaalla ennen tapahtuman laukaisemista. Tämä suodatustilaeus mahdollistaa asiakkaan päättää, pitäisikö tapahtuman edetä vai pysäyttää tiettyjen ehtojen perusteella. Kuvittele syötekenttä, jossa haluat laukaista tapahtuman vain, jos syötetyt tekstit täyttävät tietyt kriteerit, kuten minimipituuden.
Käyttö
Asettaaksesi tapahtumasuodattimen, käytä setFilter()-metodia.
Debouncaaminen ja throttling
Tavoite
ElementEventOptions tarjoaa mekanismeja tapahtumien debouncaamiseen ja throttlingiin. Nämä ominaisuudet ovat hyödyllisiä tapahtumakuuntelijoiden taajuuden hallitsemiseksi, varmistaen, että ne laukaistaan vain tietyissä olosuhteissa.
Käyttö
- Aseta debounce käyttämällä
setDebounce-metodia. - Aseta throttle käyttämällä
setThrottle-metodia.
Esimerkki
Tilanteissa, joissa haluat käsitellä nopeaa käyttäjän syötettä, kuten hakusyötekenttiä, voit käyttää debouncea viivyttääksesi suorittamista, kunnes käyttäjä on lopettanut kirjoittamisen.
Tapahtuma-asetusten yhdistäminen
ElementEventOptions -luokka tukee yhdistämistä muiden instanssien kanssa, jolloin kehittäjät voivat kerätä erilaisia vaihtoehtoja. Tämä ominaisuus on hyödyllinen yhdistettäessä asetuksia eri lähteistä.
Annotoinnit
Tavoite
Käytön helpottamiseksi ElementEventOptions voidaan konfiguroida käyttämällä annotaatioita. Nämä annotaatiot tarjoavat tiiviimmän ja ilmaisuvoimaisemman tavan määrittää tapahtuma-asetuksia.
Esimerkki
Kuvittele seuraava esimerkkiannotaatio:
@EventOptions(data = {@EventData(key = "value", exp = "component.value")},
debounce = @DebounceSettings(value = 200))