# SettingsView-Komponente für Stripe-Apps Ermöglichen Sie Nutzerinnen und Nutzern, Details zur Art und Weise, wie die App mit ihrem Konto funktioniert, zu ändern. # 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. Sie können eine spezielle Einstellungsansicht festlegen, damit Nutzer/innen bestimmte Details in Bezug auf die Art und Weise, wie die App mit ihrem Konto funktioniert, ändern können. Beispielsweise könnte eine App, die eine Drittanbieter-API wie Zendesk verwendet, `SettingsView` verwenden, um eine/n Nutzer/in bei seinem/ihrem Zendesk-Konto zu autorisieren. Um mehr zu erfahren, lesen Sie, wie Sie Ihrer App eine [Einstellungsseite hinzufügen](https://docs.stripe.com/stripe-apps/app-settings.md). ![](https://b.stripecdn.com/docs-statics-srv/assets/settingsview.ca0e43bcc311ea9819da61b2949e6ed1.png) Darstellung von SettingsView `SettingsView` ist, genau wie `ContextView`, eine Ansichts-Root-Komponente, die alle anderen Nutzeroberflächen-Elemente enthält. Es ist die einzige Ansicht, die an kein bestimmtes Objekt, wohl aber an das Darstellungsfeld `settings` gebunden ist. Das Darstellungsfeld `settings` wird dabei festgelegten Stellen im Dashboard außerhalb der App-Schublade zugeordnet. `SettingsView` wird auf der Seite mit den App-Einstellungen im Dashboard gerendert, nachdem Sie eine App hochgeladen haben. Wenn Sie Ihre App in der Vorschau lokal anzeigen, können Sie eine Vorschau der `SettingsView` im Dashboard unter anzeigen. Um `SettingsView` zu nutzen, müssen Sie eine Ansicht mit dem Darstellungsfeld `settings` zu Ihrem App-Manifest hinzufügen. Eine Anwendung mit einer Einstellungsansicht hätte ein App-Manifest mit einem Feld `ui_extension`, das ungefähr so aussieht: ```json { ..., "ui_extension": { "views": [ ..., { "viewport": "settings", "component": "AppSettings" } ] } } ``` ### SettingsView-Eigenschaften | Eigenschaft | Typ | | --------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `children` | (Pflichtfeld) `React.ReactNode` Der Inhalt der Komponente. | | `onSave` | (Optional) `((values: { [x: string]: string; }) => void) | undefined` Falls angegeben, wird eine `Button` vom Typ „Speichern“ mit der `SettingsView` angezeigt. Dieser Rückruf wird aufgerufen, wenn auf die `Button` geklickt wird. | | `statusMessage` | (Optional) `string | undefined` Eine Zeichenfolge, die einen Status wie „Gespeichert“ oder „Fehler“ in der Kopfzeile der Ansicht anzeigt. | ## Beispiel In diesem Beispiel wird gezeigt, wie Einstellungen aus einer externen API abgerufen, angezeigt und Änderungen gespeichert werden. # 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. Sie können eine spezielle Einstellungsansicht festlegen, damit Nutzer/innen bestimmte Details in Bezug auf die Art und Weise, wie die App mit ihrem Konto funktioniert, ändern können. Beispielsweise könnte eine App, die eine Drittanbieter-API wie Zendesk verwendet, `SettingsView` verwenden, um eine/n Nutzer/in bei seinem/ihrem Zendesk-Konto zu autorisieren. Um mehr zu erfahren, lesen Sie, wie Sie Ihrer App eine [Einstellungsseite hinzufügen](https://docs.stripe.com/stripe-apps/app-settings.md). ![](https://b.stripecdn.com/docs-statics-srv/assets/settingsview.ca0e43bcc311ea9819da61b2949e6ed1.png) Darstellung von SettingsView `SettingsView` ist, genau wie `ContextView`, eine Ansichts-Root-Komponente, die alle anderen Nutzeroberflächen-Elemente enthält. Es ist die einzige Ansicht, die an kein bestimmtes Objekt, wohl aber an das Darstellungsfeld `settings` gebunden ist. Das Darstellungsfeld `settings` wird dabei festgelegten Stellen im Dashboard außerhalb der App-Schublade zugeordnet. `SettingsView` wird auf der Seite mit den App-Einstellungen im Dashboard gerendert, nachdem Sie eine App hochgeladen haben. Wenn Sie Ihre App in der Vorschau lokal anzeigen, können Sie eine Vorschau der `SettingsView` im Dashboard unter anzeigen. Um `SettingsView` zu nutzen, müssen Sie eine Ansicht mit dem Darstellungsfeld `settings` zu Ihrem App-Manifest hinzufügen. Eine Anwendung mit einer Einstellungsansicht hätte ein App-Manifest mit einem Feld `ui_extension`, das ungefähr so aussieht: ```json { ..., "ui_extension": { "views": [ ..., { "viewport": "settings", "component": "AppSettings" } ] } } ``` ### SettingsView-Eigenschaften | Eigenschaft | Typ | | --------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `children` | (Pflichtfeld) `React.ReactNode` Der Inhalt der Komponente. | | `onSave` | (Optional) `((values: { [x: string]: string; }) => void) | undefined` Falls angegeben, wird eine `Button` vom Typ „Speichern“ mit der `SettingsView` angezeigt. Dieser Rückruf wird aufgerufen, wenn auf die `Button` geklickt wird. | | `statusMessage` | (Optional) `string | undefined` Eine Zeichenfolge, die einen Status wie „Gespeichert“ oder „Fehler“ in der Kopfzeile der Ansicht anzeigt. | ## Beispiel In diesem Beispiel wird gezeigt, wie Einstellungen aus einer externen API abgerufen, angezeigt und Änderungen gespeichert werden. ## See also - [Entwurfsmuster als Orientierung](https://docs.stripe.com/stripe-apps/patterns.md) - [App gestalten](https://docs.stripe.com/stripe-apps/style.md) - [Test der Nutzeroberfläche](https://docs.stripe.com/stripe-apps/ui-testing.md)