Class ilSplitButton. More...

Inheritance diagram for ilSplitButtonGUI:

Collaboration diagram for ilSplitButtonGUI:

Public Member Functions
	addMenuItem (ilSplitButtonMenuItem $menu_item)

	removeMenuItem (ilSplitButtonMenuItem $menu_item)

	hasMenuItems ()

	getMenuItems ()

	setMenuItems ($menu_items)

	getDefaultButton ()

	hasDefaultButton ()

	setDefaultButton (ilButtonBase $default_button)

	render ()

Public Member Functions inherited from ilButtonBase
	__clone ()
	Clone instance. More...

	getType ()
	Get button type. More...

	setId ($a_value)
	Set id. More...

	getId ()
	Get id. More...

	setCaption ($a_value, $a_is_lng_id=true)
	Set caption. More...

	getCaption ($a_translate=true)
	Get caption. More...

	setPrimary ($a_value)
	Toggle primary status. More...

	isPrimary ()
	Get primary status. More...

	setOmitPreventDoubleSubmission ($a_value)
	Toggle double submission prevention status. More...

	getOmitPreventDoubleSubmission ()
	Get double submission prevention status. More...

	setOnClick ($a_value)
	Set onclick. More...

	getOnClick ()
	Get onclick. More...

	setAccessKey ($a_value)
	Set access key. More...

	getAccessKey ()
	Get access key. More...

	setDisabled ($a_value)
	Toggle disabled status. More...

	isDisabled ()
	Get disabled status. More...

	addCSSClass ($a_value)
	Add CSS class. More...

	getCSSClasses ()
	Get CSS class(es) More...

	applyDefaultCss ($apply_default_css=null)

	render ()
	Render HTML. More...

	getToolbarHTML ()

Static Public Member Functions
static	getInstance ()

Static Public Member Functions inherited from ilButtonBase
static	getInstance ()
	Factory. More...

Protected Attributes
	$lng

	$default_button

	$menu_items = array()

Protected Attributes inherited from ilButtonBase
	$lng

	$type

	$id

	$caption

	$caption_is_lng_id

	$primary

	$omit_prevent_double_submission

	$onclick

	$acc_key

	$disabled

	$css = array()

	$apply_default_css = true

Additional Inherited Members
Data Fields inherited from ilButtonBase
const	TYPE_SUBMIT = 1

const	TYPE_LINK = 2

const	TYPE_SPLIT = 3

const	TYPE_BUTTON = 4

Protected Member Functions inherited from ilButtonBase
	__construct ($a_type)
	Constructor. More...

	setType ($a_value)
	Set button type. More...

	gatherCssClasses ()
	Gather all active CSS classes. More...

	renderAttributesHelper (array $a_attr)
	Render HTML node attributes. More...

	renderAttributes (array $a_additional_attr=null)
	Render current HTML attributes. More...

	prepareRender ()
	Prepare render. More...

Detailed Description

Class ilSplitButton.

Author: Michael Jansen mjans.nosp@m.en@d.nosp@m.ataba.nosp@m.y.de

Definition at line 14 of file class.ilSplitButtonGUI.php.

Member Function Documentation

◆ addMenuItem()

ilSplitButtonGUI::addMenuItem ( ilSplitButtonMenuItem $menu_item )

Parameters

ilSplitButtonMenuItem $menu_item

Definition at line 59 of file class.ilSplitButtonGUI.php.

     {
         $this->menu_items[] = $menu_item;
     }

◆ getDefaultButton()

ilSplitButtonGUI::getDefaultButton ( )

Returns: ilButtonBase

Definition at line 112 of file class.ilSplitButtonGUI.php.

References $default_button.

Referenced by render().

     {
         return $this->default_button;
     }

Here is the caller graph for this function:

◆ getInstance()

static ilSplitButtonGUI::getInstance ( )

static

Returns: self;

Definition at line 51 of file class.ilSplitButtonGUI.php.

Referenced by ilRepositorySearchGUI\fillAutoCompleteToolbar(), ilPortfolioPageTableGUI\fillRow(), ilObjForumGUI\getForumObjects(), assClozeTestGUI\populateQuestionSpecificFormPart(), and ilObjForumGUI\renderSplitButton().

     {
         return new self(self::TYPE_SPLIT);
     }

Here is the caller graph for this function:

◆ getMenuItems()

ilSplitButtonGUI::getMenuItems ( )

Returns: ilSplitButtonMenuItem[]

Definition at line 86 of file class.ilSplitButtonGUI.php.

References $menu_items.

Referenced by render().

     {
         return $this->menu_items;
     }

Here is the caller graph for this function:

◆ hasDefaultButton()

ilSplitButtonGUI::hasDefaultButton ( )

Returns: boolean

Definition at line 120 of file class.ilSplitButtonGUI.php.

