The Table is a virtual class for all panels containing a datatable
widget from the DT package, where each row usually corresponds to a row or column of the SummarizedExperiment object.
It provides observers for rendering the table widget, monitoring single selections, and applying global and column-specific searches (which serve as multiple selections).
Slot overview
The following slots control aspects of the DT::datatable
selection:
Selected
, a string containing the name of the currently selected row of the data.frame. Defaults toNA
, in which case the value should be chosen by the subclass'.refineParameters
method.Search
, a string containing the regular expression for the global search. Defaults to""
, i.e., no search.SearchColumns
, a unnamed character vector of length equal to the number of columns of the data.frame, where each entry contains the search string for its corresponding column. Alternatively, a character vector of variable length, containing search strings for one or more columns. Defaults to an character vector of length zero, which is internally expanded to an vector of zero-length strings, i.e., no search.
The following slots control the appearance of the table:
HiddenColumns
, a character vector containing names of columns to hide. Defaults to an empty vector.
In addition, this class inherits all slots from its parent Panel class.
Supported methods
In the following code snippets, x
is an instance of a Table class.
Refer to the documentation for each method for more details on the remaining arguments.
For defining the interface:
.defineOutput(x)
returns a UI element for adataTableOutput
widget..defineDataInterface(x)
will create interface elements for modifying the table, namely to choose which columns to hide. Note that this is populated by.generateOutput
upon table rendering, as we do not know the available columns before that point.
For defining reactive expressions:
.createObservers(x, se, input, session, pObjects, rObjects)
sets up observers for all of the slots. This will also call the equivalent Panel method..renderOutput(x, se, output, pObjects, rObjects)
will add a rendereddatatable
object tooutput
. This will also call the equivalent Panel method to render the panel information text boxes..generateOutput(x, se, all_memory, all_contents)
returns a list containingcontents
, a data.frame with one row per point currently present in the table;commands
, a list of character vector containing the R commands required to generatecontents
andplot
; andvarname
, a string specifying the name of the variable incommands
used to generatecontents
..exportOutput(x, se, all_memory, all_contents)
will create a CSV file containing the current table, and return a string containing the path to that file. This assumes that thecontents
field returned by.generateOutput
is a data.frame or can be coerced into one.
For controlling selections:
.multiSelectionRestricted(x)
returnsTRUE
. Transmission of a selection to a Table will manifest as a subsetting of the rows..multiSelectionActive(x)
returns a list containing the contents ofx[["Search"]]
andx[["ColumnSearch"]]
. If both contain only empty strings, aNULL
is returned instead..multiSelectionCommands(x, index)
returns a character vector of R expressions that - when evaluated - return a character vector of the row names of the table after applying all search filters. The value ofindex
is ignored..singleSelectionValue(x, contents)
returns the name of the row that was last selected in thedatatable
widget.
For documentation:
.definePanelTour(x)
returns an data.frame containing the steps of a tour relevant to subclasses, mostly describing the effect of selection from other panels and the use of row filters to transmit selections.
Unless explicitly specialized above, all methods from the parent class Panel are also available.
Subclass expectations
The Table is a rather vaguely defined class for which the only purpose is to avoid duplicating code for ColumnDotPlots and RowDotPlots. We recommend extending those subclasses instead.
See also
Panel, for the immediate parent class.