syncfusion-aspnetcore-smart-textarea

Syncfusion ASP.NET Core Smart TextArea

概述

Smart TextArea 是一款智能 AI 驱动的文本输入控件，借助语义理解提供实时句子补全和文本建议。本技能将指导你在 ASP.NET Core 应用程序中实现 Smart TextArea 功能，支持多种 AI 提供商、可自定义的建议模式和可扩展的推理后端。

Smart TextArea 提供：

• AI 驱动的补全： 使用 OpenAI、Azure OpenAI、Ollama 或自定义后端提供智能句子和文本建议
• 多种建议模式： 提供内联弹出或集成式 AI 建议显示选项
• 用户角色配置： 基于角色的建议行为（学生、作者、开发者等）
• 自定义短语： 根据用户上下文和偏好提供预定义短语建议
• 完整的 TextArea 功能： 浮动标签、验证、RTL 支持和无障碍合规
• Tag Helper 支持： 为 Razor Pages 和 MVC 提供原生 ASP.NET Core TagHelper 集成
• 事件系统： 建议选择、值更改、焦点和失焦事件

何时使用此技能

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

• 在 ASP.NET Core 应用程序中实现 AI 驱动的文本补全
• 为 Smart TextArea 功能配置 OpenAI 或 Azure OpenAI
• 设置 Ollama 或自定义 AI 推理服务
• 自定义建议显示模式（内联或弹出）
• 配置用户角色和自定义短语，以提供上下文感知建议
• 为专有 AI 模型实现自定义推理后端
• 为多行文本输入添加智能文本撰写功能
• 将 Smart TextArea 集成到表单和内容编辑器中

组件概述

主要功能：

• 实时 AI 句子补全建议
• 内联和弹出式建议显示模式
• 基于角色的建议智能（学生、作者、开发者、自定义）
• 预定义的自定义短语和片段
• 继承 TextArea 控件的全部功能
• 支持多种语言和 RTL 布局
• 事件驱动的建议处理
• 支持无障碍访问和键盘导航

常用属性：

• Placeholder - 默认提示文本
• Value - 当前文本区域内容
• OpenAIKey / AzureEndpoint / OllamaUrl - AI 服务配置
• SuggestionMode - “Inline”或“Popup”建议显示模式
• UserRole - 角色上下文（学生、作者、开发者、自定义）
• UserPhrases - 自定义短语建议
• ActionComplete - 应用建议时触发的事件
• Change - 内容更改时触发的事件
• Rows / Cols - 文本区域尺寸
• ReadOnly - 只读状态

文档导航

入门指南

📄 阅读： references/getting-started.md

• 先决条件和系统要求
• 安装 Syncfusion.EJ2.AspNet.Core NuGet 包
• 配置 AI 服务（OpenAI、Azure OpenAI、Ollama）
• 使用 Razor Pages 和 MVC 设置项目
• 注册和配置 Tag Helper
• 配置 CDN 样式表和脚本
• 创建第一个 Smart TextArea 实现
• 将 AI 补全集成到基本表单中

功能和能力

📄 阅读： references/features.md

• Smart TextArea 的核心功能和属性
• 标准 TextArea 功能继承（浮动标签、验证）
• 用户角色配置（学生、作者、开发者、自定义）
• 建议显示和交互模式
• 事件处理和回调
• 多语言和 RTL 支持
• 无障碍功能和键盘导航
• 表单提交和值管理

自定义配置

📄 阅读： references/customization.md

• 配置建议显示模式（内联或弹出）
• 配置用户角色和上下文
• 配置自定义短语和代码片段
• TextArea 外观和样式选项
• 自定义占位文本和标签
• 配置大小和尺寸
• 事件处理和补全回调
• 自定义主题和 CSS 类

自定义推理后端

📄 阅读： custom-inference-backend

• 实现 IChatInferenceService 接口
• 集成自定义 AI 提供商
• 在依赖注入中注册服务
• 请求/响应格式规范
• 预期的补全格式和响应结构
• 处理复杂推理场景
• 测试和调试自定义后端
• 性能优化策略