버튼으로 트리거되는 Toast 메시지를 나타내는 메뉴입니다.
토스트와 토스트 뷰포트를 감싸는 요소입니다. 보통 애플리케이션을 포장합니다.
토스트가 나타나는 고정 영역입니다. 사용자는 핫키를 눌러 뷰포트로 이동할 수 있습니다. 키보드 사용자를 위해 핫키의 발견 가능성을 보장하는 것은 귀하에게 달려 있습니다.
자동으로 닫히는 토스트입니다. 사용자 응답을 얻기 위해 열어두어서는 안 됩니다.
토스트의 선택적 제목입니다.
토스트 메시지입니다.
사용자가 예상치 못한 부작용 없이 작업을 완료할 수 있도록 보장하는 안전한 작업입니다. 사용자 응답이 필요한 경우, 토스트를 대화 상자로 포털하여 뷰포트에 스타일을 적용하세요.
토스트가 지속 시간이 만료되기 전에 사용자가 토스트를 닫을 수 있도록 하는 버튼입니다.
기본 핫키를 재정의하여 각 키에 대한 event.code 값을 사용합니다.
토스트의 지속 시간을 사용자 정의하여 제공자 값을 재정의합니다.
사용자가 버튼을 클릭할 때마다 토스트가 나타나야 하는 경우, 상태를 사용하여 동일한 토스트의 여러 인스턴스를 렌더링합니다(아래 참조). 또는 부품을 추상화하여 고유한 명령형 API를 생성할 수 있습니다.
--radix-toast-swipe-move-[x|y] 및 --radix-toast-swipe-end-[x|y] CSS 변수를 data-swipe="[start|move|cancel|end]" 속성과 결합하여 스와이프 닫기 제스처를 애니메이션화합니다. 예를 들어:
aria-live 요구 사항을 준수합니다.
토스트의 민감도를 제어하기 위해 type prop을 사용하세요.
사용자 작업의 결과로 생성된 토스트는 foreground를 선택하세요. 백그라운드 작업에서 생성된 토스트는 background를 사용해야 합니다.
전경 토스트는 즉시 발표됩니다. 보조 기술은 전경 토스트가 나타날 때 이전에 대기 중인 메시지를 지울 수 있습니다. 동시에 서로 다른 전경 토스트를 쌓는 것을 피하세요.
배경 토스트는 현재 문장을 읽는 것이 끝나는 다음 기회에 발표됩니다. 대기 중인 메시지를 지우지 않으므로, 사용자 상호작용에 대한 응답으로 과도하게 사용하는 경우 스크린 리더 사용자에게 지연된 사용자 경험으로 인식될 수 있습니다.
Action에서 altText prop을 사용하여 스크린 리더 사용자에게 토스트 작업을 수행하는 대체 방법을 안내합니다.
사용자가 작업을 수행할 수 있는 애플리케이션의 영구적인 위치로 안내하거나, 고유한 핫키 논리를 구현할 수 있습니다. 후자를 구현하는 경우, 즉시 발표하기 위해 foreground 유형을 사용하고 사용자가 충분한 시간을 가질 수 있도록 지속 시간을 늘리세요.
아이콘(또는 글꼴 아이콘)을 제공할 때, 스크린 리더 사용자를 위해 올바르게 레이블을 지정하는 것을 잊지 마세요.
고유한 API를 생성하여 기본 부품을 추상화합니다.
원하는 경우 토스트 중복을 허용하는 명령형 API를 생성합니다.