3/8/2019 Laravel Excel Export: Formatting and Styling Cells - Laravel Daily

Laravel Excel Export: Formatting and Styling Cells

June 26, 2018

Laravel-Excel package is great for exporting data. But not a lot of info there about
formatting Excel cells – widths, word wraps, fonts etc. So when I encountered this
in a client’s project, I decided to write this article with a few tips on this topic.

Default Laravel Export

Let’s create a dummy project with Users table and default Laravel Auth. Then we
create 10 random users. Actually, Laravel comes with pre-built Factory class for
User model, so all we need to do is to create a UsersTableSeeder.php

class UsersTableSeeder extends Seeder

{
public function run()
{
factory(App\User::class, 10)->create();
}
}

Then, we require Laravel Excel package:

composer require maatwebsite/excel

Now, we export all users to Excel. To do that, we create a separate class

app/Exports/UsersExport.php:

namespace App\Exports;

use App\User;
use Maatwebsite\Excel\Concerns\FromCollection;
use Maatwebsite\Excel\Concerns\WithHeadings;

class UsersExport implements FromCollection, WithHeadings

{
public function collection()
{
return User::all();
}

public function headings(): array

{
return [
'#',
'Name',
'Email',
'Created at',
'Updated at'
];
}

Finally, let’s use it from Controller:

https://laraveldaily.com/laravel-excel-export-formatting-and-styling-cells/ 1/5
3/8/2019 Laravel Excel Export: Formatting and Styling Cells - Laravel Daily

namespace App\Http\Controllers;

use App\Exports\UsersExport;
use Maatwebsite\Excel\Facades\Excel;

class ExportController extends Controller

{

function export()
{
return Excel::download(new UsersExport, 'users.xlsx');
}

Here’s the visual result:

It does the job, exports the data. But does it look good and readable? Far from it.
So let’s tweak it a little.

Step 1. Auto-formatting column widths

Somewhere deep in the official documentation I’ve found a really easy way to
adjust the column sizes automatically. All you need is to use one Trait
ShouldAutoSize:

// ...
use Maatwebsite\Excel\Concerns\ShouldAutoSize;

class UsersExport implements FromCollection, WithHeadings, ShouldAutoSize

{
https://laraveldaily.com/laravel-excel-export-formatting-and-styling-cells/ 2/5
3/8/2019 Laravel Excel Export: Formatting and Styling Cells - Laravel Daily
{
// ...

And here’s the new Excel:

Better, huh? Let’s move on.

Step 2. Formatting the fonts and sizes

You can adjust any cell styles using method called registerEvents() and
AfterSheet event:

// ...
use Maatwebsite\Excel\Concerns\WithEvents;
use Maatwebsite\Excel\Events\AfterSheet;

class UsersExport implements FromCollection, WithHeadings, ShouldAutoSize,

{

// ...

/**
* @return array
*/
public function registerEvents(): array
{
return [
AfterSheet::class => function(AfterSheet $event) {
$cellRange = 'A1:W1'; // All headers
$event->sheet->getDelegate()->getStyle($cellRange)->getFont
},
];
}

Here’s how the header row looks now:

https://laraveldaily.com/laravel-excel-export-formatting-and-styling-cells/ 3/5
3/8/2019 Laravel Excel Export: Formatting and Styling Cells - Laravel Daily

The main logic here is this line:

$event->sheet->getDelegate()->getStyle($cellRange)->getFont()->setSize(14);

It just takes whatever cell range we pass, and changes the styles.
Here’s where we need to dig deeper and look at the package which is the base of
Laravel Excel. It’s actually based on PHPSpreadsheet package. So let’s take a look
at its documentation, and specifically section Recipes.

Some examples from there:

Wrap text:

$spreadsheet->getActiveSheet()->getStyle('A1:D4')
->getAlignment()->setWrapText(true);

Default style of a worksheet:

$spreadsheet->getDefaultStyle()->getFont()->setName('Arial');
$spreadsheet->getDefaultStyle()->getFont()->setSize(8);

Styling borders and applying styles from array:

$styleArray = [
'borders' => [
'outline' => [
'borderStyle' => \PhpOffice\PhpSpreadsheet\Style\Border::BORDER
'color' => ['argb' => 'FFFF0000'],
],
],
];

$worksheet->getStyle('B2:G8')->applyFromArray($styleArray);

You can find more examples in that recipes section, just apply it to your individual
needs.

That’s it, that’s how you format exported excel with Laravel and PHP.

Related articles:

https://laraveldaily.com/laravel-excel-export-formatting-and-styling-cells/ 4/5
3/8/2019 Laravel Excel Export: Formatting and Styling Cells - Laravel Daily

Laravel-Excel 3.0: Export Custom Array into Excel

How to import CSV in Laravel and Choose Matching Fields

Like our articles?

Check out our Laravel online courses!

Povilas Korop
PHP web-developer with 15 years experience, 5 years with Laravel. Now leading a small team of developers,
growing Laravel adminpanel generator QuickAdminPanel and publishing Laravel courses on Teachable.

 

https://laraveldaily.com/laravel-excel-export-formatting-and-styling-cells/ 5/5