SuperAPI AI 工具集

syncfusion-maui-toolkit-text-input-layout

前端与建站

查看项目

更新于 10-16 02:11

技能介绍

用途

本技能用于在 .NET MAUI 应用中实现和定制 Syncfusion 的 Text Input Layout 控件(SfTextInputLayout)。该控件包裹输入视图,在其上方或周围添加装饰性元素,例如浮动标签、图标和辅助标签,从而构建 Material Design 风格的输入字段。

主要能力

  • 浮动标签:提示文本在聚焦时动画移动到顶部。
  • 容器类型:支持 Filled(填充背景)、Outlined(边框)、None 三种样式。
  • 辅助标签:显示帮助文本、错误消息和字符计数器。
  • 自定义图标:支持前置/后置视图,并可设置内部或外部定位。
  • 视觉状态:支持 Normal、Focused、Error、Disabled 状态。
  • 密码切换:在 Entry 控件中显示/隐藏密码字符。
  • RTL 支持:支持从右到左的文本流。
  • 多输入视图:支持 Entry、Editor、Picker、DatePicker、TimePicker、Masked Entry、Numeric Entry 等。

使用方式

技能文档按主题组织,建议按以下顺序阅读参考文件:

  1. 入门(references/getting-started.md):NuGet 包安装(Syncfusion.Maui.Toolkit)、处理程序注册(ConfigureSyncfusionToolkit)、命名空间设置(XAML 和 C#)、基于 Entry 的基本实现、添加提示标签、密码可见性切换基础、首个可运行示例。
  2. 容器类型与样式(references/container-types.md):ContainerType 属性(Filled、Outlined、None)、填充容器背景、轮廓容器边框、ContainerBackground 定制、OutlineCornerRadius 圆角、InputViewPadding 间距、各类型视觉示例。
  3. 提示与辅助标签(references/hints-and-labels.md):提示/浮动标签(Hint、ShowHint)、固定提示位置(IsHintAlwaysFloated)、帮助文本(HelperText、ShowHelperText)、错误文本(ErrorText、HasError)、字符计数器(CharMaxLength、ShowCharCount)、保留空间(ReserveSpaceForAssistiveLabels)、标签样式(HintLabelStyle、HelperLabelStyle、ErrorLabelStyle)、字体定制(FontFamily、FontSize、FontAttributes)。
  4. 自定义图标与视图(references/custom-icons.md):前置视图(LeadingView、LeadingViewPosition)、后置视图(TrailingView、TrailingViewPosition)、内部与外部定位、字体图标与 Unicode、自定义视图集成、图标操作事件处理、常见图标模式(日历、搜索、清除)。
  5. 状态、颜色与主题(references/states-and-colors.md):视觉状态(Normal、Focused、Error、Disabled)、边框 Stroke 属性、CurrentActiveColor 属性、Visual State Manager 集成、边框粗细(FocusedStrokeThickness、UnfocusedStrokeThickness)、容器背景色、标签文本颜色、主题集成。
  6. 高级功能与事件(references/advanced-features.md):密码可见性切换(EnablePasswordVisibilityToggle)、PasswordVisibilityToggled 事件、从右到左支持(FlowDirection)、支持的输入视图、平台特定限制、操作场景、故障排除。

适用场景

  • 需要为输入字段添加浮动提示标签。
  • 需要显示帮助文本、错误消息或字符计数器。
  • 需要实现填充、轮廓或无容器类型的输入字段。
  • 需要为输入视图添加前置或后置图标。
  • 需要在 Entry 控件中切换密码可见性。
  • 需要为输入应用视觉状态(正常、聚焦、错误)。
  • 需要定制标签样式、颜色和字体。
  • 需要支持多种输入视图(Entry、Editor、Picker 等)。
  • 需要实现带错误状态的表单验证。
  • 需要为无障碍添加辅助标签。
  • 需要创建 Material Design 风格的输入字段。

限制

资料中提及存在平台特定限制,但未提供具体限制内容。其他未在资料中明确说明的功能、收费、价格、平台或效果暂未提供。