source: sandbox/filemanager/tp/fckeditor/editor/_source/internals/fcktablehandler.js @ 1575

/*
 * FCKeditor - The text editor for Internet - http://www.fckeditor.net
 * Copyright (C) 2003-2009 Frederico Caldeira Knabben
 *
 * == BEGIN LICENSE ==
 *
 * Licensed under the terms of any of the following licenses at your
 * choice:
 *
 *  - GNU General Public License Version 2 or later (the "GPL")
 *    http://www.gnu.org/licenses/gpl.html
 *
 *  - GNU Lesser General Public License Version 2.1 or later (the "LGPL")
 *    http://www.gnu.org/licenses/lgpl.html
 *
 *  - Mozilla Public License Version 1.1 or later (the "MPL")
 *    http://www.mozilla.org/MPL/MPL-1.1.html
 *
 * == END LICENSE ==
 *
 * Manage table operations.
 */

var FCKTableHandler = new Object() ;

FCKTableHandler.InsertRow = function( insertBefore )
{
        // Get the row where the selection is placed in.
        var oRow = FCKSelection.MoveToAncestorNode( 'TR' ) ;
        if ( !oRow ) return ;

        // Create a clone of the row.
        var oNewRow = oRow.cloneNode( true ) ;

        // Insert the new row (copy) before of it.
        oRow.parentNode.insertBefore( oNewRow, oRow ) ;

        // Clean one of the rows to produce the illusion of inserting an empty row before or after.
        FCKTableHandler.ClearRow( insertBefore ? oNewRow : oRow ) ;
}

FCKTableHandler.DeleteRows = function( row )
{
        // If no row has been passed as a parameter,
        // then get the row( s ) containing the cells where the selection is placed in.
        // If user selected multiple rows ( by selecting multiple cells ), walk
        // the selected cell list and delete the rows containing the selected cells
        if ( ! row )
        {
                var aCells = FCKTableHandler.GetSelectedCells() ;
                var aRowsToDelete = new Array() ;
                //queue up the rows -- it's possible ( and likely ) that we may get duplicates
                for ( var i = 0; i < aCells.length; i++ )
                {
                        var oRow = aCells[i].parentNode ;
                        aRowsToDelete[oRow.rowIndex] = oRow ;
                }
                for ( var i = aRowsToDelete.length; i >= 0; i-- )
                {
                        if ( aRowsToDelete[i] )
                                FCKTableHandler.DeleteRows( aRowsToDelete[i] );
                }
                return ;
        }

        // Get the row's table.
        var oTable = FCKTools.GetElementAscensor( row, 'TABLE' ) ;

        // If just one row is available then delete the entire table.
        if ( oTable.rows.length == 1 )
        {
                FCKTableHandler.DeleteTable( oTable ) ;
                return ;
        }

        // Delete the row.
        row.parentNode.removeChild( row ) ;
}

FCKTableHandler.DeleteTable = function( table )
{
        // If no table has been passed as a parameter,
        // then get the table where the selection is placed in.
        if ( !table )
        {
                table = FCKSelection.GetSelectedElement() ;
                if ( !table || table.tagName != 'TABLE' )
                        table = FCKSelection.MoveToAncestorNode( 'TABLE' ) ;
        }
        if ( !table ) return ;

        // Delete the table.
        FCKSelection.SelectNode( table ) ;
        FCKSelection.Collapse();

        // if the table is wrapped with a singleton <p> ( or something similar ), remove
        // the surrounding tag -- which likely won't show after deletion anyway
        if ( table.parentNode.childNodes.length == 1 )
                table.parentNode.parentNode.removeChild( table.parentNode );
        else
                table.parentNode.removeChild( table  ) ;
}

