BootstrapBlazor实战 Markdown 编辑器使用

基础工程使用工程: B08. BootstrapBlazor实战 Menu 导航菜单使用

实战BootstrapBlazorMenu Markdown 编辑器使用, 以及整合Freesql orm快速制作菜单项数据库后台维护页面

BootstrapBlazor 是 Bootstrap 风格的 Blazor UI 组件库 基于 Bootstrap 样式库精心打造，并且额外增加了 100 多种常用的组件，为您快速开发项目带来非一般的感觉

demo演示的是Sqlite驱动,FreeSql支持多种数据库，MySql/SqlServer/PostgreSQL/Oracle/Sqlite/Firebird/达梦/神通/人大金仓/翰高/华为GaussDB/MsAccess

1.Markdown 编辑器简介

提供 Markdown 语法支持的文本编辑器

https://www.blazor.zone/markdowns

Nuget 包安装

使用 nuget.org 进行 BootstrapBlazor.Markdown 组件的安装

.NET CLI

dotnet add package BootstrapBlazor.Markdown

示例

<p>输入 <code>Markdown</code> 相关代码后，点击下方相关区域显示数据</p>
<div style="width: 100%; height: 300px;">
    <Markdown @bind-Value="@MarkdownString" @bind-Html="@HtmlString" />
</div>
<div class="mt-3">
    <textarea class="form-control" rows="6" disabled="disabled">
        @MarkdownString
    </textarea>
</div>
<div class="mt-3">
    <textarea class="form-control" rows="6" disabled="disabled">
        @HtmlString
    </textarea>
</div>

@code{
 private string? MarkdownString { get; set; } ="### 测试";
 private string? HtmlString { get; set; }
}

参数	说明	类型	可选值	默认值
Height	控件高度	int	—	300
MinHeight	控件最小高度	int	—	200
InitialEditType	初始化时显示的界面	InitialEditType	Markdown/Wysiwyg	Markdown
PreviewStyle	预览模式	PreviewStyle	Tab/Vertical	Vertical
Language	UI 语言	string	—	—
Placeholder	提示信息	string	—	—
IsViewer	是否为纯浏览模式	bool	true/false	false
IsDark	是否为暗黑模式	bool	true/false	false
EnableHighlight	是否启用代码高亮	bool	true/false	false

更多例子参考 https://www.blazor.zone/markdowns

2.实战

打开工程 "BootstrapBlazor实战 Menu 导航菜单使用" , 添加 Markdown 库 BootstrapBlazor.Markdown

dotnet add b08Menu/BootstrapBlazorApp.Shared package BootstrapBlazor.Markdown

注:由于模板使用了共享库,双出Server和WebAssembly工程,我们这里只使用Server工程做演示.

3.左侧菜单加入页面编辑功能导航

在BootstrapBlazorApp.Shared/Shared/MainLayout.razor.cs文件加入代码

//在 Menus = fsql.Select<WebPages>().OrderBy(a => a.Code)之前加入代码
if (fsql.Select<WebPages>().Where(a => a.PageName == "页面编辑").Count() == 0)
{
    fsql.Insert(new WebPages("页面编辑", "editpages", "fa fa-gears", "002_004")).ExecuteAffrows();
}

运行BootstrapBlazorApp.Server工程,截图如下

4.实体类加入 Markdown 字段

在BootstrapBlazorApp.Shared/Data/WebPages.cs文件加入代码

    /// <summary>
    /// Markdown内容
    /// </summary>
    [Required(ErrorMessage = "{0}不能为空")]
    [AutoGenerateColumn(Visible = false)]
    [DisplayName("Markdown内容")]
    [Column(StringLength = -2)]
    public string? Markdown { get; set; } = "";

    /// <summary>
    /// Html内容
    /// </summary>
    [Required(ErrorMessage = "{0}不能为空")]
    [AutoGenerateColumn(Visible = false)]
    [DisplayName("Html内容")]
    [Column(StringLength = -2)]
    public string? Html { get; set; } = "";

5.页面编辑功能

新建BootstrapBlazorApp.Shared/Pages/EditPages.razor文件

@page "/editpages"
@attribute [TabItemOption(Text = "页面编辑")]
@using System.Diagnostics.CodeAnalysis

<PageTitle>页面编辑</PageTitle>

<div class="row">
    <div class="col-6 col-sm-6">
        <Select TValue="string" Color="Color.Primary" Items="GroupItems()" OnSelectedItemChanged="OnItemChanged">
        </Select>
    </div>
    <div class="col-2 col-sm-2">
        <Button Text="保存" OnClickWithoutRender="Save" Color="Color.Primary" />
    </div>
</div>

@if (TpvPage != null)
{
    <div class="row">
        <h5 class="m-3">页面说明</h5>
        <div style="width: 100%; height: 500px;">

            <Markdown Height="500" MinHeight="300" PreviewStyle="PreviewStyle.Tab" InitialEditType="InitialEditType.Wysiwyg" Language="@Language" @bind-Value="@TpvPage.Markdown" @bind-Html="@TpvPage.Html" />
        </div>
    </div>
}

code如下, 代码应该比较简单,关键点注释在程序里面

