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.
Đâ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
);
}
() => ({ 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
| Pattern | Ngà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 hook | Mặ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-indexcủ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ớionClickcủ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 (popoverattribute) — 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. getSnapshottrả 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
(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
-
react.dev — useSyncExternalStoreAPI referenceDocs
-
Mã nguồn Zustand~100 dòng, rất đáng đọcSource
-
DownshiftProp getters patternLibrary
✅ Tự đánh giá hoàn thành
- Tôi giải thích được tearing và cách
useSyncExternalStorengă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