Condividi tramite

Visualizzare il contenuto markdown

Precedente: Risultati comando

Finora è stato illustrato solo come visualizzare un elenco di comandi in un controllo ListPage. Tuttavia, è anche possibile visualizzare contenuti avanzati nell'estensione, ad esempio markdown. Può essere utile per visualizzare la documentazione o un'anteprima di un documento.

Uso del contenuto markdown

IContentPage (e l'implementazione del toolkit ContentPage) è la base per la visualizzazione di tutti i tipi di contenuto avanzato nel riquadro comandi. Per visualizzare il contenuto markdown, è possibile usare la classe MarkdownContent .

Come esempio semplice, è possibile creare la pagina seguente:

Annotazioni

Se si lavora dalle sezioni precedenti, modificare il codice seguente da MarkdownPage a <ExtensionName>Page.

public class MarkdownPage : ContentPage
{
    public MarkdownPage()
    {
        Icon = IconHelpers.FromRelativePath("Assets\\StoreLogo.png");
        Title = "Markdown page";
    }

    public override IContent[] GetContent()
    {
        return [
            new MarkdownContent("# Hello, world!\n This is a **markdown** page."),
        ];
    }
}

In questo esempio viene creata una nuova proprietà MarkdownPage che visualizza una semplice stringa markdown. La classe MarkdownContent accetta una stringa di contenuto markdown ed esegue il rendering nel riquadro comandi.

È anche possibile aggiungere più blocchi di contenuto a una pagina. Ad esempio, è possibile aggiungere due blocchi di contenuto markdown:

public override IContent[] GetContent()
{
    return [
        new MarkdownContent("# Hello, world!\n This is a **markdown** page."),
        new MarkdownContent("## Second block\n This is another block of content."),
    ];
}

In questo modo è possibile combinare diversi tipi di contenuto in una singola pagina.

Aggiunta di comandi

È anche possibile aggiungere comandi a contentPage. In questo modo è possibile aggiungere altri comandi da richiamare dall'utente, mentre nel contesto del contenuto. Ad esempio, se si dispone di una pagina che visualizza un documento, è possibile aggiungere un comando per aprire il documento in Esplora file:


public class MarkdownExamplePage : ContentPage
{
    public MarkdownExamplePage()
    {
        Icon = new("\uE8A5"); // Document icon
        Title = "Markdown page";
        Name = "Preview file";

        Commands = [
            new CommandContextItem(new OpenUrlCommand("C:\\Path\\to\\file.txt")) { Title = "Open in File Explorer" },
        ];
    }
    public override IContent[] GetContent()
    {
        return [
            new MarkdownContent("# Hello, world!\n This is a **markdown** document.\nI live at `C:\\Path\\to\\file.txt`"),
        ];
    }
}

Passaggio successivo: Ottenere l'input dell'utente con i moduli

Contenuti correlati