Even better accessibility, React Native and ReasonReact support, even simpler
API, improved docs, new examples site, Flow and TypeScript support, and a new
online community ⚛️
I’m excited to let the world know that downshift 2.0.0 has been released! So I’m
going to do it now:
Hey world! downshift 2.0.0 has been released!
Woo! So what do you have to look forward to? Let’s dive in! (If you haven’t
heard of downshift, consider reading
the original release post).
Improved Accessibility (#a11y)
Lead primarily by Michael Ball (with helpful
reviews from several others), we
received a number of
improvements to the accessibility features baked-into downshift. He also added a
new
getMenuProps
prop getter
(which was also instrumental in fixing
a bug with React Portals).
This allows us to add some aria- attributes to the menu you render that will
help assistive technologies use your enhanced input components! Woo! I’ve also
updated many of the examples to use more semantically correct elements.
React Native Support
We’ve actually had this for a while in 1.x, but I wanted to include this in the
blog post because there was never really an official announcement and I think
that this is great! This is largely thanks to work by
Eli Perkins! They’ve already shipped downshift
to production in their iOS app:
ReasonReact Support
We’ve actually had this for a while too, but I want to call it out especially.
Thanks to Nicola Molinari there are
official Reason bindings for downshift.
So you can build UIs for any platform you can imagine with downshift and
ReasonML. Soooo cool!
Simpler API
It’s generally a good idea to avoid APIs which allow two ways to do the same
thing. It’s just another thing to list in docs, and you have to help people
understand what the differences are (if there are any).
Up until downshift 2.0.0, we had two props that could be used for your
render prop:
render and children. Then React released the official context API which uses
render props and they called it children. In an effort to develop consistency
throughout the ecosystem, we’ve dropped the prop called render and now only
support children.
Improved Docs
After downshift was out for a while, I started to realize that folks missed out
on some of the more useful and necessary props (like
itemToString).
I blame myself for this and recently reorganized the docs to make more relevant
information more apparent.
New Examples Site
It’s just getting started (so there are only a few examples), but it’s here and
ready for contributions!
Find it and contribute
(right in the browser!)
on codesandbox!
Improved TypeScript Support
A great effort lead primarily by
@stereobooster has lead to improved
TypeScript definitions for downshift. Even if you don’t use TypeScript, you’ll
benefit from these typings as they will help ensure we don’t publish breaking
changes unknowingly and if you use VSCode you’ll benefit from these typings with
the built-in Intellisense!
Support for Flow!
Another awesome contribution by
@stereobooster. We’re now generating flow
type definitions from the TypeScript definitions, so if you’re on the Flow
train, you’ll get more type-safety when working with downshift!
We’re on spectrum!
Yeehaw! Join us there to talk about the present and future of downshift and get
help/help others.
Thanks
This release and these amazing features would not be possible without help from
all our open source contributors. I’d like to especially thank these awesome
people:
@stereobooster,
@franklixuefei,
@dovidweisz,
@Antontelesh,
@tansongyang,
@Andarist,
@cycomachead,
@mperrotti,
@SiTaggart, and
@1Copenut
Thank you!
Source link