FCKTableHandler.InsertColumn = function( insertBefore )
{
        // Get the cell where the selection is placed in.
        var oCell = null ;
        var nodes = this.GetSelectedCells() ;

        if ( nodes && nodes.length )
                oCell = nodes[ insertBefore ? 0 : ( nodes.length - 1 ) ] ;

        if ( ! oCell )
                return ;

        // Get the cell's table.
        var oTable = FCKTools.GetElementAscensor( oCell, 'TABLE' ) ;

        var iIndex = oCell.cellIndex ;

        // Loop through all rows available in the table.
        for ( var i = 0 ; i < oTable.rows.length ; i++ )
        {
                // Get the row.
                var oRow = oTable.rows[i] ;

                // If the row doesn't have enough cells, ignore it.
                if ( oRow.cells.length < ( iIndex + 1 ) )
                        continue ;

                oCell = oRow.cells[iIndex].cloneNode(false) ;

                if ( FCKBrowserInfo.IsGeckoLike )
                        FCKTools.AppendBogusBr( oCell ) ;

                // Get back the currently selected cell.
                var oBaseCell = oRow.cells[iIndex] ;

                oRow.insertBefore( oCell, ( insertBefore ? oBaseCell : oBaseCell.nextSibling ) ) ;
        }
}

FCKTableHandler.DeleteColumns = function( oCell )
{
        // if user selected multiple cols ( by selecting multiple cells ), walk
        // the selected cell list and delete the rows containing the selected cells
        if ( !oCell  )
        {
                var aColsToDelete = FCKTableHandler.GetSelectedCells();
                for ( var i = aColsToDelete.length; i >= 0; i--  )
                {
                        if ( aColsToDelete[i]  )
                                FCKTableHandler.DeleteColumns( aColsToDelete[i]  );
                }
                return;
        }

        if ( !oCell ) return ;

        // Get the cell's table.
        var oTable = FCKTools.GetElementAscensor( oCell, 'TABLE' ) ;

        // Get the cell index.
        var iIndex = oCell.cellIndex ;

        // Loop throw all rows (from down to up, because it's possible that some
        // rows will be deleted).
        for ( var i = oTable.rows.length - 1 ; i >= 0 ; i-- )
        {
                // Get the row.
                var oRow = oTable.rows[i] ;

                // If the cell to be removed is the first one and the row has just one cell.
                if ( iIndex == 0 && oRow.cells.length == 1 )
                {
                        // Remove the entire row.
                        FCKTableHandler.DeleteRows( oRow ) ;
                        continue ;
                }

                // If the cell to be removed exists the delete it.
                if ( oRow.cells[iIndex] )
                        oRow.removeChild( oRow.cells[iIndex] ) ;
        }
}

FCKTableHandler.InsertCell = function( cell, insertBefore )
{
        // Get the cell where the selection is placed in.
        var oCell = null ;
        var nodes = this.GetSelectedCells() ;
        if ( nodes && nodes.length )
                oCell = nodes[ insertBefore ? 0 : ( nodes.length - 1 ) ] ;
        if ( ! oCell )
                return null ;

        // Create the new cell element to be added.
        var oNewCell = FCK.EditorDocument.createElement( 'TD' ) ;
        if ( FCKBrowserInfo.IsGeckoLike )
                FCKTools.AppendBogusBr( oNewCell ) ;

        if ( !insertBefore && oCell.cellIndex == oCell.parentNode.cells.length - 1 )
                oCell.parentNode.appendChild( oNewCell ) ;
        else
                oCell.parentNode.insertBefore( oNewCell, insertBefore ? oCell : oCell.nextSibling ) ;

        return oNewCell ;
}

FCKTableHandler.DeleteCell = function( cell )
{
        // If this is the last cell in the row.
        if ( cell.parentNode.cells.length == 1 )
        {
                // Delete the entire row.
                FCKTableHandler.DeleteRows( cell.parentNode ) ;
                return ;
        }

        // Delete the cell from the row.
        cell.parentNode.removeChild( cell ) ;
}

FCKTableHandler.DeleteCells = function()
{
        var aCells = FCKTableHandler.GetSelectedCells() ;

        for ( var i = aCells.length - 1 ; i >= 0  ; i-- )
        {
                FCKTableHandler.DeleteCell( aCells[i] ) ;
        }
}

FCKTableHandler._MarkCells = function( cells, label )
{
        for ( var i = 0 ; i < cells.length ; i++ )
                cells[i][label] = true ;
}

FCKTableHandler._UnmarkCells = function( cells, label )
{
        for ( var i = 0 ; i < cells.length ; i++ )
        {
                FCKDomTools.ClearElementJSProperty(cells[i], label ) ;
        }
}

