Skocz do treści

Już wkrótce odpalamy zapisy na drugą edycję next13masters.pl. Zapisz się na listę oczekujących!

Projektowanie komponentów: Presentational & Container Components

Często w różnych artykułach poświęconych Reactowi i Reduksowi napotkasz takie sformułowania jak Presentational and Container Components albo Skinny and Fat Components albo Dumb and Smart Components i być może jeszcze kilka innych podobnych ;) Wszystkie te określenia oznaczają to samo: Podział komponentów na 2 rodzaje: Służące prezentacji oraz zawierające logikę.

Ten artykuł jest częścią 27 z 43 w serii React.js.

Zdjęcie Michał Miszczyszyn
JavaScript9 komentarzy

Presentational Components

Bardzo lubię określenie dumb, bo ono naprawdę oddaje sedno takich komponentów. To komponenty głupie. Obchodzi je tylko jak rzeczy wyglądają.

Komponent prezentacyjny definiuje to jak coś wygląda. Może zawierać inne komponenty, na pewno będzie też zawierał inne elementy HTML. Co istotne: Nie zależy od zewnętrznych serwisów ani części aplikacji. Nie wykonuje żądań do API. Nie wie co to Redux. Nie korzysta z akcji. Nie mutuje danych.

Komponent głupi czasem może mieć swój stan (w sensie setState), ale jest to stan lokalny, związany z interfejsem.

Container Components

Robią wszystko to, czego nie robią komponenty prezentacyjne ;) Definiują to jak rzeczy działają.

Taki mądry komponent definiuje sposób działania aplikacji. Logikę biznesową. Może zawierać inne komponenty, albo (rzadziej) jakieś proste elementy HTML, ale nie definiuje wyglądu. Dostarcza dane oraz callbacki do komponentów prezentacyjnych. Wywołuje akcje, pobiera dane z API, korzysta ze store Reduksa.

Po co?

Jest kilka powodów, aby dzielić komponenty w taki sposób:

  • Single Responsibility Principle — jedna z najważniejszych zasad w architekturze aplikacji. Jeden komponent jest źródłem informacji, a inny wie jak coś ma wyglądać. Podział odpowiedzialności.
  • Testowalność — komponenty prezentacyjnie testuje się banalnie. Nie musisz praktycznie niczego mockować. Dostarczasz dane, robisz shallow rendering i sprawdzacz czy elementy się poprawnie wyrenderowały.
  • Reużywalność (zabijcie mnie za to słowo) — Komponenty prezentacyjne można bardzo łatwo użyć w różnych miejscach, w różnych kontekstach. Przykładowo, jeśli masz komponent, który renderuje kafelki z miniaturkami filmów, to możesz go łatwo użyć na stronie głównej do wyświetlanie najnowszych filmów i na stronie profilu użytkownika do wyświetlenia polubionych przez nią filmów. To ten sam komponent, tylko dwa różne źródła danych (dwa różne Container Components).
  • Łatwość tworzenia styleguida albo storybooków — Komponenty prezentacyjne mogą bez problemu istnieć zupełnie poza całą aplikacją, jeśli tylko otrzymają poprawne dane jako propsy. Dzięki temu można stworzyć prostą stronkę, na której designerki będą mieli wyrenderowane wszystkie komponenty i będą mogli je dopracowywać i testować.

Przykład

Jak to wygląda w praktyce? Weźmy wspomniany wcześniej przykład z filmami. Chcemy renderować ich listę pobraną z API:

class MoviesList extends React.Component {
  state = { movies: [], isLoading: false };

  componentDidMount() {
    this.setState({ isLoading: true });
    fetch('/api/movies')
      .then((res) => res.json())
      .then((movies) => this.setState({ movies, isLoading: false }));
  }

  render() {
    if (this.state.isLoading) {
      return <p>Ładowanie…</p>;
    }

    return (
      <ul>
        {this.state.movies.map((movie) => (
          <li>{movie.title}</li>
        ))}
      </ul>
    );
  }
}

Ten komponent bez wątpienia robi zbyt wiele rzeczy: Pobiera dane z API, a następnie je renderuje. Do tego, jest on na stałe związany z konkretną końcówką API — a więc użycie listy filmów na stronie profilu użytkownika jest niemożliwe bez duplikacji kodu! To nie powinno w ogóle przejść code review! Należałoby go podzielić na dwa osobne komponenty: Dumb i Smart:

class MoviesList extends React.Component {
  render() {
    if (this.props.isLoading) {
      return <p>Ładowanie…</p>;
    }

    return (
      <ul>
        {this.props.movies.map((movie) => (
          <li>{movie.title}</li>
        ))}
      </ul>
    );
  }
}
class MoviesListContainer extends React.Component {
  state = { movies: [], isLoading: false };

  componentDidMount() {
    this.setState({ isLoading: true });
    fetch('/api/movies')
      .then((res) => res.json())
      .then((movies) => this.setState({ movies, isLoading: false }));
  }

  render() {
    return <MoviesList movies={this.state.movies} isLoading={this.state.isLoading} />;
  }
}

Teraz bez problemu komponent MoviesList może być użyty w kilku miejscach niezależnie, z różnymi danymi!

Od czego zacząć?

Przede wszystkim: Nie utrudniaj sobie życia. Chodzi o to, aby kod uprościć, a nie na siłę komplikować.

Pisz kod tak, jak lubisz — a dopiero gdy zaczniesz dostrzegać korzyści płynące z podziału na komponenty Presentational i Container — wtedy zacznij ich używać ;) To nie jest kult. To rozsądek.

Redux

A jak to się ma do Reduksa? Jeśli używasz Reduksa to naturalnie automatycznie tworzysz dwa rodzaje komponentów. Praktycznie cały Twój kod to tak naprawdę komponenty prezentacyjne. Funkcja connect bierze taki komponent i zwraca nic innego jak właśnie Container Component! Przywołując przykład z poprzedniego wpisu:

// to jest Twój komponent prezentacyjny — zauważ, że korzysta tylko z przekazanych propsów!
class ContactsFilter extends React.Component {
  render() {
    return ();
  }

  handleSearchChange = e => {
    this.props.searchContacts(e.currentTarget.value);
  };
}

// tutaj tworzony jest Container Component:
const mapStateToProps = state => {
  return {
    contactsSearch: state.contactsSearch
  };
};

const mapDispatchToProps = { searchContacts };

export const ContactsFilterContainer = connect(
  mapStateToProps,
  mapDispatchToProps
)(ContactsFilter);

Czy teraz ma to sens? zapisz się na szkolenie z React i Redux.

Jeśli chcesz na bieżąco dowiadywać się o kolejnych częściach kursu React.js to koniecznie śledź mnie na Facebooku i zapisz się na newsletter.

Ćwiczenie

Ćwiczenie: Zrefaktoruj plik App.jsx z poprzedniego odcinka. Zmień go tak, aby podział na komponenty smart i dumb był zachowany również tutaj. Podziel się kodem w komentarzu!

👉  Znalazłeś/aś błąd?  👈Edytuj ten wpis na GitHubie!

Autor