component-development
Guidance for creating Blazor components that emulate ASP.NET Web Forms controls. Use this when implementing new components or extending existing ones in the BlazorWebFormsComponents library.
Installation
Pick a client and clone the repository into its skills directory.
Installation
About this skill
Guidance for creating Blazor components that emulate ASP.NET Web Forms controls. Use this when implementing new components or extending existing ones in the BlazorWebFormsComponents library.
How to use
Zidentyfikuj kontrolkę Web Forms z przestrzeni nazw System.Web.UI.WebControls, którą chcesz emulować w Blazorze — ta umiejętność poprowadzi Cię przez cały proces adaptacji.
Zbadaj oczekiwane wyjście HTML, korzystając z dołączonego przewodnika HTML Output Matching Guide, aby upewnić się, że Twój komponent będzie renderować identyczne znaczniki jak oryginalna kontrolka Web Forms.
Utwórz pliki komponentu w strukturze projektu: plik .razor z szablonem oraz plik .razor.cs z logiką, a następnie wybierz odpowiednią klasę bazową — BaseWebFormsComponent dla komponentów podstawowych, BaseStyledComponent jeśli potrzebujesz stylowania, DataBoundComponent dla komponentów powiązanych z danymi, lub BaseValidator dla walidatorów.
Dodaj testy jednostkowe w katalogu dedykowanym komponentowi oraz stronę przykładową w folderze ControlSamples, następnie skonfiguruj testy integracyjne z użyciem Playwright w sekcji testów projektu przykładowego.
Napisz dokumentację komponentu w odpowiedniej kategorii folderu docs i zaktualizuj nawigację — dodaj wpis do TreeView w pliku NavMenu.razor, aby komponent był dostępny dla użytkowników biblioteki.
Przejrzyj pełną listę kontrolną zawartą w umiejętności, aby upewnić się, że wszystkie kroki — od implementacji, przez konwencje nazewnictwa Web Forms, aż po dokumentację — zostały wykonane zgodnie ze standardami BlazorWebFormsComponents.