FCKTableHandler._ReplaceCellsByMarker = function( tableMap, marker, substitute )
{
        for ( var i = 0 ; i < tableMap.length ; i++ )
        {
                for ( var j = 0 ; j < tableMap[i].length ; j++ )
                {
                        if ( tableMap[i][j][marker] )
                                tableMap[i][j] = substitute ;
                }
        }
}

FCKTableHandler._GetMarkerGeometry = function( tableMap, rowIdx, colIdx, markerName )
{
        var selectionWidth = 0 ;
        var selectionHeight = 0 ;
        var cellsLeft = 0 ;
        var cellsUp = 0 ;
        for ( var i = colIdx ; tableMap[rowIdx][i] && tableMap[rowIdx][i][markerName] ; i++ )
                selectionWidth++ ;
        for ( var i = colIdx - 1 ; tableMap[rowIdx][i] && tableMap[rowIdx][i][markerName] ; i-- )
        {
                selectionWidth++ ;
                cellsLeft++ ;
        }
        for ( var i = rowIdx ; tableMap[i] && tableMap[i][colIdx] && tableMap[i][colIdx][markerName] ; i++ )
                selectionHeight++ ;
        for ( var i = rowIdx - 1 ; tableMap[i] && tableMap[i][colIdx] && tableMap[i][colIdx][markerName] ; i-- )
        {
                selectionHeight++ ;
                cellsUp++ ;
        }
        return { 'width' : selectionWidth, 'height' : selectionHeight, 'x' : cellsLeft, 'y' : cellsUp } ;
}

FCKTableHandler.CheckIsSelectionRectangular = function()
{
        // If every row and column in an area on a plane are of the same width and height,
        // Then the area is a rectangle.
        var cells = FCKTableHandler.GetSelectedCells() ;
        if ( cells.length < 1 )
                return false ;

        // Check if the selected cells are all in the same table section (thead, tfoot or tbody)
        for (var i = 0; i < cells.length; i++)
        {
                if ( cells[i].parentNode.parentNode != cells[0].parentNode.parentNode )
                        return false ;
        }

        this._MarkCells( cells, '_CellSelected' ) ;

        var tableMap = this._CreateTableMap( cells[0] ) ;
        var rowIdx = cells[0].parentNode.rowIndex ;
        var colIdx = this._GetCellIndexSpan( tableMap, rowIdx, cells[0] ) ;

        var geometry = this._GetMarkerGeometry( tableMap, rowIdx, colIdx, '_CellSelected' ) ;
        var baseColIdx = colIdx - geometry.x ;
        var baseRowIdx = rowIdx - geometry.y ;

        if ( geometry.width >= geometry.height )
        {
                for ( colIdx = baseColIdx ; colIdx < baseColIdx + geometry.width ; colIdx++ )
                {
                        rowIdx = baseRowIdx + ( colIdx - baseColIdx ) % geometry.height ;
                        if ( ! tableMap[rowIdx] || ! tableMap[rowIdx][colIdx] )
                        {
                                this._UnmarkCells( cells, '_CellSelected' ) ;
                                return false ;
                        }
                        var g = this._GetMarkerGeometry( tableMap, rowIdx, colIdx, '_CellSelected' ) ;
                        if ( g.width != geometry.width || g.height != geometry.height )
                        {
                                this._UnmarkCells( cells, '_CellSelected' ) ;
                                return false ;
                        }
                }
        }
        else
        {
                for ( rowIdx = baseRowIdx ; rowIdx < baseRowIdx + geometry.height ; rowIdx++ )
                {
                        colIdx = baseColIdx + ( rowIdx - baseRowIdx ) % geometry.width ;
                        if ( ! tableMap[rowIdx] || ! tableMap[rowIdx][colIdx] )
                        {
                                this._UnmarkCells( cells, '_CellSelected' ) ;
                                return false ;
                        }
                        var g = this._GetMarkerGeometry( tableMap, rowIdx, colIdx, '_CellSelected' ) ;
                        if ( g.width != geometry.width || g.height != geometry.height )
                        {
                                this._UnmarkCells( cells, '_CellSelected' ) ;
                                return false ;
                        }
                }
        }

        this._UnmarkCells( cells, '_CellSelected' ) ;
        return true ;
}

