We want to hear from you!Take our 2021 Community Survey!
This site is no longer updated.Go to react.dev

Komponenten und Props

These docs are old and won’t be updated. Go to react.dev for the new React docs.

These new documentation pages teach modern React and include live examples:

Komponenten erlauben dir deine Benutzeroberfläche in unabhängige, wiederverwendbare Teile aufzubrechen und jeden als isoliert zu betrachten. Diese Seite bietet dir eine Einführung in die Idee hinter Komponenten. Du kannst eine detaillierte Komponentenbeschreibung in der API Referenz finden.

Vom Konzept her sind Komponenten wie JavaScript-Funktionen. Sie akzeptieren beliebige Eingaben (“props” genannt) und geben React-Elemente zurück, welche beschreiben was auf dem Bildschirm angezeigt werden soll.

Funktions- und Klassenkomponenten

Der einfachste Weg eine Komponente zu definieren, ist eine JavaScript-Funktion zu schreiben:

function Welcome(props) {
  return <h1>Hallo {props.name}</h1>;
}

Diese Funktion ist eine gültige React-Komponente, da sie ein einziges “props”- (englische Abkürzung für properties) Objekt mit Daten akzeptiert und ein React-Element zurückgibt. Wir nennen solche Komponenten “Funktionskomponenten”, weil es buchstäblich JavaScript-Funktionen sind.

Du kannst ebenfalls ES6-Klassen benutzen um Komponenten zu definieren:

class Welcome extends React.Component {
  render() {
    return <h1>Hallo {this.props.name}</h1>;
  }
}

Die beiden obigen Komponenten sind aus der Sicht von React identisch.

Funktion- und Klassen-Komponenten haben beide noch ein paar zusätzliche Eigenschaften, welche wir im nächsten Abschnitt besprechen.

Eine Komponente rendern

Bis jetzt haben wir nur React-Elemente kennengelernt, die DOM-Tags repräsentiert haben:

const element = <div />;

Elemente können aber auch benutzerdefinierte Komponenten darstellen:

const element = <Welcome name="Sara" />;

React übergibt, wenn es ein Element als benutzerdefinierte Komponente erkennt, alle JSX Attribute als ein einziges Objekt. Dies sind die sogenannten “props” (Eigenschaften).

Zum Beispiel rendert dieser Code “Hallo Sarah” auf die Seite:

function Welcome(props) {  return <h1>Hallo {props.name}</h1>;
}

const root = ReactDOM.createRoot(document.getElementById('root'));
const element = <Welcome name="Sara" />;root.render(element);

Auf CodePen ausprobieren

Fassen wir mal zusammen, was in diesem Beispiel passiert:

  1. Wir rufen root.render() mit dem React-Element <Welcome name="Sara" /> auf.
  2. React ruft die Welcome Komponente mit den Props {name: 'Sara'} auf.
  3. Unsere Welcome-Komponente gibt als Ergebnis <h1>Hallo Sara</h1> zurück.
  4. React aktualisiert effizient das DOM um <h1>Hallo Sara</h1> abzugleichen.

Hinweis: Beginne den Namen von Komponenten immer mit einem Großbuchstaben.

React behandelt Komponenten, die mit Kleinbuchstaben beginnen, als DOM-Tags. Zum Beispiel stellt <div /> ein HTML div-Tag dar, <Welcome /> hingegen ist eine Komponente und erfordert, dass Welcome im Scope ist.

Bitte lese JSX im Detail, um mehr über diese Konvention zu erfahren.

Komponenten zusammensetzen

Komponenten können bei ihrer Ausgabe auf andere Komponenten verweisen. So können wir für jedes Detaillevel die selben abstrahierten Komponenten wiederverwenden. Denn sowohl Buttons, Formulare als auch Screens, werden in React-Apps allgemein als Komponenten bezeichnet.

Zum Beispiel können wir die App Komponente mehrmals Welcome rendern lassen:

function Welcome(props) {
  return <h1>Hallo {props.name}</h1>;
}

function App() {
  return (
    <div>
      <Welcome name="Sara" />      <Welcome name="Cahal" />      <Welcome name="Edite" />    </div>
  );
}

Auf CodePen ausprobieren

Typischerweise haben neue React-Apps eine einzige App Komponente an erster Stelle. Wenn du aber React in ein bestehendes Projekt integrierst, fängst du wahrscheinlich von unten nach oben (bottom-up) an und erstellst Komponenten wie Button, dabei arbeitest dich Schritt für Schritt die View-Hierarchie nach oben.

