React từ cơ bản đến nâng cao
Trang chủ / Module 19
🧠 Module 19 / 22 · 5 ngày 📅 Tuần 10 ●●●● Cực khó

Pattern nâng cao: useSyncExternalStore, headless, polymorphic, portal

Đồng bộ store bên ngoài an toàn với concurrent rendering (tearing), tự viết mini-Zustand, headless hook, render props/HOC thời hooks, polymorphic component, portal và quản lý z-index.

useSyncExternalStoreHeadlessPolymorphicPortal
📌 Vì sao module này quan trọng

Đây là những kỹ thuật bên trong các thư viện bạn dùng hằng ngày (Zustand, Redux, TanStack, Radix, Headless UI). Khi hiểu chúng, bạn tự viết được thư viện nội bộ cho team và debug được những lỗi "chỉ xảy ra khi màn hình bận".

🎯 Mục tiêu học tập

  • Giải thích tearing và vì sao cần useSyncExternalStore
  • Tự viết store có selector giống Zustand
  • Viết headless hook tách logic khỏi giao diện
  • Biết khi nào render props / HOC còn hữu ích
  • Viết polymorphic component có kiểu đúng
  • Dùng portal cho modal/tooltip và hiểu sự kiện nổi bọt qua portal

Tearing và useSyncExternalStore

Với concurrent rendering, React có thể render một nửa cây, nhường main thread, rồi render nửa còn lại. Nếu trong khoảng đó một store bên ngoài React (biến toàn cục, Redux cũ, window.innerWidth) thay đổi, nửa đầu và nửa sau đọc hai giá trị khác nhau → giao diện "rách" (tearing): hai component cạnh nhau hiển thị dữ liệu mâu thuẫn.

useSyncExternalStore giải quyết: React đọc snapshot, và nếu snapshot đổi giữa chừng thì render lại đồng bộ để đảm bảo nhất quán.

function subscribe(cb: () => void) {
  window.addEventListener('resize', cb);
  return () => window.removeEventListener('resize', cb);
}
export function useWindowWidth() {
  return useSyncExternalStore(
    subscribe,
    () => window.innerWidth,     // getSnapshot: phải trả về cùng giá trị nếu không đổi
    () => 1024,                  // getServerSnapshot: dùng khi SSR
  );
}
⚠️ getSnapshot phải ổn định

() => ({ w: window.innerWidth }) trả về object mới mỗi lần → React nghĩ luôn đổi → vòng lặp render vô hạn. Trả về giá trị nguyên thuỷ hoặc object đã cache.

Tự viết mini-Zustand

type Listener = () => void;

export function createStore<T>(initial: T) {
  let state = initial;
  const listeners = new Set<Listener>();
  const getState = () => state;
  const setState = (partial: Partial<T> | ((s: T) => Partial<T>)) => {
    const next = typeof partial === 'function' ? partial(state) : partial;
    state = { ...state, ...next };
    listeners.forEach(l => l());
  };
  const subscribe = (l: Listener) => { listeners.add(l); return () => listeners.delete(l); };

  function useStore<S>(selector: (s: T) => S): S {
    return useSyncExternalStore(subscribe, () => selector(state), () => selector(initial));
  }
  return { getState, setState, subscribe, useStore };
}

const counter = createStore({ count: 0, name: 'An' });
function Count() {
  const count = counter.useStore(s => s.count);        // đổi name không làm Count render lại
  return <button onClick={() => counter.setState(s => ({ count: s.count + 1 }))}>{count}</button>;
}

Lưu ý: selector trả về object/mảng mới (s => s.items.filter(...)) sẽ gây vòng lặp — thư viện thật thêm so sánh nông hoặc memo hoá selector (useSyncExternalStoreWithSelector, useShallow).

Headless hook: logic không có giao diện

