HOWTO · React

Wie man einen wiederverwendbaren Range Slider in React erstellt

Erstellen Sie einen wiederverwendbaren, von der übergeordneten Komponente gesteuerten Range Slider in React mit einem HTML-Eingabeelement. Der Artikel erklärt außerdem, warum ein paketbasiertes Beispiel mit zwei Werten eine release-spezifische API-Dokumentation benötigt.

Auf dieser Seite

Ein natives HTML-<input type="range"> ist ein guter Ausgangspunkt für einen Schieberegler mit einem einzelnen Wert in React. Halten Sie seinen Wert in der übergeordneten Komponente und übergeben Sie den Wert, die Grenzen und den Änderungs-Handler an einen wiederverwendbaren RangeSlider. Für zwei unabhängig ausgewählte Werte ist multi-range-slider-react ein externes Paket; seine release-spezifische API muss geprüft werden, bevor eine funktionierende Integration geschrieben werden kann.

Verwenden Sie HTML <input>, um eine benutzerdefinierte RangeSlider-React-Komponente zu erstellen

Halten Sie den aktuellen Wert in der übergeordneten Komponente, damit er angezeigt oder anderswo in der App verwendet werden kann. Die übergeordnete Komponente übergibt value, min, max und onChange als direkte Props. Die untergeordnete Komponente verwendet dieselben Props am nativen Eingabeelement und wandelt den Zeichenkettenwert der Eingabe in eine Zahl um, bevor sie den Zustand aktualisiert.

Das folgende Browser-Markup ist eine statische Veranschaulichung des nativen Steuerelements. Es ist keine React-Komponente und hat für sich allein keine Laufzeitausgabe:

<label for="volume">Volume: <output id="volume-value">40</output></label>
<input id="volume" type="range" min="0" max="100" value="40">

Ordnen Sie in einer React-App die übergeordnete und die wiederverwendbare Komponente in getrennten Dateien an. Diese vollständigen einzeiligen Dateien verwenden JSX, wie es von einem Standard-Build einer React-App unterstützt wird. Importieren Sie in App.js useState, initialisieren Sie den Wert der übergeordneten Komponente und übergeben Sie übereinstimmende Grenzen, Wert und Handler-Props an die untergeordnete Komponente:

App.js: import { useState } from 'react'; import RangeSlider from './rangeSlider'; export default function App() { const [value, setValue] = useState(40); return <main><p>Volume: {value}</p><RangeSlider min={0} max={100} value={value} onChange={(event) => setValue(Number(event.currentTarget.value))} /></main>; }

Nehmen Sie in rangeSlider.js diese direkten Props entgegen und exportieren Sie die Komponente als den von App.js verwendeten Standard-Export:

rangeSlider.js: export default function RangeSlider({ min, max, value, onChange }) { return <input type="range" min={min} max={max} value={value} onChange={onChange} aria-label="Volume" />; }

Hier besitzt App den Wert, während RangeSlider das Steuerelement aus seinen Props rendert. Wenn der Benutzer den Regler bewegt, liest onChange den neuen Wert aus event.currentTarget.value, wandelt ihn in eine Zahl um und ruft setValue auf. React rendert dann die aktualisierte Zahl und übergibt sie zurück an das Eingabeelement. Halten Sie den barrierefreien Namen des Eingabeelements passend zu dem Wert, den es steuert.

Die Umwandlung vom Ereignis zum Zustand verwendet gewöhnliches JavaScript und kann unabhängig von React veranschaulicht werden:

const currentValue = 40;
const event = { currentTarget: { value: '57' } };
const nextValue = Number(event.currentTarget.value);
const displayedValue = nextValue;
console.log(`Value: ${displayedValue}`);
Value: 57

Das ausführbare Snippet zeigt nur die numerische Umwandlung und den angezeigten Wert; die obigen React-Komponenten zeigen, wie derselbe Wert mit dem Komponentenzustand verbunden wird. Die Laufzeitnachweise zu diesem Artikel decken diese JavaScript-Umwandlung ab, nicht die Ausführung von React oder JSX.

Verwenden Sie die multi-range-slider-react-Bibliothek, um einen Multi-Range-Slider in React zu erstellen

Ein natives Bereichs-Eingabeelement stellt einen aktuellen Wert dar. multi-range-slider-react ist ein externes Paket, keine in React eingebaute Bibliothek; seine npm-Paketseite listet die Paket-Releases auf. Das bereitgestellte Material identifiziert kein festgelegtes Release und enthält weder dessen Dokumentation noch dessen Quellcode, sodass es die für ein funktionierendes Beispiel benötigten Komponenten-Props oder Ereignisdaten nicht belegen kann. Kopieren Sie keine geratenen Prop-Namen oder Ereignisfelder in eine Integration. Wählen Sie vor der Implementierung dieses Pakets ein Release, prüfen Sie in dessen Dokumentation oder Quellcode, wie die unteren und oberen Werte übergeben und zurückgegeben werden, und legen Sie diese verifizierte Version in Ihrer Anwendung fest.

Dieser Artikel kann noch keine funktionierende MultiRangeSlider-Integration demonstrieren, ausgewählte untere und obere Werte anzeigen oder Zustandsaktualisierungen der übergeordneten Komponente aus einem Paketereignis zeigen. Diese Details hängen von der dokumentierten API des gewählten Releases ab. Die ausführbare JavaScript-Veranschaulichung oben deckt nur die numerische Umwandlung für den nativen RangeSlider mit einem einzelnen Wert ab; sie führt weder React noch dieses Paket aus.

Verwenden Sie den nativen RangeSlider, wenn Sie einen von der übergeordneten Komponente gesteuerten Wert benötigen und die kleine Komponente selbst besitzen möchten. Eine paketbasierte Implementierung mit zwei Werten benötigt verifizierte release-spezifische API-Details, bevor ihre Props und ihr Pfad zur Zustandsaktualisierung genau gezeigt werden können. Dies sind getrennte Ansätze; die native Komponente wird vom Paket nicht verwendet.