ngartifex menu

ADAPTABLES menu is a library for angular

See demo

Example code

Getting Started

To get started, let's install the package through npm:

Choose the version corresponding to your Angular version:

| Angular | @ngartifex/menu-admin | | ------- | -------------------- | | 13 | 4.x | | 12 | 3.x | | 11 | 2.x | | 10 | 1.x |

npm i @ngartifex/menu-admin --S

Install peer dependencies

npm i
@ngartifex/responsive
@ngartifex/ngrx-actions
@ngartifex/perfect-scrollbar
@ngartifex/core
perfect-scrollbar
@ngrx/store
@ngx-translate/core --S

Configuration

• First, you have to configure the library @ngx-translate/core to have the translation into the menu

The library is configured as follows:

import { TranslateModule, TranslateLoader } from '@ngx-translate/core';
import { HttpClient, HttpClientModule } from '@angular/common/http';
import { TranslateHttpLoader } from '@ngx-translate/http-loader';

export function createTranslateLoader(http: HttpClient) {
    return new TranslateHttpLoader(http, './assets/i18n/', '.json');
}
@NgModule({
    imports: [
        HttpClientModule,
        TranslateModule.forRoot({
            loader: {
                provide: TranslateLoader,
                useFactory: (createTranslateLoader),
                deps: [HttpClient]
            }
        })
    ]
})
export class AppModule { }

• To obtain more information about @ngx-translate/core view link

• ngartifex menu uses the library ngrx as a base, you have to set this library in your AppModule as follows:

import { ResponsiveModule } from '@ngartifex/responsive';
@NgModule({
    imports: [
        StoreModule.forRoot(...your configuration),
        EffectsModule.forRoot([]),
        ResponsiveModule // important
    ],
})
export class AppModule { }

• To obtain more information about ngrx view link

How to use?

• First, you have to create a module and import MenuModule as follows:

import { MenuModule } from '@ngartifex/menu';
@NgModule({
  imports: [MenuModule]
  declarations: [MenuComponent]
})
export class YourModule { }


// component
import { MenuModel, MenuHeaderModel, MenuUserModel } from '@ngartifex/menu';
@Component(
    ...
)
export class MenuComponent {
    // variable to show the links of the menu
    menus: MenuModel[] = [
    {
        id: '1',
        class: 'material-icons',
        value: 'dashboard',
        title: 'menu.dashboard',
        isOpen: false,
        multiOption: false,
        url: '/admin/dashboard',
        exact: true,
    },
    {
        id: '2',
        class: 'material-icons',
        value: 'chrome_reader_mode',
        title: 'menu.forms',
        isOpen: false,
        multiOption: true,
        exact: true,
        children: [
            {
                id: '3',
                value: 'BF',
                title: 'menu.form.basicForm',
                isOpen: false,
                multiOption: false,
                url: '/admin/forms/basic-form',
                exact: true
            }
        ]
    }]

    // header of the menu
    header: MenuHeaderModel = {
        companyName: 'ngartifex',
        logoUrl: 'assets/images/logo/addaptables.svg'
    };

    // user data
    user: MenuUserModel = {
        initialName: 'Cf',
        fullName: 'ngartifex',
        email: '[email protected]',
        avatarUrl: 'assets/images/avatars/Velazquez.jpg'
    };
}

• So now you can use the variables into the html as follows

<ngartifex-menu>
  <menu-header [header]="header">
  </menu-header>
  <menu-user [user]="user">
  </menu-user>
  <menu-items-link [menus]="menus">
  </menu-items-link>
</ngartifex-menu>

• In cellphone mode you can use the following component to collapse the menu

    <button-mobile></button-mobile>

• Finally, it is important to import the styles to the application

@import '~@ngartifex/core/ngartifex-grid.theme';
@import '~@angular/material/theming';
@import '~@ngartifex/menu/_ngartifex-menu.theme.scss';

$app-primary: mat-palette($mat-teal, 800);
$ngartifex-app-accent:  mat-palette($mat-pink, 800, A100, 100);
$ngartifex-app-warn: mat-palette($mat-red);
$ngartifex-app-theme: mat-light-theme($ngartifex-app-primary, $ngartifex-app-accent, $ngartifex-app-warn);
$ngartifex-theme-variables: (
    text: white,
    transition-time: 250ms,
    border-radius: 5px
);
@include mat-core();
body.theme-default {
    @include angular-material-theme($ngartifex-app-theme);
    @include menu($ngartifex-app-theme, $ngartifex-theme-variables);
}

• Do not forget to put the theme-default class on the html body

<body class="theme-default"></body>

Assets

Background menu sidebar

/assets/images/backgrounds/sidebar.jpg