com.holonplatform.vaadin.flow.components.builders

## Interface FocusableConfigurator<T extends com.vaadin.flow.component.Component,C extends FocusableConfigurator<T,C>>

- Type Parameters:
    `T` - Concrete component type
    `C` - Concrete configurator type
  All Known Subinterfaces:
    BaseDateInputBuilder<D,B>, BeanListingBuilder<T>, BeanListingBuilder.DatastoreBeanListingBuilder<T>, BeanListingConfigurator<T,C>, BooleanInputBuilder, ButtonBuilder, ButtonConfigurator<C>, ButtonConfigurator.BaseButtonConfigurator, DateInputBuilder, DateTimeInputBuilder, ItemListingBuilder<T,P,L,B>, ItemListingConfigurator<T,P,L,C>, LocalDateInputBuilder, LocalDateTimeInputBuilder, LocalTimeInputBuilder, NativeButtonBuilder, NumberInputBuilder<T>, PasswordInputBuilder, PropertyListingBuilder, PropertyListingBuilder.DatastorePropertyListingBuilder, PropertyListingConfigurator<C>, SelectModeSingleSelectInputBuilder<T,ITEM,B>, SelectModeSingleSelectInputBuilder.DatastoreItemSelectModeSingleSelectInputBuilder<T,ITEM>, SelectModeSingleSelectInputBuilder.DatastorePropertySelectModeSingleSelectInputBuilder<T>, SelectModeSingleSelectInputBuilder.ItemSelectModeSingleSelectInputBuilder<T,ITEM>, SelectModeSingleSelectInputBuilder.PropertySelectModeSingleSelectInputBuilder<T>, StringAreaInputBuilder, StringInputBuilder

      public interface FocusableConfigurator<T extends com.vaadin.flow.component.Component,C extends FocusableConfigurator<T,C>>

  Configurator for `Focusable` type components.
  Since:
    5.2.0

- - ### Method Summary

    All Methods Instance Methods Abstract Methods
    Modifier and Type | Method and Description
    --- | ---
    `C` | `tabIndex(int tabIndex)` Sets the `tabindex` attribute in the component.
    `C` | `withBlurListener(com.vaadin.flow.component.ComponentEventListener<com.vaadin.flow.component.BlurNotifier.BlurEvent<T>> listener)` Adds a listener which gets fired when the the component focus is lost.
    `C` | `withFocusListener(com.vaadin.flow.component.ComponentEventListener<com.vaadin.flow.component.FocusNotifier.FocusEvent<T>> listener)` Adds a listener which gets fired when the component receives focus.

- - ### Method Detail

    - #### tabIndex

          C tabIndex(int tabIndex)

      Sets the `tabindex` attribute in the component. The tabIndex indicates if its element can be focused, and if/where it participates in sequential keyboard navigation:
      - A negative value (usually `tabindex = -1` means that the component should be focusable, but should not be reachable via sequential keyboard navigation.
      - `tabindex = 0` means that the component should be focusable in sequential keyboard navigation, but its order is defined by the document's source order.
      - A positive value means the component should be focusable in sequential keyboard navigation, with its order defined by the value of the number. That is, `tabindex = 4` would be focused before `tabindex = 5`, but after `tabindex = 3`. If multiple components share the same positive tabindex value, their order relative to each other follows their position in the document source.
      Parameters:
        `tabIndex` - The tab index to set
      Returns:
        this

    - #### withFocusListener

          C withFocusListener(com.vaadin.flow.component.ComponentEventListener<com.vaadin.flow.component.FocusNotifier.FocusEvent<T>> listener)

      Adds a listener which gets fired when the component receives focus.
      Parameters:
        `listener` - The listener to add
      Returns:
        this

    - #### withBlurListener

          C withBlurListener(com.vaadin.flow.component.ComponentEventListener<com.vaadin.flow.component.BlurNotifier.BlurEvent<T>> listener)

      Adds a listener which gets fired when the the component focus is lost.
      Parameters:
        `listener` - The listener to add
      Returns:
        this

Copyright © 2019 The Holon Platform. All rights reserved.