$(‘#example’).dataTable().fnAddData([giCount + ".1", giCount + ".2", giCount + ".3", giCount + ".4"]);
fnAdjustColumnSizing
这个函数将使datatable重新计算列的大小,根据表中的数据和大小应用到列(在DOM中,CSS或通过sWidth参数)。 这可能是有用的,宽度的表的父元素的变化(例如一个窗口大小调整)。
Input parameters:输入参数: {boolean} [default=true]: 重绘或不重绘,你通常会想
Return parameter:返回参数:
Code example:代码示例:
$(document).ready(function() {
var oTable = $(‘#example’).dataTable({
“sScrollY”: “200px”,
“bPaginate”: false
});
$(window).bind(‘resize’,
function() {
oTable.fnAdjustColumnSizing();
});
});
fnClearTable
快速而简单地清楚一个表
Input parameters:输入参数: {bool} [default=true]: 重绘或不重绘
Return parameter:返回参数:
Code example:代码示例:
$(document).ready(function() {
var oTable = $(‘#example’).dataTable();
// Immediately ‘nuke’ the current rows (perhaps waiting for an Ajax callback…)
oTable.fnClearTable();
});
fnClose
相反,打开的一行,此函数将关闭任何行目前是“open”。
Input parameters:输入参数: {node}: the table row to ‘close’
Return parameter:返回参数: {int}:0成功,或1如果失败(找不到行)
Code example:代码示例:
$(document).ready(function() {
var oTable;
// ‘open’ an information row when a row is clicked on
$(‘#example tbody tr’).click(function() {
if (oTable.fnIsOpen(this)) {
oTable.fnClose(this);
} else {
oTable.fnOpen(this, “Temporary row opened”, “info_row”);
}
});
oTable = $(‘#example’).dataTable();
});
fnDeleteRow
为表删除一行
Input parameters:输入参数: {mixed}:该指数从aoData的行被删除,或TR元素你想删除
{function|null}: Callback function
{bool} [default=true]: 重绘或不是重绘
Return parameter:返回参数: {array}: 行被删除
Code example:代码示例:
$(document).ready(function() {
var oTable = $(‘#example’).dataTable();
// Immediately remove the first row
oTable.fnDeleteRow(0);
});
fnDestroy
恢复表本来的状态在DOM中删除所有datatable的增强,修改DOM结构的表和事件监听器。
Input parameters:输入参数: {boolean} [default=false]:完全删除表从DOM
Return parameter:返回参数:
Code example:代码示例:
$(document).ready(function() {
// This example is fairly pointless in reality, but shows how fnDestroy can be used
var oTable = $(‘#example’).dataTable();
oTable.fnDestroy();
});
fnDraw
Show details Redraw the table重绘
Input parameters:输入参数: {bool} [default=true]: 重新过滤和重新排序(如果启用)表在画表之前。
Return parameter:返回参数:
Code example:代码示例:
$(document).ready(function() {
var oTable = $(‘#example’).dataTable();
// Re-draw the table – you wouldn’t want to do it here, but it’s an example
oTable.fnDraw();
});
fnFilter
基于数据过滤输入
Input parameters:输入参数: {string}: 字符串来过滤表
{int|null}:列来限制过滤来
{bool} [default=false]: 使用正则表达式或不使用
{bool} [default=true]: 执行智能过滤或不是
{bool} [default=true]: 显示输入全局过滤器在它的输入框
{bool} [default=true]:做不区分大小写匹配(true)或不(false)
Return parameter:返回参数:
Code example:代码示例:
$(document).ready(function() {
var oTable = $(‘#example’).dataTable();
// Sometime later – filter…
oTable.fnFilter(‘test string’);
});
fnGetData
获取数据对整个表,一个单独的行或单个Cell基于提供的参数。
Input parameters:输入参数: {int|node}: 一个TR行节点, TD/TH cell 节点 或一个整数。 如果给定作为TR节点那么数据来源将返回整个行。如果给出一个TD / THCell节点然后iCol将自动计算并返回的数据单元。如果作为一个整数,那么这可以看作是aoData内部数据索引的行(参见 fnGetPosition)和数据使用那一行。
{int}: 可选的列的索引,您想要的数据。
Return parameter:返回参数: {array|object|string}: 如果mRow是未定义,那么数据返回所有行。如果mRow被定义,只是数据,并iCol那一行定义,只有数据返回指定的Cell。
Code example:代码示例:
// Row data
$(document).ready(function() {
oTable = $(‘#example’).dataTable();
oTable.$(‘tr’).click(function() {
var data = oTable.fnGetData(this);
// … do something with the array / object of data for the row
});
});
// Individual cell data
$(document).ready(function() {
oTable = $(‘#example’).dataTable();
oTable.$(‘td’).click(function() {
var sData = oTable.fnGetData(this);
alert(‘The cell clicked on had the value of ‘ + sData);
});
});
fnGetNodes
得到一个数组的TR节点用于表的身体。注意,您通常会希望使用’$’ API方法优先于这个因为它更灵活。
Input parameters:输入参数: {int}:可选的行指数为TR元素你想要的
Return parameter:返回参数: {array|node}: 如果iRow是未定义的,返回一个数组中的元素的所有TR表的身体,或iRow被定义,只是TR元素要求。
Code example:代码示例:
$(document).ready(function() {
var oTable = $(‘#example’).dataTable();
// Get the nodes from the table
var nNodes = oTable.fnGetNodes();
});
fnGetPosition
得到数组索引特定Cell从它的DOM元素和列索引包括隐藏的列
Input parameters:输入参数: {node}: 这可以是一个TR TD或TH,在表的body
Return parameter:返回参数: {int}: 如果nNode为TR,然后返回一个索引,或者作为一个单元,一个数组(行索引、列索引(可见)、列索引(所有)]了。
Code example:代码示例:
$(document).ready(function() {
$(‘#example tbody td’).click(function() {
// Get the position of the current data from the node
var aPos = oTable.fnGetPosition(this);
// Get the data array for this row
var aData = oTable.fnGetData(aPos[0]);
// Update the data array and return the value
aData[aPos[1]] = ‘clicked’;
this.innerHTML = ‘clicked’;
});
// Init DataTables
oTable = $(‘#example’).dataTable();
});
fnIsOpen
检查一行是“open”or not。
Input parameters:输入参数: {node}: 表行检查
Return parameter:返回参数: {boolean}: true如果行目前是‘open’,false否则
Code example:代码示例:
$(document).ready(function() {
var oTable; // ‘open’ an information row when a row is clicked on
$(‘#example tbody tr’).click(function() {
if (oTable.fnIsOpen(this)) {
oTable.fnClose(this);
} else {
oTable.fnOpen(this, “Temporary row opened”, “info_row”);
}
});
oTable = $(‘#example’).dataTable();
});
fnOpen
这个函数将一个新行后直接行目前显示在页面上,用HTML内容传递到函数。这可以使用,例如,要求确认某一记录应该被删除。
Input parameters:输入参数: {node}: The table row to ‘open’
{string|node|jQuery}: HTML放入行
{string}: Class to give the new TD cell
Return parameter:返回参数: {node}: 行已经打开。注意,如果表行传入的第一个参数,不存在表,这个方法将返回。
Code example:代码示例:
$(document).ready(function() {
var oTable;
// ‘open’ an information row when a row is clicked on
$(‘#example tbody tr’).click(function() {
if (oTable.fnIsOpen(this)) {
oTable.fnClose(this);
} else {
oTable.fnOpen(this, “Temporary row opened”, “info_row”);
}
});
oTable = $(‘#example’).dataTable();
});
fnPageChange
改变分页-提供内部逻辑分页在一个简单的API函数。您可以使用此函数有一个datatable表进行下一个,以前,第一或最后一页。
Input parameters:输入参数: {string|int}: Paging action to take: “first”, “previous”, “next” or “last” or page number to jump to (integer),注意 page 0 is the first page.
{bool} [default=true]: 重绘或不重绘
Return parameter:返回参数:
Code example:代码示例:
$(document).ready(function() {
var oTable = $(‘#example’).dataTable();
oTable.fnPageChange(‘next’);
});
fnSetColumnVis
显示一个特定列
Input parameters:输入参数: {int}: 列的显示被改变
{bool}: Show (true) or hide (false) the column
{bool} [default=true]: 重绘或不重绘
Return parameter:返回参数:
Code example:代码示例:
$(document).ready(function() {
var oTable = $(‘#example’).dataTable();
// Hide the second column after initialisation
oTable.fnSetColumnVis(1, false);
});
fnSettings
得到设置为特定的表为外部操作
Input parameters:输入参数:
Return parameter:返回参数: {object}: datatable设置对象。See {@link DataTable.models.oSettings}看到{ @link DataTable.models.oSettings }
Code example:代码示例:
$(document).ready(function() {
var oTable = $(‘#example’).dataTable();
var oSettings = oTable.fnSettings();
// Show an example parameter from the settings
alert(oSettings._iDisplayStart);
});
fnSort
由一个特定的表排序的列
Input parameters:输入参数: {int}: 数据索引来排序。注意,这将不匹配”display index”如果你有隐藏的数据条目
Return parameter:返回参数:
Code example:代码示例:
$(document).ready(function() {
var oTable = $(‘#example’).dataTable();
// Sort immediately with columns 0 and 1
oTable.fnSort([[0, ‘asc‘], [1, ‘asc‘]]);
});
fnSortListener
添加一个排序侦听器给一个给定的列元素
Input parameters:输入参数: {node}: 元素附加排序侦听器
{int}: 列单击该节点将排序
{function}: 回调函数运行时进行排序
Return parameter:返回参数:
Code example:代码示例:
$(document).ready(function() {
var oTable = $(‘#example’).dataTable();
// Sort on column 1, when ‘sorter’ is clicked on
oTable.fnSortListener(document.getElementByIdx_x(‘sorter’), 1);
});
fnUpdate
更新一个表格单元格或行——这种方法将接受单个值来更新Cell,数组和一个元素的值为每一列或一个物体在相同的 式与原始数据源。自参照的功能是为了使多列更新变得更为容易。
Input parameters:输入参数: {object|array|string}: 数据来更新cell/row
{node|int}:TR元素你想更新或aoData index
{int}: 列更新(不使用的mData是一个数组或对象)
{bool} [default=true]: 重绘或不是
{bool} [default=true]:执行pre-draw actions 或不是
Return parameter:返回参数: {int}:0成功,1上的错误
Code example:代码示例:
$(document).ready(function() {
var oTable = $(‘#example’).dataTable();
oTable.fnUpdate(‘Example update’, 0, 0);
// Single cell
oTable.fnUpdate([‘a‘, ‘b‘, ‘c‘, ‘d‘, ‘e‘], 1, 0);
// Row
});
fnVersionCheck
提供一个共同的方法插件检查正在使用的版本的datatable,为了确保兼容性。
Input parameters:输入参数: {string}: 版本字符串来检查,在格式“x y z”。注意格式“X”和“X y”也是可以接受的。
Return parameter:返回参数: {boolean}: 真如果这个版本的datatable是大于或等于所需的版本,或假如果这个版本的DataTales是不合适的
Code example:代码示例:
$(document).ready(function() {
var oTable = $(‘#example’).dataTable();
alert(oTable.fnVersionCheck(’1.9.0′));
});
