Skip to content

Commit

Permalink
[Docs] Better column distribution for homepage (#2360)
Browse files Browse the repository at this point in the history
- Better column distibution for homepage
  • Loading branch information
vnbaaij authored Jul 11, 2024
1 parent 1e581d0 commit 1ebdde8
Show file tree
Hide file tree
Showing 4 changed files with 29 additions and 12 deletions.
2 changes: 1 addition & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@

## Introduction

The `Microsoft.FluentUI.AspNetCore.Components` package provides a set of [Blazor](https://blazor.net) components which are used to build applications that have a Fluent design (i.e. have the look and feel or modern Microsoft applications).
The `Microsoft.FluentUI.AspNetCore.Components` package provides a set of [Blazor](https://blazor.net) components which are used to build applications that have a Fluent design (i.e. have the look and feel of modern Microsoft applications).

Some of the components in the library are wrappers around Microsoft's official Fluent UI Web Components. Others are components that leverage the Fluent Design System or make it easier to work with Fluent UI. To get up and running with the library, see the **Getting Started** section below.

Expand Down
28 changes: 20 additions & 8 deletions examples/Demo/Shared/Pages/Home/Home.razor
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@


<FluentGrid Class="home" Justify="JustifyContent.FlexStart" Spacing="6">
<FluentGridItem xs="12" sm="6">
<FluentGridItem xs="12" sm="12" md="6">
<h1>Welcome!</h1>
<p>
The Fluent UI Blazor library provides a robust and extensive set of <a href="https://blazor.net">Blazor</a> components. Some of those
Expand All @@ -25,7 +25,7 @@
</p>

</FluentGridItem>
<FluentGridItem xs="12" sm="6">
<FluentGridItem xs="12" sm="12" md="6">
<div class="demopanel" style="margin: 1rem 0; padding: 1.5rem; text-align: center">
<p>This is the demo and documentation site for version <strong>@_version</strong> of the library. This version supports .NET 8 <strong>only</strong> </p>
<br />
Expand All @@ -40,8 +40,20 @@
If you are already up-and-running and upgrading from an earlier version of the library, please go to the <a href="/WhatsNew">What's new</a> page
for information on additions, fixes and (breaking) changes.
</p>
<h2 id="interactivity">Components & render modes</h2>
<p>
As described in the <a href="https://learn.microsoft.com/en-us/aspnet/core/blazor/components/render-modes?view=aspnetcore-8.0" target="_blank"> Blazor documentation</a>:
</p>
<blockquote>
By default, components use Static Server-side rendering (SSR). The component renders to the response stream and there is no interactivity.
</blockquote>
<p>
A component inherits its render mode from its parent. So unless a render mode is specified on the app, page or component level, every
component (including ours) is <em>statically rendered</em> on the server and <strong>will not be interactive</strong>. For the
Fluent UI Blazor library this means most components will display correctly but <strong>will not offer</strong> complete, if any, functionality.
</p>
</FluentGridItem>
<FluentGridItem xs="12" sm="6">
<FluentGridItem xs="12" sm="12" md="6">
<h2 id="getting-started">Getting Started</h2>
<p>
By far rhe easiest way to get started is by using our templates. Setting them up is quick and easy. See the <a href="/Templates">templates</a> page
Expand All @@ -60,7 +72,7 @@
</p>
</FluentGridItem>

<FluentGridItem xs="12" sm="6">
<FluentGridItem xs="12" sm="12" md="6">
<h3>Scripts</h3>
<p>
As mentioned, we wrap the Fluent UI Web Components for some of our compnents. The needed script is included in the library and will
Expand All @@ -86,7 +98,7 @@
</p>
</FluentGridItem>

<FluentGridItem xs="12" sm="8">
<FluentGridItem xs="12" sm="12" md="8" >
<h2 id="using-the-fluentui-web-components">Using the Fluent UI Blazor components</h2>
<p>With the package installed, you can begin using the Fluent UI Blazor components in the same way as any other Blazor component. Just be sure to add the following using statement to your views:</p>
<CodeSnippet>@@using Microsoft.FluentUI.AspNetCore.Components</CodeSnippet>
Expand Down Expand Up @@ -114,7 +126,7 @@
</ChildContent>
</DemoSection>
</FluentGridItem>
<FluentGridItem xs="12" sm="4">
<FluentGridItem xs="12" sm="12" md="4">
<h2 id="configuring-the-design-system">Configuring the Design System</h2>
<p>
The Fluent UI Blazor components are built on FAST's Adaptive UI technology, which enables design customization and personalization, while
Expand All @@ -127,7 +139,7 @@

</FluentGridItem>

<FluentGridItem xs="12" sm="6">
<FluentGridItem xs="12" sm="12" md="6">
<h2 id="support">Support</h2>
<p>
The Microsoft Fluent UI Blazor library is an open-source project. The source code (including this demo site) is hosted in the <a href="https://github.com/microsoft/fluentui-blazor">fluentui-blazor</a>
Expand All @@ -141,7 +153,7 @@
</p>
</FluentGridItem>

<FluentGridItem xs="12" sm="6">
<FluentGridItem xs="12" sm="12" md="6">
<h2 id="joining-the-community">Joining the Community</h2>
<p>
Looking to get answers to questions or engage with us in real-time?
Expand Down
2 changes: 1 addition & 1 deletion examples/Demo/Shared/Shared/DemoMainLayout.razor
Original file line number Diff line number Diff line change
Expand Up @@ -36,7 +36,7 @@
<div class="links">
<FluentAnchor Appearance="Appearance.Hypertext"
Href="http://github.com/microsoft/fluentui-blazor" Target="_blank" Rel="noreferrer noopener"
title="FluentUI Blazor source on GitHub" aria-label="FluentUI Blazor Repo">
title="Fluent UI Blazor library source on GitHub" aria-label="Fluent UI Blazor library source on GitHub">
<FluentIcon Value="@(new DemoIcons.Size20.GitHub())" Color="Color.FillInverse" />
</FluentAnchor>
</div>
Expand Down
9 changes: 7 additions & 2 deletions examples/Demo/Shared/wwwroot/css/site.css
Original file line number Diff line number Diff line change
Expand Up @@ -399,14 +399,19 @@ kbd {
}
}

@media (min-width: 768px) and (max-width: 1024px) {
@media (min-width: 768px) and (max-width: 1279px) {
fluent-select::part(control) {
width: 150px;
}
.content {
flex-direction: column;
}

aside {
padding: 1.5em 0.75em 1em 0.75em;
width: 12rem;
width: 100%;
height: 100%!important;
max-height: 100% !important;
}

article {
Expand Down

0 comments on commit 1ebdde8

Please sign in to comment.