@code {

    /// <summary>
    /// 获取并设置Markdown语言
    /// </summary>
    private string? Language { get; set; }

    [Inject]
    [NotNull]
    private ToastService? ToastService { get; set; }

    /// <summary>
    /// 注入fsql服务
    /// </summary>
    [Inject]
    [NotNull]
    IFreeSql? fsql { get; set; }

    [NotNull]
    List<WebPages>? Items { get; set; } = new List<WebPages>();

    [NotNull]
    WebPages? TpvPage { get; set; }

    protected override void OnInitialized()
    {
        Language = CultureInfo.CurrentUICulture.Name;
    }

    protected override void OnAfterRender(bool firstRender)
    {
        if (firstRender)
        {
            //读取页面数据,显示第一页到编辑器
            Items = fsql.Select<WebPages>().OrderBy(a => a.Code).ToList();
            TpvPage = Items?.First();
            StateHasChanged();
        }
    }

    Task Save()
    {
        var res = fsql.Update<WebPages>().SetSource(TpvPage).ExecuteAffrows();
        if (res > 0)
        {
            ToastService.Success("保存成功");
        }
        return Task.CompletedTask;
    }

    /// <summary>
    /// Select 组件数据源
    /// </summary>
    /// <returns></returns>
    private IEnumerable<SelectedItem> GroupItems()
    {
        if (Items == null)
        {
            return new List<SelectedItem>();
        }
        var list = new List<SelectedItem>();
        foreach (var item in Items)
        {
            list.Add(new SelectedItem() { Value = item.Code ?? "", Text = item.PageName ?? "", GroupName = item.ParentCode ?? "" });
        }
        return list;
    }

    /// <summary>
    /// 下拉选项改变时调用此方法
    /// </summary>
    /// <param name="item"></param>
    private Task OnItemChanged(SelectedItem item)
    {
        TpvPage = Items.Where(a => a.Code == item.Value).First();
        System.Console.WriteLine($"SelectedItem Text: {item.Text} Value: {item.Value} Selected");
        StateHasChanged();
        return Task.CompletedTask;
    }
}

运行BootstrapBlazorApp.Server工程,截图如下

6.加入两个演示页面

在BootstrapBlazorApp.Shared/Shared/MainLayout.razor.cs文件加入代码

//在 Menus = fsql.Select<WebPages>().OrderBy(a => a.Code)之前加入代码

if (fsql.Select<WebPages>().Where(a => a.PageName == "关于我们").Count() == 0)
{
    fsql.Insert(new WebPages("关于我们", "AboutUs", "fa fa-gears", "006")).ExecuteAffrows();
    fsql.Insert(new WebPages("隐私政策", "PrivacyPolicy", "fa fa-gears", "007")).ExecuteAffrows();
}

运行BootstrapBlazorApp.Server工程, 打开页面编辑, 下拉选择隐私政策 , 写入Markdown代码试试

## **本隐私政策将帮助您了解以下内容：**

1. 如何收集和使用您的个人信息
2. 如何共享、转让、公开披露您的个人信息

截图如下

7.新建展示页面 Htmls.razor

新建BootstrapBlazorApp.Shared/Pages/Htmls.razor文件

@page "/{PageName}"
<PageTitle>@(TpvPage?.PageName??"Home")</PageTitle>
<div style="background-color:white">
    @if (TpvPage != null)
    {
        <Markdown Value="@TpvPage.Markdown" IsViewer="true" />
    }
    else
    {
        <p>您访问的页面不存在</p>
    }
</div>

8.新建展示页面代码 Htmls.razor.cs

新建BootstrapBlazorApp.Shared/Pages/Htmls.razor.cs文件

using BootstrapBlazor.Components;
using BootstrapBlazorApp.Shared.Data;
using Microsoft.AspNetCore.Components;
using System.Diagnostics.CodeAnalysis;
using System.Globalization;

namespace BootstrapBlazorApp.Shared.Pages;

/// <summary>
///
/// </summary>
public partial class Htmls
{
    [Parameter]
    public string? PageName { get; set; }

    [Parameter]
    public string? Language { get; set; }

    [Inject]
    [NotNull]
    private ToastService? ToastService { get; set; }

    [Inject]
    [NotNull]
    IFreeSql? fsql { get; set; }

    [NotNull]
    WebPages? TpvPage { get; set; }

    string? pageName;

    protected override void OnInitialized()
    {
        Language = CultureInfo.CurrentUICulture.Name;
    }

    protected override void OnAfterRender(bool firstRender)
    {
        PageName ??= "Index";
        if (firstRender || pageName != PageName)
        {
            TpvPage = fsql.Select<WebPages>().Where(a => a.Url == PageName).First();
            pageName = PageName;
            StateHasChanged();
        }
    }

}

运行BootstrapBlazorApp.Server工程, 打开隐私政策, 截图如下

9.总结

Blazor 这个新鲜事物, 加上 BootstrapBlazor 组件库 100 多种常用的组件，真的可以为您快速开发项目带来非一般的感觉, 一起试试吧.

项目源码

Github | Gitee

关联项目

FreeSql QQ群：4336577(已满)、8578575(已满)、52508226(在线)

BA & Blazor QQ群：795206915、675147445

知识共享许可协议

本作品采用 知识共享署名-非商业性使用-相同方式共享 4.0 国际许可协议 进行许可。欢迎转载、使用、重新发布，但务必保留文章署名AlexChow（包含链接： https://github.com/densen2014 ），不得用于商业目的，基于本文修改后的作品务必以相同的许可发布。如有任何疑问，请与我联系 。

AlexChow

今日头条 | 博客园 | 知乎 | Gitee | GitHub