Xeku.Notes.Blazor

Blazor integration module for Xeku.Notes, providing a custom TreeGrid ListView Editor for enhanced note browsing experience.

Features

• Split-View Layout: Category tree on the left, notes grid on the right
• Real-time Filtering: Click a category to instantly filter notes
• XAF-styled Toolbar: Icon buttons (Show All, Expand All, Collapse All)
• Auto Refresh: Data automatically syncs when returning from DetailView

Architecture

graph TB subgraph UI["Presentation Layer"] style UI fill:#e1f5ff Component["NoteTreeGridComponent.razor"] TreeView["DxTreeView (Categories)"] Grid["DxGrid (Notes)"] end subgraph Logic["Service Layer"] style Logic fill:#fff4e1 Editor["NoteTreeGridListEditor"] Model["NoteTreeGridComponentModel"] end subgraph Data["Data Layer"] style Data fill:#e8f5e9 Note["Note"] Category["NoteCategory"] end Component --> Model TreeView --> Component Grid --> Component Editor --> Model Editor --> Note Editor --> Category Model --> Note Model --> Category

Installation

dotnet add package Xeku.Notes.Blazor

Usage

Module Registration

// BlazorModule.cs public sealed class MyBlazorModule : ModuleBase { public MyBlazorModule() { RequiredModuleTypes.Add(typeof(Xeku.Notes.Blazor.NotesBlazorModule)); } }

AI Agent Integration

Use Cases

Scenario	Description
Note Creation	Create notes with category via API
Category Management	Build hierarchical category trees
Content Search	Query notes by category or keywords

API Integration

// Create a note programmatically using var os = Application.CreateObjectSpace(typeof(Note)); var note = os.CreateObject<Note>(); note.Subject = "AI Generated Note"; note.Content = jsonContent; note.Category = os.FindObject<NoteCategory>(c => c.Name == "AI"); os.CommitChanges();

Best Practices

1. Data Isolation: Notes are auto-filtered by Owner field
2. Category Hierarchy: Use NoteCategory.Parent for tree structure
3. : Call after batch operations