DotNetCampus.LightTextEditorPlus.AllInOne.Avalonia 1.0.0-alpha.1

.NET 8.0 This package targets .NET 8.0. The package is compatible with this framework or higher.
This is a prerelease version of DotNetCampus.LightTextEditorPlus.AllInOne.Avalonia. 
dotnet add package DotNetCampus.LightTextEditorPlus.AllInOne.Avalonia --version 1.0.0-alpha.1
                    


                    

                
NuGet\Install-Package DotNetCampus.LightTextEditorPlus.AllInOne.Avalonia -Version 1.0.0-alpha.1
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package. 
<PackageReference Include="DotNetCampus.LightTextEditorPlus.AllInOne.Avalonia" Version="1.0.0-alpha.1" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
<PackageVersion Include="DotNetCampus.LightTextEditorPlus.AllInOne.Avalonia" Version="1.0.0-alpha.1" />
                    


                            Directory.Packages.props
                        

                    

                
<PackageReference Include="DotNetCampus.LightTextEditorPlus.AllInOne.Avalonia" />
                    


                            Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package. 
paket add DotNetCampus.LightTextEditorPlus.AllInOne.Avalonia --version 1.0.0-alpha.1
                    


                    

                
#r "nuget: DotNetCampus.LightTextEditorPlus.AllInOne.Avalonia, 1.0.0-alpha.1"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package. 
#:package DotNetCampus.LightTextEditorPlus.AllInOne.Avalonia@1.0.0-alpha.1
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package. 
#addin nuget:?package=DotNetCampus.LightTextEditorPlus.AllInOne.Avalonia&version=1.0.0-alpha.1&prerelease
                    


                            Install as a Cake Addin
                        

                    

                
#tool nuget:?package=DotNetCampus.LightTextEditorPlus.AllInOne.Avalonia&version=1.0.0-alpha.1&prerelease
                    


                            Install as a Cake Tool

文本库

富文本布局库

支持替换平台渲染和平台测量层，可采用 WPF 或 MAUI 或其他基础框架作为基础平台层。可直接对接 WPF 或 MAUI 等 UI 框架。通过对接不同的基础平台可实现跨平台功能

总进度：可当成简单的 TextBlock 或 TextBox 使用。附带比较弱的富文本功能

平台进度：

  • WPF
  • Avalonia
  • Skia 渲染（仅渲染，不提供编辑功能）
  • MAUI
  • UNO

功能

  • 平文本

  • 加粗、斜体

  • 上下标

  • 下划线、删除线、波浪线、着重号、装饰层

  • 拼音、上加、下加

  • 字体、字号、颜色

  • 左对齐、右对齐、分散对齐、两端对齐

  • 分词换行

  • 项目符号

  • 左右缩进

  • 段前段后间距（段前段后距离）

  • 倍数行距、固定倍数行距

  • 遵循中文符号换行规则

  • 命中测试，属性和光标系统

  • 文本公式混排，图文混排

  • 四线格法行内排版

  • 蒙文、藏文、合写字（需要平台层给力才行）

开发侧功能：

  • 可注入单元测试和模拟测试
  • 可脱离渲染引擎，通过 Mock 进行驱动
  • 核心库无依赖，无第三方依赖。具体平台对接层的依赖取决于具体的平台对接层需求
  • 高可控。可以控制各个模块和逻辑，可以注入干扰排版过程
  • 长文本性能友好，支持渲染缓存，支持不可见优化
  • 分层 API 设计，既有简单易用的初级 API 层，也有功能强大复杂的高级 API 层
  • 支持注入日志和配置进入调试模式

架构

从整体的角度：

alternate text is missing from this package README image

分层的角度：

alternate text is missing from this package README image

调用关系：

alternate text is missing from this package README image

依赖关系：

alternate text is missing from this package README image

数据走向：

alternate text is missing from this package README image

各个项目的作用

LightTextEditorPlus.Core

文本库的平台无关实现，实现了文本的基础排版布局功能。提供给具体平台框架对接的接口，可以在不同的平台框架上，使用具体平台框架的文本渲染引擎提供具体的文本排版布局信息，以及在排版布局完成之后，对接具体平台的渲染

入口类型：TextEditorCore

LightTextEditorPlus.Wpf

使用 WPF 框架承载的文本库，平台相关具体实现。底层使用 LightTextEditorPlus.Core 进行驱动，渲染层和 IME 输入法等使用 WPF 提供

LightTextEditorPlus.Skia

使用 Skia 提供平台渲染能力，底层使用 LightTextEditorPlus.Core 进行驱动。这一层只提供渲染支持，不提供输入交互编辑功能

LightTextEditorPlus.Avalonia

基于 LightTextEditorPlus.Skia 进行的 Avalonia 平台对接。提供 Avalonia 平台的文本编辑功能，以及文本框控件接入功能

入口文件： TextEditor.ava.cs

LightTextEditorPlus.MauiGraphics

使用 MAUI 框架承载的文本库，使用到 MAUI 的渲染层。仅提供渲染输出功能，不提供编辑功能。支持多平台渲染。底层核心对接是 SKIA 技术

文本状态

文本是脏的

默认创建出来的文本是脏的，需要布局完成之后，才不是脏的。在文本是脏的状态下，禁止获取文本布局相关信息

在文本进行任何编辑动作之后，文本也会标记为是脏的。等待文本布局完成之后，才不是脏的

调试机制

设置调试模式

可以调用 TextEditorCore 的 SetInDebugMode 方法，让单个文本对象进入调试模式。进入调试模式之后，将会有更多的输出信息，和可能抛出 TextEditorDebugException 调试异常

如期望对所有的文本都进入调试模式，可以调用 TextEditorCore.SetAllInDebugMode 静态方法

请不要在发布版本开启调试模式，开启调试模式之后，将会影响文本的性能

布局原因

通过 TextEditorCore 的 _layoutUpdateReasonManager 字段即可了解到框架内记录的触发布局的原因

行为定义

由于文本库在实现的时候，许多功能都需要选择其中某个方式，有些选择是冲突的，而且选择的方向本身将会影响整体的框架和具体的实现。关于文本库所选择的行为，详细请参阅 行为定义.md

相似的项目

https://github.com/toptensoftware/RichTextKit : Rich text rendering for SkiaSharp

文档导航

Product Compatible and additional computed target framework versions.
.NET net8.0 is compatible.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed.  net9.0 was computed.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed.  net10.0 was computed.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
1.0.0-alpha.1 36 9/15/2026