Implementar componente API de localización

Este ejemplo muestra cómo se realiza la localización para componentes de código. En este ejemplo, usamos Incrementar componente para localizar el texto que se muestra en el botón de incremento basado en el idioma seleccionado del usuario.

Nota

La localización del tiempo de ejecución del componente de código se encuentra en Vista previa pública para la página personalizada y las aplicaciones de lienzo. Más información: Blog: soporte de localización en tiempo de ejecución para componentes de código en páginas personalizadas y aplicaciones de lienzo.

Power Apps component framework usa el concepto de implementar recursos web String(resx) que se usa para administrar las cadenas localizadas mostradas en cualquier interfaz de usuario. Más información: Recursos web de cadenas RESX.

Disponible para

Aplicaciones de lienzo y basadas en modelos

Código

Puede descargar el componente de ejemplo completo aquí.

Para localizar un proyecto existente, todo lo que debe hacer es crear archivos de recursos(resx) adicionales, uno para cada idioma específico que se menciona en los recursos web de cadena e incluirlos como parte del archivo de manifiesto del control en el nodo recursos.

Power Apps component framework identifica el idioma del usuario y devuelve las cadenas del archivo de recursos específico del idioma cuando usted intenta acceder a la cadena utilizando el método context.resources.getString.

En este ejemplo, dos idiomas Spanish y Finnish con los códigos de idioma 3082 y 1035 definidos respectivamente. Hemos hecho una copia del ejemplo Increment component y le hemos cambiado el nombre a Localization API. Todos los archivos correspondientes incluidos los archivos de las subcarpetas cambian de nombre en consecuencia.

En la carpeta de cadenas en TS_LocalizationAPI, se agregan dos archivos resx adicionales con los sufijos correspondiente a español y finés como 3082 y 1035. Los nuevos archivos creados deben tener los nombres de archivo que terminan en {filename}.3082.resx y {filename}.1035.resx porque el marco usa esta convención de nomenclatura para identificar qué archivo de recursos se debe seleccionar para leer las cadenas para el usuario.

Asegúrese de que las teclas usadas para las cadenas en todos estos archivos de recursos comparten el mismo nombre en todos los idiomas. Ahora, cuando el componente se genere en la interfaz de usuario, podemos ver en el código que recuperamos el valor que se mostrará en el botón mediante context.resources.getString("PCF_LocalizationSample_ButtonLabel").

Cuando esta línea de origen se ejecute, Power Apps component framework identifica automáticamente el idioma del usuario y recoge el valor de la etiqueta del botón con la tecla proporcionada en el archivo de idioma correspondiente que definimos. A continuación se proporciona el texto que ve para cada uno de los 3 idiomas que admitimos para este componente de ejemplo.

LanguageCode	Valor mostrado
3082	Incremento
3082	Increment
1035	lisäys

Temas relacionados

Descargar componentes de ejemplo
¿Cómo usar los componentes de ejemplo?
Referencia de la API de Power Apps component framework
Referencia de esquema de manifiesto de Power Apps component framework

Nota

¿Puede indicarnos sus preferencias de idioma de documentación? Realice una breve encuesta. (tenga en cuenta que esta encuesta está en inglés)

La encuesta durará unos siete minutos. No se recopilan datos personales (declaración de privacidad).