Tooltip
툴팁
Tooltip은 버튼 같은 컨트롤에 대한 짧은 설명이야. 마우스를 올리거나 키보드 포커스가 가면 열려. 하지만 버튼처럼 누를 수는 없어.
role="tooltip"실제 예시
아이콘 버튼이 키보드 포커스를 받으면 "링크 복사"가 나타납니다. 포커스는 버튼에 남습니다.
주요 부분
- 01트리거
- 02Anchored or modal surface
- 03Focus boundary
- 04Dismiss path
사용할 때
마우스 오버와 키보드 포커스 모두에서 짧은 컨트롤 레이블을 설명하는 데 사용하십시오.
다음 경우에는 사용하지 마세요
툴팁 안에 동작, 반드시 읽어야 하는 지침, 또는 긴 내용을 절대 넣지 마세요.
코드에서 사용된 이름
role="tooltip" 출시하기 전에
Move focus on purpose. Keep it inside only when the overlay blocks the page. Support Escape and a visible close button, then return focus to the opener. Keep entered data and check small-screen, loading, and failure states.
Outcome：Complete the task with 툴팁 (Tooltip)。 User context：아이콘 버튼이 키보드 포커스를 받으면 "링크 복사"가 나타납니다. 포커스는 버튼에 남습니다. Recommended pattern：툴팁 (Tooltip)。 Why it fits：마우스 오버와 키보드 포커스 모두에서 짧은 컨트롤 레이블을 설명하는 데 사용하십시오. Do not use it when：툴팁 안에 동작, 반드시 읽어야 하는 지침, 또는 긴 내용을 절대 넣지 마세요. Product requirements: Define the default, loading, empty, error, success, and recovery states. Keep user input. Give clear feedback after every action. Accessibility and resilience: Use semantic HTML, full keyboard access, and visible focus. Make the layout work when zoomed and support reduced motion. Follow the project’s current rules. Do not add a new UI library unless the project already uses it. Acceptance criteria: The main task works with keyboard only and at 320px width. Focus and status changes are announced. Check loading, failure, retry, cancel, and reduced-motion paths. Evidence and limits (evidence boundary)：이 표준은 나열된 범위만 적용합니다. 시각적 스타일, 제품 결정, 또는 Vibulary 예시는 선택하지 않습니다. Unknowns to confirm: Product wording, data source, analytics events, supported devices and languages, and platform limits.
이 요청을 확인하세요
Review how 툴팁 (Tooltip) is used now. Definition: Tooltip은 버튼 같은 컨트롤에 대한 짧은 설명이야. 마우스를 올리거나 키보드 포커스가 가면 열려. 하지만 버튼처럼 누를 수는 없어. Release checks: Move focus on purpose. Keep it inside only when the overlay blocks the page. Support Escape and a visible close button, then return focus to the opener. Keep entered data and check small-screen, loading, and failure states. Before changing code, list the evidence, gaps, severity, and the smallest safe fix.