Represents a control that provides a menu of options.

Hierarchy

Hierarchy

Constructors

Properties

context: any

If using the new style context, re-declare this in your class to be the React.ContextType of your static contextType. Should be used with type annotation or static contextType.

static contextType = MyContext
// For TS pre-3.7:
context!: React.ContextType<typeof MyContext>
// For TS 3.7 and above:
declare context: React.ContextType<typeof MyContext>
props: Readonly<IIgrSelectProps> & Readonly<{
    children?: ReactNode;
}>
refs: {
    [key: string]: ReactInstance;
}

Type declaration

  • [key: string]: ReactInstance
state: Readonly<{}>
contextType?: Context<any>

If set, this.context will be set at runtime to the current value of the given Context.

Usage:

type MyContext = number
const Ctx = React.createContext<MyContext>(0)

class Foo extends React.Component {
static contextType = Ctx
context!: React.ContextType<typeof Ctx>
render () {
return <>My context's value: {this.context}</>;
}
}

Accessors

  • get autofocus(): boolean
  • The autofocus attribute of the control.

    Returns boolean

  • set autofocus(v): void
  • Parameters

    • v: boolean

    Returns void

  • get blur(): ((s, e) => void)
  • Returns ((s, e) => void)

  • set blur(ev): void
  • Parameters

    Returns void

  • get closed(): ((s, e) => void)
  • Returns ((s, e) => void)

  • set closed(ev): void
  • Parameters

    Returns void

  • get closing(): ((s, e) => void)
  • Returns ((s, e) => void)

  • set closing(ev): void
  • Parameters

    Returns void

  • get disabled(): boolean
  • The disabled state of the component

    Returns boolean

  • set disabled(v): void
  • Parameters

    • v: boolean

    Returns void

  • get distance(): number
  • The distance of the select dropdown from its input.

    Returns number

  • set distance(v): void
  • Parameters

    • v: number

    Returns void

  • get emitEvent(): any
  • Returns any

  • set emitEvent(v): void
  • Parameters

    • v: any

    Returns void

  • get focus(): ((s, e) => void)
  • Returns ((s, e) => void)

  • set focus(ev): void
  • Parameters

    Returns void

  • get invalid(): boolean
  • Control the validity of the control.

    Returns boolean

  • set invalid(v): void
  • Parameters

    • v: boolean

    Returns void

  • get items(): IgrSelectItem[]
  • Returns the items of the igc-select component.

    Returns IgrSelectItem[]

  • get keepOpenOnOutsideClick(): boolean
  • Whether the component dropdown should be kept open on clicking outside of it.

    Returns boolean

  • set keepOpenOnOutsideClick(v): void
  • Parameters

    • v: boolean

    Returns void

  • get keepOpenOnSelect(): boolean
  • Whether the component dropdown should be kept open on selection.

    Returns boolean

  • set keepOpenOnSelect(v): void
  • Parameters

    • v: boolean

    Returns void

  • get label(): string
  • The label attribute of the control.

    Returns string

  • set label(v): void
  • Parameters

    • v: string

    Returns void

  • get name(): string
  • The name attribute of the control.

    Returns string

  • set name(v): void
  • Parameters

    • v: string

    Returns void

  • get open(): boolean
  • Sets the open state of the component.

    Returns boolean

  • set open(v): void
  • Parameters

    • v: boolean

    Returns void

  • get opened(): ((s, e) => void)
  • Returns ((s, e) => void)

  • set opened(ev): void
  • Parameters

    Returns void

  • get opening(): ((s, e) => void)
  • Returns ((s, e) => void)

  • set opening(ev): void
  • Parameters

    Returns void

  • get outlined(): boolean
  • The outlined attribute of the control.

    Returns boolean

  • set outlined(v): void
  • Parameters

    • v: boolean

    Returns void

  • get placeholder(): string
  • The placeholder attribute of the control.

    Returns string

  • set placeholder(v): void
  • Parameters

    • v: string

    Returns void

  • get placement(): DropdownPlacement
  • The preferred placement of the select dropdown around its input.

    Returns DropdownPlacement

  • set placement(v): void
  • Parameters

    Returns void

  • get required(): boolean
  • Makes the control a required field in a form context.

    Returns boolean

  • set required(v): void
  • Parameters

    • v: boolean

    Returns void

  • get scrollStrategy(): SelectScrollStrategy
  • Determines the behavior of the component during scrolling of the parent container.

    Returns SelectScrollStrategy

  • set scrollStrategy(v): void
  • Parameters

    Returns void

  • get selectedItem(): IgrSelectItem
  • Returns the selected item from the dropdown or null.

    Returns IgrSelectItem

  • get value(): string
  • Returns string

  • set value(v): void
  • Parameters

    • v: string

    Returns void

Methods

  • Removes focus from the component.

    Returns void

  • Checks for validity of the control and emits the invalid event if it invalid.

    Returns void

  • Resets the current value and selection of the component.

    Returns void

  • Catches exceptions generated in descendant components. Unhandled exceptions will cause the entire component tree to unmount.

    Parameters

    • error: Error
    • errorInfo: ErrorInfo

    Returns void

  • Called immediately after updating occurs. Not called for the initial render.

    The snapshot is only present if getSnapshotBeforeUpdate is present and returns non-null.

    Parameters

    • prevProps: Readonly<IIgrSelectProps>
    • prevState: Readonly<{}>
    • Optional snapshot: any

    Returns void

  • Called immediately before a component is destroyed. Perform any necessary cleanup in this method, such as cancelled network requests, or cleaning up any DOM elements created in componentDidMount.

    Returns void

  • Parameters

    • name: string

    Returns any

  • Sets focus on the component.

    Parameters

    Returns void

  • Parameters

    • Optional callback: (() => void)
        • (): void
        • Returns void

    Returns void

  • Runs before React applies the result of render to the document, and returns an object to be given to componentDidUpdate. Useful for saving things such as scroll position before render causes changes to it.

    Note: the presence of getSnapshotBeforeUpdate prevents any of the deprecated lifecycle events from running.

    Parameters

    Returns any

  • Hides the component.

    Returns void

  • Returns DOMElement<any, Element>

  • Checks the validity of the control and moves the focus to it if it is not valid.

    Returns void

  • Sets a custom validation message for the control. As long as message is not empty, the control is considered invalid.

    Parameters

    • message: string

    Returns void

  • Parameters

    • element: any

    Returns void

  • Type parameters

    Type Parameters

    • K extends never

    Parameters

    • state: {} | ((prevState, props) => {} | Pick<{}, K>) | Pick<{}, K>
    • Optional callback: (() => void)
        • (): void
        • Returns void

    Returns void

  • Parameters

    • nextProps: any
    • nextState: any

    Returns boolean

  • Shows the component.

    Returns void

  • Toggles the open state of the component.

    Returns void