DataSpreadsheetColumn extends DataGridColumn

Column controller for a DataSpreadsheet — extends DataGridColumn with a record-based editing API.

In a virtualized grid the cell for a given record may not be mounted (off-screen), so editing/paste operate on the record, not a live cell. Otherwise it mirrors Spreadsheet's column shape: input(record) builds a bound editor via Input, paste/parsePaste apply pasted values, clear empties.

Constructor


new DataSpreadsheetColumn(options)

options :


            
                Object

optional

attribute :


            
                string

optional

record key this column reads/writes

editable :


            
                boolean

optional

whether cells can be edited/pasted into

input :


            
                Object

optional

extra options merged into Input.create (e.g. dump/load)

index :


            
                number

optional

0-based column position (assigned by the grid)

width :

optional

explicit column width (px number or CSS px string); falls back to the grid's default width when omitted

frozen :


            
                boolean

optional

pin this column to the left while the body scrolls

header :

optional

header content; function receives (column, grid)

render :


            
                function

optional

cell content renderer; receives (record, cell, column, grid)

value :


            
                function

optional

optional override for the copy/serialized value; receives (record, column). Defaults to the render result.

class :


            
                string

optional

extra class(es) applied to header + cells

unnest :


            
                function

optional

expand the record's nested collection into stacked sub-rows for this cell (SQL UNNEST/explode). A function (record) => Array returning the sub-records to stack (read-only display in v1)

splitInto :


            
                function

optional

deprecated alias for unnest

Instance Properties


inputOptions

Extra Input.create options merged into every editor (override per type, e.g. number dump).


inputType

Input kind passed to Input.create; overflow-friendly rich text by default (mirrors Spreadsheet).


pasteAccepts

MIME types this column accepts on paste.

Instance Methods


cellAt()

A CellHandle for this column at a 0-based row index (or null).


cellHandles()

CellHandles for this column across the whole dataset (lazy, transient).


clear()

Clear the record's value.


headerContent()

Resolve header content.


input(record, options)
    
    
    
        →
        
            
                
                    HTMLElement
                    |
                
                    null

Build the bound edit control for a record (mirrors Spreadsheet via Input.create). The returned element is two-way bound to record[attribute] — edits write back on change/blur — and is shown in a Floater over the cell. Returns null when the column isn't editable.

Parameters

record :


            
                Object

options :


            
                Object

optional

extra Input options (e.g. an initial value for type-to-edit)

Returns


                        
                            HTMLElement
                            |
                        
                            null


parsePaste()

Parse a pasted/typed string into the stored value. Override per type.


paste()

Apply a pasted value to the record.


renderContent()

Resolve the display content for a record (string / node / dolla descriptor).


valueFor()

Resolve the copy/serialized value for a record (string).