Skip to content

Latest commit

 

History

History
98 lines (64 loc) · 2.54 KB

accordion.md

File metadata and controls

98 lines (64 loc) · 2.54 KB
Raw

:::{php:namespace} Atk4\Ui :::

:::{php:class} Accordion :::

Accordion

Accordion implement another way to organize your data. The implementation is based on: https://fomantic-ui.com/modules/accordion.html.

Demo: https://ui.atk4.org/demos/interactive/accordion.php

Basic Usage

Once you create an Accordion container you can then mix and match static and dynamic accodion section:

$acc = Accordion::addTo($app);

Adding a static content section is pretty simple:

LoremIpsum::addTo($acc->addSection('Static Tab'));

You can add multiple elements into a single accordion section, like any other view.

:::{php:method} addSection($name, $action = null, $icon = 'dropdown') :::

Use addSection() method to add more section in an Accordion view. First parameter is a title of the section.

Section can be static or dynamic. Dynamic sections use {php:class}VirtualPage implementation mentioned above. You should pass Closure action as a second parameter.

Example:

$t = Accordion::addTo($layout);

// add static section
HelloWorld::addTo($t->addSection('Static Content'));

// add dynamic section
$t->addSection('Dynamically Loading', function (VirtualPage $vp) {
    LoremIpsum::addTo($vp);
});

Dynamic Accordion Section

Dynamic sections are based around implementation of {php:class}VirtualPage and allow you to pass a callback which will be triggered when user clicks on the section title.:

$acc = Accordion::addTo($app);

// dynamic section
$acc->addSection('Dynamic Lorem Ipsum', function (VirtualPage $vp) {
    LoremIpsum::addTo($vp, ['size' => 2]);
});

Controlling Accordion Section via Javascript

Accordion class has some wrapper method in order to control the accordion module behavior.

:::{php:method} jsOpen($section, $action = null) :::

:::{php:method} jsToggle($section, $action = null) :::

:::{php:method} jsClose($section, $action = null) :::

For example, you can set a button that, when clicked, will toggle an accordion section:

$button = Button::addTo($bar, ['Toggle Section 1']);

$acc = Accordion::addTo($app, ['type' => ['styled', 'fluid']]);
$section1 = LoremIpsum::addTo($acc->addSection('Static Text'));
$section2 = LoremIpsum::addTo($acc->addSection('Static Text'));

$button->on('click', $acc->jsToggle($section1));

Accordion Module settings

It is possible to change Accordion module settings via the settings property.:

Accordion::addTo($app, ['settings' => []]);

For a complete list of all settings for the Accordion module, please visit: https://fomantic-ui.com/modules/accordion.html#/settings