first commit

2026-05-18 15:53:59 +03:30
commit 2c100028a1
534 changed files with 94240 additions and 0 deletions
@@ -0,0 +1,149 @@
+# SbBanner
+
+A prominent message bar for important announcements or alerts that spans the full width of its container. Supports multiple severity levels, custom actions, and dismissible behavior.
+
+## Parameters
+
+| Parameter | Type | Default | Description |
+|-----------|------|---------|-------------|
+| Title | string? | null | Banner title displayed prominently |
+| Message | string? | null | Banner message text (used when ChildContent is not provided) |
+| Severity | SbBannerSeverity | Info | Banner severity (Info, Success, Warning, Error) |
+| Dismissible | bool | true | Whether the banner can be dismissed |
+| Class | string? | null | Additional CSS classes |
+
+## Events
+
+| Event | Type | Description |
+|-------|------|-------------|
+| OnDismiss | EventCallback | Fired when the banner is dismissed |
+
+## Templates / Slots
+
+| Slot | Type | Description |
+|------|------|-------------|
+| ChildContent | RenderFragment? | Custom content for the banner message (takes precedence over Message) |
+| Actions | RenderFragment? | Action buttons displayed at the bottom of the banner |
+
+### Template Usage
+
+#### Basic Content
+
+```razor
+<SbBanner Title="Notice" Severity="SbBannerSeverity.Info">
+    This is custom content inside the banner.
+</SbBanner>
+```
+
+#### With Actions
+
+```razor
+<SbBanner Title="Update Available" Severity="SbBannerSeverity.Info">
+    <ChildContent>
+        A new version is available. Would you like to update now?
+    </ChildContent>
+    <Actions>
+        <SbButton Variant="SbButtonVariant.Ghost" Size="SbSize.Sm">Later</SbButton>
+        <SbButton Size="SbSize.Sm">Update Now</SbButton>
+    </Actions>
+</SbBanner>
+```
+
+## Methods
+
+| Method | Return Type | Description |
+|--------|-------------|-------------|
+| Show() | void | Shows the banner after it has been dismissed |
+
+## CSS Classes
+
+- `sb-banner` - Base class
+- `sb-banner--info` - Info severity
+- `sb-banner--success` - Success severity
+- `sb-banner--warning` - Warning severity
+- `sb-banner--error` - Error severity
+- `sb-banner__header` - Header row container
+- `sb-banner__header-start` - Icon and title container
+- `sb-banner__icon` - Icon container
+- `sb-banner__title` - Title text
+- `sb-banner__close` - Close button
+- `sb-banner__content` - Content/message area
+- `sb-banner__message` - Message text
+- `sb-banner__actions` - Actions container
+
+## Accessibility
+
+- Uses `role="alert"` for important announcements
+- Close button has `aria-label="Dismiss"`
+
+## Examples
+
+### Basic Banners
+
+```razor
+<SbBanner Title="Information" Message="This is an informational banner." />
+
+<SbBanner Title="Success" 
+          Message="Your changes have been saved."
+          Severity="SbBannerSeverity.Success" />
+
+<SbBanner Title="Warning" 
+          Message="Your session will expire in 5 minutes."
+          Severity="SbBannerSeverity.Warning" />
+
+<SbBanner Title="Error" 
+          Message="Failed to connect to the server."
+          Severity="SbBannerSeverity.Error" />
+```
+
+### Non-Dismissible Banner
+
+```razor
+<SbBanner Title="System Maintenance"
+          Message="Scheduled maintenance tonight at 10 PM."
+          Severity="SbBannerSeverity.Warning"
+          Dismissible="false" />
+```
+
+### With Custom Content and Actions
+
+```razor
+<SbBanner Title="New Feature" Severity="SbBannerSeverity.Info">
+    <ChildContent>
+        <p>We've added dark mode support! Try it out in your settings.</p>
+    </ChildContent>
+    <Actions>
+        <SbButton Variant="SbButtonVariant.Ghost" Size="SbSize.Sm" OnClick="Dismiss">
+            Maybe Later
+        </SbButton>
+        <SbButton Size="SbSize.Sm" OnClick="GoToSettings">
+            Go to Settings
+        </SbButton>
+    </Actions>
+</SbBanner>
+```
+
+### Handling Dismiss
+
+```razor
+<SbBanner @ref="bannerRef"
+          Title="Welcome!"
+          Message="Thanks for joining us."
+          OnDismiss="HandleDismiss" />
+
+<SbButton OnClick="ShowBanner">Show Banner Again</SbButton>
+
+@code {
+    private SbBanner? bannerRef;
+    
+    private void HandleDismiss()
+    {
+        Console.WriteLine("Banner was dismissed");
+    }
+    
+    private void ShowBanner()
+    {
+        bannerRef?.Show();
+    }
+}
+```