Cette section s’intéresse au tri d’un tableau. Ici, nous allons effectuer un tri croissant sur la première colonne :
async function trier() { await Excel.run(async function (context) { let feuille = context.workbook.worksheets.getActiveWorksheet(); let t = feuille.tables.getItem("ventes"); t.sort.apply([ { key: 0, ascending: true }, ], true); }); }
Après avoir récupéré la feuille courante et le tableau ventes :
let feuille = context.workbook.worksheets.getActiveWorksheet(); let t = feuille.tables.getItem("ventes");
La méthode sort.apply() est appliquée au tableau. Cette méthode admet deux paramètres :
- Un tableau d’objets JSON qui indique la ou les colonnes à trier (key) et l’ordre de tri (ascending).
- Un booléen qui indique si la casse des caractère doit (true) ou ne doit pas (false) être un critère de tri.
Ici, le tri se fait sur la première colonne (key: 0). Les données sont classées par ordre alphabétique (ascending: true) et on tient compte de la casse des caractères (true) :
t.sort.apply([ { key: 0, ascending: true }, ], true);
Voici le résultat :
Pour appliquer un tri décroissant sur la première colonne puis un tri croissant sur la deuxième colonne, vous auriez utilisé ce code :
t.sort.apply( [ { key: 0, ascending: false }, { key: 1, ascending: true } ], true );
Voici le résultat :