Command Extensions

Provides Command/CommandParameter attached properties for common scenarios.

Attached Properties

Property Type Description
Command ICommand Sets the command to execute when interacting with the control.*
CommandParameter object Sets the parameter to pass to the Command property.

Remarks

  • Command is executed on:
    • ListViewBase.ItemClick
    • Selector.SelectionChanged (except for ListView which uses ItemClick)
    • NavigationView.ItemInvoked
    • ItemsRepeater item tapped
    • TextBox and PasswordBox when the Enter key is pressed
    • ToggleSwitch toggled
    • any UIElement tapped
  • For Command, the relevant parameter is also provided for the CanExecute and Execute call:

    CommandParameter can be set, on the item-container or item-template's root for collection-type control, or control itself for other controls, to replace the following.

    • ItemClickEventArgs.ClickedItem from ListView.ItemClick
    • Selector.SelectedItem
    • NavigationViewItemInvokedEventArgs.InvokedItem from NavigationView.ItemInvoked
    • ItemsRepeater's item root's DataContext
    • TextBox.Text
    • ToggleSwitch.IsOn
    • PasswordBox.Password
    • UIElement itself
  • Command on TextBox/PasswordBox*: Having this set will also cause the keyboard to dismiss on enter.
  • Command on ListView*: IsItemClickEnabled must also be set to true for this to work.

Usage

For more details on using the Command 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"
...

<!-- Execute command on enter -->
<PasswordBox utu:CommandExtensions.Command="{Binding Login}" />

<!-- Execute command on toggle -->
<ToggleSwitch utu:CommandExtensions.Command="{Binding SetDarkMode}" />

<!-- ListView item click-->
<ListView ItemsSource="123"
          IsItemClickEnabled="True"
          utu:CommandExtensions.Command="{Binding UpdateSelection}" />

<!-- NavigationView item invoke -->
<NavigationView utu:CommandExtensions.Command="{Binding Navigate}">
    <NavigationView.MenuItems>
        <NavigationViewItem Content="Apple" />
        <NavigationViewItem Content="Banana" />
        <NavigationViewItem Content="Cactus" />
    </NavigationView.MenuItems>
</NavigationView>

<muxc:ItemsRepeater ItemsSource="123" utu:CommandExtensions.Command="{Binding UpdateSelection}" />