Referenced by render().

     {
         return ($this->default_button instanceof ilButtonBase);
     }

Here is the caller graph for this function:

◆ hasMenuItems()

ilSplitButtonGUI::hasMenuItems ( )

Returns: boolean

Definition at line 78 of file class.ilSplitButtonGUI.php.

Referenced by render().

     {
         return count($this->menu_items) > 0;
     }

Here is the caller graph for this function:

◆ removeMenuItem()

ilSplitButtonGUI::removeMenuItem ( ilSplitButtonMenuItem $menu_item )

Parameters

ilSplitButtonMenuItem $menu_item

Definition at line 67 of file class.ilSplitButtonGUI.php.

References $key.

     {
         $key = array_search($menu_item, $this->menu_items);
         if ($key !== false) {
             unset($this->menu_items[$key]);
         }
     }

◆ render()

ilSplitButtonGUI::render ( )

Returns: string

Exceptions

ilSplitButtonException

Definition at line 137 of file class.ilSplitButtonGUI.php.

References $tpl, getDefaultButton(), getMenuItems(), hasDefaultButton(), hasMenuItems(), and ilButtonBase\isPrimary().

     {
         $tpl = new ilTemplate('tpl.split_button.html', true, true, 'Services/UIComponent/SplitButton');
 
         if (!$this->hasDefaultButton()) {
             throw new ilSplitButtonException(
                 "Cannot render a split button without a default button"
             );
         }
 
         $tpl->setVariable('DEFAULT_ITEM_CONTENT', $this->getDefaultButton()->render());
         if ($this->hasMenuItems()) {
             $btn_classes = $this->getDefaultButton()->getCSSClasses();
             if ($this->getDefaultButton()->isPrimary()) {
                 $btn_classes[] = 'btn-primary';
             }
             $tpl->setVariable('BTN_CSS_CLASS', implode(' ', $btn_classes));
 
             foreach ($this->getMenuItems() as $item) {
                 if ($item instanceof ilSplitButtonSeparatorMenuItem) {
                     $tpl->setCurrentBlock('separator');
                     $tpl->touchBlock('separator');
                     $tpl->parseCurrentBlock();
                 } else {
                     $tpl->setCurrentBlock('item');
                     $tpl->setVariable('CONTENT', $item->getContent());
                     $tpl->parseCurrentBlock();
                 }
 
                 $tpl->setCurrentBlock('items');
                 $tpl->parseCurrentBlock();
             }
 
             $tpl->setVariable('TXT_TOGGLE_DROPDOWN', $this->lng->txt('toggle_dropdown'));
         }
 
         return $tpl->get();
     }

Here is the call graph for this function:

◆ setDefaultButton()

ilSplitButtonGUI::setDefaultButton ( ilButtonBase $default_button )

Parameters

ilButtonBase $default_button

Definition at line 128 of file class.ilSplitButtonGUI.php.

References $default_button.

     {
         $this->default_button = $default_button;
     }

◆ setMenuItems()

ilSplitButtonGUI::setMenuItems ( $menu_items )

Parameters

ilSplitButtonMenuItem[] $menu_items

Exceptions

ilSplitButtonException

Definition at line 95 of file class.ilSplitButtonGUI.php.

References $menu_items.

     {
         array_walk($menu_items, function (&$item, $idx) {
             if (!($item instanceof ilSplitButtonMenuItem)) {
                 throw new ilSplitButtonException(sprintf(
                     "Cannot set menu items, element at index '%s' is not of type 'ilSplitButtonItem'",
                     $idx
                 ));
             }
         });
 
         $this->menu_items = $menu_items;
     }

Field Documentation

◆ $default_button

ilSplitButtonGUI::$default_button

protected

Definition at line 24 of file class.ilSplitButtonGUI.php.

Referenced by getDefaultButton(), and setDefaultButton().

◆ $lng

ilSplitButtonGUI::$lng

protected

Definition at line 19 of file class.ilSplitButtonGUI.php.

◆ $menu_items

ilSplitButtonGUI::$menu_items = array()

protected

Definition at line 29 of file class.ilSplitButtonGUI.php.

Referenced by getMenuItems(), and setMenuItems().

The documentation for this class was generated from the following file:

Services/UIComponent/SplitButton/classes/class.ilSplitButtonGUI.php

Public Member Functions

Static Public Member Functions

Protected Attributes

Additional Inherited Members

Detailed Description

Member Function Documentation

◆ addMenuItem()

◆ getDefaultButton()

◆ getInstance()

◆ getMenuItems()

◆ hasDefaultButton()

◆ hasMenuItems()

◆ removeMenuItem()

◆ render()

◆ setDefaultButton()

◆ setMenuItems()

Field Documentation

◆ $default_button

◆ $lng

◆ $menu_items