1. SmartAdmin
  2. PHP Components
  3. PHP Tables

PHP Tables Bootstrap tables for PHP

Demo

Options
Result
# Username Email
1 @lodev09 lodev09@gmail.com
2 @sunny sunny@gotbootstrap.com
3 @jos jos@email.com
4 @roberto roberto@email.com

Documentation 

Unknown error (8192): Common\Markdown::blockTable(): Implicitly marking parameter $block as nullable is deprecated, the explicit nullable type must be used instead in /var/www/vhosts/plesk.groupe-dmx.fr/dev2.groupe-dmx.fr/lib/common/Markdown.php on line 6
[0] in function {closure:/var/www/vhosts/plesk.groupe-dmx.fr/dev2.groupe-dmx.fr/debug.php:6} in /var/www/vhosts/plesk.groupe-dmx.fr/dev2.groupe-dmx.fr/vendor/composer/ClassLoader.php on line 444
[1] in function include in /var/www/vhosts/plesk.groupe-dmx.fr/dev2.groupe-dmx.fr/vendor/composer/ClassLoader.php on line 444
[2] in function Composer\Autoload\includeFile in /var/www/vhosts/plesk.groupe-dmx.fr/dev2.groupe-dmx.fr/vendor/composer/ClassLoader.php on line 322
[3] in function Composer\Autoload\ClassLoader->loadClass in /var/www/vhosts/plesk.groupe-dmx.fr/dev2.groupe-dmx.fr/public/php_tables.php on line 170

Unknown error (8192): Parsedown::blockSetextHeader(): Implicitly marking parameter $Block as nullable is deprecated, the explicit nullable type must be used instead in /var/www/vhosts/plesk.groupe-dmx.fr/dev2.groupe-dmx.fr/vendor/erusev/parsedown/Parsedown.php on line 715
[0] in function {closure:/var/www/vhosts/plesk.groupe-dmx.fr/dev2.groupe-dmx.fr/debug.php:6} in /var/www/vhosts/plesk.groupe-dmx.fr/dev2.groupe-dmx.fr/vendor/composer/ClassLoader.php on line 444
[1] in function include in /var/www/vhosts/plesk.groupe-dmx.fr/dev2.groupe-dmx.fr/vendor/composer/ClassLoader.php on line 444
[2] in function Composer\Autoload\includeFile in /var/www/vhosts/plesk.groupe-dmx.fr/dev2.groupe-dmx.fr/vendor/composer/ClassLoader.php on line 322
[3] in function Composer\Autoload\ClassLoader->loadClass in /var/www/vhosts/plesk.groupe-dmx.fr/dev2.groupe-dmx.fr/lib/common/Markdown.php on line 5
[4] in function include in /var/www/vhosts/plesk.groupe-dmx.fr/dev2.groupe-dmx.fr/vendor/composer/ClassLoader.php on line 444
[5] in function Composer\Autoload\includeFile in /var/www/vhosts/plesk.groupe-dmx.fr/dev2.groupe-dmx.fr/vendor/composer/ClassLoader.php on line 322
[6] in function Composer\Autoload\ClassLoader->loadClass in /var/www/vhosts/plesk.groupe-dmx.fr/dev2.groupe-dmx.fr/public/php_tables.php on line 170

