React Academy · Lekcja

Klonowanie i wstrzykiwanie propsów za pomocą cloneElement

Używaj React.cloneElement do przekazywania ukrytych propsów z komponentu nadrzędnego do potomnego

Lekcja 4 z 413 kroki

Klonowanie i wstrzykiwanie propsów za pomocą cloneElement to bezpłatna lekcja React Academy na CoddyKit. To lekcja 4 z 4. Możesz przeczytać całą lekcję poniżej za darmo — a potem ćwiczyć ją interaktywnie w przeglądarce z wbudowanym edytorem kodu i tutorem AI dostępnym 24/7. To część ścieżki edukacyjnej React Academy, a Twój postęp synchronizuje się między webem a aplikacją CoddyKit. Kurs React Academy zawiera 4 lekcji w sumie.

Wprowadzenie

W tej lekcji wykorzystają Państwo React.cloneElement do sklonowania elementu będącego dzieckiem i wstrzyknięcia dodatkowych właściwości z komponentu nadrzędnego, bez konieczności informowania o nich dziecka.

Czym jest cloneElement?

`React.cloneElement(element, props, ...children)` tworzy nowy element React na podstawie istniejącego elementu, łącząc nowe właściwości z właściwościami oryginalnymi. Typ oryginalnego elementu zostaje zachowany.
const clone = React.cloneElement(child, { active: true });

Dlaczego używać cloneElement?

Komponent nadrzędny może wstrzyknąć zachowanie, takie jak stan aktywności lub procedury obsługi zdarzeń, do swoich dzieci bez wiedzy dzieci o tym mechanizmie. Stosuje się to w systemach kart, akordeonach i grupach formularzy.

Przykład paska kart

Komponent Tabs może sklonować każde dziecko Tab i automatycznie wstrzyknąć właściwości `isActive` oraz `onClick`, dzięki czemu osoba korzystająca z komponentu nie musi konfigurować ich ręcznie.
function Tabs({ children, activeIndex, onChange }) {
  return (
    <div className="tabs">
      {React.Children.map(children, (child, i) =>
        React.cloneElement(child, {
          isActive: i === activeIndex,
          onClick: () => onChange(i),
        })
      )}
    </div>
  );
}

Zasady łączenia właściwości

cloneElement łączy nowe właściwości, nadając im **pierwszeństwo** przed właściwościami oryginalnymi. Jeśli oryginalny element ma już właściwość o tym samym kluczu, wygrywa nowa wartość. style i className są zastępowane, a nie łączone, chyba że zostanie to obsłużone ręcznie.

Łączenie procedur obsługi zdarzeń

Aby połączyć procedury obsługi zdarzeń zamiast je nadpisywać, należy ręcznie połączyć funkcje zwrotne przed przekazaniem ich do cloneElement.
React.cloneElement(child, {
  onClick: (e) => {
    child.props.onClick?.(e); // original handler
    handleClick(e);           // injected handler
  },
})

Zastępowanie dzieci

Trzeci argument funkcji `cloneElement` zastępuje children elementu. Należy przekazać nową zawartość, aby całkowicie zastąpić oryginalne dzieci.
// Replace children with wrapped version
React.cloneElement(child, {}, <strong>{child.props.children}</strong>)

Sprawdzanie typu elementu przed sklonowaniem

Przed sklonowaniem należy sprawdzić, czy dziecko jest prawidłowym elementem React, a opcjonalnie także zweryfikować jego typ, aby uniknąć klonowania elementów niebędących elementami React, takich jak tekst, liczby lub null.
if (React.isValidElement(child)) {
  return React.cloneElement(child, extraProps);
}
return child;

cloneElement a Context

cloneElement jest podatne na problemy, ponieważ wymaga znajomości struktury dziecka. Context jest zazwyczaj preferowany do przekazywania niejawnych danych przez wiele poziomów. cloneElement należy stosować wyłącznie do wstrzykiwania właściwości między bezpośrednim komponentem nadrzędnym a dzieckiem.

Nowoczesna alternatywa: render props i hooki

W wielu przypadkach, w których historycznie używano cloneElement, własny hook lub render prop jest przejrzystszym rozwiązaniem. cloneElement warto rozważyć, gdy mają Państwo pełną kontrolę zarówno nad komponentem nadrzędnym, jak i jego bezpośrednimi dziećmi.

Szybkie sprawdzenie

Co dzieje się z właściwością, która istnieje zarówno w oryginalnym elemencie, jak i w obiekcie właściwości przekazanym do React.cloneElement?

Podsumowanie

React.cloneElement klonuje element i wstrzykuje nowe właściwości. Należy używać go do niejawnego przekazywania właściwości z komponentu nadrzędnego do dziecka w komponentach złożonych. Gdy hierarchia jest głębsza, lepiej użyć Context lub render props.

Ukończenie kursu

Gratulacje! Ukończono kurs **React Children API i wzorzec slotów**. Opanowali Państwo props.children, narzędzia React.Children, właściwości nazwanych slotów oraz cloneElement, które służą do budowania elastycznych komponentów układu.
Bezpłatny start

Ucz się React dzięki korepetycjom AI — za darmo

Pisz i uruchamiaj kod w przeglądarce, otrzymuj natychmiastową pomoc od korepetytora AI dostępnego 24/7 i kontynuuj naukę w sieci lub w aplikacji.

Kursy
88
Lekcje
324

Często zadawane pytania

Czy lekcja „Klonowanie i wstrzykiwanie propsów za pomocą cloneElement” jest bezpłatna?

Tak — pełny tekst „Klonowanie i wstrzykiwanie propsów za pomocą cloneElement” jest dostępny za darmo tutaj w sieci. Aby ćwiczyć ją interaktywnie (wbudowany edytor kodu i tutor AI dostępny 24/7) i odblokować resztę kursu React Academy, przejdź na CoddyKit PRO. Kurs React Academy zawiera 4 lekcji w sumie.

Co nauczysz się w „Klonowanie i wstrzykiwanie propsów za pomocą cloneElement”?

Używaj React.cloneElement do przekazywania ukrytych propsów z komponentu nadrzędnego do potomnego Ćwiczysz React Academy z praktycznym kodem, który uruchamiasz bezpośrednio w przeglądarce, a tutor AI dostępny 24/7 odpowiada na Twoje pytania podczas pracy nad lekcją.

Czy potrzebuję doświadczenia, aby zacząć React Academy?

Nie wymagamy żadnego doświadczenia. React Academy w CoddyKit jest strukturyzowany dla początkujących i zaawansowanych użytkowników, więc możesz zacząć tutaj lub od początku i uczyć się w swoim tempie. To lekcja 4 z 4.

Ile czasu zajmuje lekcja „Klonowanie i wstrzykiwanie propsów za pomocą cloneElement”?

Większość lekcji CoddyKit trwa około 5–10 minut. Każda lekcja to mały, interaktywny krok, dzięki czemu robisz systematyczne postępy i zawsze wracasz dokładnie do tego samego miejsca — na webie i w aplikacji.

Czy mogę pisać i uruchamiać kod w tej lekcji React Academy?

Tak. Każda lekcja React Academy zawiera wbudowany edytor kodu, więc piszesz i uruchamiasz prawdziwy kod bezpośrednio w przeglądarce i od razu otrzymujesz sprzężenie zwrotne od AI — bez konfiguracji na komputerze.

Wszystkie lekcje w tym kursie

  1. Podstawy props.children
  2. Narzędzia React.Children
  3. Nazwane sloty za pomocą propsów obiektowych
  4. Klonowanie i wstrzykiwanie propsów za pomocą cloneElement
← Powrót do React Academy