Course contentsShow
← Web Development
Lesson 2513 of 2,98245. InternationalizationFree lesson

Updating Document Language Attribute

Dynamically update the html lang attribute when language changes for accessibility and SEO.

Updating Document Language Attribute

What you'll learn: How to dynamically update the html element's lang attribute when users change languages, ensuring accessibility tools and search engines stay in sync.

Why This Matters

When a user switches languages on your site, it's not enough to just swap out the visible text. The <html lang="..."> attribute tells screen readers which pronunciation rules to use and signals to search engines what language the page currently displays. Without updating it, a French-speaking screen reader user might hear French content read with English pronunciation rules—a frustrating experience.

Think of the lang attribute as the document's voice setting. Just as you'd adjust your phone's voice assistant language, you need to update this attribute when content language changes.

The Implementation

After the user changes language (via your switcher UI), immediately update the root element:

function updateDocumentLanguage(newLocale) {
  // newLocale is something like 'fr', 'es', 'en-US'
  document.documentElement.lang = newLocale;
}

// Called after language switch
function handleLanguageChange(selectedLanguage) {
  // Update your content (using methods from previous lessons)
  loadTranslations(selectedLanguage);
  
  // Update the document language attribute
  updateDocumentLanguage(selectedLanguage);
  
  // Persist preference
  localStorage.setItem('preferredLanguage', selectedLanguage);
}

The document.documentElement references the <html> element itself. By setting its lang property, you modify the attribute screen readers and SEO crawlers rely on.

Best Practice

Always update the lang attribute after content has changed, ensuring assistive technologies announce the new content with correct pronunciation from the first word.

Key Takeaway: Dynamically updating document.documentElement.lang keeps your page's language declaration synchronized with its content, maintaining accessibility compliance and SEO accuracy during client-side language switches.