# Composant SettingsView pour les applications Stripe Autorisez les utilisateurs à configurer le fonctionnement de l'application avec leur compte. # v8 > This is a v8 for when app-sdk-version is 8. View the full page at https://docs.stripe.com/stripe-apps/components/settingsview?app-sdk-version=8. Vous pouvez définir une vue des paramètres spéciale pour permettre aux utilisateurs de modifier des détails spécifiques sur le fonctionnement de l’application avec leur compte. Par exemple, une application qui a recours à une API tierce (comme Zendesk) peut utiliser une `SettingsView` pour autoriser les utilisateurs à se connecter avec leur compte Zendesk. Pour en savoir plus, consultez la page consacrée à l’[ajout d’une page de paramètres](https://docs.stripe.com/stripe-apps/app-settings.md) pour votre application. ![](https://b.stripecdn.com/docs-statics-srv/assets/settingsview.ca0e43bcc311ea9819da61b2949e6ed1.png) Apparence d’une SettingsView `SettingsView` est un composant racine de vue, comme `ContextView`, qui contient d’autres éléments d’interface utilisateur. C’est la seule vue qui n’est pas liée à un objet spécifique, mais à la fenêtre d’affichage `settings`, laquelle mappe vers des emplacements prédéfinis dans le Dashboard en dehors du volet d’applications. `SettingsView` s’affiche sur la page des paramètres de l’application dans le Dashboard une fois que vous avez chargé une application. Lors de la prévisualisation de votre application en local, vous pouvez afficher un aperçu de `SettingsView` dans le Dashboard à l’adresse suivante : . Pour utiliser une `SettingsView`, vous devez ajouter une vue avec la fenêtre `settings` à votre manifeste d’application. Un manifeste d’application avec une vue « settings » présenterait un champ `ui_extension` similaire à ceci : ```json { ..., "ui_extension": { "views": [ ..., { "viewport": "settings", "component": "AppSettings" } ] } } ``` ### Propriétés de la SettingsView | Propriété | Type | | --------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `children` | (Obligatoire) `React.ReactNode` Le contenu du composant. | | `onSave` | (Facultatif) `((values: { [x: string]: string; }) => void) | undefined` S’il est fourni, un `Button` « Enregistrer » sera affiché avec la `SettingsView`. Ce rappel sera appelé lors du clic sur le `Button`. | | `statusMessage` | (Facultatif) `string | undefined` Chaîne permettant d’afficher un état tel que « Enregistré » ou « Erreur » dans l’en-tête de la vue. | ## Exemple Cet exemple illustre comment récupérer des paramètres depuis une API externe, les afficher et enregistrer les modifications. # v9 > This is a v9 for when app-sdk-version is 9. View the full page at https://docs.stripe.com/stripe-apps/components/settingsview?app-sdk-version=9. Vous pouvez définir une vue des paramètres spéciale pour permettre aux utilisateurs de modifier des détails spécifiques sur le fonctionnement de l’application avec leur compte. Par exemple, une application qui a recours à une API tierce (comme Zendesk) peut utiliser une `SettingsView` pour autoriser les utilisateurs à se connecter avec leur compte Zendesk. Pour en savoir plus, consultez la page consacrée à l’[ajout d’une page de paramètres](https://docs.stripe.com/stripe-apps/app-settings.md) pour votre application. ![](https://b.stripecdn.com/docs-statics-srv/assets/settingsview.ca0e43bcc311ea9819da61b2949e6ed1.png) Apparence d’une SettingsView `SettingsView` est un composant racine de vue, comme `ContextView`, qui contient d’autres éléments d’interface utilisateur. C’est la seule vue qui n’est pas liée à un objet spécifique, mais à la fenêtre d’affichage `settings`, laquelle mappe vers des emplacements prédéfinis dans le Dashboard en dehors du volet d’applications. `SettingsView` s’affiche sur la page des paramètres de l’application dans le Dashboard une fois que vous avez chargé une application. Lors de la prévisualisation de votre application en local, vous pouvez afficher un aperçu de `SettingsView` dans le Dashboard à l’adresse suivante : . Pour utiliser une `SettingsView`, vous devez ajouter une vue avec la fenêtre `settings` à votre manifeste d’application. Un manifeste d’application avec une vue « settings » présenterait un champ `ui_extension` similaire à ceci : ```json { ..., "ui_extension": { "views": [ ..., { "viewport": "settings", "component": "AppSettings" } ] } } ``` ### Propriétés de la SettingsView | Propriété | Type | | --------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `children` | (Obligatoire) `React.ReactNode` Le contenu du composant. | | `onSave` | (Facultatif) `((values: { [x: string]: string; }) => void) | undefined` S’il est fourni, un `Button` « Enregistrer » sera affiché avec la `SettingsView`. Ce rappel sera appelé lors du clic sur le `Button`. | | `statusMessage` | (Facultatif) `string | undefined` Chaîne permettant d’afficher un état tel que « Enregistré » ou « Erreur » dans l’en-tête de la vue. | ## Exemple Cet exemple illustre comment récupérer des paramètres depuis une API externe, les afficher et enregistrer les modifications. ## See also - [Modèles de conception](https://docs.stripe.com/stripe-apps/patterns.md) - [Styliser votre application](https://docs.stripe.com/stripe-apps/style.md) - [Tests d’interface utilisateur](https://docs.stripe.com/stripe-apps/ui-testing.md)