用途
本技能用于在 .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 等。
使用方式
技能文档按主题组织,建议按以下顺序阅读参考文件:
- 入门(references/getting-started.md):NuGet 包安装(Syncfusion.Maui.Toolkit)、处理程序注册(ConfigureSyncfusionToolkit)、命名空间设置(XAML 和 C#)、基于 Entry 的基本实现、添加提示标签、密码可见性切换基础、首个可运行示例。
- 容器类型与样式(references/container-types.md):ContainerType 属性(Filled、Outlined、None)、填充容器背景、轮廓容器边框、ContainerBackground 定制、OutlineCornerRadius 圆角、InputViewPadding 间距、各类型视觉示例。
- 提示与辅助标签(references/hints-and-labels.md):提示/浮动标签(Hint、ShowHint)、固定提示位置(IsHintAlwaysFloated)、帮助文本(HelperText、ShowHelperText)、错误文本(ErrorText、HasError)、字符计数器(CharMaxLength、ShowCharCount)、保留空间(ReserveSpaceForAssistiveLabels)、标签样式(HintLabelStyle、HelperLabelStyle、ErrorLabelStyle)、字体定制(FontFamily、FontSize、FontAttributes)。
- 自定义图标与视图(references/custom-icons.md):前置视图(LeadingView、LeadingViewPosition)、后置视图(TrailingView、TrailingViewPosition)、内部与外部定位、字体图标与 Unicode、自定义视图集成、图标操作事件处理、常见图标模式(日历、搜索、清除)。
- 状态、颜色与主题(references/states-and-colors.md):视觉状态(Normal、Focused、Error、Disabled)、边框 Stroke 属性、CurrentActiveColor 属性、Visual State Manager 集成、边框粗细(FocusedStrokeThickness、UnfocusedStrokeThickness)、容器背景色、标签文本颜色、主题集成。
- 高级功能与事件(references/advanced-features.md):密码可见性切换(EnablePasswordVisibilityToggle)、PasswordVisibilityToggled 事件、从右到左支持(FlowDirection)、支持的输入视图、平台特定限制、操作场景、故障排除。
适用场景
- 需要为输入字段添加浮动提示标签。
- 需要显示帮助文本、错误消息或字符计数器。
- 需要实现填充、轮廓或无容器类型的输入字段。
- 需要为输入视图添加前置或后置图标。
- 需要在 Entry 控件中切换密码可见性。
- 需要为输入应用视觉状态(正常、聚焦、错误)。
- 需要定制标签样式、颜色和字体。
- 需要支持多种输入视图(Entry、Editor、Picker 等)。
- 需要实现带错误状态的表单验证。
- 需要为无障碍添加辅助标签。
- 需要创建 Material Design 风格的输入字段。
限制
资料中提及存在平台特定限制,但未提供具体限制内容。其他未在资料中明确说明的功能、收费、价格、平台或效果暂未提供。