use-browser-language

Reads and subscribes to the browser language preferences

Usage

use-browser-language returns the browser language from navigator.language:

Your browser language: unknown

import { Code, Text } from '@mantine/core';
import { useBrowserLanguage } from '@mantine/hooks';

function Demo() {
  const language = useBrowserLanguage();

  return (
    <Text>
      Your browser language: <Code>{language ?? 'unknown'}</Code>
    </Text>
  );
}

usePreferredLanguages

usePreferredLanguages returns the user's preferred languages from navigator.languages, most preferred first. Use it to pick the best match among the locales your application supports:

Your preferred languages, most preferred first:

    import { Code, List, Text } from '@mantine/core';
    import { usePreferredLanguages } from '@mantine/hooks';
    
    function Demo() {
      const languages = usePreferredLanguages();
    
      return (
        <>
          <Text mb="xs">Your preferred languages, most preferred first:</Text>
          <List withPadding>
            {languages.map((language) => (
              <List.Item key={language}>
                <Code>{language}</Code>
              </List.Item>
            ))}
          </List>
        </>
      );
    }

    Definition

    function useBrowserLanguage(): string | undefined;
    function usePreferredLanguages(): readonly string[];

    Reacting to changes

    Both hooks update the value when the user changes the preferred language in the browser or operating system settings.

    Server-side rendering

    On the server and during the first client render, useBrowserLanguage returns undefined and usePreferredLanguages returns an empty array.