Unknown error (8192): Parsedown::blockTable(): Implicitly marking parameter $Block as nullable is deprecated, the explicit nullable type must be used instead in /var/www/vhosts/plesk.groupe-dmx.fr/dev2.groupe-dmx.fr/vendor/erusev/parsedown/Parsedown.php on line 853
[0] in function {closure:/var/www/vhosts/plesk.groupe-dmx.fr/dev2.groupe-dmx.fr/debug.php:6} in /var/www/vhosts/plesk.groupe-dmx.fr/dev2.groupe-dmx.fr/vendor/composer/ClassLoader.php on line 444
[1] in function include in /var/www/vhosts/plesk.groupe-dmx.fr/dev2.groupe-dmx.fr/vendor/composer/ClassLoader.php on line 444
[2] in function Composer\Autoload\includeFile in /var/www/vhosts/plesk.groupe-dmx.fr/dev2.groupe-dmx.fr/vendor/composer/ClassLoader.php on line 322
[3] in function Composer\Autoload\ClassLoader->loadClass in /var/www/vhosts/plesk.groupe-dmx.fr/dev2.groupe-dmx.fr/lib/common/Markdown.php on line 5
[4] in function include in /var/www/vhosts/plesk.groupe-dmx.fr/dev2.groupe-dmx.fr/vendor/composer/ClassLoader.php on line 444
[5] in function Composer\Autoload\includeFile in /var/www/vhosts/plesk.groupe-dmx.fr/dev2.groupe-dmx.fr/vendor/composer/ClassLoader.php on line 322
[6] in function Composer\Autoload\ClassLoader->loadClass in /var/www/vhosts/plesk.groupe-dmx.fr/dev2.groupe-dmx.fr/public/php_tables.php on line 170

\Bootstrap\Components\Table

Usage

Instantiate the Table by passing the data.

// sample data from your db
$data = [
    ['id' => 1, 'name' => 'Jovanni', 'email' => 'lodev09@smartadmin.lodev09.com'],
    ['id' => 2, 'name' => 'foo', 'email' => 'bar@email.com']
];

$table = new \Bootstrap\Components\Table($data);

// continued below...

Options

Table::options

You can configure the table during initialization.

Option Default Description
checkboxes false Add checkboxes to each row
columns true Enable/disable columns
cell_class null Set global class for each cell
thead true Use <thead> or not
thead_class 'thead-light Set the class of the <thead>
table true Sets the .table class
inverse false Sets the .table-inverse class
striped true Sets the .table-striped class
responsive false Sets the .table-responsive class. Also accepts sm, md, lg, xl
dark false Sets the .table-dark class
light false Sets the .table-light class
small false Sets the .table-sm class
bordered true Sets the .table-bordered class
hover false Sets the .table-hover class
default_col "No Data" Sets the default display when data is empty

Example:

// during init
$table = new \Bootstrap\Components\Table($data, ['bordered' => true]);

// after init
$table->options('bordered', true);

Cells

Using the cell property, you can control the values of each row/column by passing static configuration or callbacks (closure). FOr example:

// changing class of a cell
$table->cell = [
    'name' => [
        'class' => 'text-primary',
        'url' => '#docs',
        // ... so much more
    ],
    // can also be a closure
    'username' => function($row, $index, $value) {
        // plog($row)
        return '<strong>@'.$row['username'].'</strong>';
    }
];
 // can be also done individually like so
 $table->cell('email', ['url' => 'mailto:{{email}}']);

 // continued below...

Columns

The col property is where you can configure each column from your data like adding custom class, renaming, etc. This will basically modify the output <th>. For example:

// define the columns
// note that columns that are not defined here will be hidden
// to avoid this behaviour, you can use the $table->col(column, value) way
$table->col = [
    'name' => [
        'title' => 'Name',
        'class' => 'bg-primary text-white',
        'attr' => ['style' => 'font-weight: bold;']
    ],
    'username' => '@' // this will rename the column to '@'
];

// can also pass the configuration like this:
$table->col('username', '@');

// continued below...

Other properties

  • Table::data - Sets the data source.

  • Table::row - Configure a row given an index. Use Table:each(row) if you don't know which index to modify.

    $table->row(1, ['class' => 'bg-primary text-white']);

  • Table::each('row', callback) - Accepts a callback that will be called for each row.

    $table->each('row', function($row) {
    return [
        'class' => 'bg-primary text-white'
    ];
})

  • Table::id - Sets the id attribute of the <table>

  • Table::hide - Sets the column visibility. Note that this will use the class d-none.

    $table->hide('id', true);

  • Table::hidden - Same as Table::hide but accepts array of hidden columns.

  • Table::class - Sets the class attribute of the <table>

Styling

To learn more about styling the <table>, see Basic Tables demo.

Print

Finally, once you configured your table, you can now htmlPrint it!

$table->printHtml();

Credits

\Bootstrap\Components\Table is part of the lodev09/bootstrap-php package created by @lodev09.