Combobox/Combobox-item - allow filtering by textLabel only

[ian13262]

Check existing issues

• I have checked for existing issues to avoid duplicates

Description

For calcite-combobox-items with significantly different value and textLabel properties, it would be helpful to only allow filtering by textLabel rather than the underlying value as well.

This prevents confusing situations like this in which value is an English string and textLabel is a localized string in a different language:

Applies to any use case where, for some reason (uniqueness, localization, etc.), value and textLabel are quite different.

Acceptance Criteria

A new property on calcite-combobox would be helpful (something like filterMode = "value" | "text-label", defaulting to both if not specified).

Relevant Info

No response

Which Component

calcite-combobox, calcite-combobox-item

Example Use Case

See above

Priority impact

p4 - not time sensitive

Calcite package

• @esri/calcite-components
• @esri/calcite-components-react
• @esri/calcite-design-tokens
• @esri/eslint-plugin-calcite-components

Esri team

ArcGIS Online

[geospatialem]

Related #7176

[jcfranco]

Combobox should follow the same approach from #9622.

Worth noting that the default behavior of including value in filtering will likely change in v3 (see #9615).

[geospatialem]

Determine if could be coupled with #9018 for R3, or if we need to tackle for 25.R1.

[github-actions]

Installed and assigned for verification.

[geospatialem]

Verified with https://codepen.io/geospatialem/pen/PwYOmOj in 3.0.0-next.88 with the combobox's new filterProps property:

document.querySelector("calcite-combobox").filterProps = ["textLabel", "description"];