Releases: glin/reactable
v0.4.4
v0.4.3
v0.4.2
v0.4.1
Documentation - reactable 0.4.1
- Fixed a failing test on Fedora 36 and earlier.
v0.4.0
Documentation - reactable 0.4.0
New features
- Experimental support for rendering tables to static HTML in R. Use
reactable(static = TRUE)
to render a table to static HTML, oroptions(reactable.status = TRUE)
to enable static rendering globally. With static rendering, tables are pre-rendered to their initial HTML so they appear immediately without any flash of content. Tables are then made interactive and subsequently rendered by JavaScript as needed. Static rendering requires the V8 package, which is not installed with reactable by default. Learn more in the Static Rendering article. reactable()
gains ameta
argument to pass arbitrary data from R to JavaScript render functions and style functions. Custom metadata can be accessed using thestate.meta
property, and updated usingupdateReactable()
in Shiny orReactable.setMeta()
in the JavaScript API. See examples of using custom metadata for custom rendering or custom metadata for conditional styling. (#255)- New
Reactable.onStateChange()
method in the JavaScript API that sets up a function to be called whenever the table state changes. (#265) - New
Reactable.setData()
method in the JavaScript API for updating the table data. (#278) Reactable.downloadDataCSV()
in the JavaScript API now supports an additionaloptions
argument to change the field or decimal separator, include specific columns, and exclude column headers. (#239, #293)- New
Reactable.getDataCSV()
method in the JavaScript API to get the table data as a CSV string. - New
Reactable.toggleHideColumn()
andReactable.setHiddenColumns()
methods in the JavaScript API to toggle or set hidden columns. JavaScript render functions and style functions also receive a newstate.hiddenColumns
property for the hidden columns in the table. (#246) getReactableState()
now includes the current sorted columns. (#265)
Minor improvements and bug fixes
- Updated the documentation site for Internet Explorer 11 (IE 11) deprecation, Bootstrap 5 theming, and better accessibility. Examples now use modern JavaScript features that aren't supported in IE 11, like template literals and arrow functions. Examples now also use scalable font sizes and length units where appropriate (i.e.,
rem
/em
instead ofpx
). The documentation site uses the default root font size of16px
, so examples may look different on pages that change the root font size. For example, Bootstrap 3 sets a default root font size of10px
, so you may need to adjust therem
values before adapting examples to your site. (Bootstrap 4 and above no longer change the default root font size). - R style functions no longer apply to aggregated cells and rows incorrectly. (@fawda123, #250)
- JavaScript render functions and style functions no longer receive an invalid
cellInfo.index
orrowInfo.index
property for aggregated cells and rows. (#250) - Column group header widths are now calculated correctly with hidden columns in the column group. (@Patrikios, #253)
NULL
values in list-columns now correctly appear as missing values instead of[object Object]
.NULL
values are now represented asnull
values in JavaScript instead of an empty object like {}.reactableTheme()
styles no longer override custom user CSS in the HTML document<head>
.getReactableState()
now accepts multiple values in itsname
argument to return a subset of state values.reactable()
now respectshtmlwidget::sizingPolicy()
'sviewer.fill
andbrowser.fill
and fills the RStudio Viewer pane by default. (@cpsievert, #280)- Using
reactable()
on a dplyr grouped data frame (dplyr::group_by()
orgrouped_df
) withrownames = TRUE
no longer adds astringsAsFactors
column to the table. (@daattali, #283)
Breaking changes
-
Numeric
NA
values are now represented asnull
in JavaScript instead of an"NA"
string. NumericNaN
,Inf
, and-Inf
values are now represented asNaN
,Infinity
, and-Infinity
in JavaScript instead of"NaN"
,"Inf"
, and"-Inf"
strings. (@daattali, #261)function(cellInfo) { // Old cellInfo.value // "NA", "NaN", "Inf", "-Inf" // New cellInfo.value // null, NaN, Infinity, -Infinity }
-
Support for Internet Explorer 11 (IE 11) is deprecated. Existing features will continue to work in IE 11, but new features may not support IE 11, and IE 11 is no longer tested.
-
The documentation website no longer supports IE 11.
v0.3.0
Documentation - reactable 0.3.0
This release upgrades to a new major version of React Table (#35), which brings many new features, improvements, and bug fixes. reactable has been largely rewritten to take advantage of React Table's new approach as a flexible table utility rather than a table component.
This means it'll be easier to add new custom features, customize styling and markup, and maintain reactable in the future. Most of the features and fixes in this release would not have been possible or easy to do without this upgrade.
Backward compatibility was kept where possible, but note that there are several breaking changes, particularly around the JavaScript API.
New features
- Cell content can now be vertically aligned using the new
vAlign
andheaderVAlign
arguments incolDef()
, and the newheaderVAlign
argument incolGroup()
(#142, #177). - Sticky columns are now supported using a new
sticky
argument incolDef()
andcolGroup()
(#19, #72, #141). - New JavaScript API to manipulate or access tables from JavaScript. Use this to create custom interactive controls, such as CSV download buttons, custom filter inputs, or toggle buttons for row grouping and row expansion (#11, #28, #182, #194). Learn more in the JavaScript API guide or the JavaScript API examples.
- Column filtering and table searching can now be customized. Learn more in the Custom Filtering guide.
reactable()
gains asearchMethod
argument to use a custom JavaScript function for global table searching (#222).colDef()
gains afilterMethod
argument to use a custom JavaScript function for column filtering (#9, #90, #145).colDef()
gains afilterInput
argument to render a custom filter input for column filtering (#9).
reactable()
gains apaginateSubRows
argument to include grouped sub rows in pagination. This is recommended for grouped tables with a large number of rows where expanded rows may not all fit on one page.- Expanded rows now stay expanded on sorting, filtering, and pagination changes. Previously, expanded rows were always collapsed on sorting and pagination changes, and incorrectly persisted on filtering changes (#39).
- Aggregated rows can now be selected when multiple selection is enabled.
colDef()
gains agrouped
argument to customize rendering for grouped cells ingroupBy
columns (#33, #94, #148).- Column group headers can now be resized.
- Column group headers and filters are now sticky. Previously, only column headers were sticky (#107).
- JavaScript render functions and style functions receive new properties:
rowInfo.expanded
andcellInfo.expanded
indicating whether the row is expandedcellInfo.selected
indicating whether the cell's row is selectedstate.page
,state.pageSize
, andstate.pages
for the current page index, page size, and number of pages in the tablecellInfo.filterValue
andcolumn.filterValue
for the column filter value, andcolumn.setFilter
to set the filter valuestate.filters
for the column filter valuesstate.searchValue
for the table search valuestate.selected
for the selected row indices
- JavaScript render functions for cells, headers, footers, and row details receive a new
state
argument to access the table state (#88). Custom cell click actions also now receive astate
argument. - R render functions for row details now receive an additional argument for the column name (@ksnap28, #155).
colDef()
gains asearchable
argument to enable or disable global table searching. Columns can be excluded from searching usingcolDef(searchable = FALSE)
, and hidden columns can be included in searching usingcolDef(searchable = TRUE)
(#217).
Breaking changes
JavaScript render and style functions
Several properties and arguments have been renamed or moved for consistency with the rest of the API. These properties were not removed unless they were very rarely used, so most code should continue to work upon upgrading.
-
The
rowInfo.row
property is now deprecated, and has been renamed torowInfo.values
.rowInfo.row
remains supported, but replace usages withrowInfo.values
when possible.// Old function(rowInfo) { rowInfo.row } // New function(rowInfo) { rowInfo.values }
-
The
colInfo.column
andcolInfo.data
properties in header and cell render functions are now deprecated. ThecolInfo
object now contains all of the same properties ascolInfo.column
, and is now referred to ascolumn
in the documentation. When possible, replace usages ofcolInfo
withcolumn
,colInfo.column
withcolumn
, andcolInfo.data
withstate.data
orstate.sortedData
.// Old function(colInfo) { colInfo.column.id colInfo.data } // New function(column, state) { column.id state.data }
-
The
state.expanded
property has been removed. To check whether a row is expanded, userowInfo.expanded
instead.// Old function(rowInfo, column, state) { if (state.expanded[rowInfo.index]) { // row is expanded ... } } // New function(rowInfo, column, state) { if (rowInfo.expanded) { // row is expanded ... } }
-
The
rowInfo.page
andcellInfo.page
properties have been removed. To get the current page index of the table, usestate.page
instead.// Old function(rowInfo, column, state) { rowInfo.page } // New function(rowInfo, column, state) { state.page }
-
When accessing row data in JavaScript render functions and style functions:
-
Date and time values are now represented in UTC time (ISO 8601 format), rather than local time without a timezone.
function(cellInfo) { // Old cellInfo.value // 2022-05-22T19:30:00 // New cellInfo.value // 2022-05-22T19:30:00Z // With a UTC time, it's much easier to format dates in the user's local time return new Date(cellInfo.value).toLocaleString() }
-
Single values (length-1 vectors) in list-columns are no longer represented as arrays (i.e., data is now serialized using
jsonlite::toJSON(auto_unbox = TRUE)
). For example,list(x = 1)
in R is now represented as{x: 1}
in JavaScript instead of{x: [1]}
.
-
Other changes
- When both
columnGroups
andgroupBy
arguments are provided inreactable()
,groupBy
columns are no longer added to a column group automatically (#87). - The
defaultGroupHeader
argument inreactableLang()
is now deprecated and no longer used. Use thecolumnGroups
argument inreactable()
to customize the column group header forgroupBy
columns. - The
detailsCollapseLabel
,deselectAllRowsLabel
,deselectAllSubRowsLabel
, anddeselectRowLabel
arguments inreactableLang()
are now deprecated and no longer used (#167). - The row selection column is now always placed as the first column in the table, even before the
groupBy
and row details columns (#71). - Increased the default width of the row selection column to match the row details column (45px).
Minor improvements and bug fixes
- Setting
show = FALSE
as a default value indefaultColDef()
now works (@csgillespie, #105). SettingsortNALast
,html
, andna
to their default values indefaultColDef()
also now works. - Using a single value for
pageSizeOptions
inreactable()
now works. - Column resizing is now limited by the min and max width of the column.
- Column group headers and filter cells in fixed height tables now display properly in Safari, Chrome, and the RStudio Viewer (#76).
- In
reactable()
,defaultExpanded = TRUE
now expands all rows in the table, not just rows on the first page. - In
reactable()
,defaultExpanded = TRUE
now works when column groups are present. - Aggregated cell values are now recalculated when filtering or searching the table.
- Aggregate functions now always take the unaggregated values in the column. Previously, if there were multiple
groupBy
columns, aggregate functions could take aggregated values which could produce inaccurate calculations (e.g., when calculating the mean of values). - The
"max"
and"min"
aggregate functions now work on dates, date-times, and strings ([#130](https://gith...
v0.2.3
v0.2.2
v0.2.1
New features
updateReactable()
gains adata
argument to update the data of a reactable
instance in Shiny (#49).
Bug fixes
- Row selection columns now display correctly in tables with column groups
(#52). defaultSelected
now works correctly with Crosstalk linked selection.- Crosstalk selection and filtering now works with nested and dynamically
rendered tables #57). - Tables now display correctly for Crosstalk
SharedData
objects with zero or one rows. - Shiny UI elements in expanded row details are now properly removed when
collapsed on page changes. colFormat()
now always formats numbers as a localized string whenlocales
is specified.- Table rows no longer stretch to fill the height of the container
(#69). To make rows stretch
again, use a theme likereactableTheme(tableBodyStyle = list(flex = "auto"))
. - Multi-sorting no longer selects text in column headers.
v0.2.0
New features
reactable()
now supports linked selection and filtering with Crosstalk-compatible
HTML widgets (#46).reactable()
gains atheme
argument to customize the default styling of a table.reactable()
gains alanguage
argument to customize the language strings in a table
(#24).reactable()
gains adefaultSelected
argument to set default selected rows.reactable()
gains adefaultExpanded
argument to set default expanded rows
(#23).- New
updateReactable()
function to update the selected rows, expanded rows, or
current page of a reactable instance in Shiny (#20). - New
getReactableState()
function to get the state of a reactable instance in Shiny
(#20). colDef()
gains a"median"
aggregate function to calculate the median of numbers
(#30).- The row selection column can now be customized using
".selection"
as the column name
(#19). - In
reactable()
, therowClass
,rowStyle
, anddetails
JavaScript functions
now receive arowInfo.selected
property indicating whether the row is selected
(#20).
Breaking changes
- The
selectionId
argument inreactable()
will be deprecated in a future release.
UsegetReactableState()
to get the selected rows of a table in Shiny instead.
Bug fixes
- General accessibility improvements, particularly for screen reader users.
- Table searching now works correctly when row selection is enabled.
colFormat(date = TRUE)
now formatsYYYY-MM-DD
dates correctly (#38).colFormat(percent = TRUE)
now works correctly when viewing tables in IE11.- Cell click actions now work for all cells in aggregated rows.
- Aggregated cells in columns with row details no longer throw an error when clicked.
- In
colDef()
, theclass
andstyle
R functions now handle list-columns correctly. - Column headers now truncate long text properly.
- Footers now display properly in fixed height tables for Safari and Chrome (#41).
- Dark themes no longer affect text color in RStudio R Notebooks (#21).
- Checkboxes and radio buttons now align with multi-line text in selectable tables.
- Text selection now works in column headers.
- Row striping and highlighting styles no longer affect nested tables.