Sélection et presse-papiers#

#Modèle de sélection

rs-grid utilise un modèle de sélection ancre/focus (comme les tableurs) :

• Ancre — la cellule où la sélection a commencé (clic)
• Focus — la cellule où la sélection se termine (Maj+clic ou touches fléchées)

La plage sélectionnée est le rectangle entre l'ancre et le focus.

Pour plus de détails sur le modèle de sélection de base, voir Sélection.

#Copier

let output = state.apply(GridCommand::CopySelection);
if let CommandOutput::CopyText(tsv) = output {
    // Écrire `tsv` dans le presse-papiers système
}

La sélection est sérialisée en TSV (valeurs séparées par des tabulations, RFC 4180) :

• Colonnes séparées par \t
• Lignes séparées par \n

#Copier avec les en-têtes

Disponible comme action intégrée du menu contextuel (BuiltinAction::CopyWithHeaders). Ajoute une ligne d'en-tête en début de sortie TSV.

#Couper

let output = state.apply(GridCommand::CutSelection);

Identique à copier, mais efface également les cellules sélectionnées. L'effacement est enregistré dans l'historique d'annulation.

#Effacer (Suppr/Retour arrière)

state.apply(GridCommand::ClearCells);

Efface les cellules sélectionnées en chaîne vide, comme l'étape d'effacement de CutSelection, mais sans toucher au presse-papiers — appuyer sur Suppr ou Retour arrière ne devrait pas écraser son contenu. Sans effet sans sélection, ou sur une sélection de colonne entière (même logique que CutSelection : un clic sur l'en-tête porte une intention de positionnement, pas "effacer toute cette colonne"). Voir Validation pour comment une cellule requise garde sa valeur plutôt que d'être effacée.

En cas de succès, le même mécanisme de flash de succès que Coller ci-dessous se déclenche, limité exactement aux cellules que CommandOutput::CellsCleared rapporte comme effacées — pas toute la sélection, pour qu'une cellule ignorée (verrouillée ou requise) n'obtienne pas un flash de "succès" trompeur.

#Coller

state.apply(GridCommand::PasteAt {
    text: "Alice\t30\nBob\t25".into(),
});

Colle le texte TSV à partir de l'ancre de sélection actuelle. Chaque valeur séparée par une tabulation est écrite dans la cellule correspondante. Le collage est enregistré comme une entrée d'annulation groupée.

En cas de succès, rs-grid-web déclenche un bref flash jaune doré (GridCanvas::flash_cells) exactement sur les cellules que CommandOutput::PasteApplied rapporte comme écrites — pas tout le rectangle cible, pour qu'une cellule ignorée (verrouillée ou échec de validation) n'obtienne pas un flash de "succès" trompeur. Effacer réutilise le même mécanisme.

#Raccourcis clavier

Ces raccourcis sont gérés par la couche web (rs-grid-web) qui écoute les événements DOM copy, cut et paste.

#Gestion des erreurs

pub enum CopyError {
    NoSelection,    // rien de sélectionné
    TooManyRows,    // la sélection dépasse MAX_COPY_ROWS
}

Si la sélection est trop grande, CopySelection renvoie CommandOutput::CopyError(CopyError::TooManyRows) au lieu du texte TSV.

#Menu contextuel

Un clic droit ouvre un menu contextuel avec les actions du presse-papiers. Voir Menu contextuel pour les options de personnalisation.