AppBar documentation (#1749)

* docs(appbar): overview and docs structure * docs(appbar): position article * docs(appbar): sections article * docs(appbar): separators article * docs(appbar): use the correct snippet in the separators article * docs(appbar): appearance article * docs(appbar): add the component to the config file * Update components/appbar/overview.md Co-authored-by: Dimo Dimov <961014+dimodi@users.noreply.github.com> * docs(appbar): remove the position step from overview * Update components/appbar/overview.md Co-authored-by: Dimo Dimov <961014+dimodi@users.noreply.github.com> * Update components/appbar/overview.md Co-authored-by: Dimo Dimov <961014+dimodi@users.noreply.github.com> * Update components/appbar/overview.md Co-authored-by: Dimo Dimov <961014+dimodi@users.noreply.github.com> * Update components/appbar/overview.md Co-authored-by: Dimo Dimov <961014+dimodi@users.noreply.github.com> * Update components/appbar/appearance.md Co-authored-by: Dimo Dimov <961014+dimodi@users.noreply.github.com> * Update components/appbar/position.md Co-authored-by: Dimo Dimov <961014+dimodi@users.noreply.github.com> * Update components/appbar/position.md Co-authored-by: Dimo Dimov <961014+dimodi@users.noreply.github.com> * docs(appbar): link the API from AppBar parameters * Update components/appbar/sections.md Co-authored-by: Dimo Dimov <961014+dimodi@users.noreply.github.com> * Update components/appbar/sections.md Co-authored-by: Dimo Dimov <961014+dimodi@users.noreply.github.com> * Update components/appbar/sections.md Co-authored-by: Dimo Dimov <961014+dimodi@users.noreply.github.com> * docs(appbar): beautify the snippet in the overview article * docs(appbar): move the class, width, and height to style table * docs(appbar): fix the next steps * Update components/appbar/separators.md Co-authored-by: Dimo Dimov <961014+dimodi@users.noreply.github.com> * Update components/appbar/separators.md Co-authored-by: Dimo Dimov <961014+dimodi@users.noreply.github.com> * Update components/appbar/separators.md Co-authored-by: Dimo Dimov <961014+dimodi@users.noreply.github.com> * docs(appbar): use singular in both columns * docs(appbar): improve positions article * docs(appbar): imrpove Spacer docs * Update components/appbar/overview.md Co-authored-by: Yordan <60105689+yordan-mitev@users.noreply.github.com> * Update components/appbar/overview.md Co-authored-by: Yordan <60105689+yordan-mitev@users.noreply.github.com> * Update components/appbar/separators.md Co-authored-by: Yordan <60105689+yordan-mitev@users.noreply.github.com> * Update components/appbar/separators.md Co-authored-by: Yordan <60105689+yordan-mitev@users.noreply.github.com> * Update components/appbar/separators.md Co-authored-by: Yordan <60105689+yordan-mitev@users.noreply.github.com> * Update components/appbar/separators.md Co-authored-by: Yordan <60105689+yordan-mitev@users.noreply.github.com> * Update components/appbar/overview.md Co-authored-by: Yordan <60105689+yordan-mitev@users.noreply.github.com> --------- Co-authored-by: Dimo Dimov <961014+dimodi@users.noreply.github.com> Co-authored-by: Yordan <60105689+yordan-mitev@users.noreply.github.com>
telerik · Nov 14, 2023 · 775f7e4 · 775f7e4
1 parent a26985a
commit 775f7e4
Show file tree

Hide file tree

Showing 6 changed files with 410 additions and 0 deletions.
diff --git a/_config.yml b/_config.yml
@@ -266,6 +266,8 @@ navigation:
         title: "Spreadsheet"
      "*gauges/arc":
         title: "Arc"
+     "*appbar":
+        title: "AppBar"
      "*autocomplete":
         title: "AutoComplete"
      "*avatar":
@@ -603,6 +605,7 @@ intro_columns:
   -
     title: "Layout"
     items:
+      "AppBar": "appbar-overview"
       "Animation Container": "components/animationcontainer/overview"
       "Card": "card-overview"
       "Carousel": "carousel-overview"

diff --git a/components/appbar/appearance.md b/components/appbar/appearance.md
@@ -0,0 +1,86 @@
+---
+title: Appearance
+page_title: AppBar Appearance
+description: Appearance settings of the AppBar for Blazor.
+slug: appbar-appearance
+tags: telerik,blazor,appbar,navbar,appearance
+published: True
+position: 35
+---
+
+# Appearance Settings
+
+This article outlines the available AppBar parameters, which control its appearance.
+
+## ThemeColor
+
+You can change the color of the AppBar by setting the `ThemeColor` parameter to a member of the `Telerik.Blazor.ThemeConstants.AppBar.ThemeColor` class:
+
+| Class members | Manual declarations |
+|---------------|--------|
+| `Base` | `base`   |
+| `Primary` | `primary`|
+| `Secondary` | `secondary`|
+| `Tertiary` | `tertiary`|
+| `Info` | `info`   |
+| `Success` | `success`|
+| `Warning` | `warning`|
+| `Error` | `error`  |
+| `Dark` | `dark`   |
+| `Light` | `light`  |
+| `Inverse` | `inverse`|
+
+>caption The built-in AppBar colors
+
+````CSHTML
+<TelerikDropDownList Data="@ThemeColors" @bind-Value="@SelectedColor" Width="150px"></TelerikDropDownList>
+
+<TelerikAppBar ThemeColor="@SelectedColor">
+    <AppBarSection>
+        <span>Our Logo</span>
+    </AppBarSection>
+
+    <AppBarSpacer Size="25%"></AppBarSpacer>
+
+    <AppBarSection>
+        <span>Our Products</span>
+    </AppBarSection>
+
+    <AppBarSpacer Size="50px"></AppBarSpacer>
+
+    <AppBarSection>
+        <span>Our Mission</span>
+    </AppBarSection>
+
+    <AppBarSpacer></AppBarSpacer>
+
+    <AppBarSection>
+        <TelerikSvgIcon Icon="@SvgIcon.User"></TelerikSvgIcon>
+    </AppBarSection>
+
+    <AppBarSeparator></AppBarSeparator>
+
+    <AppBarSection>
+        <TelerikSvgIcon Icon="@SvgIcon.Logout"></TelerikSvgIcon>
+    </AppBarSection>
+</TelerikAppBar>
+
+@code {
+    private string SelectedColor { get; set; } = "base";
+
+    private List<string> ThemeColors { get; set; } = new List<string>()
+    {
+        "base",
+        "primary",
+        "secondary",
+        "tertiary",
+        "info",
+        "success",
+        "warning",
+        "error",
+        "dark",
+        "light",
+        "inverse"
+    };
+}
+````
diff --git a/components/appbar/overview.md b/components/appbar/overview.md
@@ -0,0 +1,131 @@
+---
+title: Overview
+page_title: AppBar Overview
+description: Discover the AppBar component for Blazor. Learn how to add the component to your app and explore its features like sections, dividers, positioning, and various styling options.
+slug: appbar-overview
+tags: telerik,blazor,appbar,navbar
+published: True
+position: 0
+---
+
+# Blazor AppBar Overview
+
+The <a href = "https://www.telerik.com/blazor-ui/appbar" target="_blank">Blazor AppBar component</a> helps you build navigation bars for your application seamlessly. This article explains how to start using the component and describes its features.
+
+## Creating Blazor AppBar
+
+1. Add the `<TelerikAppBar>` tag to a Razor file.
+1. Use the `<AppBarSection>` child tag to add content to the AppBar component.
+1. (optional) Use [spacers or separators](#content-dividers) to add visual distinction between the sections in the AppBar.
+
+>caption Basic configuration of the Telerik AppBar
+
+````CSHTML
+<TelerikAppBar>
+    <AppBarSection>
+        <span>Company Logo</span>
+    </AppBarSection>
+
+    <AppBarSpacer></AppBarSpacer>
+
+    <AppBarSection>
+        <span>Our Products</span>
+    </AppBarSection>
+
+    <AppBarSeparator></AppBarSeparator>
+
+    <AppBarSection>
+        <span>Our Mission</span>
+    </AppBarSection>
+
+    <AppBarSeparator></AppBarSeparator>
+
+    <AppBarSection>
+        <span>Contact Us</span>
+    </AppBarSection>
+
+    <AppBarSpacer></AppBarSpacer>
+
+    <AppBarSection>
+        <TelerikSvgIcon Icon="@SvgIcon.User"></TelerikSvgIcon>
+    </AppBarSection>
+
+    <AppBarSeparator></AppBarSeparator>
+
+    <AppBarSection>
+        <TelerikSvgIcon Icon="@SvgIcon.Logout"></TelerikSvgIcon>
+    </AppBarSection>
+</TelerikAppBar>
+````
+
+## AppBar Sections
+
+Use the AppBar Sections to render arbitrary HTML content to match the UI and UX needs of your application. [Read more about the Blazor AppBar sections...]({%slug appbar-sections%})
+
+## Content Dividers
+
+The AppBar features separators and spacers that can visually divide the component items. [Read more about the Blazor AppBar separators and spacers.]({%slug appbar-separators%}).
+
+## Positioning
+
+You can control the position of the AppBar and how the component behaves according to the flow of the page. [Read more about the Blazor AppBar positioning.]({%slug appbar-position%}).
+
+## AppBar Parameters
+
+The Blazor AppBar provides parameters to configure the component. Also check the [AppBar API Reference](/blazor-ui/api/Telerik.Blazor.Components.TelerikAppBar) for a full list of properties.
+
+@[template](/_contentTemplates/common/parameters-table-styles.md#table-layout)
+
+| Parameter | Type | Description |
+| ----------- | ----------- | ----------- |
+| `Position` | `AppBarPosition` <br /> (`None`) | The position of the AppBar on the page. [Read more about AppBar positioning.]({%slug appbar-position%}) |
+| `PositionMode` | `AppBarPosition` <br /> (`Static`) | Sets how the AppBar is positioned according to the flow of the document. [Read more about AppBar positioning.]({%slug appbar-position%}) |
+
+### Styling and Appearance
+
+The following parameters enable you to customize the appearance of the Blazor AppBar:
+
+| Parameter | Type | Description |
+| --- | --- | --- |
+| `Class` | `string` | The CSS class to be rendered on the main wrapping element of the AppBar component, which is `<div class="k-appbar">`. Use for [styling customizations]({%slug themes-override%}). |
+| `Height` | `string` | The height of the AppBar. |
+| `ThemeColor` | `Telerik.Blazor.ThemeConstants.AppBar.ThemeColor` | Adjust the color of the AppBar |
+| `Width` | `string` | The width of the AppBar. |
+
+You can find more information for customizing the AppBar appearance in the [Appearance article]({%slug appbar-appearance%}).
+
+## AppBar Reference and Methods
+
+To execute AppBar methods, obtain reference to the component instance with `@ref`.
+
+| Method  | Description |
+|---------|-------------|
+| `Refresh` | Use the method to programmatically re-render the AppBar. |
+
+<div class="skip-repl"></div>
+
+````CSHTML
+<TelerikButton OnClick="@RefreshAppBar">Refresh AppBar</TelerikButton>
+
+<TelerikAppBar @ref="AppBarRef" />
+
+@code {
+	private TelerikAppBar AppBarRef { get; set; }
+
+	private void RefreshAppBar()
+	{
+		AppBarRef.Refresh();
+	}
+}
+````
+
+## Next Steps
+
+* [Explore the AppBar Sections]({%slug appbar-sections%})
+* [Use the AppBar Sections]({%slug appbar-separators%})
+* [Customize the AppBar position]({%slug appbar-position%})
+
+## See Also
+
+* [Live AppBar Demos](https://demos.telerik.com/blazor-ui/appbar/overview)
+* [AppBar API Reference](/blazor-ui/api/Telerik.Blazor.Components.TelerikAppBar)
diff --git a/components/appbar/position.md b/components/appbar/position.md
@@ -0,0 +1,41 @@
+---
+title: Position
+page_title: AppBar Position
+description: Position settings of the AppBar for Blazor.
+slug: appbar-position
+tags: telerik,blazor,appbar,navbar,position
+published: True
+position: 35
+---
+
+# Position Settings
+
+This article outlines the available AppBar parameters, which control its position.
+
+>note Read the [CSS positioning MDN documentation article](https://developer.mozilla.org/en-US/docs/Web/CSS/position) to get a better understanding of how the AppBar component positioning works.
+
+## Position
+
+The `Position` parameter accepts a member of the `AppBarPosition` enum and sets the `top` and `bottom` CSS properties:
+
+| Enum member | Description |
+|---------------|--------|
+| `None` <br /> (default) | Does not set any values for the `top` and `bottom` CSS properties. |
+| `Top` | Sets the `top: 0` and `bottom: auto` CSS properties. |
+| `Bottom`   | Sets the `top: auto` and `bottom: 0` CSS properties. | 
+
+>info The `Position` parameter takes effect when used with fixed [PositionMode](#positionmode).
+
+## PositionMode
+
+The `PositionMode` parameter accepts a member of the `AppBarPositionMode` enum and sets how the AppBar is positioned according to the [flow of the document](https://developer.mozilla.org/en-US/docs/Learn/CSS/CSS_layout/Normal_Flow):
+
+| Enum member | Description |
+|---------------|--------|
+| `Static` <br /> default value   | The AppBar displays at the position where it is defined and scrolls together with the other page content. |
+| `Fixed` | The AppBar displays at a fixed place, which depends on the `Position` parameter. The component doesn't scroll with the other page content. |
+| `Sticky`   | The AppBar displays at the position where it is defined. It scrolls together with the other page content, until it reaches the top of the browser viewport. Then the component will remain there. Use the `Sticky` `PositionMode` together with `Top` `Position` .| 
+
+## See Also
+
+  * [Live Demo: AppBar Position](https://demos.telerik.com/blazor-ui/appbar/position)
diff --git a/components/appbar/sections.md b/components/appbar/sections.md
@@ -0,0 +1,59 @@
+---
+title: Sections
+page_title: AppBar - Sections
+description: Add Content in the AppBar Component
+slug: appbar-sections
+tags: telerik,blazor,appbar,sections,section,content
+published: True
+position: 1
+---
+
+# Sections
+
+The `<AppBarSection>` is a template-based component that allows you to render HTML content or Razor components in the AppBar component.
+
+>note Render content only inside the `<AppBarSection>` tag, otherwise it will display outside the AppBar component.
+
+## AppBar Section Parameters
+
+The nested `AppBarSection` tag exposes parameters:
+
+| Parameter | Type and Default Value | Description |
+| ----------- | ----------- | ----------- |
+| `Class` | `string` | The CSS class that will be rendered on the main wrapping element of the AppBar section. You could use that class to cascade styles. |
+| `Visible` | `bool` <br /> (`true`) | Specifies if the section will be visible in the AppBar. |
+
+>caption The Telerik AppBar sections with its parameter
+
+````CSHTML
+@* The AppBar sections with its parameters *@
+
+<style>
+    .products-section-class {
+        font-weight: bolder;
+    }
+</style>
+
+<TelerikButton OnClick="@(() => isSectionVisible = !isSectionVisible)">Toggle the visibility of the Our Mission section</TelerikButton>
+
+<br />
+
+<TelerikAppBar>
+    <AppBarSection Class="products-section-class">
+        <span>Our Products</span>
+    </AppBarSection>
+
+    <AppBarSection Visible="@isSectionVisible">
+        <span>Our Mission</span>
+    </AppBarSection>
+</TelerikAppBar>
+
+@code{
+    private bool isSectionVisible { get; set; } = true;
+}
+````
+
+## See Also
+
+  * [Live Demo: AppBar Overview](https://demos.telerik.com/blazor-ui/appbar/overview)
+  * [AppBar Overview]({%slug appbar-overview%})