FCKTableHandler.MergeCells = function()
{
        // Get all selected cells.
        var cells = this.GetSelectedCells() ;
        if ( cells.length < 2 )
                return ;

        // Assume the selected cells are already in a rectangular geometry.
        // Because the checking is already done by FCKTableCommand.
        var refCell = cells[0] ;
        var tableMap = this._CreateTableMap( refCell ) ;
        var rowIdx = refCell.parentNode.rowIndex ;
        var colIdx = this._GetCellIndexSpan( tableMap, rowIdx, refCell ) ;

        this._MarkCells( cells, '_SelectedCells' ) ;
        var selectionGeometry = this._GetMarkerGeometry( tableMap, rowIdx, colIdx, '_SelectedCells' ) ;

        var baseColIdx = colIdx - selectionGeometry.x ;
        var baseRowIdx = rowIdx - selectionGeometry.y ;
        var cellContents = FCKTools.GetElementDocument( refCell ).createDocumentFragment() ;
        for ( var i = 0 ; i < selectionGeometry.height ; i++ )
        {
                var rowChildNodesCount = 0 ;
                for ( var j = 0 ; j < selectionGeometry.width ; j++ )
                {
                        var currentCell = tableMap[baseRowIdx + i][baseColIdx + j] ;
                        while ( currentCell.childNodes.length > 0 )
                        {
                                var node = currentCell.removeChild( currentCell.firstChild ) ;
                                if ( node.nodeType != 1
                                        || ( node.getAttribute( 'type', 2 ) != '_moz' && node.getAttribute( '_moz_dirty' ) != null ) )
                                {
                                        cellContents.appendChild( node ) ;
                                        rowChildNodesCount++ ;
                                }
                        }
                }
                if ( rowChildNodesCount > 0 )
                        cellContents.appendChild( FCK.EditorDocument.createElement( 'br' ) ) ;
        }

        this._ReplaceCellsByMarker( tableMap, '_SelectedCells', refCell ) ;
        this._UnmarkCells( cells, '_SelectedCells' ) ;
        this._InstallTableMap( tableMap, refCell.parentNode.parentNode.parentNode ) ;
        refCell.appendChild( cellContents ) ;

        if ( FCKBrowserInfo.IsGeckoLike && ( ! refCell.firstChild ) )
                FCKTools.AppendBogusBr( refCell ) ;

        this._MoveCaretToCell( refCell, false ) ;
}

FCKTableHandler.MergeRight = function()
{
        var target = this.GetMergeRightTarget() ;
        if ( target == null )
                return ;
        var refCell = target.refCell ;
        var tableMap = target.tableMap ;
        var nextCell = target.nextCell ;

        var cellContents = FCK.EditorDocument.createDocumentFragment() ;
        while ( nextCell && nextCell.childNodes && nextCell.childNodes.length > 0 )
                cellContents.appendChild( nextCell.removeChild( nextCell.firstChild ) ) ;

        nextCell.parentNode.removeChild( nextCell ) ;
        refCell.appendChild( cellContents ) ;
        this._MarkCells( [nextCell], '_Replace' ) ;
        this._ReplaceCellsByMarker( tableMap, '_Replace', refCell ) ;
        this._InstallTableMap( tableMap, refCell.parentNode.parentNode.parentNode ) ;

        this._MoveCaretToCell( refCell, false ) ;
}

FCKTableHandler.MergeDown = function()
{
        var target = this.GetMergeDownTarget() ;
        if ( target == null )
                return ;
        var refCell = target.refCell ;
        var tableMap = target.tableMap ;
        var nextCell = target.nextCell ;

        var cellContents = FCKTools.GetElementDocument( refCell ).createDocumentFragment() ;
        while ( nextCell && nextCell.childNodes && nextCell.childNodes.length > 0 )
                cellContents.appendChild( nextCell.removeChild( nextCell.firstChild ) ) ;
        if ( cellContents.firstChild )
                cellContents.insertBefore( FCK.EditorDocument.createElement( 'br' ), cellContents.firstChild ) ;
        refCell.appendChild( cellContents ) ;
        this._MarkCells( [nextCell], '_Replace' ) ;
        this._ReplaceCellsByMarker( tableMap, '_Replace', refCell ) ;
        this._InstallTableMap( tableMap, refCell.parentNode.parentNode.parentNode ) ;

        this._MoveCaretToCell( refCell, false ) ;
}

