[react-bootstrap-table] Add thStyle, tdStyle, tdAttr properties to TableHeaderColumn (#19910)

* Add thStyle, tdStyle, tdAttr properties to TableHeaderColumn
Also style apply TSLint rules where it was fast to implement without introducing issues.

* Fix missed TSLint warnings
This commit is contained in:
Andrey Kurdyumov
2017-09-27 00:40:20 +06:00
committed by Mohamed Hegazy
parent 71d4497212
commit 82ace18841
3 changed files with 356 additions and 307 deletions

View File

@@ -1,10 +1,9 @@
// Type definitions for react-bootstrap-table v2.6.0
// Type definitions for react-bootstrap-table 2.6
// Project: https://github.com/AllenFang/react-bootstrap-table
// Definitions by: Frank Laub <https://github.com/flaub>, Aleksander Lode <https://github.com/alelode>, Josué Us <https://github.com/UJosue10>
// Definitions: https://github.com/DefinitelyTyped/DefinitelyTyped
// TypeScript Version: 2.3
/// <reference types="react" />
/// <reference types="node" />
// documentation taken from http://allenfang.github.io/react-bootstrap-table/docs.html
@@ -14,65 +13,65 @@ import { EventEmitter } from 'events';
/**
* Interface spec for sepcifying functionality to handle remotely
*
*
* Consult [documentation](https://allenfang.github.io/react-bootstrap-table/docs.html#remote)
* for more info
*
*
* @interface RemoteObjSpec
*/
export interface RemoteObjSpec {
/**
* If set, cell edits will be handled remotely
*
*
* @type {boolean}
* @memberof RemoteObjSpec
*/
cellEdit?: boolean;
/**
* If set insertions will be handled remotely
*
*
* @type {boolean}
* @memberof RemoteObjSpec
*/
insertRow?: boolean;
/**
* If set deletion will be handled remotely
*
*
* @type {boolean}
* @memberof RemoteObjSpec
*/
dropRow?: boolean;
/**
* If set filters will be handled remotely
*
*
* @type {boolean}
* @memberof RemoteObjSpec
*/
filter?: boolean;
/**
* If set search will be handled remotely
*
*
* @type {boolean}
* @memberof RemoteObjSpec
*/
search?: boolean;
/**
* If set, exporting CSV will be handled remotely
*
*
* @type {boolean}
* @memberof RemoteObjSpec
*/
exportCSV?: boolean;
/**
* If set sorting will be handled remotely
*
*
* @type {boolean}
* @memberof RemoteObjSpec
*/
sort?: boolean;
/**
* If set pagination will be handled remotely
*
*
* @type {boolean}
* @memberof RemoteObjSpec
*/
@@ -81,115 +80,115 @@ export interface RemoteObjSpec {
export interface BootstrapTableProps extends Props<BootstrapTable> {
/**
Set version='4' to use bootstrap@4, else bootstrap@3 is used.
*/
* Set version='4' to use bootstrap@4, else bootstrap@3 is used.
*/
version?: string;
/**
Use data to specify the data that you want to display on table.
*/
* Use data to specify the data that you want to display on table.
*/
data: any[];
/**
If set, data is remote (use also fetchInfo)
*/
* If set, data is remote (use also fetchInfo)
*/
remote?: ((remobeObj: RemoteObjSpec) => RemoteObjSpec) | boolean; // Updated to support ^3.0.0
/**
Use keyField to tell table which column is unique. This is same as isKey in <TableHeaderColumn>
Tips: You need choose one configuration to set key field: keyField or isKey in <TableHeaderColumn>
*/
* Use keyField to tell table which column is unique. This is same as isKey in <TableHeaderColumn>
* Tips: You need choose one configuration to set key field: keyField or isKey in <TableHeaderColumn>
*/
keyField?: string;
/**
Use height to set the height of table, default is 100%.
*/
* Use height to set the height of table, default is 100%.
*/
height?: string;
/**
Set the max column width (pixels)
*/
* Set the max column width (pixels)
*/
maxHeight?: string;
/**
Enable striped by setting striped to true. Same as Bootstrap table class .table-striped, default is false.
*/
* Enable striped by setting striped to true. Same as Bootstrap table class .table-striped, default is false.
*/
striped?: boolean;
/**
Enable hover by setting hover to true. Same as Bootstrap table class .table-hover, default is false.
*/
* Enable hover by setting hover to true. Same as Bootstrap table class .table-hover, default is false.
*/
hover?: boolean;
/**
Enable condensed by setting condensed to true. Same as Bootstrap table class .table-condensed, default is false.
*/
* Enable condensed by setting condensed to true. Same as Bootstrap table class .table-condensed, default is false.
*/
condensed?: boolean;
/**
Become a borderless table by setting bordered to false, default is true.
*/
* Become a borderless table by setting bordered to false, default is true.
*/
bordered?: boolean;
/**
Enable pagination by setting pagination to true, default is false.
*/
* Enable pagination by setting pagination to true, default is false.
*/
pagination?: boolean;
/**
Assign the class name of row(tr). This attribute accept a string or function and function is a better way to do more customization.
If a string given, means the value will be presented as the row class.
If a function given, will pass rowData and rowIndex as params and should return string for presenting class. for examples:
@example
function trClassFormat(rowData,rowIndex){
return rowIndex%2==0?"tr-odd":"tr-even"; //return a class name.
}
*/
* Assign the class name of row(tr). This attribute accept a string or function and function is a better way to do more customization.
* If a string given, means the value will be presented as the row class.
* If a function given, will pass rowData and rowIndex as params and should return string for presenting class. for examples:
* @example
* function trClassFormat(rowData,rowIndex){
* return rowIndex%2==0?"tr-odd":"tr-even"; //return a class name.
* }
*/
trClassName?: string | ((rowData: any, rowIndex: number) => string);
/**
Enable row insertion by setting insertRow to true, default is false.
If you enable row insertion, there's a button on the upper left side of table.
*/
* Enable row insertion by setting insertRow to true, default is false.
* If you enable row insertion, there's a button on the upper left side of table.
*/
insertRow?: boolean;
/**
Enable row deletion by setting deleteRow to true, default is false.
If you enable row deletion, there's a button on the upper left side of table.
*/
* Enable row deletion by setting deleteRow to true, default is false.
* If you enable row deletion, there's a button on the upper left side of table.
*/
deleteRow?: boolean;
/**
Enable column filter by setting columnFilter to true, default is false.
If enabled, there're input text field per column under the table, user can input your filter condition by each column.
*/
* Enable column filter by setting columnFilter to true, default is false.
* If enabled, there're input text field per column under the table, user can input your filter condition by each column.
*/
columnFilter?: boolean;
/**
Enable search by setting search to true, default is false.
If enabled, there is a on the upper left side of the table. The default place holder is Search
*/
* Enable search by setting search to true, default is false.
* If enabled, there is a on the upper left side of the table. The default place holder is Search
*/
search?: boolean;
/**
Set searchPlaceholder to change the placeholder in search field, default is Search.
*/
* Set searchPlaceholder to change the placeholder in search field, default is Search.
*/
searchPlaceholder?: string;
/**
Enable strict search, default is false.
More info here: https://github.com/AllenFang/react-bootstrap-table/issues/1199
*/
* Enable strict search, default is false.
* More info here: https://github.com/AllenFang/react-bootstrap-table/issues/1199
*/
strictSearch?: boolean;
/**
Enable multi search by multiColumnSearch, default is false.
If you want to use multi search, you must enable search at first.
Tips: Use space to delimited search text. EX: 3 4, which means match all 3 or 4 datas in table.
*/
* Enable multi search by multiColumnSearch, default is false.
* If you want to use multi search, you must enable search at first.
* Tips: Use space to delimited search text. EX: 3 4, which means match all 3 or 4 datas in table.
*/
multiColumnSearch?: boolean;
/**
Enable export csv function, default is false.
If you enable, there's a button on the upper left side of table.
*/
* Enable export csv function, default is false.
* If you enable, there's a button on the upper left side of table.
*/
exportCSV?: boolean;
/**
Set CSV filename (e.g. items.csv). Default is spreadsheet.csv
*/
* Set CSV filename (e.g. items.csv). Default is spreadsheet.csv
*/
csvFileName?: string;
/**
Enable row selection on table. selectRow accept an object which have the following properties
*/
* Enable row selection on table. selectRow accept an object which have the following properties
*/
selectRow?: SelectRow;
/**
Enable cell editing on table. cellEdit accept an object which have the following properties
*/
* Enable cell editing on table. cellEdit accept an object which have the following properties
*/
cellEdit?: CellEdit;
/**
For some options setting on this component, you can set the options attribute and give an object which contain following properties
*/
* For some options setting on this component, you can set the options attribute and give an object which contain following properties
*/
options?: Options;
fetchInfo?: FetchInfo;
printable?: boolean;
@@ -199,7 +198,7 @@ export interface BootstrapTableProps extends Props<BootstrapTable> {
bodyStyle?: any;
ignoreSinglePage?: boolean;
containerClass?: string;
tableContainerClass?: string
tableContainerClass?: string;
headerContainerClass?: string;
bodyContainerClass?: string;
expandableRow?: (row: any) => boolean;
@@ -210,55 +209,55 @@ export type SelectRowMode = 'none' | 'radio' | 'checkbox';
export interface SelectRow {
/**
For specifing the selection is single(radio) or multiple(checkbox).
*/
* For specifing the selection is single(radio) or multiple(checkbox).
*/
mode: SelectRowMode;
/**
Click the row will trigger selection on that row if enable clickToSelect, default is false.
*/
* Click the row will trigger selection on that row if enable clickToSelect, default is false.
*/
clickToSelect?: boolean;
/**
If true, click the row will trigger selection on that row and also trigger cell editing if you enabled cell edit. Default is false.
*/
* If true, click the row will trigger selection on that row and also trigger cell editing if you enabled cell edit. Default is false.
*/
clickToSelectAndEditCell?: boolean;
/**
You can assign the background color of row which be selected.
*/
* You can assign the background color of row which be selected.
*/
bgColor?: string;
/**
You can assign the class name of row which be selected.
*/
* You can assign the class name of row which be selected.
*/
className?: string;
/**
Give an array data to perform which rows you want to be selected when table loading.
The content of array should be the rowkey which you want to be selected.
*/
* Give an array data to perform which rows you want to be selected when table loading.
* The content of array should be the rowkey which you want to be selected.
*/
selected?: string[] | number[];
/**
if true, the radio/checkbox column will be hide.
You can enable this attribute if you enable clickToSelect and you don't want to show the selection column.
*/
* if true, the radio/checkbox column will be hide.
* You can enable this attribute if you enable clickToSelect and you don't want to show the selection column.
*/
hideSelectColumn?: boolean;
/**
Default is false, if enabled, there will be a button on top of table for toggling selected rows only.
*/
* Default is false, if enabled, there will be a button on top of table for toggling selected rows only.
*/
showOnlySelected?: boolean;
/**
Accept a custom callback function, if a row be selected or unselected, this function will be called.
This callback function taking three arguments row, isSelected and event:
`row`: is the row data which you wanted to select or unselect.
`isSelected`: it's a boolean value means "whether or not that row will be selected?".
`event`: The event target object.
If return value of this (function) is false, the select or deselect action will not be applied.
*/
onSelect?: (row: any, isSelected: Boolean, event: any) => boolean;
* Accept a custom callback function, if a row be selected or unselected, this function will be called.
* This callback function taking three arguments row, isSelected and event:
* `row`: is the row data which you wanted to select or unselect.
* `isSelected`: it's a boolean value means "whether or not that row will be selected?".
* `event`: The event target object.
* If return value of this (function) is false, the select or deselect action will not be applied.
*/
onSelect?: (row: any, isSelected: boolean, event: any) => boolean;
/**
Accept a custom callback function, if click select all checkbox, this function will be called.
This callback function taking two arguments isSelected and currentSelectedAndDisplayData:
`isSelected`: it's a boolean value means "whether or not that row will be selected?".
`currentSelectedAndDisplayData`: If pagination enabled, this result is the data which in a page. In contrast, this is all data in table.
If return value of this function is false, the select all or deselect all action will not be applied.
*/
* Accept a custom callback function, if click select all checkbox, this function will be called.
* This callback function taking two arguments isSelected and currentSelectedAndDisplayData:
* `isSelected`: it's a boolean value means "whether or not that row will be selected?".
* `currentSelectedAndDisplayData`: If pagination enabled, this result is the data which in a page. In contrast, this is all data in table.
* If return value of this function is false, the select all or deselect all action will not be applied.
*/
onSelectAll?: (isSelected: boolean, currentSelectedAndDisplayData: any) => boolean;
/**
@@ -271,24 +270,24 @@ export type CellEditClickMode = 'none' | 'click' | 'dbclick';
export interface CellEdit {
/**
To spectify which condition will trigger cell editing.(click or dbclick)
*/
* To spectify which condition will trigger cell editing.(click or dbclick)
*/
mode: CellEditClickMode;
/**
Enable blurToSave will trigger a saving event on cell when mouse blur on the input field. Default is false.
In the default condition, you need to press ENTER to save the cell.
*/
* Enable blurToSave will trigger a saving event on cell when mouse blur on the input field. Default is false.
* In the default condition, you need to press ENTER to save the cell.
*/
blurToSave?: boolean;
/**
Accept a custom callback function, before cell saving, this function will be called.
This callback function taking three arguments:row, cellName and cellValue
It's necessary to return a bool value which whether apply this cell editing.
*/
* Accept a custom callback function, before cell saving, this function will be called.
* This callback function taking three arguments:row, cellName and cellValue
* It's necessary to return a bool value which whether apply this cell editing.
*/
beforeSaveCell?: (row: any, cellName: string, cellValue: any) => boolean;
/**
Accept a custom callback function, after cell saving, this function will be called.
This callback function taking three arguments:row, cellName and cellValue
*/
* Accept a custom callback function, after cell saving, this function will be called.
* This callback function taking three arguments:row, cellName and cellValue
*/
afterSaveCell?: (row: any, cellName: string, cellValue: any) => void;
}
@@ -296,171 +295,169 @@ export type SortOrder = 'asc' | 'desc';
export interface Options {
/**
Manage sort field by yourself
*/
* Manage sort field by yourself
*/
sortName?: string;
/**
Manage sort order by yourself
*/
* Manage sort order by yourself
*/
sortOrder?: SortOrder;
/**
Assign a default sort field.
*/
* Assign a default sort field.
*/
defaultSortName?: string;
/**
Assign a default sort ordering.
*/
* Assign a default sort ordering.
*/
defaultSortOrder?: SortOrder;
/**
False to disable sort indicator on header column, default is true.
*/
* False to disable sort indicator on header column, default is true.
*/
sortIndicator?: boolean;
/**
Change the displaying text on table if data is empty.
*/
* Change the displaying text on table if data is empty.
*/
noDataText?: string | ReactElement<any>;
/**
A delay for trigger search after a keyup (millisecond)
*/
* A delay for trigger search after a keyup (millisecond)
*/
searchDelayTime?: number;
/**
A custom text on export csv button
*/
* A custom text on export csv button
*/
exportCSVText?: string;
/**
Default is false, if true means you want to ignore any editable configuration when row insert.
*/
* Default is false, if true means you want to ignore any editable configuration when row insert.
*/
ignoreEditable?: boolean;
/**
Only work on enable search. If true, there will be a button beside search input field for clear search field text.
*/
* Only work on enable search. If true, there will be a button beside search input field for clear search field text.
*/
clearSearch?: boolean;
/**
Assign a callback function which will be called after table update.
*/
* Assign a callback function which will be called after table update.
*/
afterTableComplete?: Function;
/**
Assign a callback function which will be called after row delete.
This function taking one argument: rowKeys, which means the row key you dropped.
*/
* Assign a callback function which will be called after row delete.
* This function taking one argument: rowKeys, which means the row key you dropped.
*/
afterDeleteRow?: (rowKeys: string[]) => void;
/**
Assign a callback function which will be called after row insert.
This function taking one argument: row, which means the whole row data you added.
*/
* Assign a callback function which will be called after row insert.
* This function taking one argument: row, which means the whole row data you added.
*/
afterInsertRow?: (row: any) => void;
/**
Customize the text of previouse page button
*/
* Customize the text of previouse page button
*/
prePage?: string;
/**
Customize the text of next page button
*/
* Customize the text of next page button
*/
nextPage?: string;
/**
Customize the text of first page button
*/
* Customize the text of first page button
*/
firstPage?: string;
/**
Customize the text of last page button
*/
* Customize the text of last page button
*/
lastPage?: string;
/**
Accept a number, which means the page you want to show as default.
*/
* Accept a number, which means the page you want to show as default.
*/
page?: number;
/**
You can change the dropdown list for size per page if you enable pagination.
*/
* You can change the dropdown list for size per page if you enable pagination.
*/
sizePerPageList?: number[];
/**
Means the size per page you want to locate as default.
*/
* Means the size per page you want to locate as default.
*/
sizePerPage?: number;
/**
To define the pagination bar length, default is 5.
*/
* To define the pagination bar length, default is 5.
*/
paginationSize?: number;
/**
To define where to start counting the pages.
*/
* To define where to start counting the pages.
*/
pageStartIndex?: number;
/**
Assign a callback function which will be called after page changed.
This function taking two argument: page and sizePerPage.
`page`: Current page.
`sizePerPage`: The data size which in one page.
*/
* Assign a callback function which will be called after page changed.
* This function taking two argument: page and sizePerPage.
* `page`: Current page.
* `sizePerPage`: The data size which in one page.
*/
onPageChange?: (page: number, sizePerPage: number) => void;
/**
Assign a callback function which will be called after size per page dropdown changed.
This function taking one argument: sizePerPage.
`sizePerPage`: The data size which in one page.
*/
* Assign a callback function which will be called after size per page dropdown changed.
* This function taking one argument: sizePerPage.
* `sizePerPage`: The data size which in one page.
*/
onSizePerPageList?: (sizePerPage: number) => void;
/**
Assign a callback function which will be called after trigger sorting.
This function taking two argument: `sortName` and `sortOrde`r.
`sortName`: The sort column name
`sortOrder`: The sort ordering.
*/
* Assign a callback function which will be called after trigger sorting.
* This function taking two argument: `sortName` and `sortOrde`r.
* `sortName`: The sort column name
* `sortOrder`: The sort ordering.
*/
onSortChange?: (sortName: string, sortOrder: SortOrder) => void;
/**
Assign a callback function which will be called after trigger searching.
This function taking two argument: search and result.
`search`: The search text which user input.
`result`: The results after searching.
*/
* Assign a callback function which will be called after trigger searching.
* This function taking two argument: search and result.
* `search`: The search text which user input.
* `result`: The results after searching.
*/
afterSearch?: (search: string, result: any) => void;
/**
Assign a callback function which will be called after trigger column filtering.
This function taking two argument: filterConds and result.
`filterConds`: It's an array object which contain all column filter conditions.
`result`: The results after filtering.
*/
* Assign a callback function which will be called after trigger column filtering.
* This function taking two argument: filterConds and result.
* `filterConds`: It's an array object which contain all column filter conditions.
* `result`: The results after filtering.
*/
afterColumnFilter?: (filterConds: any[], result: any) => void;
/**
Assign a callback function which will be called after a row click.
This function taking one argument: row which is the row data which you click on.
*/
* Assign a callback function which will be called after a row click.
* This function taking one argument: row which is the row data which you click on.
*/
onRowClick?: (row: any) => void;
/**
Assign a callback function which will be called after a row double click.
This function taking one argument: row which is the row data which you double click on.
*/
* Assign a callback function which will be called after a row double click.
* This function taking one argument: row which is the row data which you double click on.
*/
onRowDoubleClick?: (row: any) => void;
/**
Background color on expanded rows.
*/
* Background color on expanded rows.
*/
expandRowBgColor?: string;
/**
Assign a callback function which will be called when mouse enter into the table.
*/
* Assign a callback function which will be called when mouse enter into the table.
*/
onMouseEnter?: Function;
/**
Assign a callback function which will be called when mouse leave from the table.
*/
* Assign a callback function which will be called when mouse leave from the table.
*/
onMouseLeave?: Function;
/**
Assign a callback function which will be called when mouse over a row in table.
This function taking one argument: row which is the row data which mouse over.
*/
* Assign a callback function which will be called when mouse over a row in table.
* This function taking one argument: row which is the row data which mouse over.
*/
onRowMouseOver?: Function;
/**
Assign a callback function which will be called when mouse leave from a row in table.
This function taking one argument: row which is the row data which mouse out.
*/
* Assign a callback function which will be called when mouse leave from a row in table.
* This function taking one argument: row which is the row data which mouse out.
*/
onRowMouseOut?: Function;
/**
Assign a callback function which will be called when row dropping.
It give you a chance to customize your confirmation for row deletion.
This function taking two argument: next and rowKeys:
`next`: If you confirm to drop row, call next() to continue the process
`rowKeys` is the row keys which been deleted, you can call next function to apply this deletion.
*/
* Assign a callback function which will be called when row dropping.
* It give you a chance to customize your confirmation for row deletion.
* This function taking two argument: next and rowKeys:
* `next`: If you confirm to drop row, call next() to continue the process
* `rowKeys` is the row keys which been deleted, you can call next function to apply this deletion.
*/
handleConfirmDeleteRow?: (next: Function, rowKeys: any[]) => void;
paginationShowsTotal?: boolean | ReactElement<any>;
onSearchChange?: Function;
@@ -474,39 +471,38 @@ export interface Options {
// Customization properties
/**
* Callback function to be called when a cell is modified
*
*
* https://allenfang.github.io/react-bootstrap-table/example.html#remote
*
*
* @memberof BootstrapTableProps
*/
onCellEdit?: (row: any, field: string, value: any) => any;
/**
* Callback function to be called when filter changing
*
*
* https://github.com/AllenFang/react-bootstrap-table/blob/master/examples/js/remote/remote-store-filtering.js#L67
*
*
* @memberof BootstrapTableProps
*/
onFilterChange?:(filterObj: any) => any;
onFilterChange?: (filterObj: any) => any;
/**
* Callback function which will be called when a row will be deleted
*
*
* https://github.com/AllenFang/react-bootstrap-table/blob/master/examples/js/remote/remote-store-delete-row.js#L27
*
*
* @memberof BootstrapTableProps
*/
onDeleteRow?: (rows: any[] | any) => any;
onDeleteRow?: (rows: any) => any;
/**
* A callback which will be called after page changed
*
*
* https://github.com/AllenFang/react-bootstrap-table/blob/master/examples/js/remote/remote-store-paging.js#L30
*
*
* @memberof BootstrapTableProps
*/
onpageChange?: (page: any, sizePerPage: number) => any;
}
interface FetchInfo {
dataTotalSize?: number;
}
@@ -555,21 +551,21 @@ export type DataAlignType = 'left' | 'center' | 'right' | 'start' | 'end';
export interface TableHeaderColumnProps extends Props<TableHeaderColumn> {
/**
The field of data you want to show on column.
*/
* The field of data you want to show on column.
*/
dataField?: string;
/**
Use isKey to tell table which column is unique. This is same as keyField in <BootstrapTable>
Tips: You need choose one configuration to set key field: isKey or keyField in <BootstrapTable>
*/
* Use isKey to tell table which column is unique. This is same as keyField in <BootstrapTable>
* Tips: You need choose one configuration to set key field: isKey or keyField in <BootstrapTable>
*/
isKey?: boolean;
/**
Set the column width. ex: 150, it's means 150px
*/
* Set the column width. ex: 150, it's means 150px
*/
width?: string;
/**
Set align in column, value is left, center, right, start and end.
*/
* Set align in column, value is left, center, right, start and end.
*/
dataAlign?: DataAlignType;
/**
@@ -577,94 +573,94 @@ export interface TableHeaderColumnProps extends Props<TableHeaderColumn> {
*/
headerAlign?: DataAlignType;
/**
True to enable table sorting. Default is disabled.
*/
* True to enable table sorting. Default is disabled.
*/
dataSort?: boolean;
/**
Default search string.
*/
* Default search string.
*/
defaultSearch?: string;
/**
Allow user to render a custom sort caret. You should give a function and should return a JSX.
This function taking one arguments: order which present the sort order currently.
*/
* Allow user to render a custom sort caret. You should give a function and should return a JSX.
* This function taking one arguments: order which present the sort order currently.
*/
caretRender?: Function;
/**
Give an Object like following to able to customize your own editing component.
This Object should contain these two property:
getElement(REQUIRED): Accept a callback function and take two arguments: onUpdate and props.
customEditorParameters: Another extra data for custom cell edit component.
*/
customEditor?: { getElement: (onUpdate: any, props: any) => ReactElement<any>, customEditorParameters?: Object };
* Give an Object like following to able to customize your own editing component.
* This Object should contain these two property:
* getElement(REQUIRED): Accept a callback function and take two arguments: onUpdate and props.
* customEditorParameters: Another extra data for custom cell edit component.
*/
customEditor?: { getElement: (onUpdate: any, props: any) => ReactElement<any>, customEditorParameters?: object };
/**
To customize the column. This callback function should return a String or a React Component.
In addition, this function taking two argument: cell and row.
*/
* To customize the column. This callback function should return a String or a React Component.
* In addition, this function taking two argument: cell and row.
*/
dataFormat?: (cell: any, row: any, formatExtraData?: any) => string | ReactElement<any>;
/**
To to enable search or filter data on formatting. Default is false
*/
* To to enable search or filter data on formatting. Default is false
*/
filterFormatted?: boolean;
/**
True to hide column.
*/
* True to hide column.
*/
hidden?: boolean;
/**
* True to hide from insert dialog
*/
hiddenOnInsert?: boolean;
/**
True to hide the dropdown for sizePerPage.
*/
hideSizePerPage?: boolean
* True to hide the dropdown for sizePerPage.
*/
hideSizePerPage?: boolean;
/**
False to disable search functionality on column, default is true.
*/
* False to disable search functionality on column, default is true.
*/
searchable?: boolean;
/**
Give a customize function for data sorting.
This function taking four arguments: a, b, order, sortField, extraData
*/
* Give a customize function for data sorting.
* This function taking four arguments: a, b, order, sortField, extraData
*/
sortFunc?: (a: any, b: any, order: SortOrder, sortField: any, extraData: any) => number;
/**
It's a extra data for custom sort function, if defined, this data will be pass as fifth argument in sortFunc.
*/
* It's a extra data for custom sort function, if defined, this data will be pass as fifth argument in sortFunc.
*/
sortFuncExtraData?: any;
/**
Add custom css class on table header column, this attribute only accept String or Function.
If Function, it taking four arguments: cell, row, rowIndex, columnIndex.
In addition, this function should return a String which is the class name you want to add on.
*/
* Add custom css class on table header column, this attribute only accept String or Function.
* If Function, it taking four arguments: cell, row, rowIndex, columnIndex.
* In addition, this function should return a String which is the class name you want to add on.
*/
className?: string | ((cell: any, row: any, rowIndex: number, columnIndex: number) => string);
/**
Add custom css class on table body column, this attribute only accept String or Function.
If Function, it taking four arguments: cell, row, rowIndex, columnIndex.
In addition, this function should return a String which is the class name you want to add on.
*/
* Add custom css class on table body column, this attribute only accept String or Function.
* If Function, it taking four arguments: cell, row, rowIndex, columnIndex.
* In addition, this function should return a String which is the class name you want to add on.
*/
columnClassName?: String | ((cell: any, row: any, rowIndex: number, columnIndex: number) => string);
/**
Add True to set column editable, false is non-editable. If give Object,
you can do more customization when editing cell. This object have following properties:
@example
{
type: //edit type, avaiable value is textarea, select, checkbox
validator: //give function for validation and taking only one "cell value" as argument. This function should return Bool.
options:{
values: //values means data in select or checkbox.If checkbox, use ':'(colon) to separate value, ex: Y:N
}
}
*/
* Add True to set column editable, false is non-editable. If give Object,
* you can do more customization when editing cell. This object have following properties:
* @example
* {
* type: //edit type, avaiable value is textarea, select, checkbox
* validator: //give function for validation and taking only one "cell value" as argument. This function should return Bool.
* options:{
* values: //values means data in select or checkbox.If checkbox, use ':'(colon) to separate value, ex: Y:N
* }
* }
*/
editable?: boolean | Editable;
/**
It only work when you enable insertRow and be assign on rowKey column.
If true, the row key will be generated automatically after a row insertion.
*/
* It only work when you enable insertRow and be assign on rowKey column.
* If true, the row key will be generated automatically after a row insertion.
*/
autoValue?: boolean;
/**
To Enable a column filter within header column.
This feature support a lots of filter type and condition. Please check example
Following is the format for filter
*/
* To Enable a column filter within header column.
* This feature support a lots of filter type and condition. Please check example
* Following is the format for filter
*/
filter?: Filter;
onSort?: Function;
@@ -700,23 +696,38 @@ export interface TableHeaderColumnProps extends Props<TableHeaderColumn> {
* It's useful if your column data is an object.
*/
filterValue?: Function;
/**
* Allow you to add your custom attributes on TD element.
*/
tdAttr?: object;
/**
* Allow you to add your custom style object on TD element.
*/
tdStyle?: object;
/**
* Allow you to add your custom style object on TH element.
*/
thStyle?: object;
}
export interface Editable {
type?: string;//edit type, avaiable value is textarea, select, checkbox
type?: string; // edit type, avaiable value is textarea, select, checkbox
/**
function for validation and taking only one "cell value" as argument. This function should return Bool.
* Function for validation and taking only one "cell value" as argument. This function should return Bool.
*/
validator?: (cell: any) => boolean;
/**
{
values: //values means data in select or checkbox.If checkbox, use ':'(colon) to separate value, ex: Y:N
}
* @example
* {
* values: //values means data in select or checkbox. If checkbox, use ':'(colon) to separate value, ex: Y:N
* }
*/
options?: any;
/**
Configuration for the textarea editable type
* Configuration for the textarea editable type
*/
cols?: number;
rows?: number;
@@ -729,7 +740,7 @@ export interface ApplyFilterParameter {
export type FilterType = 'TextFilter' | 'RegexFilter' | 'SelectFilter' | 'NumberFilter' | 'DateFilter' | 'CustomFilter';
export interface Filter {
/**
"TextFilter"||"SelectFilter"||"NumberFilter"||"DateFilter"||"RegexFilter"||"YOUR_CUSTOM_FILTER"
* "TextFilter"||"SelectFilter"||"NumberFilter"||"DateFilter"||"RegexFilter"||"YOUR_CUSTOM_FILTER"
*/
type?: FilterType;
/**

View File

@@ -1,10 +1,8 @@
/// <reference types="react-dom"/>
import * as React from 'react';
import { render } from 'react-dom';
import { BootstrapTable, TableHeaderColumn, ApplyFilterParameter } from 'react-bootstrap-table';
import { BootstrapTable, TableHeaderColumn, ApplyFilterParameter, Filter } from 'react-bootstrap-table';
var products = [{
const products = [{
id: 1,
name: "Item name 1",
price: 100
@@ -71,11 +69,12 @@ function getCustomFilter(filterHandler: (parameters?: ApplyFilterParameter) => v
class CustomFilter extends React.Component {
render() {
const filter: Filter = { type: 'CustomFilter', getElement: getCustomFilter, customFilterParameters: { textOK: 'yes', textNOK: 'no' } };
return (
<BootstrapTable data={products}>
<TableHeaderColumn dataField='id' isKey>Product ID</TableHeaderColumn>
<TableHeaderColumn dataField='name'>Product Name</TableHeaderColumn>
<TableHeaderColumn dataField='isInStock' filter={{ type: 'CustomFilter', getElement: getCustomFilter, customFilterParameters: { textOK: 'yes', textNOK: 'no' } }}>Product Is In Stock</TableHeaderColumn>
<TableHeaderColumn dataField='isInStock' filter={filter}>Product Is In Stock</TableHeaderColumn>
</BootstrapTable>
);
}
@@ -83,6 +82,7 @@ class CustomFilter extends React.Component {
class RemoteProps extends React.Component {
render() {
const filter: Filter = { type: 'CustomFilter', getElement: getCustomFilter, customFilterParameters: { textOK: 'yes', textNOK: 'no' } };
return (
<BootstrapTable
data={products}
@@ -96,7 +96,7 @@ class RemoteProps extends React.Component {
>
<TableHeaderColumn dataField='id' isKey>Product ID</TableHeaderColumn>
<TableHeaderColumn dataField='name'>Product Name</TableHeaderColumn>
<TableHeaderColumn dataField='isInStock' filter={{ type: 'CustomFilter', getElement: getCustomFilter, customFilterParameters: { textOK: 'yes', textNOK: 'no' } }}>Product Is In Stock</TableHeaderColumn>
<TableHeaderColumn dataField='isInStock' filter={filter}>Product Is In Stock</TableHeaderColumn>
</BootstrapTable>
);
}
@@ -104,6 +104,7 @@ class RemoteProps extends React.Component {
class RemoteBool extends React.Component {
render() {
const filter: Filter = { type: 'CustomFilter', getElement: getCustomFilter, customFilterParameters: { textOK: 'yes', textNOK: 'no' } };
return (
<BootstrapTable
data={products}
@@ -111,12 +112,39 @@ class RemoteBool extends React.Component {
>
<TableHeaderColumn dataField='id' isKey>Product ID</TableHeaderColumn>
<TableHeaderColumn dataField='name'>Product Name</TableHeaderColumn>
<TableHeaderColumn dataField='isInStock' filter={{ type: 'CustomFilter', getElement: getCustomFilter, customFilterParameters: { textOK: 'yes', textNOK: 'no' } }}>Product Is In Stock</TableHeaderColumn>
<TableHeaderColumn dataField='isInStock' filter={filter}>Product Is In Stock</TableHeaderColumn>
</BootstrapTable>
);
}
}
/**
* See http://allenfang.github.io/react-bootstrap-table/docs.html#tdAttr
*/
const tdAttrExample = <BootstrapTable data={ products } search>
<TableHeaderColumn dataField='id' isKey>Product ID</TableHeaderColumn>
<TableHeaderColumn dataField='name' tdAttr={ { "data-attr": 'test' } }>Product Name</TableHeaderColumn>
<TableHeaderColumn dataField='price'>Product Price</TableHeaderColumn>
</BootstrapTable>;
/**
* See http://allenfang.github.io/react-bootstrap-table/docs.html#tdStyle
*/
const tdStyleExample = <BootstrapTable data={ products } search>
<TableHeaderColumn dataField='id' isKey>Product ID</TableHeaderColumn>
<TableHeaderColumn dataField='name' tdStyle={ { whiteSpace: 'normal' } }>Product Name</TableHeaderColumn>
<TableHeaderColumn dataField='price'>Product Price</TableHeaderColumn>
</BootstrapTable>;
/**
* See http://allenfang.github.io/react-bootstrap-table/docs.html#thStyle
*/
const thStyleExample = <BootstrapTable data={ products } search>
<TableHeaderColumn dataField='id' isKey>Product ID</TableHeaderColumn>
<TableHeaderColumn dataField='name' thStyle={ { fontWeight: 'lighter' } }>Product Name</TableHeaderColumn>
<TableHeaderColumn dataField='price'>Product Price</TableHeaderColumn>
</BootstrapTable>;
// Adopted from https://github.com/AllenFang/react-bootstrap-table/blob/master/examples/js/column-header-span/column-header-span-complex.js
export default class ColumnHeaderSpanComplex extends React.Component {
render() {

View File

@@ -0,0 +1,10 @@
{
"extends": "dtslint/dt.json",
"rules": {
// TODO
"ban-types": false,
"prefer-method-signature": false,
"strict-export-declare-modifiers": false,
"no-empty-interface": false
}
}