syncfusion-maui-linear-progressbar

实现 .NET MAUI 线性 ProgressBar

本指南全面介绍如何实现和自定义 Syncfusion® .NET MAUI 线性 ProgressBar（SfLinearProgressBar）控件。该组件使用矩形形状显示任务进度，支持确定和不确定状态、分段、流畅动画，以及包括范围颜色在内的可自定义视觉效果。

何时使用此技能

在以下情况下使用此技能：

• 实现进度指示器，用于文件上传、下载或数据处理任务
• 显示确定进度，并展示已知的完成百分比（0-100%）
• 显示不确定进度，适用于任务时长未知或无法计算的情况
• 可视化缓冲状态，同时显示主要进度和次要进度（例如视频缓冲）
• 创建多段进度条，用于顺序任务或多步骤任务
• 自定义进度外观，包括颜色、渐变、尺寸、圆角或动画
• 应用基于范围的颜色，以显示不同的进度区域（成功、警告、危险）
• 添加进度动画，并自定义时长和缓动效果
• 处理进度事件，以便在进度变化或完成时作出响应
• 实现现代 UI 效果，例如用于半透明设计的液态玻璃效果

组件概述

SfLinearProgressBar 是一种 .NET MAUI 控件，可通过水平矩形条显示任务进度。它支持：

• 多种状态：确定（进度已知）、不确定（时长未知）、缓冲（双进度）
• 分段：将进度拆分为多个部分，用于顺序任务
• 丰富的自定义选项：颜色、渐变、厚度、内边距、圆角
• 流畅动画：可配置的时长和缓动函数
• 范围颜色：为不同的进度范围设置不同颜色
• 事件：跟踪进度变化和完成状态
• 现代效果：营造简洁半透明 UI 的液态玻璃效果

文档和导航指南

快速入门

📄 阅读： references/getting-started.md

在以下情况下阅读：

• 安装和设置 Linear ProgressBar 控件
• 添加 NuGet 包（Syncfusion.Maui.ProgressBar）
• 注册 Core 处理程序
• 创建第一个基本进度条
• 了解命名空间导入和初始化

进度状态

📄 阅读： references/states.md

在以下情况下阅读：

• 了解确定状态（默认，进度已知）
• 为时长未知的任务启用不确定状态
• 实现带有次要进度的缓冲状态
• 为用例选择合适的状态
• 为复杂场景组合状态

分段

📄 阅读： references/segments.md

在以下情况下阅读：

• 在一个进度条中可视化多个顺序任务
• 使用 SegmentCount 将进度条拆分为多个分段
• 使用 SegmentGapWidth 自定义分段之间的间距
• 显示逐步推进的多步骤进度

外观自定义

📄 阅读： references/appearance.md

在以下情况下阅读：

• 使用 GradientStops 应用范围颜色（纯色或渐变）
• 自定义轨道、进度和次要进度的高度
• 调整进度指示器周围的内边距
• 设置圆角半径以实现圆角边缘
• 更改进度填充、轨道填充和次要进度的颜色

动画

📄 阅读： references/animation.md

在以下情况下阅读：

• 为不同状态配置动画时长
• 应用缓动效果（Linear、CubicInOut、BounceIn 等）
• 使用 SetProgress() 方法一次性覆盖动画设置
• 自定义不确定进度动画行为
• 创建流畅、可交互的进度过渡效果

范围自定义

📄 阅读： references/range.md

在以下情况下阅读：

• 定义自定义 Minimum 和 Maximum 值
• 使用因子值（0.0 到 1.0），而不是百分比
• 针对特定场景调整进度范围
• 处理非标准进度刻度

事件

📄 阅读： references/events.md

需要执行以下操作时：

• 处理 ProgressChanged 事件以响应进度更新
• 在进度达到最大值时处理 ProgressCompleted 事件
• 根据进度值动态更改外观
• 实现由进度里程碑触发的自定义逻辑

液态玻璃效果

📄 阅读： references/liquid-glass-effect.md

需要执行以下操作时：

• 为进度条应用现代半透明玻璃效果
• 将进度条置于 SfGlassEffectView 中
• 配置透明背景以实现玻璃外观
• 实现简洁、现代的 UI 设计
• 检查平台要求（macOS 26+、iOS 26+、.NET 10）