FCKTableHandler.HorizontalSplitCell = function()
{
        var cells = FCKTableHandler.GetSelectedCells() ;
        if ( cells.length != 1 )
                return ;

        var refCell = cells[0] ;
        var tableMap = this._CreateTableMap( refCell ) ;
        var rowIdx = refCell.parentNode.rowIndex ;
        var colIdx = FCKTableHandler._GetCellIndexSpan( tableMap, rowIdx, refCell ) ;
        var cellSpan = isNaN( refCell.colSpan ) ? 1 : refCell.colSpan ;

        if ( cellSpan > 1 )
        {
                // Splitting a multi-column cell - original cell gets ceil(colSpan/2) columns,
                // new cell gets floor(colSpan/2).
                var newCellSpan = Math.ceil( cellSpan / 2 ) ;
                var newCell = FCK.EditorDocument.createElement( refCell.nodeName ) ;
                if ( FCKBrowserInfo.IsGeckoLike )
                        FCKTools.AppendBogusBr( newCell ) ;
                var startIdx = colIdx + newCellSpan ;
                var endIdx = colIdx + cellSpan ;
                var rowSpan = isNaN( refCell.rowSpan ) ? 1 : refCell.rowSpan ;
                for ( var r = rowIdx ; r < rowIdx + rowSpan ; r++ )
                {
                        for ( var i = startIdx ; i < endIdx ; i++ )
                                tableMap[r][i] = newCell ;
                }
        }
        else
        {
                // Splitting a single-column cell - add a new cell, and expand
                // cells crossing the same column.
                var newTableMap = [] ;
                for ( var i = 0 ; i < tableMap.length ; i++ )
                {
                        var newRow = tableMap[i].slice( 0, colIdx ) ;
                        if ( tableMap[i].length <= colIdx )
                        {
                                newTableMap.push( newRow ) ;
                                continue ;
                        }
                        if ( tableMap[i][colIdx] == refCell )
                        {
                                newRow.push( refCell ) ;
                                newRow.push( FCK.EditorDocument.createElement( refCell.nodeName ) ) ;
                                if ( FCKBrowserInfo.IsGeckoLike )
                                        FCKTools.AppendBogusBr( newRow[newRow.length - 1] ) ;
                        }
                        else
                        {
                                newRow.push( tableMap[i][colIdx] ) ;
                                newRow.push( tableMap[i][colIdx] ) ;
                        }
                        for ( var j = colIdx + 1 ; j < tableMap[i].length ; j++ )
                                newRow.push( tableMap[i][j] ) ;
                        newTableMap.push( newRow ) ;
                }
                tableMap = newTableMap ;
        }

        this._InstallTableMap( tableMap, refCell.parentNode.parentNode.parentNode ) ;
}

