페이지 매김

Altium 365 API는 Relay connection specification을 따르는 커서 기반 페이지네이션을 사용합니다. 컬렉션 쿼리는 노드 목록, 페이지네이션 메타데이터, 그리고 결과를 앞이나 뒤로 탐색하기 위한 커서를 포함하는 connection 타입을 반환합니다.

Connection 구조

페이지네이션된 응답은 다음과 같은 형태를 가집니다.

query {
  someCollection {
    nodes {        # 이 페이지의 항목들
      ...
    }
    pageInfo {     # 페이지네이션 메타데이터
      hasNextPage
      hasPreviousPage
      startCursor
      endCursor
    }
    totalCount     # 전체 항목 수(모든 페이지)
  }
}

페이지 가져오기

컬렉션을 앞으로 페이지 이동하려면 first 및 after 인수를 사용합니다.

query {
  desProjects(first: 20, after: "{cursor}") {
    nodes {
      id
      name
    }
    pageInfo {
      hasNextPage
      endCursor
    }
  }
}

• first – 반환할 항목 수(페이지 크기)

• after – 이전 페이지의 끝을 표시하는 커서이며, 첫 번째 요청에서는 생략합니다

endCursor의 pageInfo 값은 다음 페이지의 after 값이 됩니다. hasNextPage가 false가 될 때까지 계속 진행합니다.

뒤로 페이지 이동하려면 last 및 before를 startCursor와 함께 사용합니다.

첫 번째 요청

첫 페이지의 경우 after 인수를 생략합니다.

query {
  desProjects(first: 20) {
    nodes {
      id
      name
      updatedAt
    }
    pageInfo {
      hasNextPage
      endCursor
    }
    totalCount
  }
}

페이지네이션을 시작하기 전에 예상되는 페이지 수를 파악하려면 totalCount를 사용합니다.

항목을 가져오지 않고 개수만 확인하기

전체 개수만 필요하다면 nodes를 완전히 생략할 수 있습니다.

query {
  desProjects {
    totalCount
  }
}