useCollator

Provides localized string collation for the current locale. Automatically updates when the locale changes, and handles caching of the collator for performance.

installyarn add @react-aria/i18n
version3.3.8
usageimport {useCollator} from '@react-aria/i18n'

Introduction#


useCollator wraps a builtin browser Intl.Collator object to provide a React Hook that integrates with the i18n system in React Aria. It handles string comparison according to the current locale, updating when the locale changes, and caching of collators for performance. See the Intl.Collator docs for information.

API#


useCollator( (options?: Intl.CollatorOptions )): Intl.Collator

Example#


This example includes two textfields and compares the values of the two fields using a collator according to the current locale.