FCKTableHandler.VerticalSplitCell = function()
{
        var cells = FCKTableHandler.GetSelectedCells() ;
        if ( cells.length != 1 )
                return ;

        var currentCell = cells[0] ;
        var tableMap = this._CreateTableMap( currentCell ) ;
        var currentRowIndex = currentCell.parentNode.rowIndex ;
        var cellIndex = FCKTableHandler._GetCellIndexSpan( tableMap, currentRowIndex, currentCell ) ;
        // Save current cell colSpan
        var currentColSpan = isNaN( currentCell.colSpan ) ? 1 : currentCell.colSpan ;
        var currentRowSpan = currentCell.rowSpan ;
        if ( isNaN( currentRowSpan ) )
                currentRowSpan = 1 ;

        if ( currentRowSpan > 1 )
        {
                // 1. Set the current cell's rowSpan to 1.
                currentCell.rowSpan = Math.ceil( currentRowSpan / 2 ) ;

                // 2. Find the appropriate place to insert a new cell at the next row.
                var newCellRowIndex = currentRowIndex + Math.ceil( currentRowSpan / 2 ) ;
                var oRow = tableMap[newCellRowIndex] ;
                var insertMarker = null ;
                for ( var i = cellIndex+1 ; i < oRow.length ; i++ )
                {
                        if ( oRow[i].parentNode.rowIndex == newCellRowIndex )
                        {
                                insertMarker = oRow[i] ;
                                break ;
                        }
                }

                // 3. Insert the new cell to the indicated place, with the appropriate rowSpan and colSpan, next row.
                var newCell = FCK.EditorDocument.createElement( currentCell.nodeName ) ;
                newCell.rowSpan = Math.floor( currentRowSpan / 2 ) ;
                if ( currentColSpan > 1 )
                        newCell.colSpan = currentColSpan ;
                if ( FCKBrowserInfo.IsGeckoLike )
                        FCKTools.AppendBogusBr( newCell ) ;
                currentCell.parentNode.parentNode.parentNode.rows[newCellRowIndex].insertBefore( newCell, insertMarker ) ;
        }
        else
        {
                // 1. Insert a new row.
                var newSectionRowIdx = currentCell.parentNode.sectionRowIndex + 1 ;
                var newRow = FCK.EditorDocument.createElement( 'tr' ) ;
                var tSection = currentCell.parentNode.parentNode ;
                if ( tSection.rows.length > newSectionRowIdx )
                        tSection.insertBefore( newRow, tSection.rows[newSectionRowIdx] ) ;
                else
                        tSection.appendChild( newRow ) ;

                // 2. +1 to rowSpan for all cells crossing currentCell's row.
                for ( var i = 0 ; i < tableMap[currentRowIndex].length ; )
                {
                        var colSpan = tableMap[currentRowIndex][i].colSpan ;
                        if ( isNaN( colSpan ) || colSpan < 1 )
                                colSpan = 1 ;
                        if ( i == cellIndex )
                        {
                                i += colSpan ;
                                continue ;
                        }
                        var rowSpan = tableMap[currentRowIndex][i].rowSpan ;
                        if ( isNaN( rowSpan ) )
                                rowSpan = 1 ;
                        tableMap[currentRowIndex][i].rowSpan = rowSpan + 1 ;
                        i += colSpan ;
                }

                // 3. Insert a new cell to new row. Set colSpan on the new cell.
                var newCell = FCK.EditorDocument.createElement( currentCell.nodeName ) ;
                if ( currentColSpan > 1 )
                        newCell.colSpan = currentColSpan ;
                if ( FCKBrowserInfo.IsGeckoLike )
                        FCKTools.AppendBogusBr( newCell ) ;
                newRow.appendChild( newCell ) ;
        }
}

// Get the cell index from a TableMap.
FCKTableHandler._GetCellIndexSpan = function( tableMap, rowIndex, cell )
{
        if ( tableMap.length < rowIndex + 1 )
                return null ;

        var oRow = tableMap[ rowIndex ] ;

        for ( var c = 0 ; c < oRow.length ; c++ )
        {
                if ( oRow[c] == cell )
                        return c ;
        }

        return null ;
}

// Get the cell location from a TableMap. Returns an array with an [x,y] location
FCKTableHandler._GetCellLocation = function( tableMap, cell  )
{
        for ( var i = 0 ; i < tableMap.length; i++ )
        {
                for ( var c = 0 ; c < tableMap[i].length ; c++  )
                {
                        if ( tableMap[i][c] == cell  ) return [i,c];
                }
        }
        return null ;
}

// This function is quite hard to explain. It creates a matrix representing all cells in a table.
// The difference here is that the "spanned" cells (colSpan and rowSpan) are duplicated on the matrix
// cells that are "spanned". For example, a row with 3 cells where the second cell has colSpan=2 and rowSpan=3
// will produce a bi-dimensional matrix with the following values (representing the cells):
//              Cell1, Cell2, Cell2, Cell3
//              Cell4, Cell2, Cell2, Cell5
//              Cell6, Cell2, Cell2, Cell7
FCKTableHandler._CreateTableMap = function( refCell )
{
        var table = (refCell.nodeName == 'TABLE' ? refCell : refCell.parentNode.parentNode.parentNode ) ;

        var aRows = table.rows ;

        // Row and Column counters.
        var r = -1 ;

        var aMap = new Array() ;

        for ( var i = 0 ; i < aRows.length ; i++ )
        {
                r++ ;
                if ( !aMap[r] )
                        aMap[r] = new Array() ;

                var c = -1 ;

                for ( var j = 0 ; j < aRows[i].cells.length ; j++ )
                {
                        var oCell = aRows[i].cells[j] ;

                        c++ ;
                        while ( aMap[r][c] )
                                c++ ;

                        var iColSpan = isNaN( oCell.colSpan ) ? 1 : oCell.colSpan ;
                        var iRowSpan = isNaN( oCell.rowSpan ) ? 1 : oCell.rowSpan ;

                        for ( var rs = 0 ; rs < iRowSpan ; rs++ )
                        {
                                if ( !aMap[r + rs] )
                                        aMap[r + rs] = new Array() ;

                                for ( var cs = 0 ; cs < iColSpan ; cs++ )
                                {
                                        aMap[r + rs][c + cs] = aRows[i].cells[j] ;
                                }
                        }

                        c += iColSpan - 1 ;
                }
        }
        return aMap ;
}

