Lookup

Reference-field picker: bind .data_source__thing_id to the thing_id UUID of a platform reference field type. The component loads that field type build and renders the correct lookup UI (autocomplete, radio, search grid, etc.).

HTML tag: c-e0792387377784f0d83cd94a55e1a995c

When to use

• pick a value for a reference field type
• foreign-key or enum lookup driven by field type config
• autocomplete, radio, or search-grid lookup UI

Props

Prop	Type	Default	Description
displayValue	String
data_source__thing_id	String		thing_id UUID of a reference field type. Bind from field_type__thing_id. Not a field type name, enum id, entity id, component id, or view id.
data_source_input_params	Object	[object Object]
value	String
adding_disabled	Boolean
clear_button_visible	Boolean	true
createNew	String
enabled	Boolean	true
is_version	Boolean
display_path	String	committee__display
value_path	String	committee__display
items	Array	“
label	String
lkp_parent_thing_id	String
lookup_type	String
lookup_ui_type	String
mode	String
placeholder	String	Type here to Search
radio_group_orientation	String
record_versions	Array	“
search_grid	Object	[object Object]
search_grid_info	Object	[object Object]
selectedItem	Object	[object Object]
show_object	Boolean	true
show_object_disabled	Boolean
theme	String
thing_id	String
thing_id_column	String

Rules

• Set .data_source__thing_id to the reference field type thing_id UUID — not its display name or code, and not an enum, entity, component, or view id.
• .value (stored id) and .displayValue (label); @selected-item-changed detail.value is the full row.
• value-modified / displayValue-modified while typing; value-changed when committed id changes.
• Optional .data_source_input_params for filters.
• Do not set lookup_ui_type, display_path, or value_path — the component derives them from the field type build.
• May embed search grid internally — still use c-e0792387377784f0d83cd94a55e1a995c, not ab-data-grid directly.

Events

Event	Detail
selected-item-changed	value: Object
value-modified	String
displayValue-modified	String
value-changed	String
show-object
focus
blur

Methods

Signature	Description
focus()
clear()
createNewEntity(value: any)

What to avoid

Do not pass enum, entity, component, or view thing_id as data_source__thing_id. Do not set lookup_ui_type, display_path, or value_path. Do not use ab-select for reference field types that need search/create/show-object. Do not instantiate lookup search grid component directly in forms.

Example

<c-e0792387377784f0d83cd94a55e1a995c .data_source__thing_id=${field_type__thing_id} .data_source_input_params=${{}} .value=${value} .displayValue=${displayValue} @selected-item-changed=${onSelectedItemChanged}></c-e0792387377784f0d83cd94a55e1a995c>