Skip to content

Latest commit

 

History

History
44 lines (32 loc) · 2.48 KB

Input-extensions.md

File metadata and controls

44 lines (32 loc) · 2.48 KB
Raw
uid
Toolkit.Helpers.InputExtensions

Input Extensions

Provides various attached properties for input controls, such as TextBox and PasswordBox.

Attached Properties

Property Type Description
AutoDismiss bool Whether the soft keyboard will be dismissed when the enter key is pressed.
AutoFocusNext bool Whether the focus will move to the next focusable element when the enter key is pressed.*
AutoFocusNextElement Control Sets the next control to focus when the enter key is pressed.*
ReturnType ReturnType The type of return button on a soft keyboard for Android/iOS. It can be one of the following options: Default, Done, Go, Next, Search, Send.

AutoFocusNext and AutoFocusNextElement*: Having either or both of the two properties set will enable the focus next behavior. AutoFocusNextElement will take precedence over AutoFocusNext when both are set.

Remarks

  • AutoFocusNext and AutoFocusNextElement have different focus target:
    • AutoFocusNext is determined by FocusManager.FindNextFocusableElement
    • AutoFocusNextElement is provided by the value.

Usage

<!-- Include the following XAML namespace to use the samples below -->
xmlns:utu="using:Uno.Toolkit.UI"
...

<!-- The focus will move in this order when pressing enter repeatedly: 1-2-4-3 -->
<TextBox x:Name="Input1" utu:InputExtensions.AutoFocusNext="True" />
<TextBox x:Name="Input2" utu:InputExtensions.AutoFocusNextElement="{Binding ElementName=Input4}" />
<TextBox x:Name="Input3" utu:InputExtensions.AutoFocusNextElement="{Binding ElementName=Input1}" />
<TextBox x:Name="Input4" utu:InputExtensions.AutoFocusNextElement="{Binding ElementName=Input3}" />

<!-- Dismiss soft keyboard on enter -->
<TextBox utu:InputExtensions.AutoDismiss="True" />

<!-- Soft keyboard with send as return button -->
<TextBox utu:InputExtensions.ReturnType="Send" />