function useCombobox<T>({ items, itemToString }: { items: T[]; itemToString: (i: T) => string }) {
  const [open, setOpen] = useState(false);
  const [input, setInput] = useState('');
  const [active, setActive] = useState(0);
  const id = useId();
  const filtered = items.filter(i => itemToString(i).toLowerCase().includes(input.toLowerCase()));

  const getInputProps = () => ({
    role: 'combobox', 'aria-expanded': open, 'aria-controls': `${id}-list`,
    'aria-activedescendant': open ? `${id}-opt-${active}` : undefined,
    value: input,
    onChange: (e: React.ChangeEvent<HTMLInputElement>) => { setInput(e.target.value); setOpen(true); setActive(0); },
    onKeyDown: (e: React.KeyboardEvent) => {
      if (e.key === 'ArrowDown') setActive(a => Math.min(a + 1, filtered.length - 1));
      if (e.key === 'ArrowUp') setActive(a => Math.max(a - 1, 0));
      if (e.key === 'Enter' && filtered[active]) { setInput(itemToString(filtered[active])); setOpen(false); }
      if (e.key === 'Escape') setOpen(false);
    },
  });
  const getOptionProps = (index: number) => ({
    id: `${id}-opt-${index}`, role: 'option', 'aria-selected': index === active,
    onMouseDown: () => { setInput(itemToString(filtered[index])); setOpen(false); },
  });
  return { open, filtered, active, getInputProps, getOptionProps, listProps: { id: `${id}-list`, role: 'listbox' } };
}

Mẫu "prop getters" (getInputProps) cho phép người dùng tự quyết định giao diện mà vẫn đúng ARIA và bàn phím — cách Downshift, TanStack Table, React Aria làm.

Render props và HOC thời hooks

PatternNgày nay dùng khi
Render props <DataTable renderRow={row => ...} />Cần cho người dùng tuỳ biến một phần giao diện bên trong component (row, cell, item)
HOC withAuth(Component)Hiếm: bọc cross-cutting ở biên (route guard, error boundary, analytics) hoặc code legacy. Nhược: che props, khó gõ kiểu, "wrapper hell"
Custom hookMặc định để chia sẻ logic

Polymorphic component

type PolymorphicProps<E extends React.ElementType, P = {}> = P & { as?: E } &
  Omit<React.ComponentPropsWithRef<E>, keyof P | 'as'>;

type TextOwnProps = { size?: 'sm' | 'md' | 'lg'; weight?: 'normal' | 'bold' };

export function Text<E extends React.ElementType = 'span'>({ as, size = 'md', weight = 'normal', ...rest }: PolymorphicProps<E, TextOwnProps>) {
  const Tag = as ?? 'span';
  return <Tag className={`text-${size} font-${weight}`} {...rest} />;
}

<Text as="label" htmlFor="email" size="sm">Email</Text>     // có htmlFor vì là label
<Text as="a" href="/docs" weight="bold">Docs</Text>         // có href vì là a
<Text as={Link} to="/home">Home</Text>                       // nhận props của Link

Thay thế hiện đại: mẫu asChild của Radix (<Button asChild><a href="/">…</a></Button>) — gộp props vào phần tử con thay vì đổi thẻ, kiểu đơn giản hơn.

Portal

import { createPortal } from 'react-dom';

function Modal({ open, onClose, children }) {
  if (!open) return null;
  return createPortal(
    <div className="backdrop" onClick={onClose}>
      <div role="dialog" aria-modal="true" onClick={e => e.stopPropagation()}>{children}</div>
    </div>,
    document.body,
  );
}
  • Portal đưa DOM ra ngoài (thoát overflow: hidden, z-index của cha) nhưng vẫn nằm trong cây React: context vẫn truyền vào, sự kiện React nổi bọt theo cây React chứ không theo cây DOM — click trong modal sẽ tới onClick của component cha chứa <Modal>.
  • Thay thế gốc của trình duyệt đáng cân nhắc: <dialog> + showModal() (top layer, tự giữ focus, Esc) và Popover API (popover attribute) — không cần portal và z-index.

🚩 Sai lầm hay gặp

  • Đọc biến toàn cục thay đổi được trong render mà không qua useSyncExternalStore.
  • getSnapshot trả object mới mỗi lần.
  • Quên rằng sự kiện trong portal nổi bọt lên cha React → đóng dropdown ngoài ý muốn.

🏋️ Bài tập thực hành

Thư viện nội bộ mini

(1) Tự viết createStore có selector + middleware persist, test bằng Vitest. (2) Viết useCombobox headless + 2 giao diện khác nhau dùng chung hook. (3) Viết Text polymorphic. (4) Viết Modal bằng <dialog> và so sánh với bản portal.

📚 Tài nguyên học tập

✅ Tự đánh giá hoàn thành

  • Tôi giải thích được tearing và cách useSyncExternalStore ngăn nó
  • Tôi tự viết được store có selector
  • Tôi viết được headless hook với prop getters
  • Tôi viết được polymorphic component có kiểu đúng
  • Tôi giải thích được sự kiện nổi bọt qua portal