Add custom search field support to ComboboxControl

[Infinite-Null]

Closes: #68760

What?

Added a searchField prop to ComboboxControl that allows specifying which option field should be used for filtering suggestions.

Why?

Currently, ComboboxControl only uses the label field to filter matching suggestions, which limits its flexibility. There are cases where users might want to search through other fields like codes, IDs, or alternate names.

This enhancement allows developers to specify which field should be used for searching, making the component more versatile while maintaining backward compatibility by defaulting to the label field.

Testing Instructions

Testing Instructions

1. Create or open any component that uses ComboboxControl
2. Add an array of options with multiple fields, for example:

const options = [
  {
    value: 'us',
    label: 'United States',
    code: 'USA'
  },
  {
    value: 'uk',
    label: 'United Kingdom',
    code: 'GBR'
  }
];

3. Set up the ComboboxControl with the new searchField prop:

<ComboboxControl
  options={options}
  searchField="code"
/>

4. Type 'USA' or 'GBR' in the combobox input
5. Verify that options are filtered based on the code field instead of the label
6. Try removing the searchField prop and verify it falls back to searching by label

Screencast

Code for combobox:

<ComboboxControl
	__next40pxDefaultSize
	__nextHasNoMarginBottom
	options={ [
		{
		 value: 'dollor',
		 label: '$',
		 code: 'usd',
		},
		{
		 value: 'rupee',
		 label: '₹',
		 code: 'inr',
		},
	] }
	searchField="code"
/>

Screen.Recording.2025-01-22.at.12.26.25.PM.mov

[github-actions]

The following accounts have interacted with this PR and/or linked issues. I will continue to update these lists as activity occurs. You can also manually ask me to refresh this list by adding the props-bot label.

If you're merging code through a pull request on GitHub, copy and paste the following into the bottom of the merge commit message.

Co-authored-by: Infinite-Null <[email protected]>
Co-authored-by: picocodes <[email protected]>

To understand the WordPress project's expectations around crediting contributors, please review the Contributor Attribution page in the Core Handbook.