Elm Search Input

Simple search input for use in Elm with debouncer capabilities.

Description

This is not intended for external use yet and the docs will be filled out in more detail when ready.

There are other options that may suit your needs better than this project:

1. (elm-select)[https://package.elm-lang.org/packages/Confidenceman02/elm-select/11.1.0/)]. Stand alone + elm css
2. (Elm Select)[https://github.com/sporto/elm-select]

This package includes debouncing emission of input changes. Otherwise the other projects are more mature and (frankly) better written (twas written quickly for fun).

Badges

On some READMEs, you may see small images that convey metadata, such as whether or not all the tests are passing for the project. You can use Shields to add some to your README. Many services also have instructions for adding a badge.

Visuals

Depending on what you are making, it can be a good idea to include screenshots or even a video (you'll frequently see GIFs rather than actual videos). Tools like ttygif can help, but check out Asciinema for a more sophisticated method.

Installation

To install run:

elm install o-train/elm-search-input

Usage

import Select

type alias YourItem =
    { id : Int 
    , name : String }

type alias YourModel =
    { items = List YourItem
    , selectInput = Select.Model YourUser
    }

initModel =
    { items = [] 
    , selectInput = Select.basicInit etc.
    }

type Msg =
    ...
    | SelectInput (Select.Msg YourItem)

update : ...
    SelectInput subMsg ->
        SelectInput subMsg ->
            let
                ( selectInputModel, selectMsg ) =
                    Select.update subMsg model.selectInput
            in
            ( { model | selectInput = selectInputModel }, selectMsg |> Cmd.map SelectInput )
        

Roadmap

• Refactor from initial quick one file write
• Refactor inits using Builder pattern
• Improve docs
• Make it Beta (and better...)
• Better example

Contributing

To contribute please open an MR/PR with a title and description of what it does. Point it to main branch

Authors and acknowledgment

Olly Putland (Maintainer)

License

MIT License

Project status

Alpha