coksnuss/yii2-cli-layoutbuilder

Allows to render complex ASCII GUI's on console.

yii2-cli-layoutbuilder

Allows to render complex ASCII GUI's on console., _(*1)

What this extension does

This extension can be used to render ASCII based GUI's on console (i.e. without the help of ncurses or similar libraries). It allows to define a GUI in terms of nested frames which can be nested in horizontal or vertical fashion. Such a frame can have a fixed or dynamic size (in terms of console window width/height)., _(*2)

Installation

This extension needs to be included via composer by issuing the following console command within the root directory of your yii2 project:, _(*3)

composer require --prefer-dist "coksnuss/yii2-cli-layoutbuilder"

Thats it. Check the new extension folder to see which classes are available and how to use or extend from them., _(*4)

Usage

Below is some example code to get you started., _(*5)

$frameTop = Yii::createObject(['class' => GuiFrame::className(), 'layout' => GuiFrame::LAYOUT_HORIZONTAL, 'border' => 1]);
$frameTop->addElement('Test1.1');
$frameTop->addElement('Test1.2');
$frameTop->addElement('Test1.3');

$frameBottom = Yii::createObject(['class' => GuiFrame::className(), 'layout' => GuiFrame::LAYOUT_HORIZONTAL]);

$frameLeft = Yii::createObject(['class' => GuiFrame::className(), 'layout' => GuiFrame::LAYOUT_VERTICAL, 'border' => 1]);
$frameLeft->addElement('Left Frame 1.1');
$frameLeft->addElement('Left Frame 1.2');
$frameRight = Yii::createObject(['class' => GuiFrame::className(), 'layout' => GuiFrame::LAYOUT_VERTICAL, 'border' => 1]);
$frameRight->addElement('Right Frame 1.1234567');
$frameRight->addElement('Right Frame 1.2');
$frameRight->addElement('Right Frame 1.3');

$frameBottom->addElement($frameLeft);
$frameBottom->addElement($frameRight);
$gui->addElement($frameTop);
$gui->addElement($frameBottom);

echo $gui->render() . PHP_EOL;