DataTables (table plugin for jQuery) 2. API

API


Javascript API

일부 API함수들은 데이터 스토리지가 서버보다는 클라이언트측에 있다고 가정한다.
예를들면 fnAddData, fnDeleteRow 는 서버의 데이터베이스에는 효과가 없다.
실제로 DataTables는 당신이 데이터베이스를 사용하고 있는지를 모른다.
그래서 서버측 처리 사용자hgs 필요한 데이터처리를 서버에 요청해야하고,
새로운 데이터를 보여주기 위해서 테이블을 reDraw해야 한다. (fnDraw)


jQuery.dataTable 오브젝트에서 다음 함수들이 가능하다.


fnAddData  - 테이블에 한row 또는 여러 rows를 추가한다.

function fnClickAddRow() {

    oTable.fnAddData( [

        giCount+".1",

        giCount+".2",

        giCount+".3",

        giCount+".4" ] );

fnClearTable  - 현재 row정보의 전체 테이블을 비운다.

oTable.fnClearTable( 0 );

fnClose - row 'openning'의 정확히 반대이다. 이 함수는 현재 'open' 상태인 row들을 close한다.

     oTable.fnClose(this);

fnDeleteRow - 테이블에서 한 row를 삭제한다. 자동으로 테이블을 redraw한다.

oTable.fnDeleteRow( 0 );

fnDraw  -  테이블을 redraw한다.

 oTable.fnDraw();

fnFilter  - 스트링 입력을 기반으로 필터링을 한다.

oTable.fnFilter( 'test string' );

fnGetData - 입력 스트링으로 테이블을 필터한다. 자동으로 테이블을 redraw한다.
                개별컬럼을 필터할때도 사용할 수 있고 정규표현식이 가능하다.

     var aData = oTable.fnGetData( this );

fnGetNodes  - 한 TR 노드 또는 전체 TR 노드들을 구한다. 이벤트 처리를 위해 유용하다.

var nNodes = oTable.fnGetNodes( );


fnGetPosition - DOM요소로 부터 특정 셀의 array index를 구한다.  fnGetData()와 함께 가장 잘 사용된다.

    var aPos = oTable.fnGetPosition( this );

fnOpen  - 페이지에서 현재 표시되고 있는 row (해당 html컨텐츠가 함수에 전달)의 다음에 위치한다.

      oTable.fnOpen( this, "Temporary row opened", "info_row" );

fnPageChange - simple API함수의 페이징을 위한 내부 로직을 제공한다.
               DataTables를 처음,이전,다음,끝페이지로 이동하게 한다.

oTable.fnPageChange( 'next' );

fnSetColumnVis - 주어진 컬럼을 간단하게 visibility를 설정한다.

oTable.fnSetColumnVis( 1, false );

fnSettings - 테이블의 내부 DataTables 파라미터에 접근할 수 있다.

var oSettings = oTable.fnSettings();
alert( oSettings._iDisplayStart );

fnSort - 자바스크립트 함수 콜로 트리거되어 한 컬럼 또는 다중컬럼으로 테이블을 소트할 수 있게 한다.

oTable.fnSort( [ [0,'asc'], [1,'asc'] ] );

fnSortListener - 요소에 소트 리스너를 추가한다. 기본적으로 DataTables가 TH 클릭할 때 리스너 추가하여
                 사용하는것과 같은 함수이다.
                 외부로직으로 필요에 따라 외부요소로 소트를 컨트롤할 수 있게 한다.

oTable.fnSortListener( document.getElementById('sorter'), 1 );

fnUpdate  - DataTables가 제공하는 소트, 필터, 기타 다른 기능들에 의한 새로운 데이터로 테이블을 갱신한다.

     oTable.fnUpdate( 'Example update', 0, 0 ); /* Single cell */
oTable.fnUpdate( ['a', 'b', 'c', 'd', 'e'], 1, 0 ); /* Row */

fnVersionCheck - 호환성을 보장하기 위해 DataTables의 버젼을 첵크하려는 플러그인들을 위한 공용 메서드를 제공한다.

alert( oTable.fnVersionCheck( '1.6.0' ) );