diff --git a/docs/30_Page/20_Navigation.md b/docs/30_Page/20_Navigation.md index 2b4daa9ea14addb8e1bb774b28b98e3e69ccbfca..e1aad06399d0426d17ab0cae81447b947adc4c24 100644 --- a/docs/30_Page/20_Navigation.md +++ b/docs/30_Page/20_Navigation.md @@ -72,4 +72,20 @@ $aReplace['{{NAVI_LEFT}}']='' 'nav', ['class'=>'mt-2'], $renderAdminLTE->getSidebarNavigation($aSidebarNav) ); -``` \ No newline at end of file +``` + +### Navigation hacks + +#### Sidebar + +To render a horizontal line in the sidebar menu, add a navigation item with label '-' + +```php +$aSidebarNav[]=['href'=>'#', 'label'=>'-']; +``` + +In your css file add a rule: + +```css +.nav-item hr{color: #505860; border-top: 1px solid; height: 1px; padding: 0; margin: 0; } +``` diff --git a/docs/50_Forms/Select.md b/docs/50_Forms/Select.md new file mode 100644 index 0000000000000000000000000000000000000000..415a7f312baf18ebb6511bff41847cc410531e1a --- /dev/null +++ b/docs/50_Forms/Select.md @@ -0,0 +1,75 @@ +## Select + +Draw aselect box with option fields + +### Syntax + +```php +$renderAdminLTE->getFormSelect($aOptions); +``` + +### Return + +{string} html code + +### Parameters + +* $aOptions - {array} options to describe the element + +Option fields: + +Key | Description +--- | --- +options | List of option tags<br> - value - value in the option<br> - label - visible text in the option<br>other keys are attributes in the option + +Styling for select tag: + +Key | Description +--- | --- +class | optional: additional css classes +size | optional: visible option lines + +Content: + +Key | Description +--- | --- +name | name attribute for sending form data +value | value of the input field/ visible text; for checkbox and radio: the data to send when sending a form + +### Example + +#### Simple select box + +```php +$renderAdminLTE->getFormSelect(array +( + 'label' => 'Select contact', + 'name' => 'contact', + 'tag' => 'select', + 'size' => 1, + 'options' => [ + ['value' => '', 'label' => 'select'], + ['value' => '1', 'label' => 'Tom'], + ['value' => '2', 'label' => 'Dick', 'selected' => 1 ], + ['value' => '3', 'label' => 'Harry'], + ], +)); +``` + +You get a label, an select box wrapped in a ``<div class="form-group row">``. + +```html +<div class="form-group row"> + <label for="contact-39c4c14176af359d95e81c45078f27f3" class="col-sm-2 col-form-label">Select contact</label> + <div class="col-sm-10"> + <div class="form-group"> + <select name="contact" tag="select" size="1" class="form-control "> + <option value="">select</option> + <option value="1">Tom</option> + <option value="2" selected="1">Dick</option> + <option value="3">Harry</option> + </select> + </div> + </div> +</div> +```