feat(dropdown): add renderSelectedItem prop

[kevinsperrine]

Closes #10038

Adds a renderSelectedItem prop as a callback when it would be helpful to render the currently selected item as an element instead of just text

Changelog

New

• renderSelectedItem prop that is called to render the current selectedItem as an element
• added unit tests
• added RenderSelectedItem demo story

Changed

• if given, renderSelectedItem will be called and passed the currently selected item allowing the consumer to render the item as desired
• updated public api snapshot

Testing / Reviewing

• Added a RenderSelectedItem story to demonstrate the functionality
• added new tests to confirm

[netlify]

✔️ Deploy Preview for carbon-react-next ready!

🔨 Explore the source changes: facc191

🔍 Inspect the deploy log: https://app.netlify.com/sites/carbon-react-next/deploys/61af9aad4139e1000780b0bd

😎 Browse the preview: https://deploy-preview-10188--carbon-react-next.netlify.app

[netlify]

✔️ Deploy Preview for carbon-elements ready!

🔨 Explore the source changes: facc191

🔍 Inspect the deploy log: https://app.netlify.com/sites/carbon-elements/deploys/61af9aad98d7200007f3e2a7

😎 Browse the preview: https://deploy-preview-10188--carbon-elements.netlify.app

[netlify]

✔️ Deploy Preview for carbon-components-react ready!
Built without sensitive environment variables

🔨 Explore the source changes: facc191

🔍 Inspect the deploy log: https://app.netlify.com/sites/carbon-components-react/deploys/61af9aadffe84500074f6068

😎 Browse the preview: https://deploy-preview-10188--carbon-components-react.netlify.app

[dakahn]

Hey there! Code lgtm, but do you think we could demonstrate this props intended usage in the story you've built out. Might help with reviews as well 👍🏾

[kevinsperrine]

Hey there! Code lgtm, but do you think we could demonstrate this props intended usage in the story you've built out. Might help with reviews as well 👍🏾

Yep! @dakahn, I just pushed up a version that uses icons in both the itemToElement callback for when the dropdown is open and the renderSelectedItem for when an item has been chosen.

[dakahn]

This looks good to me! The story is a big help thanks. Tested and speaks as expected with both NVDA and JAWS 2021 on Windows 11 🏄🏾