컴포넌트/Timeline

Timeline

활동 로그와 히스토리를 시간 순서대로 표시하는 컴포넌트입니다. 프로세스 진행 상황, 이벤트 기록, 작업 흐름 등을 시각적으로 표현할 수 있습니다.

설치

Terminal
npx @msub-core/ui-cli add timeline

사용법

TSX
import {
  Timeline,
  TimelineItem,
  TimelineIcon,
  TimelineContent,
  TimelineTitle,
  TimelineDescription,
  TimelineTime,
} from "@msub-core/ui/components/timeline"

function MyComponent() {
  return (
    <Timeline>
      <TimelineItem status="success">
        <TimelineIcon>
          <CheckCircle2 className="h-4 w-4" />
        </TimelineIcon>
        <TimelineContent>
          <TimelineTitle>작업 완료</TimelineTitle>
          <TimelineDescription>
            프로젝트가 성공적으로 배포되었습니다.
          </TimelineDescription>
          <TimelineTime>2시간 전</TimelineTime>
        </TimelineContent>
      </TimelineItem>
    </Timeline>
  )
}

기본

프로젝트 시작

새로운 프로젝트를 시작했습니다.

개발 진행

핵심 기능 개발을 진행하고 있습니다.

배포 완료

프로덕션 환경에 배포했습니다.

PropTypeDefaultRequiredDescription
variant"default" | "alternate" | "right""default"No타임라인 레이아웃 변형 (default: 왼쪽 정렬, alternate: 좌우 교차, right: 오른쪽 정렬)
size"sm" | "default" | "lg""default"No타임라인 크기
connectorStyle"solid" | "dashed" | "dotted""solid"No연결선 스타일
animatedbooleanfalseNo등장 애니메이션 활성화

변형 (Variants)

Default (왼쪽 정렬)

첫 번째 단계

모든 항목이 왼쪽에 정렬됩니다.

두 번째 단계

일관된 레이아웃을 유지합니다.

Alternate (좌우 교차)

왼쪽 항목

첫 번째 항목은 왼쪽에 표시됩니다.

오른쪽 항목

두 번째 항목은 오른쪽에 표시됩니다.

Right (오른쪽 정렬)

첫 번째 단계

모든 항목이 오른쪽에 정렬됩니다.

두 번째 단계

RTL 레이아웃에 적합합니다.

크기

Small

작은 크기

컴팩트한 레이아웃에 적합합니다.

진행 중

작업을 진행하고 있습니다.

Default

기본 크기

일반적인 사용에 적합합니다.

진행 중

작업을 진행하고 있습니다.

Large

큰 크기

강조가 필요한 경우에 적합합니다.

진행 중

작업을 진행하고 있습니다.

커넥터 스타일

Solid

완료

대기 중

Dashed

완료

대기 중

Dotted

완료

대기 중

상태 색상

기본 상태

일반적인 상태를 나타냅니다.

성공

작업이 성공적으로 완료되었습니다.

경고

주의가 필요한 상태입니다.

오류

작업 중 오류가 발생했습니다.

정보

추가 정보를 제공합니다.

활성 상태

완료됨

이 단계는 완료되었습니다.

현재 진행 중

현재 이 단계를 진행하고 있습니다.

대기 중

아직 시작되지 않았습니다.

예정됨

향후 진행될 단계입니다.

접이식 콘텐츠

코드 리뷰 완료

모든 리뷰어가 승인했습니다.

리뷰어 의견:
- "LGTM! 잘 작성되었습니다."
- "테스트 커버리지가 우수합니다."
- "문서화가 완벽합니다."

PR 생성

새로운 기능 추가를 위한 Pull Request를 생성했습니다.

커스텀 아이콘

커밋 푸시

feat: 새로운 타임라인 컴포넌트 추가

PR 생성

타임라인 컴포넌트 추가 #42

코멘트 작성

"좋은 작업입니다! 몇 가지 제안사항이 있습니다."

리뷰어 지정

@johndoe, @janesmith를 리뷰어로 지정했습니다.

애니메이션

스크롤하면 타임라인 항목이 부드럽게 나타납니다.

프로젝트 시작

새로운 프로젝트를 시작했습니다.

디자인 완료

UI/UX 디자인 작업을 완료했습니다.

개발 완료

모든 기능 개발을 완료했습니다.

테스트 완료

QA 테스트를 통과했습니다.

배포 완료

프로덕션 환경에 배포했습니다.

활동 로그 예제

최근 활동

커밋 푸시

mingyu9495가 main 브랜치에 커밋을 푸시했습니다.

PR 병합

#127 "새로운 타임라인 컴포넌트 추가"가 병합되었습니다.

코멘트 작성

janesmith가 #127에 코멘트를 작성했습니다.

빌드 경고

CI/CD 파이프라인에서 2개의 경고가 발생했습니다.

새로운 멤버 추가

johndoe가 팀에 합류했습니다.

주문 추적 예제

주문 번호: #ORD-2024-001234

배송 예정일: 2024년 3월 18일

주문 접수

주문이 접수되어 처리 중입니다.

결제 완료

결제가 완료되었습니다.

상품 준비 중

배송을 위해 상품을 준비하고 있습니다.

배송 시작

곧 배송이 시작됩니다.

배송 완료

상품이 배송 완료됩니다.