LeptonX Blazor UI
LeptonX theme is implemented and ready to use with ABP. No custom implementation is needed for Blazor Server & WebAssembly.
Installation
Complete the MVC Razor Pages Installation for the HttpApi.Host application first. If the solution is tiered/micro-service, complete the MVC steps for all MVC applications such as HttpApi.Host and if Auth Server is separated, install to the OpenIddict.
Add Volo.Abp.AspNetCore.Components.WebAssembly.LeptonXTheme.Bundling package to your Blazor application with the following command:
Remove Volo.Abp.AspNetCore.Components.WebAssembly.LeptonTheme.Bundling reference from the project since it's not necessary after switching to LeptonX Lite.
Remove the old theme from the DependsOn attribute in your module class and add the AbpAspNetCoreComponentsWebAssemblyLeptonXThemeBundlingModule type to the DependsOn attribute.
Add Volo.Abp.AspNetCore.Components.WebAssembly.LeptonXTheme package to your Blazor.Client application with the following command:
Remove Volo.Abp.AspNetCore.Components.WebAssembly.LeptonTheme reference from the project since it's not necessary after switching to LeptonX Lite.
Remove the old theme from the DependsOn attribute in your module class and add the AbpAspNetCoreComponentsWebAssemblyLeptonXThemeModule type to the DependsOn attribute.
Update Routes.razor
file in Blazor.Client
project as below:
Source-Code
You can download the source-code of the LeptonX Theme according to you your ABP License.
Visit the LeptonX Source Code section to download the source-code.
Customization
Before starting to customize the theme, you can consider downloading the source code of the theme. You can find the original codes of related components below in the source code.
Themes
You can set default theme or add or remove themes via using LeptonXThemeOptions.
DefaultStyle
: Defines deffault fallback theme. Default value is DimStyles
: Defines selectable themes from UI.red.css
andbootstrap-red.css
have to be added under thewwwroot/_content/Volo.Abp.AspNetCore.Components.Web.LeptonXTheme/side-menu/css/
folder to switch to your custom theme properly when selected.If your layout is TopMenu, then you have to add them under the
wwwroot/_content/Volo.Abp.AspNetCore.Components.Web.LeptonXTheme/top-menu/css/
folder.
LeptonXThemeBlazorOptions
Layout options of Blazor UI can be manageable via using LeptonXThemeMvcOptions.
Layout
: Layout of main application. Default value isLeptonXMvcLayouts.SideMenu
MobileMenuSelector
: Defines items to be displayed at mobile menu. Default value is first 2 items from main menu items.
Layouts
LeptonX offers two ready-made layouts for your web application. One of them is placed with the menu items on the top and the other with the menu items on the sides.
Top Menu Layout
Side Menu Layout
You can override layouts by following the steps below:
- Create a razor page, like
MySideMenuLayout.razor
, in your blazor application as shown below:
- If you prefer to use a code-behind file for the C# code of your component, create a razor component, like
MySideMenuLayout.razor.cs
, in your blazor application as shown below:
Don't forget to remove repeated attributes from the razor page!
Common Components
Commonly used components in all layouts.
Breadcrumb
Breadcrumbs can be customized by using the PageLayout
service. See the PageLayout - BreadCrumb section for more information.
If you need to replace the component, you can follow the steps below.
- Create a razor page, like
MyBreadcrumbs.razor
, in your blazor application as shown below:
- If you prefer to use a code-behind file for the C# code of your component, create a razor component, like
MyBreadcrumbs.razor.cs
, in your blazor application as shown below:
Content Toolbar
- Create a razor page, like
MyContentToolbar.razor
, in your blazor application as shown below:
- If you prefer to use a code-behind file for the C# code of your component, create a razor component, like
MyContentToolbar.razor.cs
, in your blazor application as shown below:
General Settings
- Create a razor page, like
MyGeneralSettings.razor
, in your blazor application as shown below:
- If you prefer to use a code-behind file for the C# code of your component, create a razor component, like
MyGeneralSettings.razor.cs
, in your blazor application as shown below:
Mobile General Settings
- Create a razor page, like
MyMobileGeneralSettings.razor
, in your blazor application as shown below:
- If you prefer to use a code-behind file for the C# code of your component, create a razor component, like
MyMobileGeneralSettings.razor.cs
, in your blazor application as shown below:
Side Menu Components
Components used in the side menu layout.
Main Menu
- Create a razor page, like
MyMainMenu.razor
, in your blazor application as shown below:
- If you prefer to use a code-behind file for the C# code of your component, create a razor component, like
MyMainMenu.razor.cs
, in your blazor application as shown below:
Main Menu Item
- Create a razor page, like
MyMainMenuItem.razor
, in your blazor application as shown below:
- If you prefer to use a code-behind file for the C# code of your component, create a razor component, like
MyMainMenuItem.razor.cs
, in your blazor application as shown below:
Mobile Navbar
- Create a razor page, like
MyMobileNavbar.razor
, in your blazor application as shown below:
- If you prefer to use a code-behind file for the C# code of your component, create a razor component, like
MyMobileNavbar.razor.cs
, in your blazor application as shown below:
Main Header
- Create a razor page, like
MyMainHeader.razor
, in your blazor application as shown below:
- If you prefer to use a code-behind file for the C# code of your component, create a razor component, like
MyMainHeader.razor.cs
, in your blazor application as shown below:
Main Header Branding
Application branding can be customized with the IBrandingProvider
. See the Branding section for more information.
If you need to replace the component, you can follow the steps below.
- Create a razor page, like
MyMainHeaderBranding.razor
, in your blazor application as shown below:
- If you prefer to use a code-behind file for the C# code of your component, create a razor component, like
MyMainHeaderBranding.razor.cs
, in your blazor application as shown below:
Main Header Toolbar
The main toolbar can be managed by using the ToolbarContributor
classes. See the Toolbars section for more information.
If you need to replace the component, you can follow the steps below.
- Create a razor page, like
MyMainHeaderToolbar.razor
, in your blazor application as shown below:
- If you prefer to use a code-behind file for the C# code of your component, create a razor component, like
MyMainHeaderToolbar.razor.cs
, in your blazor application as shown below:
Top Menu Components
Components used in the top menu layout.
Main Menu
- Create a razor page, like
MyMainMenu.razor
, in your blazor application as shown below:
- If you prefer to use a code-behind file for the C# code of your component, create a razor component, like
MyMainMenu.razor.cs
, in your blazor application as shown below:
Main Menu Item
- Create a razor page, like
MyMainMenuItem.razor
, in your blazor application as shown below:
- If you prefer to use a code-behind file for the C# code of your component, create a razor component, like
MyMainMenuItem.razor.cs
, in your blazor application as shown below:
Mobile Navbar
- Create a razor page, like
MyMobileNavbar.razor
, in your blazor application as shown below:
- If you prefer to use a code-behind file for the C# code of your component, create a razor component, like
MyMobileNavbar.razor.cs
, in your blazor application as shown below:
Main Header
- Create a razor page, like
MyMainHeader.razor
, in your blazor application as shown below:
- If you prefer to use a code-behind file for the C# code of your component, create a razor component, like
MyMainHeader.razor.cs
, in your blazor application as shown below:
Main Header Branding
Application branding can be customized with the IBrandingProvider
. See the Branding section for more information.
- Create a razor page, like
MyMainHeaderBranding.razor
, in your blazor application as shown below:
- If you prefer to use a code-behind file for the C# code of your component, create a razor component, like
MyMainHeaderBranding.razor.cs
, in your blazor application as shown below:
Main Header Toolbar
The main toolbar can be managed by using the ToolbarContributor
classes. See the Toolbars section for more information.
If you need to replace the component, you can follow the steps below.
- Create a razor page, like
MyMainHeaderToolbar.razor
, in your blazor application as shown below:
- If you prefer to use a code-behind file for the C# code of your component, create a razor component, like
MyMainHeaderToolbar.razor.cs
, in your blazor application as shown below: