fix(a11y): add lang attribute to language selector for better SR accessibility (#8689)

* fix(ui-components): implement hrefLang in language selector for better a11y

* test(ui-components): update language selector stories with localized examples

* fix(ui-components): refine language dropdown a11y for cross-browser consistency

Author: ShubhamOulkar

packages/ui-components/src/Common/LanguageDropDown/index.stories.tsx

@@ -8,12 +8,32 @@ type Meta = MetaObj<typeof LanguageDropDown>;
 export const Default: Story = {
   args: {
     availableLanguages: [
-      { name: 'English', code: 'en', localName: 'English' },
-      { name: 'French', code: 'fr', localName: 'Français' },
-      { name: 'Spanish', code: 'es', localName: 'Español' },
+      { name: 'English', code: 'en', localName: 'English', hrefLang: 'en-GB' },
+      { name: 'French', code: 'fr', localName: 'Français', hrefLang: 'fr' },
+      { name: 'Spanish', code: 'es', localName: 'Español', hrefLang: 'es-ES' },
+      { name: 'Japanese', code: 'ja', localName: '日本語', hrefLang: 'ja' },
+      {
+        name: 'Simplified Chinese',
+        code: 'zh-cn',
+        localName: '简体中文',
+        hrefLang: 'zh-Hans',
+      },
+      {
+        name: 'Traditional Chinese',
+        code: 'zh-tw',
+        localName: '繁體中文',
+        hrefLang: 'zh-Hant',
+      },
     ],
     currentLanguage: 'en',
   },
 };
 
+export const Japanese: Story = {
+  args: {
+    ...Default.args,
+    currentLanguage: 'ja',
+  },
+};
+
 export default { component: LanguageDropDown } as Meta;

packages/ui-components/src/Common/LanguageDropDown/index.tsx

@@ -35,15 +35,18 @@ const LanguageDropdown: FC<LanguageDropDownProps> = ({
           sideOffset={5}
         >
           <div>
-            {availableLanguages.map(({ name, code, localName }) => (
+            {availableLanguages.map(({ name, code, localName, hrefLang }) => (
               <DropdownMenu.Item
                 key={code}
-                onClick={() => onChange({ name, code, localName })}
+                aria-label={name}
+                onClick={() => onChange({ name, code, localName, hrefLang })}
                 className={classNames(styles.dropDownItem, {
                   [styles.currentDropDown]: code === currentLanguage,
                 })}
               >
-                {localName}
+                <span lang={hrefLang} aria-hidden="true">
+                  {localName}
+                </span>
               </DropdownMenu.Item>
             ))}
           </div>

packages/ui-components/src/types.ts

@@ -22,4 +22,5 @@ export type SimpleLocaleConfig = {
   code: string;
   localName: string;
   name: string;
+  hrefLang: string;
 };