Komponenten auslagern

Hab keine Angst vor dem Aufteilen von Komponenten in kleinere Komponenten.

Nehmen wir mal als Beispiel diese Comment-Komponente:

function Comment(props) {
  return (
    <div className="Comment">
      <div className="UserInfo">
        <img className="Avatar"
          src={props.author.avatarUrl}
          alt={props.author.name}
        />
        <div className="UserInfo-name">
          {props.author.name}
        </div>
      </div>
      <div className="Comment-text">
        {props.text}
      </div>
      <div className="Comment-date">
        {formatDate(props.date)}
      </div>
    </div>
  );
}

Auf CodePen ausprobieren

Diese Komponente nimmt author (ein Objekt), text (ein String), und date (ein date-Objekt) als Props entgegen und beschreibt einen Kommentar auf einer Social Media Webseite.

Aufgrund der Verschachtlung könnte diese Komponente schwer abänderbar sein, außerdem ist es auch schwierig einzelne Teile davon wiederzuverwenden. Lass uns doch mal ein paar Komponenten daraus ziehen.

Als erstes werden wir Avatar auslagern:

function Avatar(props) {
  return (
    <img className="Avatar"      src={props.user.avatarUrl}      alt={props.user.name}    />  );
}

Der Avatar muss nicht wissen, dass er in innerhalb von Comment gerendert wird. Darum geben wir dem prop einen gebräuchlicheren Namen als: author und nennen es user.

Wir empfehlen props nicht nach dem Kontext in dem sie verwendet werden, sondern aus dem sie kommen zu benennen.

Wir können nun Comment ein bisschen vereinfachen:

function Comment(props) {
  return (
    <div className="Comment">
      <div className="UserInfo">
        <Avatar user={props.author} />        <div className="UserInfo-name">
          {props.author.name}
        </div>
      </div>
      <div className="Comment-text">
        {props.text}
      </div>
      <div className="Comment-date">
        {formatDate(props.date)}
      </div>
    </div>
  );
}

Als nächstes werden wir eine UserInfo Komponente extrahieren, welche einen Avatar neben den Namen des Benutzers rendert:

function UserInfo(props) {
  return (
    <div className="UserInfo">      <Avatar user={props.user} />      <div className="UserInfo-name">        {props.user.name}      </div>    </div>  );
}

Dadurch können wir Comment weiter vereinfachen:

function Comment(props) {
  return (
    <div className="Comment">
      <UserInfo user={props.author} />      <div className="Comment-text">
        {props.text}
      </div>
      <div className="Comment-date">
        {formatDate(props.date)}
      </div>
    </div>
  );
}

Auf CodePen ausprobieren

Komponenten zu extrahieren mag sich wie Routinearbeit anfühlen, aber am Ende zahlt es sich für größere Apps aus, eine Palette an wiederverwendbaren Komponenten zu haben. Eine gute Faustregel ist es, dass wenn ein Teil der Benutzeroberfläche (Button, Panel, Avatar) öfters verwendet wird oder für sich allein komplex genug ist (App, FeedStory, Comment), dies gute Kandidaten für wiederverwendbare Komponenten sind.

Props sind Read-Only

Es ist egal, ob eine Komponente als Funktion oder Klasse deklariert wird, sie darf nie ihre eigenen props verändern. Schauen wir uns mal diese sum Funktion an:

function sum(a, b) {
  return a + b;
}

Solch eine Funktion wird als “pure” bezeichnet, da sie nicht ihre Eingaben ändert und immer das gleiche Ergebnis für die gleichen Eingaben zurückgibt.

Im Umkehrschluss ist diese Funktion keine “pure function”, sondern “impure”, da sie ihre eigenen Eingaben ändert:

function withdraw(account, amount) {
  account.total -= amount;
}

React ist sehr flexibel, es gibt aber eine strikte Regel:

Alle React-Komponenten müssen sich im Bezug auf ihre Props, als sogenannte “pure functions” verhalten.

Natürlich sind Anwendungen dynamisch und ändern ihre Benutzeroberfläche über die Zeit. Im nächsten Abschnitt werden wir das “state” Konzept vorstellen. React-Komponenten reagieren auf Benutzereingaben, Netzwerkantworten und vieles mehr, dabei erlaubt uns der State (Zustand), die Ausgabe einer Komponente über die Zeit zu ändern.

Ist diese Seite hilfreich?Bearbeite diese Seite