Jahr-Auswahl
Beispiele
Im Abschnitt Verwendung finden Sie Informationen zum korrekten Design einer Jahresauswahl und den verschiedenen von Guidewire bereitgestellten Konfigurationsoptionen.
Einfaches Beispiel
Sie können einem Benutzer gestatten, mithilfe der bereitgestellten Eingabe ein Jahr auszuwählen.
<YearPicker
label={{
id: 'year-picker',
defaultMessage: 'Enter year',
}}
onChange={(event, value) => console.log('The year chosen is', value.year)}
/>
Beispiel für einen Fehler
Die stateMessages-Eigenschaft kann zum Anzeigen eines Fehlers verwendet werden.
<YearPicker
label={{
id: 'year-picker',
defaultMessage: 'Enter year',
}}
stateMessages={{ error: ['This is an error message'] }}
/>
Beispiel für Min/Max
Mit den Eigenschaften minYear und maxYear können Sie einschränken, welche Jahre ein Benutzer auswählen kann.
<YearPicker
label={{
id: 'year-picker',
defaultMessage: 'Enter year',
}}
minYear={{ year: 2020 }}
maxYear={{ year: 2030 }}
/>
Beispiel für eine kontrollierte Auswahl
Sie können die Jahr-Auswahl steuern, indem Sie die Werteigenschaft übergeben. Dies ist hilfreich, wenn Sie die Jahresauswahl als gesteuerte Komponente verwenden möchten.
const [picked, setYear] = React.useState({ year: undefined });
function handleYearChange(event, value) {
setYear(value);
}
<YearPicker
label={{
id: 'year-picker-label',
defaultMessage: 'Select year',
}}
onChange={handleYearChange}
value={picked}
/>
<div>
{picked && picked.year ? (
<>The selected year is {picked.year}.</>
) : (
<>Waiting for the user to specify year.</>
)}
</div>
Verwendung
Überblick
Die Jahr-Auswahl ist ein Steuerelement, mit dem der Benutzer ein bestimmtes Jahr aus einem Kalender auswählt oder manuell eingibt. Diese Komponente wird häufig in Versicherungsanwendungen verwendet, bei denen Benutzer ein Jahr angeben müssen, z. B. das Jahr, in dem sie einen Schaden erlitten haben, der durch ihre Hauseigentümerversicherung abgedeckt ist.
Zu verwenden
Wenn der Benutzer ein Jahr auswählen muss.
Nicht zu verwenden
- Wenn der Benutzer ein Jahr eingeben muss, das weit in der Vergangenheit oder Zukunft liegt. Verwenden Sie in diesem Fall die Datumseingabe.
- Wenn der Benutzer den Monat, den Tag und das Jahr auswählen muss. Verwenden Sie in diesem Fall die Datumsauswahl.
- Wenn der Benutzer sowohl einen Monat als auch ein Jahr auswählen muss. Verwenden Sie in diesem Fall die Monatsauswahl.
Siehe auch
Formatierung
Aufbau

Die Jahr-Auswahl-Komponente besteht aus den folgenden Elementen:
- Datumsauswahlfeld: Ein Eingabefeld, in das der Benutzer das Jahr manuell eingeben kann.
- Kalendersymbol: Eine Symbolschaltfläche, die den Dropdown-Kalender auslöst, wenn sie angeklickt wird.
- Schaltfläche „Vorheriges Jahr“: Ein Steuerelement zum Anzeigen und Auswählen aus einem früheren Satz von Jahren innerhalb des Auswahlbereichs.
- Schaltfläche „Nächstes Jahr“: Ein Steuerelement zum Anzeigen und Auswählen aus einem späteren Satz von Jahren innerhalb des Auswahlbereichs.
- Ausgewähltes Jahr: Das vom Benutzer ausgewählte und in der Jahresauswahl hervorgehobene Jahr.
- Schaltfläche „Aktuelles Jahr“: Eine Schaltfläche, die beim Anklicken das Jahr-Auswahlfeld automatisch mit dem aktuellen Jahr ausfüllt.
Datumsformat
Ein YYYY-Platzhalter im Eingabefeld dient während der Eingabe als Hilfe für den Benutzer zum erwarteten Format der Jahresangabe.
Inhalt
Allgemeine Richtlinien fürs Schreiben
- Verwenden Sie die Großschreibung des ersten Worts und von Substantiven für alle Aspekte der Gestaltung von Guidewire-Produktschnittstellen. Schreiben Sie nicht alles groß.
- Verwenden Sie in den meisten Situationen Verben im Präsens und im Aktiv.
- Verwenden Sie gebräuchliche Abkürzungen, um Ihrem Text einen natürlichen und informellen Ton zu verleihen.
- Verwenden Sie eine einfache Sprache. Vermeiden Sie unnötigen Jargon und komplexe Sprache.
- Halten Sie Wörter und Sätze kurz.
Eine Beschriftung einfügen
Beschriften Sie die Jahr-Auswahl mit einem aussagekräftigen, beschreibenden Text. In dieser Beschriftung müssen der Zweck und die Art des auszuwählenden Jahres angegeben sein.