// This function is the inverse of _CreateTableMap - it takes in a table map and converts it to an HTML table.
FCKTableHandler._InstallTableMap = function( tableMap, table )
{
        // Workaround for #1917 : MSIE will always report a cell's rowSpan as 1 as long
        // as the cell is not attached to a row. So we'll need an alternative attribute
        // for storing the calculated rowSpan in IE.
        var rowSpanAttr = FCKBrowserInfo.IsIE ? "_fckrowspan" : "rowSpan" ;

        // Disconnect all the cells in tableMap from their parents, set all colSpan and rowSpan attributes to 1.
        for ( var i = 0 ; i < tableMap.length ; i++ )
        {
                for ( var j = 0 ; j < tableMap[i].length ; j++ )
                {
                        var cell = tableMap[i][j] ;
                        if ( cell.parentNode )
                                cell.parentNode.removeChild( cell ) ;
                        cell.colSpan = cell[rowSpanAttr] = 1 ;
                }
        }

        // Scan by rows and set colSpan.
        var maxCol = 0 ;
        for ( var i = 0 ; i < tableMap.length ; i++ )
        {
                for ( var j = 0 ; j < tableMap[i].length ; j++ )
                {
                        var cell = tableMap[i][j] ;
                        if ( ! cell)
                                continue ;
                        if ( j > maxCol )
                                maxCol = j ;
                        if ( cell._colScanned === true )
                                continue ;
                        if ( tableMap[i][j-1] == cell )
                                cell.colSpan++ ;
                        if ( tableMap[i][j+1] != cell )
                                cell._colScanned = true ;
                }
        }

        // Scan by columns and set rowSpan.
        for ( var i = 0 ; i <= maxCol ; i++ )
        {
                for ( var j = 0 ; j < tableMap.length ; j++ )
                {
                        if ( ! tableMap[j] )
                                continue ;
                        var cell = tableMap[j][i] ;
                        if ( ! cell || cell._rowScanned === true )
                                continue ;
                        if ( tableMap[j-1] && tableMap[j-1][i] == cell )
                                cell[rowSpanAttr]++ ;
                        if ( ! tableMap[j+1] || tableMap[j+1][i] != cell )
                                cell._rowScanned = true ;
                }
        }

        // Clear all temporary flags.
        for ( var i = 0 ; i < tableMap.length ; i++ )
        {
                for ( var j = 0 ; j < tableMap[i].length ; j++)
                {
                        var cell = tableMap[i][j] ;
                        FCKDomTools.ClearElementJSProperty(cell, '_colScanned' ) ;
                        FCKDomTools.ClearElementJSProperty(cell, '_rowScanned' ) ;
                }
        }

        // Insert physical rows and columns to the table.
        for ( var i = 0 ; i < tableMap.length ; i++ )
        {
                var rowObj = FCK.EditorDocument.createElement( 'tr' ) ;
                for ( var j = 0 ; j < tableMap[i].length ; )
                {
                        var cell = tableMap[i][j] ;
                        if ( tableMap[i-1] && tableMap[i-1][j] == cell )
                        {
                                j += cell.colSpan ;
                                continue ;
                        }
                        rowObj.appendChild( cell ) ;
                        if ( rowSpanAttr != 'rowSpan' )
                        {
                                cell.rowSpan = cell[rowSpanAttr] ;
                                cell.removeAttribute( rowSpanAttr ) ;
                        }
                        j += cell.colSpan ;
                        if ( cell.colSpan == 1 )
                                cell.removeAttribute( 'colspan' ) ;
                        if ( cell.rowSpan == 1 )
                                cell.removeAttribute( 'rowspan' ) ;
                }
                if ( FCKBrowserInfo.IsIE )
                {
                        table.rows[i].replaceNode( rowObj ) ;
                }
                else
                {
                        table.rows[i].innerHTML = '' ;
                        FCKDomTools.MoveChildren( rowObj, table.rows[i] ) ;
                }
        }
}

