Class: PagingCollection

PagingCollection

new PagingCollection()

전체 데이터를 넣고 페이징을 시키는 기능을 제공하는 콜렉션 컴포넌트입니다.

처리하는 데이터는 병합정보등 셀,행 속성을 포함하지 않는 배열이나 XML이어야 합니다.

Since:
  • 3.5
Example

레이아웃은 다음과 같은 형식으로 작성됩니다.

<rMateGrid>
     <NumberFormatter id="numfmt" useThousandsSeparator="true"/>
     <PercentFormatter id="percfmt" useThousandsSeparator="true"/>
     <DataGrid id="dg1" horizontalScrollPolicy="auto" verticalAlign="middle">
         <groupedColumns>
           ...
         </groupedColumns>
         <dataProvider>
             <PagingCollection rowsPerPage="25" source="{$gridData}"/>
         </dataProvider>
     </DataGrid>
 </rMateGrid>

Members

currentPagenumber

현재 페이지 넘버.

Default Value:
  • 1
See:
  • 자바스크립트에서 사용할 때는 getter, setter함수를 사용합니다. - getCurrentPage(), setCurrentPage(value)

readonlylengthnumber

현재 페이지의 데이터 개수

See:
  • 자바스크립트에서 사용할 때는 getter함수를 사용합니다. - getLength()

rowsPerPagenumber

1페이지에서 보여줄 레코드 수

0으로 설정할 경우 전체 데이터를 표시하게 됩니다.

Default Value:
  • 20
See:
  • 자바스크립트에서 사용할 때는 getter, setter함수를 사용합니다. - getRowsPerPage(), setRowsPerPage(value)

sourceArray

PagingCollection의 원천 데이터.

See:
  • 자바스크립트에서 사용할 때는 getter, setter함수를 사용합니다. - getSource(), setSource(value)

readonlytotalLengthnumber

전체 데이터의 개수.

See:
  • 자바스크립트에서 사용할 때는 getter함수를 사용합니다. - getTotalLength()

readonlytotalPageCountnumber

전체 페이지 수.

See:
  • 자바스크립트에서 사용할 때는 getter함수를 사용합니다. - getTotalPageCount()

Methods

addEventListener(type, listener)

type에 선언된 이벤트가 발생할 경우 이벤트를 받을 수 있는 listener 함수를 등록합니다.

Name Type Description
type string

이벤트 종류를 표현하는 문자열

listener function

이벤트 발생시 불려질 함수

getIndexBySource(index)

전달된 페이지에 의한 index를 전체 건수중의 index로 변환하여 반환합니다.

Name Type Description
index number

검색할 인덱스(페이징에 의거한 인덱스)

getItemAtBySource(index)

source에 의거해 전달된 인덱스값의 데이터를 반환합니다.

Name Type Description
index number

검색할 인덱스(페이징이 아닌 전체 데이터에 의거한 인덱스)

getItemIndex(item){number}

특정 요소의 위치를 가져옵니다.

현재 페이지에 나타난 데이터에 대해서만 검색 합니다.

Name Type Description
item object

검색하려는 요소

Returns:
Type Description
number 요소의 위치 값. 없을 경우에는 -1

refresh()

정렬이나 필터링에 의해 재계산을 수행합니다.

removeEventListener(type, listener)

type에 선언된 이벤트에 연결된 listener 함수를 제거합니다.

Name Type Description
type string

이벤트 종류를 표현하는 문자열

listener function

이벤트 발생시 불려질 함수

Events

collectionChange

콜렉션의 데이터에 변경이 일어났을때 발생합니다. (그리드의 에디팅 기능을 이용할 경우에는 발생하지 않음)

Type:
  • Event
Properties:
Name Type Description
kind string

변경의 내용. 다음 중 한 개가 됩니다.
- add : 데이터 행 추가
- refresh : 정렬이나 필터링, 페이징에 의해 수정되어 데이터의 변화가 발생한 상태
- remove : 데이터 행 삭제
- replace : 데이터 행 수정
- reset : 콜렉션 자체가 수정되어 reset이 필요한 상태
- update : 데이터의 여러행의 수정이 일어난 경우

location number

데이터가 추가, 삭제, 수정된 경우 해당 행의 번호

items Array

데이터가 추가, 삭제된 경우 해당 행이 들어있는 배열