RealGrid2 API
Interface
SearchOptions

SearchOptions

행 검색 관련 유연한 설정 정보 모델

Signature:

export interface SearchOptions 

Remarks

GridBase.searchItem()에서 사용된다.

LocalDataProvider.searchDataRow(), LocalTreeDataProvider.searchDataRow() 에서 사용될 경우, 필터링 되었거나 행 그룹핑 된 경우 감춰진 행들은 찾지 않는다.

Example

function searchItemHandler() {
    let values = ["PR20012392", "QF24212112"]
    let fields = [ "RequestType", "ServiceCode" ];
    let startFieldIndex = fields.indexOf(grid.getCurrent().fieldName) + 1;
    let options = {
         fields : fields,
         values: values,
         startIndex : grid.getCurrent().itemIndex,
         startFieldIndex : startFieldIndex,
         wrap : true,
         caseSensitive : false,
         partialMatch : true
    }
    let index = grid.searchCell(options);
    grid.setCurrent(index);
}

Events

PropertyTypeDescription
compareCallbackCompareCallback사용자 정의 조건을 위한 콜백

Properties

PropertyTypeDescription
allFieldsboolean해당 조건에 맞는 필드들을 전부 검색할 건지의 여부
caseSensitiveboolean대소문자를 구분하여 검색할지의 여부
fieldsstring[]검색할 필드 목록
parentIdnumber상위트리의 행 고유 번호 LocalTreeDataProvider 에서만 사용 가능하다.
partialMatchboolean포함되는 것도 검색할지 여부
reverseboolean역순으로 검색한다.
selectboolean검색된 행 focus 여부
startIndexnumber검색 시작 행
valuesstring[]fields 에 지정한 각 필드에 해당하는 순서에 맞게 배열된 검색 조건값
wrapboolean마지막 행까지 해당하는 행이 없으면 첫 행부터 다시 검색할 것인지 여부

Events Desc

compareCallback

사용자 정의 조건을 위한 콜백

Type - CompareCallback

Example:

const f = function(v1, v2, sensitive, partialMatch) {
     if (v1 === v2) {
          return true;
     }
     let s1 = String(v1);
     let s2 = v2 == null ? undefined : String(v2);
     if (!s1 && !s2) {
          return true;
     }
     if (!s1 || !s2) {
          return false;
     }
     if (!caseSensitive) {
          s1 = s1.toLowerCase();
          s2 = s2.toLowerCase();
     }
     if (partialMatch) {
     	    return s2.indexOf(s1) >= 0;
     } else {
     	    return s1 == s2;
     }
}
 
let options = {
         fields : fields,
         values : values,
         compareCallback: f
}
 
let index = grid.searchItem(options);

Properties Desc

allFields

해당 조건에 맞는 필드들을 전부 검색할 건지의 여부

Type - boolean

Remarks:

false면 지정된 fields중 일치하는 필드가 있으면 검색을 종료한다.


caseSensitive

대소문자를 구분하여 검색할지의 여부

Type - boolean


fields

검색할 필드 목록

Type - string[]

Remarks:

필드명 또는 필드 인덱스로 지정 가능.


parentId

상위트리의 행 고유 번호 LocalTreeDataProvider 에서만 사용 가능하다.

Type - number


partialMatch

포함되는 것도 검색할지 여부

Type - boolean


reverse

역순으로 검색한다.

Type - boolean

Remarks:

reversetrue이면 startIndex를 기준으로 위의 행을 검색한다.


select

검색된 행 focus 여부

Type - boolean

Remarks:

true로 지정하면 검색된 행이 있을 때 그 행을 선택하고, 현재 표시된 범위 밖이면 표시되도록 스크롤한다.

GridBase.searchItem() 에서만 사용 가능하다.


startIndex

검색 시작 행

Type - number


values

fields 에 지정한 각 필드에 해당하는 순서에 맞게 배열된 검색 조건값

Type - string[]


wrap

마지막 행까지 해당하는 행이 없으면 첫 행부터 다시 검색할 것인지 여부

Type - boolean