SearchMode (cfg)

데이터를 조회하고 화면에 표시하는 방식을 설정합니다.

• 데이터를 한번에 전체 조회할 수 있으면 → 0, 1, 2를 설정합니다.
• 데이터가 많아 서버·브라우저 메모리 부족이나 렌더링 부담이 크면 → 3, 4, 5를 설정합니다.

Type

number

Options

비교표

SearchMode: 0 (FastLoad)

가상 스크롤 기반으로, 사용자가 세로 스크롤 시 보이는 영역의 데이터만 즉시 갱신합니다.
스크롤과 동시에 화면의 끊김 없이 행의 데이터를 바로 확인할 수 있습니다.

각 행의 높이는 모두 동일해야 하며, (Appendix)기능에 제약사항이 있습니다.
데이터행의 높이가 일정하지 않다면 (Cfg)AutoRowHeight를 설정하시기 바랍니다.

options.Cfg = { SearchMode: 0 };

// AJAX 통신으로 조회
sheet.doSearch({ url: "/api/data.jsp", method: "POST" });

// 또는 데이터 직접 바인딩
sheet.loadSearchData({ data: jsonData });

SearchMode: 1 (ClientPaging)

전체 데이터를 조회하고 (Cfg)PageLength 설정값만큼 페이징 처리 후 페이지 번호를 통해 보여주는 기능입니다.

• (Method)updateClientPaging 함수를 이용해서 동적으로 페이지의 개수를 변경하고 재계산할 수 있습니다.
• InfoRowConfig를 사용해 페이지 번호를 표시해야 페이지를 클릭하여 이동할 수 있습니다.

주의 : (Method) makeSubTotal 지원하지 않습니다.

// 기본 페이지 번호
options.Cfg = {
    SearchMode: 1,
    PageLength: 50,
    InfoRowConfig: { Layout: ["Paging", "Count"] }
};

// 숫자형 페이지 번호 + 페이지 크기 선택
options.Cfg = {
    SearchMode: 1,
    PageLength: 50,
    InfoRowConfig: {
        Layout: ["Paging2", "Count"],
        ViewCount: 1,
        ViewFormat: "10|20|50|100"
    }
};

// AJAX 통신으로 조회
sheet.doSearch({ url: "/api/data.jsp", method: "POST" });

// 또는 데이터 직접 바인딩
sheet.loadSearchData({ data: jsonData });

SearchMode: 2 (LazyLoad) — default

가상 스크롤 기반으로, 전체 데이터를 조회하고 (Cfg)PageLength 설정값 단위로 스크롤 위치에 따라 데이터를 화면에 표시하는 기능입니다.

options.Cfg = { SearchMode: 2, PageLength: 50 };

// AJAX 통신으로 조회
sheet.doSearch({ url: "/api/data.jsp", method: "POST" });

// 또는 데이터 직접 바인딩
sheet.loadSearchData({ data: jsonData });

SearchMode: 3 (ScrollAppend)

(Cfg)PageLength에 지정된 개수만큼 한 페이지씩 서버에서 조회하여 화면에 표시하는 기능입니다.

• 조회는 반드시 (Method)doSearchPaging 함수를 통해 수행해야 합니다.
• 세로 스크롤이 하단에 도달하면 다음 페이지 데이터를 서버에서 조회하여 기존 데이터 아래에 추가합니다.
• 서버는 시트로부터 넘어오는 페이지 정보(ibpage=2,3,4...)에 따라 페이징 쿼리를 구성하여 각 페이지별 데이터를 리턴해야 합니다.
• 조회 데이터에 Total(전체 record 수) 속성이 포함되어 있어야 합니다.
• Total 값과 누적 데이터 수가 같아지면 더 이상 서버 호출은 발생하지 않습니다.
• 한번 조회한 페이지는 재요청 없이 재사용됩니다.
• Sort, Filter, 엑셀 다운로드는 기본적으로 조회된 데이터 안에서만 동작합니다.
  • Sort : (Cfg) ScrollPagingServerSort를 설정하면 서버로 정렬 요청을 전송할 수 있습니다.
  • 엑셀 다운로드 : (Method) directDown2Excel을 사용하면 전체 데이터를 다운로드할 수 있습니다. 단, 서버에서 전체 데이터를 처리할 수 있는 메모리가 충분해야 합니다.
  • Filter : 전체 데이터에 대한 필터링은 지원하지 않습니다.

주의

• Type:Lines, Img나 Wrap:1 과 같이 데이터 행의 높이가 일정하지 않은 속성을 사용하려면 (Cfg)AutoRowHeight를 설정해야 합니다.
• (Col) FormulaRow 사용할 수 없습니다.
  전체 합계가 필요한 경우 서버에서 계산하여 Foot 또는 showFixedRows로 Footer에 표시하시기 바랍니다.
• (Method) makeSubTotal 지원하지 않습니다.

options.Cfg = { SearchMode: 3, PageLength: 50 };

// doSearchPaging으로 최초 조회
// 이후 페이지 이동, Sort 등은 시트가 자동으로 서버에 요청합니다.
sheet.doSearchPaging({ url: "/api/data.jsp", method: "POST" });

SearchMode: 4 (ServerPaging)

(Cfg)PageLength에 지정된 개수만큼 한 페이지씩 서버에서 조회하여 화면에 표시하는 기능입니다.

