Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/intrip/bootstrap-table-generator
Dynamic table generator for bootstrap written in php.
https://github.com/intrip/bootstrap-table-generator
Last synced: 27 days ago
JSON representation
Dynamic table generator for bootstrap written in php.
- Host: GitHub
- URL: https://github.com/intrip/bootstrap-table-generator
- Owner: intrip
- License: mit
- Created: 2013-10-13T20:22:17.000Z (about 11 years ago)
- Default Branch: master
- Last Pushed: 2018-06-03T19:47:07.000Z (over 6 years ago)
- Last Synced: 2024-09-27T16:20:32.499Z (about 1 month ago)
- Language: PHP
- Size: 17.6 KB
- Stars: 14
- Watchers: 3
- Forks: 3
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
## Bootstrap 3 Table generator
This package is a dynamic table generator for Bootstrap 3 written in Php.
This package is fully tested and ready for use.
[](https://travis-ci.org/intrip/bootstrap-table-generator)
### Installation
The first requisite to run the package is to include Bootstrap 3 in your Application.
For more info see: this link.
The next step is to install this package through Composer. Edit your project's `composer.json` file to require `"jacopo/bootstrap-3-table-generator": "dev-master"`.
"require": {
"jacopo/bootstrap-3-table-generator": "dev-master"
},
"minimum-stability" : "dev"
Next, update Composer from the Terminal:
composer update
That's it. You successfully installed Bootstrap 3 table generator!
### Usage
To use te package you need to require `Jacopo\Bootstrap3Table\BootstrapTable`.
Here is an example for a quick usage of the tool:
```PHP
use Jacopo\Bootstrap3Table\BootstrapTable;
// create the generator class
$table = new BootstrapTable();
// set the configuration
$table->setConfig(array("table-hover"=>false, "table-condensed"=>true, "table-striped"=>true ) );
// set header content (optional)
$table->setHeader(array("firstCol") );
// add table row
$table->addRows(array("cell1","cell2"), array("custom-class1"));
// you can also add a bigger row
$table->addRows(array("cell1","cell2","cell3"));
// or add a smaller row
$table->addRows(array("cell1"));
// setup extra custom css classes for the table
$table->setTableExtraClasses(array("extra-table"));
// print the table
echo $table; // equals to echo $table->getHtml();
```
### Methods overview
The methods available are:
`setConfig`: set the base configuration of the table. Accepts an array of options. The option available are:
`table-striped`: Adds zebra-striping to any table row .
`table-bordered`: Add borders and rounded corners to the table.
`table-hover`: Enable a hover state on table rows.
`table-condensed`: Makes tables more compact by cutting cell padding in half.
`table-responsive`: Makes table responsive.
`id`: Set the id of the table.
You can also add extra css classes to the ``tag. To do that you need to set the
`setTableExtraClasses()`method.
Example:
```PHP
$table = new BootstrapTable();
$table->setTableExtraClasses(array("extra-custom-class") );
```
`setHeader`: this method setup the header of the file, the only parameter is an array that contains the data of each ``.
Setting header is optional, if not setted the header won't be shown.
Example:
```PHP
$table = new BootstrapTable();
$table->setHeader(array("First header column data") );
```
`addRows`: add a row of data to the table. Accepts two params: the fist is the array of data, the second is an array of custom css classes to add to the `` tag.
Example:
```PHP
$table = new BootstrapTable();
$table->addRows(array("First data column data"), array("custom-class1") );
```
#### Dynamic Size
Keep in mind that you dont have to set the size of the table, you can add as many rows as you want
and the table size will adjust automatically!
#### Printing the table
When you're done setting up you table you can just do `echo $table` and you'll see the table as html.
If you prefer you can get the html string of the table instead with the `table->getHtml()` method.