# vue: URL: https://generaltranslation.com/es/docs/vue/reference/components/t.mdx --- title: "" description: Traduce el contenido de las plantillas de Vue en el mismo documento. Referencia de la API del componente . --- El componente `` lee contenido creado estáticamente desde su slot predeterminado y renderiza la entrada coincidente del catálogo de contenido enriquecido. Si faltan entradas, renderiza el slot original y no añade ningún contenedor HTML. ## Resumen [#overview] Agrupa el texto y el marcado que deben formar una sola traducción: ```vue Hoy fui a la tienda. ``` Usa [``](/docs/vue/reference/components/var), [``](/docs/vue/reference/components/num), [``](/docs/vue/reference/components/currency) y [``](/docs/vue/reference/components/datetime) para valores en tiempo de ejecución. Usa [``](/docs/vue/reference/components/plural) o [``](/docs/vue/reference/components/branch) para las alternativas. ## Cómo funciona [#how-it-works] * **Extracción estática.** La CLI extrae la estructura literal de la plantilla, los metadatos de traducción, las props de texto compatibles y todas las ramas compatibles. Las expresiones de tiempo de ejecución que aportan contenido traducido deben envolverse en un componente variable; las props normales de los componentes y los listeners siguen siendo valores de tiempo de ejecución. * **Búsqueda en el catálogo.** El componente calcula el hash de su estructura fuente y sus metadatos, y luego lee esa entrada del catálogo del plugin activo. Si la entrada no existe o es incompatible, recurre al slot de origen. * **Renderizado reactivo.** Con un plugin [`createGT()`](/docs/vue/reference/functions/create-gt), la carga de un nuevo catálogo o un cambio de configuración regional vuelve a renderizar la búsqueda. Un plugin devuelto por [`initializeGTSPA()`](/docs/vue/reference/functions/initialize-gt-spa) realiza la precarga antes del montaje y cambia la configuración regional recargando la página. * **Raíz de Fragment.** El componente siempre devuelve un límite de Fragment de Vue. No inserta ningún elemento DOM, y la salida traducida puede contener cero, uno o varios elementos hijos sin modificar ese límite del componente. `` no procesa sintaxis ICU ni interpola marcadores de posición. Coloca cada valor dinámico en el componente variable adecuado. ## Props y slots [#props] | Nombre | Descripción | Tipo | Opcional | Predeterminado | | ----------------------------------- | -------------------------------------------------------------- | ------------ | -------- | -------------- | | [`default`](#default-slot) | Contenido estático de la plantilla que se debe traducir. | `VNodeChild` | Sí | Vacío | | [`context`](#context) | Contexto que permite desambiguar contenido de origen idéntico. | `string` | Sí | — | | [`id`](#id) | Metadatos de compatibilidad obsoletos. | `string` | Sí | — | | [`maxChars`](#maxchars) | Longitud máxima solicitada para la traducción. | `number` | Sí | — | | [`requiresReview`](#requiresreview) | Indica que la entrada requiere revisión humana. | `boolean` | Sí | `false` | ### Slot predeterminado **Tipo** `VNodeChild` · **Opcional** · **Predeterminado** Vacío El texto, los elementos, los componentes y las ramas compatibles que componen la traducción. El contenido debe ser estático, excepto los valores envueltos en componentes variables. ### `context` **Tipo** `string` · **Opcional** Contexto estático que se utiliza al calcular el hash del contenido. Úsalo cuando el mismo texto de origen requiera traducciones distintas, como `"Open"` cuando se usa como verbo o como adjetivo. ```vue Open ``` ### `id` **Tipo** `string` · **Opcional** · **Obsoleto** Metadatos de compatibilidad para código adaptado de la API de React. No sustituye el hash de catálogo basado en contenido de Vue y no debe usarse como identificador estable de traducción. ### `maxChars` **Tipo** `number` · **Opcional** Número máximo de caracteres solicitado a las herramientas de traducción. Son metadatos de traducción; el tiempo de ejecución de Vue no trunca la salida renderizada. Usa un entero vinculado estáticamente en una plantilla: ```vue Save your changes ``` ### `requiresReview` **Tipo** `boolean` · **Opcional** · **Predeterminado** `false` Indica que la entrada de traducción requiere revisión humana. Son metadatos de traducción y no modifican el renderizado por sí solos. ```vue Terms and conditions apply. ``` ## Reglas de plantilla [#template-rules] Mantén la estructura del contenido de origen determinista para que la extracción y el renderizado en tiempo de ejecución sean coherentes: * No anides un `` dentro de otro. * Envuelve cada interpolación y cualquier otro valor de tiempo de ejecución que se renderice como contenido traducido en un componente variable. * Mueve `v-if`, `v-else-if`, `v-else` y `v-for` fuera de la traducción, o representa las alternativas con [``](/docs/vue/reference/components/branch) o [``](/docs/vue/reference/components/plural). * No uses `v-html`, `v-text` ni `` dentro de la traducción. * Usa etiquetas directas para los componentes personalizados. Las formas de selector como `` e `is="vue:..."` solo son compatibles con componentes de GT reconocidos o elementos integrados de Vue compatibles que el extractor resuelve explícitamente; no se admiten selectores personalizados arbitrarios, seleccionados en tiempo de ejecución ni sin resolver. * Mantén `context` e `id` como cadenas estáticas, `maxChars` como un entero vinculado estáticamente y `requiresReview` como un booleano estático o un atributo sin valor. Las props estáticas `placeholder`, `title`, `alt`, `aria-label`, `aria-labelledby` y `aria-describedby` de elementos HTML y componentes personalizados participan en la traducción cuando los valores secundarios, tanto los originales como los traducidos, superan la comprobación de veracidad en tiempo de ejecución. Los elementos sin valores secundarios, como ``, y los nodos cuyo valor secundario original o traducido sea falso conservan sus props de origen. Traduce por separado las props de texto de esos elementos con [`useGT()`](/docs/vue/reference/composables/use-gt). No se admiten versiones dinámicas de estas props de texto dentro de ``. ```vue title="ProfileGreeting.vue" ``` ## Límites de los componentes [#components] El contenido del slot predeterminado definido estáticamente dentro de un componente personalizado sigue formando parte de la traducción circundante. Vue conserva el componente, las props de tiempo de ejecución no traducibles, los listeners y la identidad, y reemplaza su contenido del slot predeterminado y las props de texto estático compatibles: ```vue Lee la documentación ``` El contenido creado dentro de la implementación de `DocsLink` no es visible para la traducción externa. Use una etiqueta directa para un componente personalizado. Las formas de selector se limitan a componentes de GT reconocidos y elementos integrados compatibles de Vue que el extractor resuelve explícitamente; los selectores personalizados arbitrarios, seleccionados en tiempo de ejecución o sin resolver no son fuentes de traducción. Para slots con ámbito o con nombre arbitrario de componentes personalizados, coloque `` dentro del slot. También puede envolver un límite opaco de componente dinámico en [``](/docs/vue/reference/components/var). Los límites literales de `` admiten un slot predeterminado estático con una única raíz. Ese contenido predeterminado participa en la traducción externa, mientras que el slot de contenido alternativo se conserva, pero se excluye. Coloque componentes `` separados dentro de los slots predeterminado y de contenido alternativo cuando el límite sea dinámico o tenga un alias de una forma que el extractor no pueda resolver. ## Espacios en blanco [#whitespace] El compilador de plantillas de Vue decide si los espacios en blanco del contenido de origen se condensan o se conservan. El extractor utiliza la configuración del compilador de Vue de la aplicación consumidora, por lo que cambiar la opción `whitespace` del compilador puede modificar el contenido de origen y su hash. Mantén los espacios significativos explícitos e inline: ```vue Hello world! ``` Evita comentarios que dividan el texto o queden junto a espacios en blanco significativos dentro de ``. Vue puede conservar los comentarios de forma distinta según la compilación, y el extractor rechaza los casos en los que esto haría que el hash de traducción dependiera de la compilación.