new eg.InfiniteGrid(element, options)
A module used to arrange card elements including content infinitely according to layout type. With this module, you can implement various layouts composed of different card elements whose sizes vary. It guarantees performance by maintaining the number of DOMs the module is handling under any circumstance
콘텐츠가 있는 카드 엘리먼트를 레이아웃 타입에 따라 무한으로 배치하는 모듈. 다양한 크기의 카드 엘리먼트를 다양한 레이아웃으로 배치할 수 있다. 카드 엘리먼트의 개수가 계속 늘어나도 모듈이 처리하는 DOM의 개수를 일정하게 유지해 최적의 성능을 보장한다
-
elementType: HTMLElement | string | jQuery
A base element for a module
모듈을 적용할 기준 엘리먼트
-
options optionalType: object
The option object of the eg.InfiniteGrid module
eg.InfiniteGrid 모듈의 옵션 객체
-
itemSelector optionalType: string
A selector to select card elements that make up the layout
레이아웃을 구성하는 카드 엘리먼트를 선택할 선택자(selector)
-
useRecycle (default:
true
) optionalType: booleanIndicates whether keep the number of DOMs is maintained. If the useRecycle value is 'true', keep the number of DOMs is maintained. If the useRecycle value is 'false', the number of DOMs will increase as card elements are added.
DOM의 수를 유지할지 여부를 나타낸다. useRecycle 값이 'true'이면 DOM 개수를 일정하게 유지한다. useRecycle 값이 'false' 이면 카드 엘리먼트가 추가될수록 DOM 개수가 계속 증가한다.
-
isOverflowScroll (default:
false
) optionalType: booleanIndicates whether overflow:scroll is applied
overflow:scroll 적용여부를 결정한다.
-
horizontal (default:
false
) optionalType: booleanDirection of the scroll movement (true: horizontal, false: vertical)
스크롤 이동 방향 (true 가로방향, false 세로방향)
-
useFit (default:
true
) optionalType: booleanThe useFit option scrolls upwards so that no space is visible until an item is added
위로 스크롤할 시 아이템을 추가하는 동안 보이는 빈 공간을 안보이게 한다.
-
useOffset (default:
false
) optionalType: booleanWhether to get the size as offsetWidth, offsetHeight. Set to true if transform is applied to the container. If false, get the size through getBoundingClientRect.
사이즈를 offsetWidth, offsetHeight로 가져올지 여부.
container에 transform이 적용되어 있다면 true로 설정해라. false면 getBoundingClientRect를 통해 사이즈를 가져온다. -
isEqualSize (default:
false
) optionalType: booleanIndicates whether sizes of all card elements are equal to one another. If sizes of card elements to be arranged are all equal and this option is set to "true", the performance of layout arrangement can be improved.
카드 엘리먼트의 크기가 동일한지 여부. 배치될 카드 엘리먼트의 크기가 모두 동일할 때 이 옵션을 'true'로 설정하면 레이아웃 배치 성능을 높일 수 있다
-
isConstantSize (default:
false
) optionalType: booleanIndicates whether sizes of all card elements does not change, the performance of layout arrangement can be improved.
모든 카드 엘리먼트의 크기가 불변일 때 이 옵션을 'true'로 설정하면 레이아웃 배치 성능을 높일 수 있다
-
transitionDruation (default:
0
) optionalType: numberIndicates how many seconds a transition effect takes to complete.
트랜지션 효과를 완료하는데 걸리는 시간을 나타낸다.
-
threshold (default:
100
) optionalType: numberThe threshold size of an event area where card elements are added to a layout.
레이아웃에 카드 엘리먼트를 추가하는 이벤트가 발생하는 기준 영역의 크기.
-
attributePrefix (default:
"data-"
) optionalType: stringThe prefix to use element's data attribute.
엘리먼트의 데이타 속성에 사용할 접두사.
-
resizeDebounce (default:
100
) optionalType: numberDebounce time to set in the resize event.
리사이즈 이벤트에 설정할 디바운스 시간.
-
maxResizeDebounce (default:
0
) optionalType: numberMaximum time to debounce the resize event(0 is not set).
리사이즈 이벤트를 디바운스할 수 있는 최대 시간(0은 미설정이다).
-
renderExternal (default:
false
) optionalType: booleanWhether to use external rendering. It will delegate DOM manipulation and can synchronize the rendered state by calling
sync()
method. You can use this option to use in frameworks like React, Vue, Angular, which has its states and rendering methods.외부 렌더링을 사용할 지의 여부. 이 옵션을 사용시 렌더링을 외부에 위임할 수 있고,
sync()
를 호출하여 그 상태를 동기화할 수 있다. 이 옵션을 사용하여, React, Vue, Angular 등 자체적인 상태와 렌더링 방법을 갖는 프레임워크에 대응할 수 있다. -
percentage (default:
false
) optionalType: boolean | Array.<("size"|"position")>Whether to set the css size and position of the item to %.
item의 css size와 position를 %로 설정할지 여부.
-
Example
<ul id="grid">
<li class="card">
<div>test1</div>
</li>
<li class="card">
<div>test2</div>
</li>
<li class="card">
<div>test3</div>
</li>
<li class="card">
<div>test4</div>
</li>
<li class="card">
<div>test5</div>
</li>
<li class="card">
<div>test6</div>
</li>
</ul>
<script>
var some = new eg.InfiniteGrid("#grid").on("layoutComplete", function(e) {
// ...
});
// If you already have items in the container, call "layout" method.
some.layout();
</script>
Browser Support
Browser | Version |
---|---|
Desktop - Internet Explorer | 8+ |
Desktop - Chrome | latest |
Desktop - Firefox | latest |
Desktop - Safari | latest |
Desktop - Edge | latest |
iOS | 7+ |
Andorid | 2.1+ (except 3.x) |
Extends
- eg.Component
Classes
Members
-
staticeg.InfiniteGrid.VERSIONString
-
Version info string
버전정보 문자열
Example
eg.InfiniteGrid.VERSION; // ex) 3.3.3
Methods
-
append(elements, groupKey){eg.InfiniteGrid}
-
Adds a card element at the bottom of a layout. This method is available only if the isProcessing() method returns false.
카드 엘리먼트를 레이아웃 아래에 추가한다. isProcessing() 메서드의 반환값이 'false'일 때만 이 메서드를 사용할 수 있다
이 메소드는 isProcessing()의 반환값이 false일 경우에만 사용 가능하다.-
elementsType: HTMLElement[] | IJQuery | string[] | string
elements Array of the card elements to be added
추가할 카드 엘리먼트의 배열
-
groupKey optionalType: string | number
The group key to be configured in a card element. It is automatically generated by default.
추가할 카드 엘리먼트에 설정할 그룹 키. 생략하면 값이 자동으로 생성된다.
Returns:
Type Description eg.InfiniteGrid An instance of a module itself모듈 자신의 인스턴스
Example
infinitegrid.append("<div class='item'>test1</div><div class='item'>test2</div>");
infinitegrid.append(["<div class='item'>test1</div>", "<div class='item'>test2</div>"]);
infinitegrid.append([HTMLElement1, HTMLElement2]);
infinitegrid.append(jQuery(["<div class='item'>test1</div>", "<div class='item'>test2</div>"])); -
-
clear(){eg.InfiniteGrid}
-
Clears added card elements and data.
추가된 카드 엘리먼트와 데이터를 모두 지운다.
Returns:
Type Description eg.InfiniteGrid An instance of a module itself모듈 자신의 인스턴스
-
destroy()
-
Destroys elements, properties, and events used on a grid layout.
그리드 레이아웃에 사용한 엘리먼트와 속성, 이벤트를 해제한다
-
endLoading(userStyle){eg.InfiniteGrid}
-
End loading after startLoading() for append/prepend
append/prepend하길 위해 startLoading() 호출해선 걸었던 로딩을 끝낸다.
-
userStyle (default:
{display: "none"}
) optionalType: Objectcustom style to apply to this loading bar for end
로딩 시작을 위한 로딩 바에 적용할 커스텀 스타일
Returns:
Type Description eg.InfiniteGrid An instance of a module itself모듈 자신의 인스턴스
-
-
getGroupKeys(includeCached){Array}
-
Returns the list of group keys which belongs to card elements currently being maintained. You can use the append() or prepend() method to configure group keys so that multiple card elements can be managed at once. If you do not use these methods to configure group keys, groupkey is automatically generated.
현재 유지하고 있는 카드 엘리먼트의 그룹 키 목록을 반환한다. 여러 개의 카드 엘리먼트를 묶어서 관리할 수 있도록 append() 메서드나 prepend() 메서드에서 그룹 키를 지정할 수 있다. append() 메서드나 prepend() 메서드에서 그룹 키를 지정하지 않았다면 자동으로 그룹키가 생성된다.
-
includeCached optionalType: Boolean
Indicates whether to include the cached groups.
캐싱된 그룹을 포함할지 여부를 나타낸다.
Returns:
Type Description Array List of group keys그룹 키의 목록
-
-
getItem(groupIndex, itemIndex){IInfiniteGridItem | undefined}
-
Retrieves the item via index or the element.
index 또는 element를 통해 아이템을 가져온다.
-
groupIndex (default:
0
) optionalType: number | HTMLElementThe element corresponding to item or the index of the group where the item is in position
item에 해당하는 element 또는 해당 item이 있는 group의 index
-
itemIndex optionalType: number
If groupIndex is used, the index of the item in the group
groupIndex를 사용할 경우 해당 group에 있는 Item의 index
Returns:
Type Description IInfiniteGridItem | undefined The item containing the content, size and position,etccontent, size, position 등이 담겨있는 item 정보
Example
ig.getItem(0, 0);
ig.getItem(element);{ el: HTMLElement, content: "<div>...</div>", size: {width: ..., height: ...}, rect: {top: ..., left: ..., width: ..., height: ...}, }
-
-
getItems(includeCached){IInfiniteGridItem[]}
-
Returns the layouted items.
레이아웃된 아이템들을 반환한다.
-
includeCached (default:
false
) optionalType: BooleanIndicates whether to include the cached items.
캐싱된 아이템을 포함할지 여부를 나타낸다.
Returns:
Type Description IInfiniteGridItem[] List of items아이템의 목록
-
-
getLoadingBar(isAppend){Element}
-
Returns the element of loading bar.
로딩 바의 element를 반환한다.
-
isAppend (default:
currentLoadingBar|true
) optionalType: BooleanChecks whether the card element is added to the append () method.
카드 엘리먼트가 append() 메서드로 추가 할 것인지 확인한다.
Returns:
Type Description Element The element of loading bar.로딩 바의 element
-
-
getStatus(startKey, endKey){Object}
-
Returns the current state of a module such as location information. You can use the setStatus() method to restore the information returned through a call to this method.
카드의 위치 정보 등 모듈의 현재 상태 정보를 반환한다. 이 메서드가 반환한 정보를 저장해 두었다가 setStatus() 메서드로 복원할 수 있다
-
startKey optionalType: string | number
-
endKey optionalType: string | number
Returns:
Type Description Object State object of the eg.InfiniteGrid moduleeg.InfiniteGrid 모듈의 상태 객체
-
-
inherited hasOn(eventName){boolean}
-
Checks whether an event has been attached to a component.
컴포넌트에 이벤트가 등록됐는지 확인한다.
-
eventNameType: string
The name of the event to be attached
등록 여부를 확인할 이벤트의 이름
Returns:
Type Description boolean Indicates whether the event is attached.이벤트 등록 여부
Example
class Some extends eg.Component { some() { this.hasOn("hi");// check hi event. } }
-
-
isLoading(){Boolean}
-
Checks whether data is loading.
데이터 로딩 중인지 확인한다
Returns:
Type Description Boolean Indicates whether data is loading데이터 로딩 진행 중 여부
-
isProcessing(){Boolean}
-
Checks whether a card element or data is being added.
카드 엘리먼트 추가 또는 데이터 로딩이 진행 중인지 확인한다
Returns:
Type Description Boolean Indicates whether a card element or data is being added카드 엘리먼트 추가 또는 데이터 로딩 진행 중 여부
-
layout(isRelayout){eg.InfiniteGrid}
-
Rearranges a layout.
레이아웃을 다시 배치한다.
-
isRelayout (default:
true
) optionalType: BooleanIndicates whether a card element is being relayouted
카드 엘리먼트 재배치 여부
Returns:
Type Description eg.InfiniteGrid An instance of a module itself모듈 자신의 인스턴스
-
-
moveTo(index, itemIndex){eg.InfiniteGrid}
-
Move to some group or item position.
해당하는 그룹 또는 아이템의 위치로 이동한다.
-
index optionalType: Number
group's index
그룹의 index
-
itemIndex (default:
-1
) optionalType: Numberitem's index
그룹의 index
Returns:
Type Description eg.InfiniteGrid An instance of a module itself모듈 자신의 인스턴스
-
-
inherited off(eventName, handlerToDetach){this}
-
Detaches an event from the component.
컴포넌트에 등록된 이벤트를 해제한다
-
eventName optionalType: string | ...
The name of the event to be detached
해제할 이벤트의 이름
-
handlerToDetach optionalType: function | ...
The handler function of the event to be detached
해제할 이벤트의 핸들러 함수
Returns:
Type Description this An instance of a component itself컴포넌트 자신의 인스턴스
Example
class Some extends eg.Component { hi() { console.log("hi"); } some() { this.off("hi",this.hi); //detach event } }
-
-
inherited on(eventName, handlerToAttach){this}
-
Attaches an event to a component.
컴포넌트에 이벤트를 등록한다.
-
eventNameType: string | ...
The name of the event to be attached
등록할 이벤트의 이름
-
handlerToAttach optionalType: function | ...
The handler function of the event to be attached
등록할 이벤트의 핸들러 함수
Returns:
Type Description this An instance of a component itself컴포넌트 자신의 인스턴스
Example
class Some extends eg.Component { hi() { console.log("hi"); } some() { this.on("hi",this.hi); //attach event } }
-
-
inherited once(eventName, handlerToAttach){this}
-
Executed event just one time.
이벤트가 한번만 실행된다.
-
eventNameType: string | ...
The name of the event to be attached
등록할 이벤트의 이름
-
handlerToAttach optionalType: function | ...
The handler function of the event to be attached
등록할 이벤트의 핸들러 함수
Returns:
Type Description this An instance of a component itself컴포넌트 자신의 인스턴스
Example
class Some extends eg.Component { hi() { alert("hi"); } thing() { this.once("hi", this.hi); } var some = new Some(); some.thing(); some.trigger("hi"); // fire alert("hi"); some.trigger("hi"); // Nothing happens
-
-
prepend(elements, groupKey){eg.InfiniteGrid}
-
Adds a card element at the top of a layout. This method is available only if the isProcessing() method returns false.
카드 엘리먼트를 레이아웃의 위에 추가한다. isProcessing() 메서드의 반환값이 'false'일 때만 이 메서드를 사용할 수 있다
-
elementsType: HTMLElement[] | IJQuery | string[] | string
elements Array of the card elements to be added
추가할 카드 엘리먼트 배열
-
groupKey optionalType: string | number
The group key to be configured in a card element. It is automatically generated by default.
추가할 카드 엘리먼트에 설정할 그룹 키. 생략하면 값이 자동으로 생성된다.
Returns:
Type Description eg.InfiniteGrid An instance of a module itself모듈 자신의 인스턴스
Example
infinitegrid.prepend("<div class='item'>test1</div><div class='item'>test2</div>");
infinitegrid.prepend(["<div class='item'>test1</div>", "<div class='item'>test2</div>"]);
infinitegrid.prepend([HTMLElement1, HTMLElement2]);
infinitegrid.prepend(jQuery(["<div class='item'>test1</div>", "<div class='item'>test2</div>"])); -
-
remove(item, isLayout){Object}
-
Removes a item element on a grid layout.
그리드 레이아웃의 카드 엘리먼트를 삭제한다.
-
itemType: HTMLElement
element to be removed
삭제될 아이템 엘리먼트
-
isLayout (default:
true
) optionalType:
Returns:
Type Description Object Removed items information삭제된 아이템들 정보
-
-
removeByIndex(groupIndex, itemIndex, isLayout){Object}
-
Removes a item corresponding to an index on a grid layout.
그리드 레이아웃에서 인덱스에 해당하는 아이템 삭제한다.
-
groupIndexType: number
Index of group corresponding to item to remove
삭제할 아이템에 해당하는 그룹의 인덱스
-
itemIndexType: number
Index of item to remove on group
그룹에서 삭제할 아이템의 인덱스
-
isLayout (default:
true
) optionalType:
Returns:
Type Description Object Removed items information삭제된 아이템들 정보
-
-
setLayout(LayoutKlass, options){eg.InfiniteGrid}
-
Specifies the Layout class to use.
사용할 Layout 클래스를 지정한다.
-
LayoutKlassType: Class | Object
The Layout class to use or an instance of a layout moudle
사용할 Layout 클래스 또는 레이아웃 모듈의 인스턴스
-
options (default:
{}
) optionalType: ObjectOptions to apply to the Layout.
Layout에 적용할 옵션
Returns:
Type Description eg.InfiniteGrid An instance of a module itself모듈 자신의 인스턴스
Example
infinitegrid.setLayout(eg.InfiniteGrid.GridLayout, {
margin: 10,
align: "start"
});
infinitegrid.setLayout(eg.InfiniteGrid.JustifiedLayout, {
margin: 10,
minSize: 100,
maxSize: 200
});
infinitegrid.setLayout(eg.InfiniteGrid.SquareLayout, {
margin: 10,
column: 2
});
infinitegrid.setLayout(eg.InfiniteGrid.FrameLayout, {
margin: 10,
frame: [
[1, 2],
[4, 3],
]
});
infinitegrid.setLayout(eg.InfiniteGrid.PackingLayout, {
margin: 10,
aspectRatio: 1.5
});
var layout = new eg.InfiniteGrid.GridLayout({
margin: 10,
align: "start"
});
infinitegrid.setLayout(layout); -
-
setLoadingBar(userLoadingBar){eg.InfiniteGrid}
-
Specifies the Loading Bar to use for append or prepend items.
아이템을 append 또는 prepend 하기 위해 사용할 로딩 바를 지정한다.
-
userLoadingBar (default:
{}
) optionalType: String | ObjectThe loading bar HTML markup or element or element selector
로딩 바 HTML 또는 element 또는 selector
Returns:
Type Description eg.InfiniteGrid An instance of a module itself모듈 자신의 인스턴스
-
-
setStatus(status, applyScrollPos, syncElements){eg.InfiniteGrid}
-
Sets the state of the eg.InfiniteGrid module with the information returned through a call to the getStatue() method.
getStatue() 메서드가 저장한 정보로 eg.InfiniteGrid 모듈의 상태를 설정한다.
-
statusType: Object
State object of the eg.InfiniteGrid module
eg.InfiniteGrid 모듈의 상태 객체
-
applyScrollPos (default:
true
) optionalType: booleanChecks whether to scroll
스크롤의 위치를 복원할지 결정한다.
-
syncElements optionalType: HTMLElement[]
Returns:
Type Description eg.InfiniteGrid An instance of a module itself모듈 자신의 인스턴스
-
-
startLoading(isAppend, userStyle){eg.InfiniteGrid}
-
Start loading for append/prepend during loading data.
데이터가 로딩되는 동안 append/prepend하길 위해 로딩을 시작한다.
-
isAppend (default:
true
) optionalType: BooleanChecks whether the card element is added to the append () method.
카드 엘리먼트가 append() 메서드로 추가 할 것인지 확인한다.
-
userStyle (default:
{display: "block"}
) optionalType: Objectcustom style to apply to this loading bar for start.
로딩 시작을 위한 로딩 바에 적용할 커스텀 스타일
Returns:
Type Description eg.InfiniteGrid An instance of a module itself모듈 자신의 인스턴스
-
-
inherited trigger(eventName, customEvent, restParam){boolean}
-
Triggers a custom event.
커스텀 이벤트를 발생시킨다
-
eventNameType: string | ...
The name of the custom event to be triggered
발생할 커스텀 이벤트의 이름
-
customEventType: object | ...
Event data to be sent when triggering a custom event
커스텀 이벤트가 발생할 때 전달할 데이터
-
restParamType: Array.<any>
Additional parameters when triggering a custom event
커스텀 이벤트가 발생할 때 필요시 추가적으로 전달할 데이터
Returns:
Type Description boolean Indicates whether the event has occurred. If the stop() method is called by a custom event handler, it will return false and prevent the event from occurring. Ref이벤트 발생 여부. 커스텀 이벤트 핸들러에서 stop() 메서드를 호출하면 'false'를 반환하고 이벤트 발생을 중단한다. 참고
Example
class Some extends eg.Component { some(){ if(this.trigger("beforeHi")){ // When event call to stop return false. this.trigger("hi");// fire hi event. } } } const some = new Some(); some.on("beforeHi", (e) => { if(condition){ e.stop(); // When event call to stop, `hi` event not call. } }); some.on("hi", (e) => { // `currentTarget` is component instance. console.log(some === e.currentTarget); // true }); // If you want to more know event design. You can see article. // https://github.com/naver/egjs-component/wiki/How-to-make-Component-event-design%3F
-
-
updateItem(groupIndex, itemIndex){eg.InfiniteGrid}
-
Updates the item via index or the element.
index 또는 element를 통해 아이템을 업데이트한다.
-
groupIndex (default:
0
) optionalType: number | HTMLElementThe element corresponding to item or the index of the group where the item is in position
item에 해당하는 element 또는 해당 item이 있는 group의 index
-
itemIndex optionalType: number
If groupIndex is used, the index of the item in the group
groupIndex를 사용할 경우 해당 group에 있는 Item의 index
Returns:
Type Description eg.InfiniteGrid An instance of a module itself모듈 자신의 인스턴스
Example
element.innerHTML = "2";
element.style.height = "400px";
ig.updateItem(element);
ig.updateItem(0, 0); -
-
updateItems(){eg.InfiniteGrid}
-
Update the currently displayed items.
현재보여주는 아이템들을 업데이트한다.
Returns:
Type Description eg.InfiniteGrid An instance of a module itself모듈 자신의 인스턴스
Example
element.innerHTML = "2";
element.style.height = "400px";element2.innerHTML = "2"; element2.style.height = "400px"; ig.updateItems();
Type Definitions
-
eg.InfiniteGrid.IErrorCallbackOptionsTSInterface
-
Error Interface
에러 인터페이스
Properties:
Name Type Description target
HTMLImageElement element
HTMLElement items
IInfiniteGridItem[] item
IInfiniteGridItem itemIndex
number totalIndex
number replace
(src?: string | HTMLElement) => void replaceItem
(content: string) => void remove
() => void removeItem
() => void -
eg.InfiniteGrid.IInfiniteGridItemTSInterface
-
Item Interface
Item Interface
Properties:
Name Type Argument Description groupKey
string | number Key in group containing item
아이템을 포함하고 있는 그룹의 키
itemKey
string | number <optional>
html of element in item
아이템의 엘리먼트 html
content
HTMLElement Element for the item
아이템에 있는 엘리먼트
el
IInfiniteGridItemElement | null <optional>
Size of elements of the rendering when the first time.
처음 렌더링 했을 때의 엘리먼트의 사이즈
orgSize
ISize | null <optional>
Currently seen the size of element
현재 보여지는 엘리먼트의 사이즈
size
ISize | null <optional>
Position and size of the element shown in layout
레이아웃할 때 보여지는 포지션과 사이즈
rect
IPosition & Partial<ISize> The position and size of the element that was seen in the layout before
전에 레이아웃했을 때 보였었던 포지션과 사이즈
prevRect
IPosition & Partial<ISize> | null <optional>
needUpdate
boolean mounted
boolean [key: string]
any -
eg.InfiniteGrid.IPositionTSInterface
-
Position Interface
Position Interface
Properties:
Name Type Description top
number left
number -
eg.InfiniteGrid.ISizeTSInterface
-
Size Interface
Size Interface
Properties:
Name Type Description width
number height
number
Events
-
append
-
This event is fired when a card element must be added at the bottom or right of a layout because there is no card to be displayed on screen when a user scrolls near bottom or right.
카드 엘리먼트가 레이아웃의 아래나 오른쪽에 추가돼야 할 때 발생하는 이벤트. 사용자가 아래나 오른쪽으로 스크롤해서 화면에 표시될 카드가 없을 때 발생한다
-
paramType: Object
The object of data to be sent to an event
이벤트에 전달되는 데이터 객체
-
groupKeyType: String | Number
The group key of the first group visible on the screen
화면에 보여지는 마지막 그룹의 그룹키
-
param.isTrustedType: Boolean
Returns true if an event was generated by the user action, or false if it was caused by a script or API call
사용자의 액션에 의해 이벤트가 발생하였으면 true, 스크립트나 API호출에 의해 발생하였을 경우에는 false를 반환한다.
-
param.startLoadingType: function
Start loading for append loading data.
뒷쪽에 추가되는 데이터 로딩을 시작한다.
-
userStyleType: Object
The custom style to apply to this loading bar for start.
로딩을 시작할 때 로딩 바에 적용될 사용자 스타일
-
-
param.endLoadingType: function
End loading after startLoading() for append/prepend loading data.
데이터 로딩을 위해 append/prepend startLoading() 호출 이후 로딩을 끝낸다.
-
userStyleType: Object
The custom style to apply to this loading bar for start.
로딩이 끝날 때 로딩 바에 적용될 사용자 스타일
-
-
-
change
-
This event is fired when the user scrolls.
사용자가 스크롤 할 경우 발생하는 이벤트.
-
paramType: Object
The object of data to be sent to an event
이벤트에 전달되는 데이터 객체
-
isForwardType: Boolean
Indicates whether the scroll progression direction is forward or backword.
스크롤 진행방향이 앞쪽으로 진행하는 지, 뒤쪽으로 진행하는지를 나타낸다.
-
scrollPosType: Number
Current scroll position value relative to the infiniteGrid container element.
infiniteGrid 컨테이너 엘리먼트 기준의 현재 스크롤 위치값
-
orgScrollPosType: Boolean
Current position of the scroll
현재 스크롤 위치값
-
isTrustedType: Boolean
Returns true if an event was generated by the user action, or false if it was caused by a script or API call
사용자의 액션에 의해 이벤트가 발생하였으면 true, 스크립트나 API호출에 의해 발생하였을 경우에는 false를 반환한다.
-
-
options.horizontalType: Boolean
Direction of the scroll movement (true: horizontal, false: vertical)
스크롤 이동 방향 (true 가로방향, false 세로방향
-
-
contentError
-
This event is fired when an error occurs in the content.
콘텐츠 로드에 에러가 날 때 발생하는 이벤트.
-
e
The object of data to be sent to an event
이벤트에 전달되는 데이터 객체
-
element optionalType: HTMLElement
Appending card's image element.
추가 되는 카드의 콘텐츠 엘리먼트
-
target optionalType: target
The item's element with error images.
에러난 콘텐츠를 가지고 있는 아이템의 엘리먼트
-
items optionalType: Array.<Item>
The items being added.
화면에 추가중인 아이템들
-
item optionalType: Item
The item with error images.
에러난 콘텐츠를 가지고 있는 아이템
-
index optionalType: number
The item's index with error images.
에러난 콘텐츠를 가지고 있는 아이템의 인덱스
-
totalIndex optionalType: number
The item's index with error images in all items.
전체 아이템중 에러난 콘텐츠를 가지고 있는 아이템의 인덱스
-
remove optionalType: function
In the contentError event, this method expects to remove the error image.
콘텐츠 에러 이벤트에서 이 메서드는 에러난 콘텐츠를 삭제한다.
-
removeItem optionalType: function
In the contentError event, this method expects to remove the item with the error image.
콘텐츠 에러 이벤트에서 이 메서드는 에러난 콘텐츠를 가지고 있는 아이템을 삭제한다.
-
replace optionalType: function
In the contentError event, this method expects to replace the error image's source or element. If the replacement was done externally, call replace().
콘텐츠 에러 이벤트에서 이 메서드는 에러난 엘리먼트를 교체한다. 외부에서 교체를 했다면 replace()로 호출해라.
-
replaceItem optionalType: function
In the contentError event, this method expects to replace the item's contents with the error image.
콘텐츠 에러 이벤트에서 이 메서드는 에러난 콘텐츠를 가지고 있는 아이템의 내용을 교체한다.
-
Example
ig.on("contentError", e => {
e.remove();
e.removeItem();
e.replace(imageElement);
// If the replacement was done externally
e.replace();
e.replaceItem("item html");
}); -
-
imageError
-
This event is fired when an error occurs in the image.
이미지 로드에 에러가 날 때 발생하는 이벤트.
-
e
The object of data to be sent to an event
이벤트에 전달되는 데이터 객체
-
element optionalType: HTMLElement
Appending card's image element.
추가 되는 카드의 이미지 엘리먼트
-
target optionalType: target
The item's element with error images.
에러난 이미지를 가지고 있는 아이템의 엘리먼트
-
items optionalType: Array.<Item>
The items being added.
화면에 추가중인 아이템들
-
item optionalType: Item
The item with error images.
에러난 이미지를 가지고 있는 아이템
-
index optionalType: number
The item's index with error images.
에러난 이미지를 가지고 있는 아이템의 인덱스
-
totalIndex optionalType: number
The item's index with error images in all items.
전체 아이템중 에러난 이미지를 가지고 있는 아이템의 인덱스
-
remove optionalType: function
In the imageError event, this method expects to remove the error image.
이미지 에러 이벤트에서 이 메서드는 에러난 이미지를 삭제한다.
-
removeItem optionalType: function
In the imageError event, this method expects to remove the item with the error image.
이미지 에러 이벤트에서 이 메서드는 에러난 이미지를 가지고 있는 아이템을 삭제한다.
-
replace optionalType: function
In the imageError event, this method expects to replace the error image's source or element.
이미지 에러 이벤트에서 이 메서드는 에러난 이미지의 주소 또는 엘리먼트를 교체한다.
-
replaceItem optionalType: function
In the imageError event, this method expects to replace the item's contents with the error image.
이미지 에러 이벤트에서 이 메서드는 에러난 이미지를 가지고 있는 아이템의 내용을 교체한다.
-
Example
ig.on("imageError", e => {
e.remove();
e.removeItem();
e.replace("http://...jpg");
e.replace(imageElement);
e.replaceItem("item html");
}); -
-
layoutComplete
-
This event is fired when layout is successfully arranged through a call to the append(), prepend(), or layout() method.
레이아웃 배치가 완료됐을 때 발생하는 이벤트. append() 메서드나 prepend() 메서드, layout() 메서드 호출 후 카드의 배치가 완료됐을 때 발생한다
-
paramType: Object
The object of data to be sent to an event
이벤트에 전달되는 데이터 객체
-
targetType: Array
Rearranged card elements
재배치된 카드 엘리먼트들
-
fromCacheType: Boolean
Check whether these items are cache or not
해당 아이템들이 캐시인지 아닌지 확인한다.
-
isLayoutType: Boolean
Returns true if this is an event called by resize event or layout method. Returns false if this is an event called by adding an item.
해당 이벤트가 리사이즈 이벤트 또는 layout() 메서드를 통해 호출됐으면 true, 아이템 추가로 호출됐으면 false를 반환한다.
-
isAppendType: Boolean
Checks whether the append() method is used to add a card element. It returns true even though the layoutComplete event is fired after the layout() method is called.
카드 엘리먼트가 append() 메서드로 추가됐는지 확인한다. layout() 메서드가 호출된 후 layoutComplete 이벤트가 발생해도 'true'를 반환한다.
-
isScrollType: Boolean
Checks whether scrolling has occurred after the append(), prepend(), ..., etc method is called
append, prend 등 호출 후 스크롤이 생겼는지 확인한다.
-
scrollPosType: Number
Current scroll position value relative to the infiniteGrid container element.
infiniteGrid 컨테이너 엘리먼트 기준의 현재 스크롤 위치값
-
orgScrollPosType: Number
Current position of the scroll
현재 스크롤 위치값
-
sizeType: Number
The size of container element
컨테이너 엘리먼트의 크기
-
isTrustedType: Boolean
Returns true if an event was generated by the user action, or false if it was caused by a script or API call
사용자의 액션에 의해 이벤트가 발생하였으면 true, 스크립트나 API호출에 의해 발생하였을 경우에는 false를 반환한다.
-
endLoadingType: function
End loading after startLoading() for append/prepend loading data.
데이터 로딩을 위해 append/prepend startLoading() 호출 이후 로딩을 끝낸다.
-
userStyleType: Object
The custom style to apply to this loading bar for start.
로딩이 끝날 때 로딩 바에 적용될 사용자 스타일
-
-
-
-
prepend
-
This event is fired when a card element must be added at the top or left of a layout because there is no card to be displayed on screen when a user scrolls near top or left.
카드가 레이아웃의 위나 왼쪽에 추가돼야 할 때 발생하는 이벤트. 사용자가 위나 왼쪽으로 스크롤해서 화면에 표시될 카드가 없을 때 발생한다.
-
paramType: Object
The object of data to be sent to an event
이벤트에 전달되는 데이터 객체
-
groupKeyType: String | Number
The group key of the first group visible on the screen
화면에 보여지는 첫번째 그룹의 그룹키
-
param.isTrustedType: Boolean
Returns true if an event was generated by the user action, or false if it was caused by a script or API call
사용자의 액션에 의해 이벤트가 발생하였으면 true, 스크립트나 API호출에 의해 발생하였을 경우에는 false를 반환한다.
-
param.startLoadingType: function
Start loading for prepend loading data.
앞쪽에 추가되는 데이터 로딩을 시작한다.
-
userStyleType: Object
The custom style to apply to this loading bar for start.
로딩을 시작할 때 로딩 바에 적용될 사용자 스타일
-
-
param.endLoadingType: function
End loading after startLoading() for append/prepend loading data.
데이터 로딩을 위해 append/prepend startLoading() 호출 이후 로딩을 끝낸다.
-
userStyleType: Object
The custom style to apply to this loading bar for start.
로딩이 끝날 때 로딩 바에 적용될 사용자 스타일
-
-