Ferreteria/v0.5/menu: Difference between revisions

From Woozle Writes Code
Jump to navigation Jump to search
No edit summary
No edit summary
 
(7 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{fmt/title|Ferreteria 0.5: menu system}}
'''Related''': {{l/ver|@cls/menu}}, {{l/ferreteria/|v0.4/file/menu}}
==About==
==About==
Menus in Ferreteria are static HTML which use URL data to convey state-changes. Many of the same classes and code are also used for isolated action-links which can be placed anywhere on a page, as appropriate (e.g. "[recalculate]", "[void]").
Menus in Ferreteria are static HTML which use URL data to convey state-changes. Many of the same classes and code are also used for isolated action-links which can be placed anywhere on a page, as appropriate (e.g. "[recalculate]", "[void]").
==Changes from v0.4==
==Classes==
The code for adding a menu entry to a section-header used to look like this:
* {{l/ver/class|menu/Nav}}
<syntaxhighlight lang=php>
==Pages==
        $oag = \fcHeaderMenuGroup::CreateCollection();
* [[/refactor]]: changes from v0.4
          $oag->ChoiceKey()->SetIt('do');
          $oag->BasePath()->SetIt($urlSelf);
         
          // create & configure settings for "edit" menu item
          $oa = \fcMenuOptionLink::CreateCollection();
            $oag->CopyValuesTo($oa);
            $oa->ChoiceValue()->SetIt('edit');
            $oa->Popup()->SetIt('edit this invoice');
            // create edit menu item object
            $ol = new \fcMenuOptionLink($oa);
            // add it to the menu group
            $oGrp->SetNode($ol);
 
          // create & configure settings for "empty the invoice" menu item
          $oa = \fcMenuOptionLink::CreateCollection();
            $oag->CopyValuesTo($oa);
            $oa->ChoiceValue()->SetIt('empty');
            $oa->Popup()->SetIt('remove all lines from this invoice');
            // create edit menu item object
            $ol = new \fcMenuOptionLink($oa);
            // add it to the menu group
            $oGrp->SetNode($ol);
</syntaxhighlight>
The v0.5 methodology looks like this:
<syntaxhighlight lang=php>
        $oMenu = caApp::Me()->GetHeaderMenu();
        // create & configure settings for "[add] => create new permission" menu item
          $ol = new \fcMenuOptionLink;
          $oa =  $ol->GetArgPod();
            $oa->BasePath()->SetIt($this->LinkURL());      // base URL to prefix all output URLs
            $oa->ChoiceKey()->SetIt('do');                // name of option group to which this option belongs
            $oa->ChoiceValue()->SetIt('add');              // value of key for this action
            $oa->Popup()->SetIt('create new permission');  // (optional) hover-over text
          $doAdd = $ol->GetIsSelected();
          $oMenu->AddTwig($ol);
</syntaxhighlight>
Changes:
* We now create the MenuOptionLink object directly, rather than spawning it using a static function.
* The function name for adding the Link to a parent object has changed from SetNode() to AddTwig().
** In the v0.4 example, the parent is a Group object; in the v0.5 example, it's a HeaderMenu object.

Latest revision as of 14:14, 30 June 2022

Ferreteria 0.5: menu system

Related: @cls/menu, v0.4/file/menu

About

Menus in Ferreteria are static HTML which use URL data to convey state-changes. Many of the same classes and code are also used for isolated action-links which can be placed anywhere on a page, as appropriate (e.g. "[recalculate]", "[void]").

Classes

Pages

Retrieved from "https://wooz.dev/mw/index.php?title=Ferreteria/v0.5/menu&oldid=3095"