Extensión local

Una utilidad para ampliar una configuración regional existente con traducciones personalizadas.

@@pH000@@Uso del producto

Utilice la utilidad de importación automática extendLocale para personalizar una configuración regional existente anulando propiedades o mensajes específicos.

<script setup lang="ts">
import { en } from '@nuxt/ui/locale'

const locale = extendLocale(en, {
  code: 'en-AU',
  messages: {
    commandPalette: {
      placeholder: 'Search a component...'
    }
  }
})
</script>

<template>
  <UApp :locale="locale">
    <NuxtPage />
  </UApp>
</template>

Esto es útil cuando quieres:

  • Crear una variante regional de un idioma (por ejemplo,en-AU desde en)
  • Anular traducciones específicas sin redefinir toda la configuración regional
  • Personalice las etiquetas de componentes para su aplicación

@@pH031@@pH031

@@

Amplía una configuración regional existente con las opciones proporcionadas, fusionando profundamente los mensajes.

Parámetros

locale
Locale<M> required
La configuración regional base para extender. Import desde @nuxt/ui/locale.
options
Partial<DefineLocaleOptions<DeepPartial<M>>> required
Las propiedades a superar:

Returns: A new Locale<M> object with the merged properties.

@@pH041@@Ejemplos

Aquí hay un ejemplo que extiende la configuración regional en inglés para una variante australiana:

<script setup lang="ts">
import { en } from '@nuxt/ui/locale'

const locale = extendLocale(en, {
  name: 'English (Australia)',
  code: 'en-AU',
  messages: {
    colorMode: {
      dark: 'Dark',
      light: 'Light',
      system: 'System'
    },
    selectMenu: {
      search: 'Search…',
      noData: 'No results found',
      noMatch: 'No matching results'
    }
  }
})
</script>

<template>
  <UApp :locale="locale">
    <NuxtPage />
  </UApp>
</template>
La utilidad extendLocale utiliza la fusión profunda, por lo que sólo necesita especificar los mensajes que desea anular.

defineShortcuts

A composable to define keyboard shortcuts in your app.

extractShortcuts

A utility to extract keyboard shortcuts from menu items.