Struct LookupField 

pub struct LookupField { /* private fields */ }

Picks a record from a list that is searched as you type, loaded from memory or through a callback that can go to a database or a server. Arrows move through the options, Enter picks and Escape closes. The chosen option can be cleared.

use ravenrs_reactive::State;
use ravenrs_widgets::{LookupField, LookupItem, Ui};

let city = State::new(None);
let field = LookupField::remote(city.binding(), |request, responder| {
    // Ask a database here; answer now, or later with a clone of the responder.
    let found = LookupItem::new("1", format!("{} (first match)", request.query));
    responder.respond(vec![found]);
});
let mut ui = Ui::new(field, ravenrs_style::Theme::raven_dark());
ui.update();

Implementations

impl LookupField

pub fn new( selected: Binding<Option<LookupItem>>, items: Vec<LookupItem>, ) -> Self

A lookup over options already in memory.

pub fn remote( selected: Binding<Option<LookupItem>>, load: impl Fn(LookupRequest, LookupResponder) + 'static, ) -> Self

A lookup that asks load for its options when it opens and on every search.

pub fn placeholder(self, text: impl Into<String>) -> Self

Text shown while nothing is chosen.

pub fn limit(self, limit: usize) -> Self

The most options asked for at a time. 50 by default.

pub fn width(self, width: f32) -> Self

Width in logical pixels. 240 by default.

pub fn label(self, label: impl Into<String>) -> Self

The name screen readers announce. Inside a crate::FormField, its label is used instead.

pub fn disabled(self, disabled: bool) -> Self

Turns the lookup off: it fades, leaves the tab order and ignores input.

pub fn read_only(self, read_only: bool) -> Self

Shows the choice without letting it change; it can still be focused and read.

Trait Implementations

impl Debug for LookupField

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl View for LookupField

fn build(&self, cx: &mut BuildCx<'_>) -> NodeId

Creates this view’s node for the current build.

fn type_name(&self) -> &'static str

The name the diagnostics panel shows this view’s cost under.