• 조회는 반드시 (Method)doSearchPaging 함수를 통해 수행해야 합니다.
• InfoRowConfig를 사용해 페이지 번호를 표시해야 페이지를 클릭하여 이동할 수 있습니다.
• 페이지 번호 변경 시 doSearchPaging이 호출한 URL을 다시 요청하여 해당 페이지 데이터를 표시합니다.
• 서버는 시트로부터 넘어오는 페이지 정보(ibpage=2,3,4...)에 따라 페이징 쿼리를 구성하여 각 페이지별 데이터를 리턴해야 합니다.
• 조회 데이터에 Total(전체 record 수) 속성이 포함되어 있어야 합니다.
• 한번 조회한 페이지는 서버를 다시 호출하지 않습니다.
• Sort는 기본적으로 서버로 정렬 정보를 전송하므로, 서버에서 정렬된 결과를 조회해야 합니다. 조회된 데이터에서만 정렬하려면 SortCurrentPage를 설정하세요.
• Filter, 엑셀 다운로드는 조회된 데이터 안에서만 동작합니다.
  • 엑셀 다운로드 : (Method) directDown2Excel을 사용하면 전체 데이터를 다운로드할 수 있습니다. 단, 서버에서 전체 데이터를 처리할 수 있는 메모리가 충분해야 합니다.
  • Filter : 전체 데이터에 대한 필터링은 지원하지 않습니다.

주의

• (Col) FormulaRow 사용할 수 없습니다.
  전체 합계가 필요한 경우 서버에서 계산하여 Foot 또는 showFixedRows로 Footer에 표시하시기 바랍니다.
• (Method) makeSubTotal 지원하지 않습니다.

// 기본 페이지 번호
options.Cfg = {
    SearchMode: 4,
    PageLength: 50,
    InfoRowConfig: { Layout: ["Paging", "Count"] }
};

// 숫자형 페이지 번호 + 건수 포맷 커스텀
options.Cfg = {
    SearchMode: 4,
    PageLength: 50,
    InfoRowConfig: {
        Layout: ["Paging2", "Count"],
        ViewCount: 1,
        Format: "[BOTTOMDATAROW / TOTALROWS] 건"
    }
};

// doSearchPaging으로 최초 조회
// 이후 페이지 이동, Sort 등은 시트가 자동으로 서버에 요청합니다.
sheet.doSearchPaging({ url: "/api/data.jsp", method: "POST" });

SearchMode: 5 (ServerPaging2)

(Cfg)PageLength에 지정된 개수만큼 한 페이지씩 서버에서 조회하여 화면에 표시하는 기능입니다. ServerPaging과 동일하지만, 페이지 이동 시 항상 서버를 호출하여 최신 데이터를 조회합니다.

• 조회는 반드시 (Method)doSearchPaging 함수를 통해 수행해야 합니다.
• InfoRowConfig를 사용해 페이지 번호를 표시해야 페이지를 클릭하여 이동할 수 있습니다.
• 서버는 시트로부터 넘어오는 페이지 정보(ibpage=2,3,4...)에 따라 페이징 쿼리를 구성하여 각 페이지별 데이터를 리턴해야 합니다.
• 조회 데이터에 Total(전체 record 수) 속성이 포함되어 있어야 합니다.
• 페이지 이동 시 항상 서버를 재요청합니다. (캐싱 없음)
• Sort는 기본적으로 서버로 정렬 정보를 전송하므로, 서버에서 정렬된 결과를 조회해야 합니다. 조회된 데이터에서만 정렬하려면 SortCurrentPage를 설정하세요.
• Filter, 엑셀 다운로드는 조회된 데이터(PageLength) 안에서만 동작합니다.
  • 엑셀 다운로드 : (Method) directDown2Excel을 사용하면 전체 데이터를 다운로드할 수 있습니다. 단, 서버에서 전체 데이터를 처리할 수 있는 메모리가 충분해야 합니다.
  • Filter : 전체 데이터에 대한 필터링은 지원하지 않습니다.
• (Method)updatePageLength를 통해 동적으로 페이지 행의 개수를 변경할 수 있습니다.

주의

• (Col) FormulaRow 사용할 수 없습니다.
  전체 합계가 필요한 경우 서버에서 계산하여 Foot 또는 showFixedRows로 Footer에 표시하시기 바랍니다.
• (Method) makeSubTotal 지원하지 않습니다.

// 숫자형 페이지 번호 + 페이지 크기 선택
options.Cfg = {
    SearchMode: 5,
    PageLength: 50,
    InfoRowConfig: {
        Layout: ["Paging2", "Count"],
        ViewCount: 1,
        ViewFormat: "10|20|50|100"
    }
};

// doSearchPaging으로 최초 조회 (항상 서버 재요청)
// 이후 페이지 이동, Sort 등은 시트가 자동으로 서버에 요청합니다.
sheet.doSearchPaging({ url: "/api/data.jsp", method: "POST" });

Read More

• AutoRowHeight cfg
• InfoRowConfig cfg
• PageLength cfg
• SortCurrentPage cfg
• ScrollPagingServerSort cfg
• 조회 응답 규격
• 페이징 응답 규격
• doSearch method
• loadSearchData method
• doSearchPaging method
• updateClientPaging method
• updatePageLength method
• showFixedRows method
• directDown2Excel method

Since