본문으로 건너뛰기
Documentation

RwSlideItemViewer

마지막 게시: 2026-07-21 19:00

RwSlideItemViewer

RwSlideItemViewer는 목록 위에 상세·편집 내용을 겹쳐 여는 슬라이드 패널입니다. Docs의 문서 편집처럼 현재 문맥을 유지하면서 보조 작업을 수행할 때 사용합니다.

슬라이드 상세 영역

HeaderContent, HeaderActionsContent와 본문 ChildContent를 구분하고 Width, Direction과 TopOffset으로 배치를 정합니다. Overlay와 고정 Pin 모드, 바깥 영역 클릭 닫기와 열림·닫힘 이벤트를 지원합니다.

사용 화면 선택

목록에서 선택한 항목의 상세, 빠른 편집과 검토에 적합합니다. 사용자가 새 URL로 이동해야 하거나 매우 긴 독립 작업에는 전체 페이지가 더 적합합니다.

크기와 콘텐츠 설정

파라미터 용도
Title 헤더에 표시할 패널 제목입니다.
ChildContent 상세 또는 편집 본문입니다.
Width / MaxWidth 슬라이드 폭과 최대 폭입니다.
Direction 왼쪽 또는 오른쪽 열림 방향입니다.
ShowOverlay 배경 오버레이를 표시합니다.
CloseOnOverlayClick 바깥 클릭으로 닫을지 결정합니다.
IsPinned 패널을 고정 상태로 유지합니다.
OnOpened / OnClosed 열림과 닫힘 완료 이벤트입니다.

열기와 닫기

  1. 본문과 헤더 작업을 별도 RenderFragment로 구성합니다.
  2. 화면 밀도에 맞는 Width와 Direction을 정합니다.
  3. 편집 중 오작동을 막으려면 Overlay와 닫기 정책을 설정합니다.
  4. 열기 전 선택 항목을 로드합니다.
  5. OnClosed에서 임시 상태와 검증 메시지를 정리합니다.

상세 작업 연결

OnOpened는 패널이 열린 뒤 포커스를 초기화할 때 사용하고 OnClosed는 임시 편집 상태를 폐기할 때 사용합니다. IsPinnedChanged를 연결하면 고정 상태를 상위 레이아웃과 동기화할 수 있습니다.

포커스와 배경 화면

열릴 때 제목 또는 첫 입력으로 포커스를 옮기고 닫을 때 원래 실행 단추로 돌려보냅니다. Escape 닫기와 명시적 닫기 단추를 제공하며 배경 콘텐츠가 포커스를 받지 않게 합니다.

저장하지 않은 변경

본문이 길어도 body 스크롤과 중첩 스크롤을 무분별하게 만들지 않습니다. 저장하지 않은 변경이 있을 때 Overlay 클릭으로 즉시 닫히지 않도록 확인 흐름을 둡니다.

슬라이드 점검

  • 열림·닫힘 후 포커스 복귀를 확인합니다.
  • 고정 모드에서 본문 폭이 실제로 재배치되는지 확인합니다.
  • 작은 화면에서 MaxWidth와 방향을 확인합니다.

수정 이력

이 문서의 변경 내역을 시간순으로 볼 수 있습니다.

표시할 수정 이력이 없습니다.

An unhandled error has occurred. Reload 🗙

Rejoining the server...

Rejoin failed... trying again in seconds.

Failed to rejoin.
Please retry or reload the page.

The session has been paused by the server.

Failed to resume the session.
Please retry or reload the page.