Boîte de dialogue Prompt avec Apps Script

La méthode prompt vous permet de créer une boîte de dialogue dans Google Sheets qui invite l'utilisateur à entrer une valeur.

Cette méthode est légèrement plus complexe que l'utilisation de Browser.inputBox mais aussi plus fonctionnelle (elle vous permet notamment de récupérer à la fois le texte entré et le bouton cliqué par l'utilisateur).

Boîte de dialogue simple

Pour afficher une boîte de dialogue simple et récupérer uniquement le texte entré (sans se soucier du bouton cliqué), vous pouvez entrer :

function exemple() {
  const ui = SpreadsheetApp.getUi();
  const resultat = ui.prompt('Entrez la valeur à rechercher :');

  SpreadsheetApp.getUi().alert('La valeur entrée est : ' + resultat.getResponseText());
}

Boîte de dialogue avec titre et boutons

Vous pouvez définir un titre et les boutons à afficher parmi les sets de boutons suivants :

• OK : bouton Ok
• OK_CANCEL : boutons Ok, Annuler
• YES_NO : boutons Oui, Non
• YES_NO_CANCEL : boutons Oui, Non, Annuler

Dans cet exemple, la seconde boîte de dialogue n'est affichée que si l'utilisateur a entré une valeur et cliqué sur Ok :

function exemple() {
  const ui = SpreadsheetApp.getUi();
  const resultat = ui.prompt('Recherche', 'Entrez la valeur à rechercher :', ui.ButtonSet.OK_CANCEL);
  const texte = resultat.getResponseText();
  
  if (texte != '' && resultat.getSelectedButton() == ui.Button.OK) {
    SpreadsheetApp.getUi().alert('La valeur entrée est : ' + texte);
  }
}

Les boutons :

• OK : clic sur le bouton Ok
• YES : clic sur le bouton Oui
• NO : clic sur le bouton Non
• CANCEL : clic sur le bouton Annuler
• CLOSE : clic sur la croix de la fenêtre