Viewport#

Le viewport est la fenetre sur les donnees de la grille. Seules les cellules qui intersectent la zone visible sont transmises au renderer, quel que soit le nombre total de lignes ou de colonnes.

#ViewportState

ViewportState vit a l'interieur de GridState et suit quatre valeurs :

Les valeurs en pixels sont en pixels CSS. Le renderer applique le multiplicateur de ratio de pixels de l'appareil (DPR) lors des appels de dessin.

#Colonnes visibles

Les decalages de colonnes sont precalcules et stockes dans un tableau de sommes prefixees. A partir de scroll_x et width, la premiere et la derniere colonne visible sont trouvees par recherche binaire — O(log n) quel que soit le nombre de colonnes.

La meme approche s'applique aux lignes en utilisant la hauteur de ligne et scroll_y.

#Limites du nombre de lignes

Les indices de lignes utilisent u64. La limite pratique avec des decalages de scroll en f64 est d'environ 9 x 10^14 lignes avant que la precision en virgule flottante ne se degrade.

#Defilement

Envoyez une commande de scroll pour mettre a jour le viewport :

grid_state.apply(GridCommand::ScrollTo {
    x: new_scroll_x,
    y: new_scroll_y,
});

La couche d'integration web (rs-grid-web) traduit automatiquement les evenements de molette du navigateur en commandes de scroll. Le DPR et l'arrondi des pixels sont geres en interne.

#Redimensionnement

Lorsque le canvas est redimensionne (redimensionnement de fenetre ou de conteneur), mettez a jour les dimensions du viewport :

grid_state.apply(GridCommand::Resize {
    width: new_width,
    height: new_height,
});

Le composant Leptos observe un ResizeObserver et envoie cette commande automatiquement.