An enhanced side navigation menu styled for bootstrap (sub repo split from yii2-widgets)
Clone or download
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
assets Initial release Nov 9, 2014
CHANGE.md Initial release Nov 9, 2014
LICENSE.md Initial release Nov 9, 2014
README.md Update project status badges Apr 21, 2015
SideNav.php Initial release Nov 9, 2014
SideNavAsset.php Initial release Nov 9, 2014
composer.json Revert minimum stability for master Nov 9, 2014

README.md

yii2-widget-sidenav

Latest Stable Version License Total Downloads Monthly Downloads Daily Downloads

This widget is a collapsible side navigation menu built to seamlessly work with Bootstrap framework. It is built over Bootstrap stacked nav component. This widget class extends the Yii Menu widget. Upto 3 levels of submenus are by default supported by the CSS styles to balance performance and useability. You can choose to extend it to more or less levels by customizing the CSS.

NOTE: This extension is a sub repo split of yii2-widgets. The split has been done since 08-Nov-2014 to allow developers to install this specific widget in isolation if needed. One can also use the extension the previous way with the whole suite of yii2-widgets.

Installation

The preferred way to install this extension is through composer. Check the composer.json for this extension's requirements and dependencies. Read this web tip /wiki on setting the minimum-stability settings for your application's composer.json.

To install, either run

$ php composer.phar require kartik-v/yii2-widget-sidenav "*"

or add

"kartik-v/yii2-widget-sidenav": "*"

to the require section of your composer.json file.

Latest Release

NOTE: The latest version of the module is v1.0.0 released on 08-Nov-2014. Refer the CHANGE LOG for details.

Demo

You can refer detailed documentation and demos on usage of the extension.

Usage

use kartik\sidenav\SideNav;
     
echo SideNav::widget([
	'type' => SideNav::TYPE_DEFAULT,
	'heading' => 'Options',
	'items' => [
		[
			'url' => '#',
			'label' => 'Home',
			'icon' => 'home'
		],
		[
			'label' => 'Help',
			'icon' => 'question-sign',
			'items' => [
				['label' => 'About', 'icon'=>'info-sign', 'url'=>'#'],
				['label' => 'Contact', 'icon'=>'phone', 'url'=>'#'],
			],
		],
	],
]);

License

yii2-widget-sidenav is released under the BSD 3-Clause License. See the bundled LICENSE.md for details.