Class AutocompleteField<T>

Autocomplete field

Type Parameters

Hierarchy

Constructors

Properties

_cls?: string
_input: undefined | HTMLInputElement | HTMLSelectElement | HTMLTextAreaElement
_labelEl?: HTMLElement
_value: any
baseCls: string = 'goui-form-field text'

Adds standard style. You may want to remove this if you don't want the standard look of a form field.

buffer: number = 300

Buffer typing in the input in ms

control: undefined | HTMLElement
dataSet: Record<string, any> = {}

Set arbitrary data on a component.

Should be used with caution as this data is not typed.

defaultValue: any

The value that was set before adding this component to a parent.

fireChangeOnBlur: boolean = true

Fires a change event if the field's value is different since it got focus

invalidMsg: string = ""
isFormField: true = true
list: T

The table to use for suggestions

menu: Menu
menuButton: Button
parent?: Component

When this item is added to a Component this is set to the parent Component

picker: ListPicker<T>
renderTo?: HTMLElement

Normally components are rendered to its parent component's element. But in some cases like menu's it's desired to render them to the root and position them absolute.

resetValue: any

The value this field resets to when a form is reset. Changes when a form loads.

stateId?: string

ID used for storing state of the component in the State storage.

If stateId is given it will also be used as itemId

If not set then the component won't store it's state.

tagName: keyof HTMLElementTagNameMap = "div"

The tagname used for the root HTMLElement of this component

validateOnBlur: boolean = true

Validate the field on blur

valueOnFocus?: string

Used for "change" event

Accessors

  • set attr(attr): void
  • Set attributes of the DOM element

    Parameters

    • attr: Record<string, string>

    Returns void

  • get buttons(): undefined | Button[]
  • Returns undefined | Button[]

  • set buttons(buttons): void
  • Render buttons inside the text field

    Parameters

    • buttons: undefined | Button[]

    Returns void

    Example

    buttons: [
    btn({icon: "clear", handler:(btn) => (btn.parent!.parent! as Field).value = ""})
    ]
  • set cls(cls): void
  • Class name to add to element

    Some common classes to add for layout:

    • hbox: Set's flex layout to horizontal boxes. Use flex: n to stretch columns
    • vbox: As above but vertical
    • fit: Fit the parent's size
    • scroll: Set's autoscroll: true
    • pad: Set common padding on the element
    • border-(top|bottom|left|right) to add a border

    Other:

    • goui-fade-in: The component will fade in when show() is used.
    • goui-fade-out: The component will fade out when hide is used.

    Parameters

    • cls: string

    Returns void

  • get disabled(): boolean
  • Returns boolean

  • set disabled(disabled): void
  • Disable component

    Parameters

    • disabled: boolean

    Returns void

  • get flex(): string | number
  • CSS flex value

    Returns string | number

  • set flex(flex): void
  • CSS flex value

    Parameters

    • flex: string | number

    Returns void

  • get height(): number
  • Returns number

  • set height(height): void
  • The height in scalable pixels

    Parameters

    • height: number

    Returns void

    See

    width

  • get html(): string
  • Returns string

  • set html(html): void
  • Set the HTML contents of the component (innerHTML)

    Parameters

    • html: string

    Returns void

  • get input(): HTMLInputElement
  • Get the DOM HTMLInputElement

    Returns HTMLInputElement

  • get itemContainerEl(): HTMLElement
  • Returns HTMLElement

  • get itemId(): string
  • Component item ID that can be used to lookup the Component inside a Component with Component.findItem() and Component.findItemIndex();

    if stateId is given it will also be used as itemId

    Returns string

  • set itemId(itemId): void
  • Parameters

    • itemId: string

    Returns void

  • get name(): string
  • Form element name which will be the key in values If omitted the field won't be included in the form values.

    Returns string

  • set name(name): void
  • The field's name

    Parameters

    • name: string

    Returns void

  • get rendered(): boolean
  • Check if the component has been rendered and added to the DOM tree

    Returns boolean

  • get resizable(): boolean
  • Returns boolean

  • set resizable(resizable): void
  • Make it resizable

    Parameters

    • resizable: boolean

    Returns void

  • get style(): Partial<CSSStyleDeclaration>
  • Returns Partial<CSSStyleDeclaration>

  • set style(style): void
  • Set inline style

    Parameters

    • style: Partial<CSSStyleDeclaration>

    Returns void

  • get tabIndex(): number
  • Returns number

  • set tabIndex(tabIndex): void
  • The tabindex attribute specifies the tab order of an element (when the "tab" button is used for navigating).

    Parameters

    • tabIndex: number

    Returns void

  • set title(title): void
  • Title of the dom element

    Parameters

    • title: string

    Returns void

  • get width(): number
  • Returns number

  • set width(width): void
  • Set the width in scalable pixels

    The width is applied in rem units divided by 10. Because the font-size of the html element has a font-size of 62.5% this is equals the amount of pixels, but it can be scaled easily for different themes.

    Parameters

    • width: number

    Returns void

  • get wrap(): HTMLDivElement
  • A wrapper DIV element that contains input and toolbar for input buttons like an expand button for a drop down

    Returns HTMLDivElement

Methods

  • Find ancestor

    The method traverses the Component's ancestors (heading toward the document root) until it finds one where the given function returns true.

    Parameters

    • fn: ((cmp) => boolean | void)

      When the function returns true the item will be returned. Otherwise it will move up to the next parent.

        • (cmp): boolean | void
        • Parameters

          Returns boolean | void

    Returns undefined | Component

  • Find parent by instance type of the parent

    Type Parameters

    Parameters

    • cls: T

    Returns undefined | InstanceType<T>

    Example

    const form = textField.findAncestorByType(Form);
    
  • Find child by instance type of the parent

    Type Parameters

    Parameters

    • cls: ClassTypeOf<T>

    Returns undefined | T

    Example

    const form = textField.findAncestorByType(Form);
    
  • Hide this component

    This sets the "hidden" attribute on the DOM element which set's CSS display:none. You can change this to fade with css class "goui-fade-in" and "goui-fade-out"

    If you want to override this function, please override internalSetHidden instead so the beforeshow and show event fire at the right time.

    Returns boolean

  • Mask the component to disable user interaction It creates an absolute positioned Mask component. This component should have a non-static position style for this to work.

    Parameters

    • delay: number = 300

    Returns void

  • Render the component

    Parameters

    • Optional parentEl: Node

      The element this componennt will render into

    • Optional insertBefore: Node

      If given, the element will be inserted before this child

    Returns HTMLElement

  • Protected

    Call save start when something relevant to the state changes. Implement buildState() to save relevant state properties and restore it in restoreState()

    stateId must be set on components to be stateful

    Returns void

  • Protected

    When buttons with menus are added it is handy to delay the validation on blur. Because when the user will click something in the menu it will blur the field and you probably don't want it to validate at that point. It's important that the menu will return focus to the field and sets the value afterward.

    Parameters

    Returns void

  • Show the component

    If you want to override this function, please override internalSetHidden instead so the beforeshow and show event fire at the right time.

    Returns boolean

  • Copies the current value to the reset value. Typically happens when this component was added to a parent and when the form it belongs too loads.

    Returns void

    See

    Form in the trackModifications method

Generated using TypeDoc