Přidání About boxu do Blazor aplikace

Živá ukázka

Toto je About box samotné aplikace AboutTheApp. Přepnutím varianty uvidíte další podoby. Kód níže zobrazí přesně tento box. Pro svou aplikaci v něm změňte alias.

<script src="https://aboutthe.app/embed/web/0.3.5/card.js" integrity="sha384-X3VGSEdTNGsfVKfVUx7sq9ICfpWsJW88HDQYidGPio1KjoxYCbSirTNqtbVfq1sj" crossorigin="anonymous" async></script>

<about-the-app alias="aboutthe.app" variant="card" api-base="https://aboutthe.app/api/v1" visual-style="default" palette="default" appearance="auto"></about-the-app>

Přidání do Blazor aplikace ve 3 krocích

About box je Web Component, který prohlížeč vykreslí po načtení stránky. Funguje stejně v Blazor Server, Blazor WebAssembly i v Blazor Web App.

1. 1

   Vytvořte si produkt

   Vytvořte ho v AboutTheApp a poznamenejte si jeho alias. V panelu Integrovat na kartě produktu najdete stejný kód jako v živé ukázce, už s vaším aliasem.

2. 2

   Načtěte skript

   Vložte skript do Components/App.razor v Blazor Web App (.NET 8 a novější), do wwwroot/index.html v samostatném Blazor WebAssembly nebo do Pages/_Host.cshtml v Blazor Server na .NET 7 a starším.

3. 3

   Umístěte prvek

   Vložte <about-the-app alias="aboutthe.app"></about-the-app> do MainLayout.razor nebo do jiné komponenty.

@inherits LayoutComponentBase

<main>@Body</main>

<footer>
    <about-the-app alias="aboutthe.app" variant="footer" version="@AppVersion"></about-the-app>
</footer>

@code {
    private static readonly string AppVersion =
        typeof(Program).Assembly.GetName().Version?.ToString(3) ?? "";
}

Verze sestavení

Verze sestavení vychází z vlastnosti Version v souboru .csproj. ToString(3) ponechá tři části, takže box ukáže 1.4.2 místo 1.4.2.0.

Pokud místo ní použijete informační verzi, počítejte s tím, že .NET 8 SDK k ní za znak plus přidává hash commitu, například 1.4.2+3f2a1c9. Poznámky k vydání se zobrazí jen při přesné shodě s katalogem verzí produktu, proto používejte na obou místech stejný formát. Pokud si nejste jistí, jaký formát zvolit, přečtěte si článek Verzování aplikací.

Výběr podoby a vzhledu

Podobu určuje atribut variant: card (výchozí), footer, compact, dialog, support, version, maker, credits nebo link. Každou si můžete vyzkoušet v živé ukázce výše.

Pokud nastavíte visual-style="host" a palette="host", box převezme písmo, zaoblení a barvy z vaší aplikace. Atribut appearance přepíná mezi světlým, tmavým a automatickým režimem podle nastavení systému.

Časté otázky