FCKTableHandler._MoveCaretToCell = function ( refCell, toStart )
{
        var range = new FCKDomRange( FCK.EditorWindow ) ;
        range.MoveToNodeContents( refCell ) ;
        range.Collapse( toStart ) ;
        range.Select() ;
}

FCKTableHandler.ClearRow = function( tr )
{
        // Get the array of row's cells.
        var aCells = tr.cells ;

        // Replace the contents of each cell with "nothing".
        for ( var i = 0 ; i < aCells.length ; i++ )
        {
                aCells[i].innerHTML = '' ;

                if ( FCKBrowserInfo.IsGeckoLike )
                        FCKTools.AppendBogusBr( aCells[i] ) ;
        }
}

FCKTableHandler.GetMergeRightTarget = function()
{
        var cells = this.GetSelectedCells() ;
        if ( cells.length != 1 )
                return null ;

        var refCell = cells[0] ;
        var tableMap = this._CreateTableMap( refCell ) ;
        var rowIdx = refCell.parentNode.rowIndex ;
        var colIdx = this._GetCellIndexSpan( tableMap, rowIdx, refCell ) ;
        var nextColIdx = colIdx + ( isNaN( refCell.colSpan ) ? 1 : refCell.colSpan ) ;
        var nextCell = tableMap[rowIdx][nextColIdx] ;

        if ( ! nextCell )
                return null ;

        // The two cells must have the same vertical geometry, otherwise merging does not make sense.
        this._MarkCells( [refCell, nextCell], '_SizeTest' ) ;
        var refGeometry = this._GetMarkerGeometry( tableMap, rowIdx, colIdx, '_SizeTest' ) ;
        var nextGeometry = this._GetMarkerGeometry( tableMap, rowIdx, nextColIdx, '_SizeTest' ) ;
        this._UnmarkCells( [refCell, nextCell], '_SizeTest' ) ;

        if ( refGeometry.height != nextGeometry.height || refGeometry.y != nextGeometry.y )
                return null ;

        return { 'refCell' : refCell, 'nextCell' : nextCell, 'tableMap' : tableMap } ;
}

FCKTableHandler.GetMergeDownTarget = function()
{
        var cells = this.GetSelectedCells() ;
        if ( cells.length != 1 )
                return null ;

        var refCell = cells[0] ;
        var tableMap = this._CreateTableMap( refCell ) ;
        var rowIdx = refCell.parentNode.rowIndex ;
        var colIdx = this._GetCellIndexSpan( tableMap, rowIdx, refCell ) ;
        var newRowIdx = rowIdx + ( isNaN( refCell.rowSpan ) ? 1 : refCell.rowSpan ) ;
        if ( ! tableMap[newRowIdx] )
                return null ;

        var nextCell = tableMap[newRowIdx][colIdx] ;

        if ( ! nextCell )
                return null ;

        // Check if the selected cells are both in the same table section (thead, tfoot or tbody).
        if ( refCell.parentNode.parentNode != nextCell.parentNode.parentNode )
                return null ;

        // The two cells must have the same horizontal geometry, otherwise merging does not makes sense.
        this._MarkCells( [refCell, nextCell], '_SizeTest' ) ;
        var refGeometry = this._GetMarkerGeometry( tableMap, rowIdx, colIdx, '_SizeTest' ) ;
        var nextGeometry = this._GetMarkerGeometry( tableMap, newRowIdx, colIdx, '_SizeTest' ) ;
        this._UnmarkCells( [refCell, nextCell], '_SizeTest' ) ;

        if ( refGeometry.width != nextGeometry.width || refGeometry.x != nextGeometry.x )
                return null ;

        return { 'refCell' : refCell, 'nextCell' : nextCell, 'tableMap' : tableMap } ;
}