class atk4\ui\Button

Implements a clickable button:

$button = $view->add(new \atk4\ui\Button('Click me'));

Button will typically inherit all same properties of a View. Functionality of View alone yields in many various usage patterns such as:

$b1 = new Button(['Load', 'primary']);

$button = new Button('Hello there');
$button->addClass('size big');


property atk4\ui\Button::$icon

Includes icon on the button:

$bar = new Buttons('vertical');  // NOTE: class called Buttons, not Button
$bar->add(new Button(['Play', 'icon'=>'play']));
$bar->add(new Button(['Pause', 'icon'=>'pause']));
$bar->add(new Button(['Shuffle', 'icon'=>'shuffle']));

Icon can also be specified as object:

$b1 = new Button(['Forks', 'blue', 'icon'=>new Icon('fork'));
property atk4\ui\Button::$iconRight

Setting this will display icon on the right of the button:

$b1 = new Button(['Next', 'iconRight'=>'right arrow']);

Apart from being on the right, same rules apply as Button::$icon. Both icons cannot be specified simultaniously.


Will link button to a destination URL or page:

// or
$button->link(['details', 'id'=>123]);

If array is used, it’s routed to App::url

For other JavaScript actions you can use JavaScript Mapping:

$button->js('click', new jsExpression('document.location.reload()'));

Complex Buttons

Knowledge of Semantic UI button (http://semantic-ui.com/elements/button.html) can help you in creating more complex buttons:

$forks = new Button(['labeled'=> true]); // Button, not Buttons!
$forks->add(new Button(['Forks', 'blue']))->add(new Icon('fork'));
$forks->add(new Label(['1,048', 'basic blue left pointing']));