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
andAutoFocusNextElement
have different focus target:AutoFocusNext
is determined byFocusManager.FindNextFocusableElement
AutoFocusNextElement
is provided by the value.
Usage
For more details on using the Input Extensions in your project, check out our Tech Bite video:
<!-- 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" />