mirror of
https://github.com/PHPOffice/PhpSpreadsheet.git
synced 2026-08-23 10:14:57 +00:00
aswinkumar863
92a50d134f
Initial implementation of Excel's tables feature (i.e. Select Home >
Format as Table in Excel App).
Tables are similar to AutoFilter but tables have other advantages like
named ranges, easy formatting, totals row and header row with filter.
Tables can also be converted to charts and pivot tables easily.
Usage:
$table = new Table();
$table->setName('Sales_Data');
$table->setRange('A1:D17');
$spreadsheet->getActiveSheet()->addTable($table);
In this Commit:
- Added Table API with initial support for header and totals row.
- Added complete styling options for Table.
- Added Xlsx Writer for Table.
- Added samples.
- Covered with unit tests.
To be done:
- Filter expressions similar to AutoFilter.
- Precalucate formulas for totals row (Check sample 2).
- Table named ranges in formulas and calculation.
85 lines
2.7 KiB
PHP
85 lines
2.7 KiB
PHP
<?php
|
|
|
|
use PhpOffice\PhpSpreadsheet\IOFactory;
|
|
use PhpOffice\PhpSpreadsheet\Spreadsheet;
|
|
use PhpOffice\PhpSpreadsheet\Worksheet\Table;
|
|
|
|
require __DIR__ . '/../Header.php';
|
|
|
|
// Create new Spreadsheet object
|
|
$helper->log('Create new Spreadsheet object');
|
|
$spreadsheet = new Spreadsheet();
|
|
|
|
// Set document properties
|
|
$helper->log('Set document properties');
|
|
$spreadsheet->getProperties()->setCreator('aswinkumar863')
|
|
->setLastModifiedBy('aswinkumar863')
|
|
->setTitle('PhpSpreadsheet Table Test Document')
|
|
->setSubject('PhpSpreadsheet Table Test Document')
|
|
->setDescription('Test document for PhpSpreadsheet, generated using PHP classes.')
|
|
->setKeywords('office PhpSpreadsheet php')
|
|
->setCategory('Table');
|
|
|
|
// Create the worksheet
|
|
$helper->log('Add data');
|
|
|
|
$spreadsheet->setActiveSheetIndex(0);
|
|
$spreadsheet->getActiveSheet()->setCellValue('A1', 'Year')
|
|
->setCellValue('B1', 'Quarter')
|
|
->setCellValue('C1', 'Country')
|
|
->setCellValue('D1', 'Sales');
|
|
|
|
$dataArray = [
|
|
['2010', 'Q1', 'United States', 790],
|
|
['2010', 'Q2', 'United States', 730],
|
|
['2010', 'Q3', 'United States', 860],
|
|
['2010', 'Q4', 'United States', 850],
|
|
['2011', 'Q1', 'United States', 800],
|
|
['2011', 'Q2', 'United States', 700],
|
|
['2011', 'Q3', 'United States', 900],
|
|
['2011', 'Q4', 'United States', 950],
|
|
['2010', 'Q1', 'Belgium', 380],
|
|
['2010', 'Q2', 'Belgium', 390],
|
|
['2010', 'Q3', 'Belgium', 420],
|
|
['2010', 'Q4', 'Belgium', 460],
|
|
['2011', 'Q1', 'Belgium', 400],
|
|
['2011', 'Q2', 'Belgium', 350],
|
|
['2011', 'Q3', 'Belgium', 450],
|
|
['2011', 'Q4', 'Belgium', 500],
|
|
];
|
|
|
|
$spreadsheet->getActiveSheet()->fromArray($dataArray, null, 'A2');
|
|
|
|
// Table
|
|
$helper->log('Create Table');
|
|
$table = new Table();
|
|
$table->setName('SalesData');
|
|
$table->setShowTotalsRow(true);
|
|
$table->setRange('A1:D18'); // +1 row for totalsRow
|
|
|
|
$helper->log('Add Totals Row');
|
|
// Table column label not implemented yet,
|
|
$table->getColumn('A')->setTotalsRowLabel('Total');
|
|
// So set the label directly to the cell
|
|
$spreadsheet->getActiveSheet()->getCell('A18')->setValue('Total');
|
|
|
|
// Table column function not implemented yet,
|
|
$table->getColumn('D')->setTotalsRowFunction('sum');
|
|
// So set the formula directly to the cell
|
|
$spreadsheet->getActiveSheet()->getCell('D18')->setValue('=SUBTOTAL(109,SalesData[Sales])');
|
|
|
|
// Add Table to Worksheet
|
|
$helper->log('Add Table to Worksheet');
|
|
$spreadsheet->getActiveSheet()->addTable($table);
|
|
|
|
// Save
|
|
$path = $helper->getFilename(__FILE__);
|
|
$writer = IOFactory::createWriter($spreadsheet, 'Xlsx');
|
|
|
|
// Disable precalculation to add table's total row
|
|
$writer->setPreCalculateFormulas(false);
|
|
$callStartTime = microtime(true);
|
|
$writer->save($path);
|
|
$helper->logWrite($writer, $path, $callStartTime);
|
|
$helper->logEndingNotes();
|