Cette page a été traduite par l'API Cloud Translation.

Class Browser

Cette classe permet d'accéder aux boîtes de dialogue spécifiques à Google Sheets.

Les méthodes de cette classe ne peuvent être utilisées que dans le contexte d'une feuille de calcul Google. Veuillez utiliser les boîtes de dialogue Google Workspace à la place.

Voir aussi

ButtonSet

Propriétés

Propriété	Type	Description
`Buttons`	`ButtonSet`

Méthodes

Méthode	Type renvoyé	Brève description
`inputBox(prompt)`	`String`	Affiche une boîte de dialogue avec une zone de saisie de texte dans le navigateur de l'utilisateur.
`inputBox(prompt, buttons)`	`String`	Affiche une boîte de dialogue avec une zone de saisie de texte dans le navigateur de l'utilisateur.
`inputBox(title, prompt, buttons)`	`String`	Affiche une boîte de dialogue avec une zone de saisie de texte dans le navigateur de l'utilisateur.
`msgBox(prompt)`	`String`	Affiche une boîte de dialogue contenant le message donné et un bouton "OK" dans le navigateur de l'utilisateur.
`msgBox(prompt, buttons)`	`String`	Affiche une boîte de dialogue avec le message donné et les boutons spécifiés dans le navigateur de l'utilisateur.
`msgBox(title, prompt, buttons)`	`String`	Affiche une boîte de dialogue avec le titre, le message et les boutons spécifiés dans le navigateur de l'utilisateur.

Documentation détaillée

`inputBox(prompt)`

Affiche une boîte de dialogue avec une zone de saisie de texte dans le navigateur de l'utilisateur.

La méthode inputBox génère une zone de saisie côté client qui affiche l'invite donnée à l'utilisateur. Notez que cette fonction entraîne la suspension du script côté serveur. Il reprend automatiquement une fois que l'utilisateur a effacé la boîte de dialogue, mais les connexions JDBC ne persistent pas pendant la suspension.

// The code below sets the value of name to the name input by the user, or
// 'cancel'.
const name = Browser.inputBox('Enter your name');

Nous vous déconseillons d'utiliser cette méthode. Utilisez plutôt une invite d'interface utilisateur.

Paramètres

Nom	Type	Description
`prompt`	`String`	Texte à afficher dans la boîte de dialogue.

Renvois

String : texte saisi par l'utilisateur (ou "Annuler" pour une boîte de dialogue annulée ou ignorée).

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`inputBox(prompt, buttons)`

Affiche une boîte de dialogue avec une zone de saisie de texte dans le navigateur de l'utilisateur.

La méthode inputBox génère une zone de saisie côté client qui affiche l'invite donnée à l'utilisateur et propose un choix de boutons à afficher. Notez que cette fonction entraîne la suspension du script côté serveur. Il reprend automatiquement une fois que l'utilisateur a effacé la boîte de dialogue, mais les connexions JDBC ne persistent pas pendant la suspension.

// The code below sets the value of name to the name input by the user, or
// 'cancel'.
const name = Browser.inputBox('Enter your name', Browser.Buttons.OK_CANCEL);

Nous vous déconseillons d'utiliser cette méthode. Utilisez plutôt une invite d'interface utilisateur.

Paramètres

Nom	Type	Description
`prompt`	`String`	Texte à afficher dans la boîte de dialogue.
`buttons`	`ButtonSet`	Type de bouton défini à utiliser.

Renvois

String : texte saisi par l'utilisateur (ou "Annuler" pour une boîte de dialogue annulée ou ignorée).

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`inputBox(title, prompt, buttons)`

Affiche une boîte de dialogue avec une zone de saisie de texte dans le navigateur de l'utilisateur.

La méthode inputBox génère une zone de saisie côté client avec le titre donné, qui affiche l'invite donnée à l'utilisateur et propose un choix de boutons à afficher. Notez que cette fonction entraîne la suspension du script côté serveur. Il reprend automatiquement une fois que l'utilisateur a effacé la boîte de dialogue, mais les connexions JDBC ne persistent pas pendant la suspension.

