Fukicycle.Tool.AppBase 1.0.2

Fukicycle.Tool.AppBase

This library provides blazor app base function. For example, error handling, display loading and display dialog.

Happy coding 😃

Features

1. Provides application base function.

Installing and Getting started

1. install package.

Fukicycle.Tool.AppBase is available for download and installation as NuGet packages.

dotnet add package Fukicycle.Tool.AppBase --version <version>

2. Create your app.

1. Add using Fukicycle.Tool.AppBase (_Imports.razor_)

2. If you use other components, you have to add bellow namespace.

   • Fukicycle.Tool.AppBase.Components
   • Fukicycle.Tool.AppBase.Components.Dialog
   • Fukicycle.Tool.AppBase.Store

3. Register service. (Program.cs)

    builder.Services.AddAppBase();
   

4. Change LayoutComponentBase to AppBaseLayoutComponentBase (MainLayout.razor)

    - @inherits LayoutComponentBase
    + @inherits AppBaseLayoutComponentBase
   
    @Body
   

5. If you want to use default loader and dialog, you have to add bellow. (MainLayout.razor)

    @inherits AppBaseLayoutComponentBase
   
    @Body
   
    @if (StateContainer.IsLoading)
    {
        <Loader /> @/* 👈 You can change your loader component */
    }
    @if (StateContainer.DialogContent != null)
    {
        <Dialog /> @/* 👈 You can change your dialog component */
    }
   

6. Finally, let each page inherit ViewBase and you're done! 😃

    @page "/"
    @inherits ViewBase
    <h1>Hello, world!</h1>
   

7. Use Execute or ExecuteAsync to execute code while handling errors.

    @page "/"
    @inherits ViewBase
    <h1>Hello, world!</h1>
    <div>Members</div>
    @if(_members != null)
    {
    	@foreach (string member in _members)
    	{
    		<div>@member</div>
    	}
    }
   
    @if(_skills != null)
    {
    	@foreach (string skill in _skills)
    	{
    		<div>@skill</div>
    	}
    }
    @code {
        private List<string>? _members = null;
        private List<string>? _skills = null;
        protected override async Task OnInitializedAsync()
        {
            //loader
            _skills = await ExecuteAsync(GetSkillsAsync, true);
   
            //no loader
            _members = Execute(GetMembers);
        }
   
        private List<string> GetMembers()
        {
            if (Random.Shared.Next() % 2 == 0) throw new Exception("Something broke!!!");
            return new List<string>
            {
                "fukicycle",
                "you",
                "other"
            };
        }
   
        private async Task<List<string>> GetSkillsAsync()
        {
            await Task.Delay(3000);
            return new List<string>
            {
                "C#",
                "Kotlin",
                "Java",
                "Blazor"
            };
        }
   
    }
   

Contributing

Pull requests and stars are always welcome. Contributions are what make the open source community such an amazing place to be learn, inspire, and create.
Any contributions you make are greatly appreciated.

1. Fork the Project.
2. Create your Feature Branch(git checkout -b feature/amazing_feature).
3. Commit your Changes(git commit -m 'Add some changes').
4. Push to the Branch(git push origin feature/amazing_feature).
5. Open a Pull Request.

Author

• fukicycle

License

MIT. Click here for details.