https://react-ko.dev/reference/react/useId accessibility ์†์„ฑ์— ์ „๋‹ฌํ•  ์ˆ˜ ์žˆ๋Š” ๊ณ ์œ  ID๋ฅผ ์ƒ์„ฑํ•˜๊ธฐ ์œ„ํ•œ ํ›…

const id = useId()

Returns

  • ํŠน์ • ์ปดํฌ๋„ŒํŠธ ๋‚ด ํŠน์ • useId์™€ ๊ด€๋ จ๋œ ๊ณ ์œ  ID ๋ฌธ์ž์—ด์„ ๋ฐ˜ํ™˜ํ•œ๋‹ค. ์ด ๊ฐ’์€ ๋ฆฌ๋ Œ๋”๋ง๋˜์–ด๋„ ํ•ญ์ƒ ๋™์ผํ•˜๋‹ค.

Caveats

  • key๋ฅผ ์ƒ์„ฑ ํ•˜๊ธฐ์œ„ํ•ด ์‚ฌ์šฉํ•˜๋ฉด ์•ˆ๋œ๋‹ค. key๋Š” ๋ฐ์ดํ„ฐ์—์„œ ์ƒ์„ฑ๋˜์–ด์•ผํ•œ๋‹ค.
  • ์„œ๋ฒ„ ๋ Œ๋”๋ง์—์„œ ์„œ๋ฒ„์™€ ํด๋ผ์ด์–ธํŠธ์—์„œ ๋ Œ๋”๋งํ•œ ํŠธ๋ฆฌ๊ฐ€ ์ •ํ™•ํžˆ ์ผ์น˜ํ•˜์ง€ ์•Š์œผ๋ฉด ์ƒ์„ฑ๋œ ID๊ฐ€ ์ผ์น˜ํ•˜์ง€ ์•Š๋Š”๋‹ค.

์นด์šดํ„ฐ vs useId

์ „์—ญ ๋ณ€์ˆ˜๋กœ nextId++ํ•˜๋Š” ๊ฒƒ๋ณด๋‹ค ์™œ ๋‚˜์€๊ฐ€?

  • useId๋Š” ์„œ๋ฒ„๋ Œ๋”๋ง๊ณผ ํ•จ๊ป˜ ์ž‘๋™ํ•œ๋‹ค. ์„œ๋ฒ„์™€ ํด๋ผ์ด์–ธํŠธ์—์„œ ๋ Œ๋”๋งํ•œ ํŠธ๋ฆฌ๊ฐ€ ์ •ํ™•ํžˆ ์ผ์น˜ํ•˜๋ฉด, ๊ฐ™์€ ์ปดํฌ๋„ŒํŠธ์— ๊ฐ™์€ id ๊ฐ’์„ ์ „๋‹ฌํ•œ๋‹ค.
  • ํด๋ผ์ด์–ธํŠธ ์ปดํฌ๋„ŒํŠธ๊ฐ€ hydration ๋˜๋Š” ์ˆœ์„œ๋Š” ์„œ๋ฒ„์™€ ๋‹ค๋ฅด๊ธฐ์— ์นด์šดํ„ฐ๋กœ๋Š” ์ด๋ฅผ ๋ณด์žฅํ•˜๊ธฐ๊ฐ€ ์–ด๋ ต๋‹ค.

Usage

Generating unique IDs for accessibility attributes

import { useId } from 'react';  
 
function PasswordField() {  
	const passwordHintId = useId();
	//...
	
	return (
		<>  
			<input type="password" aria-describedby={passwordHintId} />  
			<p id={passwordHintId}>  
		</>
	)
}

aria-describedBy์™€ ๊ฐ™์€ html accessibility ์†์„ฑ์œผ๋กœ ๋‘ ํƒœ๊ทธ๊ฐ€ ์„œ๋กœ ์—ฐ๊ด€ ๋˜์–ด์žˆ์Œ์„ ๋‚˜ํƒ€๋‚ผ ์ˆ˜ ์žˆ๋‹ค.

useId๋Š” ํ•„์š”ํ•œ ๋ชจ๋“  ์š”์†Œ์— ๋Œ€์‘ํ•˜์—ฌ ํ˜ธ์ถœํ•˜์ง€ ์•Š์•„๋„ ๋œ๋‹ค.

import { useId } from 'react';
 
export default function Form() {
  const id = useId();
  return (
    <form>
      <label htmlFor={id + '-firstName'}>First Name:</label>
      <input id={id + '-firstName'} type="text" />
      <hr />
      <label htmlFor={id + '-lastName'}>Last Name:</label>
      <input id={id + '-lastName'} type="text" />
    </form>
  );
}

Specifying a shared prefix for all generated IDs

๋‹จ์ผ ํŽ˜์ด์ง€์—์„œ ์—ฌ๋Ÿฌ ๊ฐœ์˜ ๋…๋ฆฝ๋œ React ์•ฑ์„ ๋ Œ๋”๋งํ•  ๋•Œ, identifierPrefix ์˜ต์…˜์œผ๋กœ ๊ณ ์œ ํ•œ ์ ‘๋‘์‚ฌ๋ฅผ ๊ฐ ์‹๋ณ„์ž์— ์ „๋‹ฌํ•  ์ˆ˜ ์žˆ๋‹ค

const root1 = createRoot(document.getElementById('root1'), {
  identifierPrefix: 'my-first-app-'
});
root1.render(<App />);
 
const root2 = createRoot(document.getElementById('root2'), {
  identifierPrefix: 'my-second-app-'
});
root2.render(<App />);