// The code below sets the value of name to the name input by the user, or
// 'cancel'.
const name = Browser.inputBox(
    'ID Check',
    'Enter your name',
    Browser.Buttons.OK_CANCEL,
);

Cette méthode n'est pas recommandée. Utilisez plutôt une invite d'interface utilisateur.

Paramètres

Nom	Type	Description
`title`	`String`	Titre de la boîte de dialogue.
`prompt`	`String`	Texte à afficher dans la boîte de dialogue.
`buttons`	`ButtonSet`	Type de bouton défini à utiliser.

Renvois

String : texte saisi par l'utilisateur (ou "Annuler" pour une boîte de dialogue annulée ou ignorée).

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`msgBox(prompt)`

Affiche une boîte de dialogue contenant le message donné et un bouton "OK" dans le navigateur de l'utilisateur.

La méthode msgBox génère une boîte de message côté client qui affiche le message donné à l'utilisateur. Notez que cette méthode suspend le script côté serveur. Il reprend automatiquement une fois que l'utilisateur a effacé la boîte de dialogue, mais les connexions JDBC ne persistent pas pendant la suspension.

// The code below displays "hello world" in a dialog box with an OK button
Browser.msgBox('hello world');

Cette méthode n'est pas recommandée. Utilisez plutôt une boîte de dialogue Alerte de l'interface utilisateur.

Paramètres

Nom	Type	Description
`prompt`	`String`	Texte à afficher dans la boîte de dialogue.

Renvois

String : texte en minuscules du bouton sur lequel l'utilisateur clique (ou "Annuler" pour une boîte de dialogue fermée).

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`msgBox(prompt, buttons)`

Affiche une boîte de dialogue avec le message donné et les boutons spécifiés dans le navigateur de l'utilisateur.

La méthode msgBox génère une boîte de message côté client qui affiche le message donné à l'utilisateur et propose un choix de boutons à afficher. Notez que cette méthode suspend le script côté serveur. Il reprend automatiquement une fois que l'utilisateur a effacé la boîte de dialogue, mais les connexions JDBC ne persistent pas pendant la suspension.

// The code below displays "hello world" in a dialog box with OK and Cancel
// buttons.
Browser.msgBox('hello world', Browser.Buttons.OK_CANCEL);

Cette méthode n'est pas recommandée. Utilisez plutôt une boîte de dialogue Alerte de l'interface utilisateur.

Paramètres

Nom	Type	Description
`prompt`	`String`	Texte à afficher dans la boîte de dialogue.
`buttons`	`ButtonSet`	Type de bouton défini à utiliser.

Renvois

String : texte en minuscules du bouton sur lequel l'utilisateur clique (ou "Annuler" pour une boîte de dialogue fermée).

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`msgBox(title, prompt, buttons)`

Affiche une boîte de dialogue avec le titre, le message et les boutons spécifiés dans le navigateur de l'utilisateur.

La méthode msgBox génère une boîte de message côté client avec le titre donné, qui affiche le message donné à l'utilisateur et propose un choix de boutons à afficher. Notez que cette méthode entraîne la suspension du script côté serveur. Il reprend automatiquement une fois que l'utilisateur a effacé la boîte de dialogue, mais les connexions JDBC ne persistent pas pendant la suspension.

// The code below displays "hello world" in a dialog box with a custom title and
// Yes and No buttons
Browser.msgBox('Greetings', 'hello world', Browser.Buttons.YES_NO);

Nous vous déconseillons d'utiliser cette méthode. Utilisez plutôt une boîte de dialogue Alerte de l'interface utilisateur.

Paramètres

Nom	Type	Description
`title`	`String`	Titre de la boîte de dialogue.
`prompt`	`String`	Texte à afficher dans la boîte de dialogue.
`buttons`	`ButtonSet`	Type de bouton défini à utiliser.

Renvois

String : texte en minuscules du bouton sur lequel l'utilisateur clique (ou "Annuler" pour une boîte de dialogue fermée).

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets