HtmlForgeX

API Reference

Class

DataTablesSearchBuilderBuilder

Namespace HtmlForgeX
Assembly HtmlForgeX

Fluent builder used to configure the DataTables SearchBuilder plugin without having to create the underlying option objects manually. This allows complex groups and custom operators to be declared using a C# API and serialized to the structure expected by DataTables.

Inheritance

  • Object
  • DataTablesSearchBuilderBuilder

Constructors

Methods

Build() #

Finalises configuration and returns the resulting DataTablesSearchBuilder instance.

Returns

The configured DataTablesSearchBuilder.

public DataTablesSearchBuilderBuilder Conditions(Int32 count) #
Returns: DataTablesSearchBuilderBuilder

Sets the default number of conditions that will be available to the user when SearchBuilder is first initialised.

Parameters

count System.Int32 requiredposition: 0
Number of conditions.

Returns

The current builder instance.

CustomOperator 2 overloads
public DataTablesSearchBuilderBuilder CustomOperator(String name, String javascript) #
Returns: DataTablesSearchBuilderBuilder

Registers a custom filtering operator.

Parameters

name System.String requiredposition: 0
Name of the operator as used by DataTables.
javascript System.String requiredposition: 1
JavaScript implementation of the operator.

Returns

The current builder instance.

public DataTablesSearchBuilderBuilder CustomOperator(DataTablesBuiltInOperator op) #
Returns: DataTablesSearchBuilderBuilder

Adds one of the predefined operators provided by DataTablesSearchBuiltIns.

Parameters

op HtmlForgeX.DataTablesBuiltInOperator requiredposition: 0
Identifier of the built-in operator.

Returns

The current builder instance.

public DataTablesSearchBuilderBuilder Enable(Boolean enable = true) #
Returns: DataTablesSearchBuilderBuilder

Enables or disables the SearchBuilder plug-in for the table.

Parameters

enable System.Boolean = true optionalposition: 0
Whether SearchBuilder should be enabled.

Returns

The current builder instance.

public DataTablesSearchBuilderBuilder Greyscale(Boolean greyscale = true) #
Returns: DataTablesSearchBuilderBuilder

Enables grey-scale colour scheme which can improve readability on some backgrounds.

Parameters

greyscale System.Boolean = true optionalposition: 0
Value indicating whether grey-scale styling should be used.

Returns

The current builder instance.

public DataTablesSearchBuilderBuilder Group(Action<DataTablesSearchGroupBuilder> configure) #
Returns: DataTablesSearchBuilderBuilder

Adds a group of conditions to the SearchBuilder configuration.

Parameters

configure System.Action{HtmlForgeX.DataTablesSearchGroupBuilder} requiredposition: 0
Delegate used to configure the group.

Returns

The current builder instance.

Logic 2 overloads
public DataTablesSearchBuilderBuilder Logic(DataTablesSearchLogic logic) #
Returns: DataTablesSearchBuilderBuilder

Defines the logical operator used between top level groups.

Parameters

logic System.String requiredposition: 0
Value to assign, typically "AND" or "OR".

Returns

The current builder instance.

Logic(HtmlForgeX.DataTablesSearchLogic logic) #

Defines the logical operator used between top level groups using a typed enumeration.

Parameters

logic HtmlForgeX.DataTablesSearchLogic required
public DataTablesSearchBuilderBuilder PreDefined(Object predefined) #
Returns: DataTablesSearchBuilderBuilder

Injects a predefined SearchBuilder configuration object. Useful for restoring a previous state.

Parameters

predefined System.Object requiredposition: 0
Object describing SearchBuilder state.

Returns

The current builder instance.