column().search() 在所选单个列中搜索数据文档(Options & API) DataTables中文网

描述(Description)

虽然 search()API 方法提供了在整个表中进行全局搜索的功能，但是此方法以及复数形式提供了搜索特定列上数据的功能。

因为可以使用多种不同的方式来搜索特定列数据，所以Datatables没有内置任何搜索控件，但是使用这种方法添加自定义列搜索控件变得非常容易。下面的例子显示了如何使用它。

请注意，Datatables中的这种搜索功能实际上是一种过滤器，它是减法操作。之所以称为搜索，以避免与过滤器辅助方法 filter()API 重名。

请注意，此方法只是在内部执行过滤，并没有把数据显示到表中。为了执行搜索并显示结果，还需用 draw()API 方法。使用链式操作，比如这样table.column( 0 ).search( 'Fred' ).draw();，这是为了能够执行绘制之前将多个更改排入队列。

类型(Types)

function column().search()

描述(Description):

获取当前列搜索应用的搜索词。

返回(Returns):

stringType

当前应用于该列的搜索词，如果未应用搜索项，则该字符串为空。

function column().search( input [, regex[ , smart[ , caseInsen ]]] )

描述(Description):

在选择器匹配到的单个列设置列的搜索词。注意，这实际并不执行搜索，而是将其操作加入到队列中，使用 draw()API 执行搜索并显示结果。

参数(Parameters):

	名称（Name）	类型（Type）	是否可选（Optional）
1	`input`	`stringType`	No
	应用于单个列的搜索字符串
2	`regex`	`booleanType`	Yes - default:false
	视指定的字符串为正则表达式（`true`）或者不（默认，`false`）
3	`smart`	`booleanType`	Yes - default:true
	执行智能搜索（默认 `true`）或不执行（`false`）。请注意，执行“smart”搜索，Datatables使用正则表达式，因此，如果您将正则表达式作为第二个参数传递给此方法，您可能需要禁用智能搜索，以保证不同的正则表达是不会冲突。
4	`caseInsen`	`booleanType`	Yes - default:true
	不区分大小写的匹配（默认，`true`）或者不（`false`）

返回(Returns):

DataTables.ApiType

Datatables API 实例

例子(Example)

单个列搜索：

var table = $('#example').DataTable({
    dom:"<'#toolbox'><lftip>",
    initComplete:function(){
        $("#toolbox").append("第四列过滤：<input type='text' id='column3_search'>");
    }

});
 
// #column3_search is a <input type="text"> element
$('#column3_search').on( 'keyup', function () {
    table
        .columns( 3 )
        .search( this.value )
        .draw();
} );

给具有.select-filter类名的列构建一个下拉搜索框：

var table = $('#example').DataTable();
 
table.columns( '.select-filter' ).every( function () {
    var that = this;
 
    // Create the select list and search operation
    var select = $('<select />')
        .appendTo(
            this.footer()
        )
        .on( 'change', function () {
            that
                .search( $(this).val() )
                .draw();
        } );
 
    // Get the search data for the first column and add to the select list
    this
        .cache( 'search' )
        .sort()
        .unique()
        .each( function ( d ) {
            select.append( $('<option value="'+d+'">'+d+'</option>') );
        } );
} );