Fügen Sie Hilfetext hinzu, wenn er aussagekräftig ist
Verwenden Sie Hilfetext, um Kontext bereitzustellen und zu kommunizieren, welches Jahr ausgewählt werden soll. Hier sind einige Beispiele dafür, was darin stehen könnte:
- Hinweise, die den Benutzer bei der Auswahl des entsprechenden Jahres unterstützen
- Mehr Kontext, warum der Benutzer ein bestimmtes Jahr auswählen muss
Verwenden Sie Hilfetext nur für relevante Informationen. Vermeiden Sie es, die gleichen Angaben wie in der Beschriftung zu wiederholen. Schreiben Sie den Hilfetext in 1 bis 2 kurzen, vollständigen Sätzen, die mit einem Punkt enden. Verwenden Sie die übliche Groß- und Kleinschreibung.


Verhalten
Zustände
Die Jahr-Auswahl-Komponente verhält sich wie ein Eingabefeld, mit den gleichen interaktiven Zuständen.
Interaktionen
Maus
Die Benutzer können das Jahr manuell in das Jahr-Auswahlfeld eingeben oder das Kalendersymbol anklicken, um das Jahr aus einer Dropdown-Liste auszuwählen.
Tastatur
Die Datumsauswahl wird mit Spacebar aus- und eingeklappt. Die Benutzer navigieren mit den Pfeiltasten durch die Optionen und wählen mit der Taste Spacebar oder Enter aus.
Wenn der Benutzer mit der Tabulatortaste in das Eingabefeld für die Datumsauswahl wechselt, wird ein Kalender-Widget angezeigt. Das aktuelle Datum wird hervorgehoben und Nur-Tastatur-Benutzer können das Datum hier manuell eingeben. Durch Drücken der NACH-UNTEN-TASTE können Benutzer den Tastaturfokus auch auf das Widget legen, wenn es erweitert ist. Navigieren Sie mit den Pfeiltasten durch den Kalender. Die Schaltflächen „Zurück“, „Monat“, „Jahr“ und „Weiter“ können mit der Tab-Taste fokussiert werden, wenn das Widget geöffnet ist.
Screenreader
Die Benutzer werden über den vorausgefüllten Datumswert informiert, und darüber, dass dieser Wert aktuell aktiviert ist, wenn sie mit der Tabulatortaste in das Eingabefeld für die Datumsauswahl wechseln. Über dieses Eingabefeld kann das Datum manuell eingegeben werden. Solange das vorausgefüllten Datum fokussiert wird, ist auch ein Kalender-Widget verfügbar. Die Benutzer können den Fokus durch Drücken der Abwärtspfeiltaste auch auf das Widget verschieben. Die Navigation durch den Kalenderbereich des Widgets erfolgt über die Pfeiltasten. Der Wert, der aktuell den Fokus hat, wird von Screenreadern über das WAI-ARIA-Attribut aria-label ausgegeben. Die Schaltflächen „Zurück“, „Monat“, „Jahr“ und „Weiter“ sind über die Tab-Taste fokussierbar, wenn das Widget geöffnet ist. Die React-Datumsauswahl aktiviert derzeit nicht die Tastaturnavigation zum Link „Heute“.
Handhabung von Eingaben
In der Jahresauswahl-Komponente können Benutzer die Einfügemarke (den blinkenden Textcursor) nicht so steuern, dass der Wert teilweise gelöscht werden kann. Benutzer können in das Feld klicken, um den Cursor zu bewegen. Durch Löschen einer Ziffer wird jedoch der gesamte Wert gelöscht, sodass Benutzer das Jahr neu eingeben müssen. Dieses Verhalten ist bei allen Datumskomponenten einheitlich, bei denen die Eingabe in der Eingabemaske formatiert wird, während ein Benutzer die Eingabe vornimmt.
Barrierefreiheit
Das Kontrastverhältnis von Textelementen zu ihrem Hintergrund liegt über 4,5:1 gemäß den Anforderungen der WCAG 2.1 AA. Nicht-textuelle Inhalte, die eine Bedeutung vermitteln müssen (z. B. Symbole und Sichtbarkeit des Tastaturfokus), weisen ein Kontrastverhältnis von mindestens 3:1 zu den angrenzenden Farben auf. Alle Inhalte sind bis einschließlich 400 % sichtbar und funktionsfähig, ohne dass ein Scrollen in zwei Dimensionen erforderlich ist.
Diese Komponente wurde validiert, um die Zugänglichkeitsrichtlinien WCAG 2.1 AA zu erfüllen. Vom Autor des Inhalts vorgenommene Änderungen können sich jedoch auf die Konformität mit der Barrierefreiheit auswirken.
Achten Sie bei der Verwendung dieser Komponente darauf, dass die Beschriftung eindeutig angibt, welches Jahr der Benutzer eingeben oder auswählen muss.
Code
<YearPicker
label={{
id: 'year-picker',
defaultMessage: 'Enter year',
}}
onChange={(event, value) => console.log('The year chosen is', value.year)}
/>
Importanweisung
import { YearPicker } from '@jutro/components/new';
Komponentenvertrag
Vergewissern Sie sich, dass Sie die API-Oberfläche der Design System-Komponenten und die damit verbundenen Auswirkungen und Kompromisse verstehen. Erfahren Sie mehr in unserer Einführung zur Komponenten-API.
Eigenschaften
labelerforderlich- Beschreibung
Label associated with the input field, also passed as a default value to 'aria-label'.
className- Typ
stringBeschreibungCSS class name for this component.
disabled- Typ
booleanBeschreibungIf set to
true, the component is rendered in disabled state. displayOnly- Typ
booleanBeschreibungIf set to
true, displays the component value in plain text. Consider usingreadonlyinstead, if possible, because plain text is worse for accessibility than readonly inputs. hideCurrentYearButton- Typ
booleanBeschreibungHides the current year button in the calendar.
hideLabel- Typ
booleanBeschreibungIf set to
true, the label is not visible. id- Typ
stringBeschreibungUnique identifier for the component.
initialValue- Typ
{ year: number }BeschreibungInitial value of the input. The value must be in an object format with a year property. If a value prop is specified along with this prop, this prop's value is discarded.
labelPosition- Typ
'top|'left'BeschreibungAllows to select label position.
maxYear- Typ
{ year: number }BeschreibungMaximum allowed year value.
minYear- Typ
{ year: number }BeschreibungMinimum allowed year value.
onBlur- Typ
function (FocusEvent<HTMLInputElement>)BeschreibungA callback called after the component is focused.
onChange- Typ
function (React.ChangeEvent<HTMLInputElement>, { year: number })BeschreibungCallback invoked when component value is changed.
onFocus- Typ
function (FocusEvent<HTMLInputElement>)BeschreibungA callback called after the component is focused.
placeholder- Typ
stringBeschreibungPlaceholder to display on an empty component.
readOnly- Typ
booleanBeschreibungIf set to
true, component is rendered in a read-only state. For values in plain text, consider usingdisplayOnly. required- Typ
booleanBeschreibungIf set to
true, the component is rendered as required and the label will display an asterisk. secondaryLabel- Typ
stringBeschreibungSecondary label text to display.
stateMessages- Typ
{ error: string[] }BeschreibungAn object with a list of error messages for the current state.
tooltip- Typ
{ text: intlMessageShape, trigger: string } | intlMessageShapeBeschreibungText to be displayed in the tooltip or tooltip object that includes: text - to show tooltip content, trigger - to set tooltip trigger.
value- Typ
{ year: number }BeschreibungValue of the input. Takes precedence over initialValue. The value must be in object format with a year property. If this prop is passed, the component works in a controlled mode and its value will change only if this prop changes.
Hooks
Für YearPicker sind keine Hooks verfügbar.
Übersetzungsschlüssel
Die YearPicker-Komponente definiert einen Übersetzungsschlüssel:
| Schlüssel | Verwendet für |
|---|---|
| jutro-components.fields.YearPicker.chooseYear | Der Beschriftungstext für das Eingabefeld. |
Die Komponente YearPicker erbt außerdem die folgenden Übersetzungen:
| Schlüssel | Verwendet für |
|---|---|
| jutro-components.YearCalendar.previousYears | Die Beschriftung für die Schaltfläche für den vorherigen Jahresbereich. |
| jutro-components.YearCalendar.currentYear | Die Beschriftung für die Schaltfläche „Zum aktuellen Jahr gehen“. |
| jutro-components.YearCalendar.currentYearAriaLabel | Die Beschriftung für die Schaltfläche zur Auswahl des aktuellen Jahres als Wert. |
| jutro-components.fields.DatePicker.placeholderYear | Der „Jahr“-Teil des Platzhalters. Muss aus vier sich wiederholenden Zeichen bestehen. |
Datumsformat und Lokalisierung
Das Datum wird entsprechend dem ausgewählten Gebietsschema formatiert. Ist das Gebietsschema zum Beispiel en-US, wird das Datum 20. Januar 2024 folgendermaßen formatiert: „01/20/2024“. Wenn das Gebietsschema en-GB ist, wird es als „20/01/2024“ formatiert.
Escape Hatches
Weitere Informationen finden Sie in unserer Dokumentation über Escape-Hatches.