mirror of https://github.com/xfarrow/phpxpress.git
12c171577d | ||
---|---|---|
bootstrap-5.1.3-dist | ||
examples | ||
phpxpress | ||
README.md |
README.md
phpxpress
PhpXpress' goal is to create a simple way to programmatically manage Bootstrap elements. It's similar to Microsoft's WebForms with a great layout by default (like DevExpress).
Available components
- Table
- Card
- Breadcrumb
- Dropdown
Examples
Table
The following code
$employees = array($employee1, $employee2, $employee3);
$table = new Table;
$table->setDataSource($employees);
$table->setCustomCaptions(array("Name", "Surname", "Date of Birth", "Social Security Number")); //not required. If not specified it'll use objects' property names
$table->addColumn("Extra");
$table->onValueDisplaying("onValueDisplaying");
$table->setStripedRows(true);
$table->setBordered(true);
$table->setHoverAnimation(true);
$table->draw();
function onValueDisplaying($caption, &$value, $row){
if($caption == "ssn"){
if($row["ssn"] != "12345")
{
$value = "SSN not shown for privacy reasons";
}
else
{
$value = $row["name"] . " " . $row["surname"] . " agreed to share their ssn (12345)" ;
}
}
else if($caption == "Extra")
{
$value = "This column did not exist in the datasource";
}
}
produces the following output
Card
The follwing code
Card::beginCardGroupLayout(36);
$card1 = new Card;
$card1->setImageSource("colosseum.jpg");
$card1->setTitle("Rome");
$card1->setSubTitle("Capital of Italy");
$card1->setInnerText("After the foundation by Romulus according to a legend, Rome was ruled for a period of 244 years by a monarchical system, initially with sovereigns of Latin and Sabine origin, later by Etruscan kings.");
$card1->setFooterText("Image By John");
$card1->addField("Mayor", "Roberto Gualtieri");
$card1->addField("Inhabitants", "2.763.804");
$card1->AddField("Zip", "001XX");
$card1->setButton("More info", "https://en.wikipedia.org/wiki/Rome");
$card1->draw();
class City{
public $Mayor;
public $Inhabitants;
public $Zip;
}
$paris = new City;
$paris->Mayor = "Anne Hidalgo";
$paris->Inhabitants = "2.229.095";
$paris->Zip = "750XX";
$card2 = new Card;
$card2->setImageSource("paris.jpg");
$card2->setTitle("Paris");
$card2->setSubTitle("Capital of France");
$card2->setInnerText("The following fields' name & data will be acquired by the datasource.");
$card2->setDataSource($paris);
$card2->setButton("More info", "https://en.wikipedia.org/wiki/Paris");
$card2->draw();
Card::endCardGroupLayout();
produces the following output
$card2 receives a DataSource whereas $card1 does not.
Breadcrumb
The follwing code
$links["Github"] = "https://www.github.com";
$links["xfarrow"] = "https://www.github.com/xfarrow";
$links["PhpXpress"] = "https://www.github.com/xfarrow/phoxpress";
$breadcrumb = new BreadCrumb;
$breadcrumb->setDataSource($links);
$breadcrumb->draw();
Produces the following output: