Compartir a través de


Localización de complementos para Office

Puede implementar cualquier esquema de localización que le resulte adecuado para su Complemento de Office. La API de JavaScript y el esquema de manifiesto de la plataforma Complementos de Office ofrecen algunas opciones. Puede usar la API de JavaScript de Office para determinar una configuración regional y mostrar cadenas basadas en la configuración regional de la aplicación de Office, o para interpretar o mostrar datos en función de la configuración regional de los datos. También puede usar el manifiesto para especificar información descriptiva y la ubicación del archivo de la aplicación específica de la configuración regional. Como alternativa, puede usar el script de Visual Studio y Microsoft Ajax para admitir la globalización y la localización.

Uso de la API de JavaScript para determinar cadenas específicas de configuración regional

La API de JavaScript de Office proporciona dos propiedades que admiten la visualización o interpretación de valores coherentes con la configuración regional de la aplicación de Office y los datos.

  • Context.displayLanguage especifica la configuración regional (o idioma) de la interfaz de usuario de la aplicación de Office. En el ejemplo siguiente se comprueba si la aplicación de Office usa la configuración regional en-US o fr-FR y muestra un saludo específico de la configuración regional.

    function sayHelloWithDisplayLanguage() {
        const myLanguage = Office.context.displayLanguage;
        switch (myLanguage) {
            case 'en-US':
                write('Hello!');
                break;
            case 'fr-FR':
                write('Bonjour!');
                break;
        }
    }
    
    // Function that writes to a div with id='message' on the page.
    function write(message) {
        document.getElementById('message').innerText += message;
    }
    
  • Context.contentLanguage especifica la configuración regional (o idioma) de los datos. Ampliando el último ejemplo de código, en lugar de comprobar la propiedad displayLanguage , asigne myLanguage el valor de la propiedad contentLanguage y use el resto del mismo código para mostrar un saludo en función de la configuración regional de los datos.

    const myLanguage = Office.context.contentLanguage;
    

Localización del control desde el manifiesto

Las técnicas para localizar con el manifiesto varían en función de si usa el manifiesto XML o el manifiesto unificado para Microsoft 365 (versión preliminar), que solo se admite en Outlook para Windows.

Cada Complemento de Office especifica un elemento DefaultLocale y una configuración regional en su manifiesto. De forma predeterminada, la plataforma de complementos de Office y las aplicaciones cliente de Office aplican los valores de los elementos Description, DisplayName, IconUrl, HighResolutionIconUrl y SourceLocation a todas las configuraciones regionales. Opcionalmente, si desea aceptar valores específicos para configuraciones regionales específicas, puede especificar un elemento secundario Override para cada configuración adicional, para cualquiera de estos cinco elementos. El valor del elemento DefaultLocale y del Locale atributo del elemento Override se especifica según RFC 3066, "Tags for the Identification of Languages". En la tabla 1 se describe la compatibilidad con la localización de estos elementos.

Tabla 1. Soporte de localización

Elemento Compatibilidad de localización
Descripción Los usuarios de las configuraciones regionales que especifique pueden ver una descripción localizada del complemento en AppSource (o en un catálogo privado).
Para los complementos de Outlook, los usuarios pueden ver la descripción en el Centro de administración de Exchange (EAC) después de la instalación.
DisplayName Los usuarios de las configuraciones regionales que especifique pueden ver una descripción localizada del complemento en AppSource (o en un catálogo privado).
Para los complementos de Outlook, los usuarios pueden ver el nombre para mostrar como una etiqueta del botón de aplicación de Outlook y en el EAC después de la instalación.
En el caso de los complementos de contenido y panel de tareas, los usuarios pueden ver el nombre para mostrar en la cinta de opciones después de instalar el complemento.
IconUrl La imagen de icono es opcional. Puede usar la misma técnica de reemplazo para especificar una imagen concreta para una referencia cultural específica. Si usa y localiza el icono, los usuarios de cada configuración regional que especifique verán una imagen de icono localizada del complemento.
En el caso de los complemento de Outlook, los usuarios podrán ver el icono en el EAC después de instalar el complemento.
En el caso de los complementos de contenido y panel de tareas, los usuarios pueden ver el icono en la cinta de opciones después de instalar el complemento.
HighResolutionIconUrlImportante: Este elemento solo está disponible al usar el manifiesto del complemento versión 1.1. La imagen de icono de alta resolución es opcional, pero si se especifica, debe producirse después del elemento IconUrl . Si especifica HighResolutionIconUrl y el complemento está instalado en un dispositivo compatible con una resolución con valores altos de ppp, se usará el valor HighResolutionIconUrl en lugar de IconUrl.
Puede usar la misma técnica de reemplazo para especificar una imagen concreta para una referencia cultural específica. Si usa y localiza el icono, los usuarios de cada configuración regional que especifique verán una imagen de icono localizada del complemento.
En el caso de los complemento de Outlook, los usuarios podrán ver el icono en el EAC después de instalar el complemento.
En el caso de los complementos de contenido y panel de tareas, los usuarios pueden ver el icono en la cinta de opciones después de instalar el complemento.
RecursosImportante: Este elemento solo está disponible cuando se usa el manifiesto del complemento versión 1.1. Los usuarios de cada configuración regional que especifique pueden ver los recursos de cadena y de icono que cree específicamente para el complemento en esa configuración regional.
SourceLocation Los usuarios de las configuraciones regionales que especifique pueden ver una página web que diseñe específicamente para el complemento para esa configuración regional.

Nota:

Puede localizar la descripción y el nombre para mostrar solo para las configuraciones regionales compatibles con Office. Consulte Información general sobre la implementación de idiomas para Aplicaciones Microsoft 365 para obtener una lista de idiomas y configuraciones regionales para la versión actual de Office.

Ejemplos

Por ejemplo, un complemento de Office puede especificar DefaultLocale como en-us. Para el elemento DisplayName , el complemento puede especificar un elemento secundario Override para la configuración regional fr-fr, como se muestra a continuación.

<DefaultLocale>en-us</DefaultLocale>
...
<DisplayName DefaultValue="Video player">
    <Override Locale="fr-fr" Value="Lecteur vidéo" />
</DisplayName>

Nota:

Si tiene que adaptar para más de una zona en una familia de idioma, como de-de y de-at, se recomienda usar elementos Override independientes para cada zona. El uso del nombre de idioma por sí solo, en este caso, , deno se admite en todas las combinaciones de aplicaciones y plataformas cliente de Office.

Esto significa que el complemento asume la en-us configuración regional de forma predeterminada. Los usuarios verán el nombre para mostrar en inglés ("Video player") para todas las configuraciones regionales, excepto si la configuración regional del equipo cliente es fr-fr, en cuyo caso los usuarios verán el nombre para mostrar en francés ("Lecteur vidéo").

Nota:

Solo puede especificar un único reemplazo por idioma, incluido el de la configuración regional predeterminada. Por ejemplo, si la configuración regional predeterminada es en-us no se puede especificar una invalidación para en-us también.

En el ejemplo siguiente se aplica una invalidación de configuración regional para el elemento Description . En primer lugar, especifica una configuración regional predeterminada de en-us y una descripción en inglés y, a continuación, especifica una instrucción Override con una descripción en francés para la fr-fr configuración regional.

<DefaultLocale>en-us</DefaultLocale>
...
<Description DefaultValue=
   "Watch YouTube videos referenced in the emails you receive
   without leaving your email client.">
   <Override Locale="fr-fr" Value=
   "Visualisez les vidéos YouTube référencées dans vos courriers 
   électronique directement depuis Outlook."/>
</Description>

Esto significa que el complemento asume la en-us configuración regional de forma predeterminada. Los usuarios verían la descripción en inglés del atributo DefaultValue para todas las configuraciones regionales, a menos que la configuración regional del equipo cliente sea fr-fr, en cuyo caso verían la descripción en francés.

En el ejemplo siguiente, el complemento especifica una imagen independiente que sea más adecuada para la configuración regional y la fr-fr referencia cultural. Los usuarios ven la imagen DefaultLogo.png de manera predeterminada, salvo cuando la configuración regional del equipo cliente sea fr-fr. En ese caso, los usuarios verían la imagen FrenchLogo.png.

<!-- Replace "domain" with a real web server name and path. -->
<IconUrl DefaultValue="https://<domain>/DefaultLogo.png"/>
<Override Locale="fr-fr" Value="https://<domain>/FrenchLogo.png"/>

En el ejemplo siguiente se muestra cómo localizar un recurso en la Resources sección . Aplica una invalidación de configuración regional para una imagen que es más adecuada para la ja-jp referencia cultural.

<Resources>
      <bt:Images>
        <bt:Image id="icon1_16x16" DefaultValue="https://www.contoso.com/icon_default.png">
          <bt:Override Locale="ja-jp" Value="https://www.contoso.com/ja-jp16-icon_default.png" />
        </bt:Image>
 ...

Para el elemento SourceLocation , admitir configuraciones regionales adicionales significa proporcionar un archivo HTML de origen independiente para cada una de las configuraciones regionales especificadas. Los usuarios de las configuraciones regionales que se especifiquen pueden ver una página web personalizada diseñada para ellos.

Para los complementos de Outlook, el elemento SourceLocation también se alinea con el factor de forma. Esto permite proporcionar un archivo HTML de origen localizado diferente para el factor de forma correspondiente. Puede especificar uno o más elementos secundarios Override en cada elemento de configuración aplicable (DesktopSettings, TabletSettings o PhoneSettings). En el ejemplo siguiente se muestran elementos de configuración para los factores de forma de escritorio, de tableta o smartphone, cada uno con un archivo HTML para la configuración regional predeterminada y otro para la configuración regional en francés.

<DesktopSettings>
   <SourceLocation DefaultValue="https://contoso.com/Desktop.html">
      <Override Locale="fr-fr" Value="https://contoso.com/fr/Desktop.html" />
   </SourceLocation>
   <RequestedHeight>250</RequestedHeight>
</DesktopSettings>
<TabletSettings>
   <SourceLocation DefaultValue="https://contoso.com/Tablet.html">
      <Override Locale="fr-fr" Value="https://contoso.com/fr/Tablet.html" />
   </SourceLocation>
   <RequestedHeight>200</RequestedHeight>
</TabletSettings>
<PhoneSettings>
   <SourceLocation DefaultValue="https://contoso.com/Mobile.html">
      <Override Locale="fr-fr" Value="https://contoso.com/fr/Mobile.html" />
   </SourceLocation>
</PhoneSettings>

Localización de invalidaciones extendidas

Nota:

Esta sección no es aplicable si usa el manifiesto unificado.

Algunas características de extensibilidad de los complementos de Office, como los métodos abreviados de teclado, se configuran con archivos JSON hospedados en el servidor, en lugar de con el manifiesto XML del complemento. En esta sección se supone que está familiarizado con las invalidaciones extendidas. Consulte Trabajar con invalidaciones extendidas del manifiesto y el elemento ExtendedOverrides .

Use el ResourceUrl atributo del elemento ExtendedOverrides para que Office apunte a un archivo de recursos localizados. A continuación se muestra un ejemplo.

    ...
    </VersionOverrides>  
    <ExtendedOverrides Url="https://contoso.com/addin/extended-overrides.json" 
                       ResourceUrl="https://contoso.com/addin/my-resources.json">
    </ExtendedOverrides>
</OfficeApp>

Después, el archivo de invalidaciones extendidas usa tokens en lugar de cadenas. Las cadenas de nombre de tokens en el archivo de recursos. A continuación se muestra un ejemplo que asigna un método abreviado de teclado a una función (definida en otro lugar) que muestra el panel de tareas del complemento. Tenga en cuenta este marcado:

  • El ejemplo no es muy válido. (A continuación se agrega una propiedad adicional necesaria).
  • Los tokens deben tener el formato ${resource.name-of-resource}.
{
    "actions": [
        {
            "id": "SHOWTASKPANE",
            "type": "ExecuteFunction",
            "name": "${resource.SHOWTASKPANE_action_name}"
        }
    ],
    "shortcuts": [
        {
            "action": "SHOWTASKPANE",
            "key": {
                "default": "${resource.SHOWTASKPANE_default_shortcut}"
            }
        }
    ] 
}

El archivo de recursos, que también tiene formato JSON, tiene una propiedad de nivel resources superior que se divide en subpropiedades por configuración regional. Para cada configuración regional, se asigna una cadena a cada token que se usó en el archivo de invalidaciones extendidas. A continuación se muestra un ejemplo que tiene cadenas para en-us y fr-fr. En este ejemplo, el método abreviado de teclado es el mismo en ambas configuraciones regionales, pero eso no siempre será así, especialmente cuando se localizan configuraciones regionales que tienen un alfabeto o sistema de escritura diferente y, por tanto, un teclado diferente.

{
    "resources":{ 
        "en-us": { 
            "SHOWTASKPANE_default_shortcut": { 
                "value": "CTRL+SHIFT+A", 
            }, 
            "SHOWTASKPANE_action_name": {
                "value": "Show task pane for add-in",
            }, 
        },
        "fr-fr": { 
            "SHOWTASKPANE_default_shortcut": { 
                "value": "CTRL+SHIFT+A", 
            }, 
            "SHOWTASKPANE_action_name": {
                "value": "Afficher le volet de tâche pour add-in",
              } 
        }
    }
}

No hay ninguna default propiedad en el archivo que sea del mismo nivel que las en-us secciones y fr-fr . Esto se debe a que las cadenas predeterminadas, que se usan cuando la configuración regional de la aplicación host de Office no coincide con ninguna de las propiedades ll-cc del archivo de recursos, deben definirse en el propio archivo de invalidaciones extendidas. La definición de las cadenas predeterminadas directamente en el archivo de invalidaciones extendidas garantiza que Office no descargue el archivo de recursos cuando la configuración regional de la aplicación de Office coincida con la configuración regional predeterminada del complemento (como se especifica en el manifiesto). A continuación se muestra una versión corregida del ejemplo anterior de un archivo de invalidaciones extendidas que usa tokens de recursos.

{
    "actions": [
        {
            "id": "SHOWTASKPANE",
            "type": "ExecuteFunction",
            "name": "${resource.SHOWTASKPANE_action_name}"
        }
    ],
    "shortcuts": [
        {
            "action": "SHOWTASKPANE",
            "key": {
                "default": "${resource.SHOWTASKPANE_default_shortcut}"
            }
        }
    ],
    "resources": { 
        "default": { 
            "SHOWTASKPANE_default_shortcut": { 
                "value": "CTRL+SHIFT+A", 
            }, 
            "SHOWTASKPANE_action_name": {
                "value": "Show task pane for add-in",
            } 
        }
    }
}

Ajuste de formato de fecha y hora con la configuración regional del cliente

Puede obtener la configuración regional de la interfaz de usuario de la aplicación cliente de Office mediante la propiedad displayLanguage . A continuación, puede mostrar los valores de fecha y hora en un formato coherente con la configuración regional actual de la aplicación de Office. Una forma de hacerlo es preparar un archivo de recursos que especifique el formato de presentación de fecha y hora que quiere usar para cada configuración regional que el complemento de Office admite. En tiempo de ejecución, el complemento puede usar el archivo de recursos y coincidir con el formato de fecha y hora adecuado con la configuración regional obtenida de la propiedad displayLanguage .

Puede obtener la configuración regional de los datos de la aplicación cliente de Office mediante la propiedad contentLanguage . Basándose en este valor, puede interpretar o mostrar cadenas de fecha y hora correctamente. Por ejemplo, la configuración regional jp-JP expresa los valores de fecha y hora como yyyy/MM/dd y la configuración regional fr-FR, dd/MM/yyyy.

Uso de Visual Studio para crear un complemento localizado y globalizado

Si usa Visual Studio para crear Complementos de Office, .NET Framework y Ajax ofrecen varias formas de localizar y globalizar los archivos de secuencias de comando cliente.

De este modo, puede globalizar y usar las extensiones de tipo JavaScript Date y Number, así como el objeto de JavaScript Date en el código JavaScript de una Complemento de Office para mostrar valores en función de la configuración regional del explorador actual. Para más información, vea Walkthrough: Globalizing a Date by Using Client Script.

Puede incluir cadenas de recursos localizadas directamente en los archivos independientes de JavaScript para proporcionar archivos de script cliente para distintas configuraciones regionales, que están en el navegador o son proporcionados por el usuario. Cree un archivo de script separado por cada configuración regional admitida. En cada archivo de script, incluya un objeto en formato JSON que contenga las cadenas de recursos para esa configuración regional. Los valores localizados se aplican cuando el script se ejecuta en el navegador.

Ejemplo: Cree un complemento de Office localizado

Esta sección ofrece ejemplos que le muestran cómo localizar una descripción, nombre para mostrar e IU de Complemento de Office.

Nota:

Para descargar Visual Studio, consulte la página IDE de Visual Studio. Durante la instalación debe seleccionar la carga de trabajo de desarrollo de Office y SharePoint.

Configurar Office para usar idiomas adicionales para mostrar o editar

Para ejecutar el código de ejemplo proporcionado, configure Office en el equipo para que use idiomas adicionales para que pueda probar el complemento cambiando el idioma que se usa para mostrar en menús y comandos, para editar y corregir, o ambos.

Puede usar un paquete de idioma de Office para instalar un idioma adicional. Para más información sobre los paquetes de idioma y dónde conseguirlos, vea Paquete de accesorio de idioma para Office.

Después de instalar el paquete de accesorios de idioma, puede configurar Office para usar el idioma instalado para su presentación en la interfaz de usuario o para editar el contenido del documento, o ambos. En el ejemplo de este artículo se usa una instalación de Office que aplica el paquete de idioma de español.

Crear un proyecto de complemento de Office

Tendrá que crear un proyecto de complemento de Office de Visual Studio.

Nota:

Si no ha instalado Visual Studio, consulte la página IDE de Visual Studio para obtener instrucciones de descarga. Durante la instalación debe seleccionar la carga de trabajo de desarrollo de Office y SharePoint. Si ya ha instalado Visual Studio 2019 o una versión posterior, use el Instalador de Visual Studio para asegurarse de que la carga de trabajo de desarrollo de Office/SharePoint está instalada.

  1. Seleccione Crear un nuevo proyecto.

  2. Utilizando el cuadro de búsqueda, escribacomplemento. Seleccioneun complemento de Web de Word,y a continuación, seleccioneSiguiente.

  3. Asigne al proyecto el nombre WorldReadyAddIn y seleccione Create.

  4. Visual Studio crea una solución, y los dos proyectos que contiene aparecen en el Explorador de soluciones. El archivo Home.html se abre en Visual Studio.

Localizar el texto usado en su complemento

El texto que desea localizar para otro idioma aparece en dos áreas.

  • Nombre para mostrar y descripción del complemento. Esto se controla mediante entradas en el archivo de manifiesto del complemento.

  • Interfaz de usuario del complemento. Puede localizar las cadenas que aparecen en la interfaz de usuario del complemento usando el código de JavaScript, por ejemplo, usando un archivo de recurso independiente que contenga las cadenas localizadas.

Localizar el nombre para mostrar y la descripción del complemento
  1. En el Explorador de soluciones, expanda WorldReadyAddIn, WorldReadyAddInManifest y, a continuación, elija WorldReadyAddIn.xml.

  2. En WorldReadyAddInManifest.xml, reemplace los elementos DisplayName y Description por el siguiente bloque de código.

    Nota:

    Puede reemplazar las cadenas localizadas en idioma español usadas en este ejemplo por los elementos DisplayName y Description con las cadenas localizadas para cualquier otro idioma.

    <DisplayName DefaultValue="World Ready add-in">
      <Override Locale="es-es" Value="Aplicación de uso internacional"/>
    </DisplayName>
    <Description DefaultValue="An add-in for testing localization">
      <Override Locale="es-es" Value="Una aplicación para la prueba de la localización"/>
    </Description>
    
  3. Al cambiar el idioma para mostrar de Microsoft 365 de inglés a español, por ejemplo, y luego ejecuta el complemento, el nombre para mostrar y la descripción del complemento se muestran con texto localizado.

Diseñar la interfaz de usuario del complemento
  1. En Visual Studio, en el Explorador de soluciones, elija Home.html.

  2. Reemplace los contenidos del elemento <body> en Home.html por el HTML siguiente y guarde el archivo.

    <body>
        <!-- Page content -->
        <div id="content-header" class="ms-bgColor-themePrimary ms-font-xl">
            <div class="padding">
                <h1 id="greeting" class="ms-fontColor-white"></h1>
            </div>
        </div>
        <div id="content-main">
            <div class="padding">
                <div class="ms-font-m">
                    <p id="about"></p>
                </div>
            </div>
        </div>
    </body>
    

En la siguiente figura se muestra el elemento de encabezado (h1) y el elemento de párrafo (p) donde se verá el texto localizado cuando se completen los pasos restantes y se ejecute el complemento.

Figura 1. IU del complemento

Interfaz de usuario de la aplicación con secciones resaltadas

Agregue el archivo de recursos que contiene las cadenas localizadas

El archivo de recursos de JavaScript contiene las cadenas que se usan para la interfaz de usuario del complemento. El HTML para la interfaz de usuario del complemento de ejemplo contiene un elemento <h1> que muestra un saludo y un elemento <p> que presenta el complemento al usuario.

Para habilitar cadenas localizadas para el encabezado y el párrafo, debe colocar las cadenas en un archivo de recurso separado. El archivo de recurso crea un objeto JavaScript que contiene un objeto Notación de objetos de JavaScript (JSON) separado para cada conjunto de cadenas localizadas. El archivo de recursos también proporciona un método para recuperar el objeto JSON adecuado para una configuración regional determinada.

Adición del archivo de recursos al proyecto de complemento

  1. En Explorador de soluciones de Visual Studio, haga clic derecho en el proyecto WorldReadyAddInWeb y seleccione Agregar>Nuevo elemento.

  2. En el cuadro de diálogo Agregar nuevo elemento, seleccione Archivo de JavaScript.

  3. Escriba UIStrings.js como nombre de archivo y seleccione Agregar.

  4. Agregue el siguiente código al archivo UIStrings.js y guarde el archivo.

    /* Store the locale-specific strings */
    
    const UIStrings = (function ()
    {
        "use strict";
    
        const UIStrings = {};
    
        // JSON object for English strings
        UIStrings.EN =
        {
            "Greeting": "Welcome",
            "Introduction": "This is my localized add-in."
        };
    
        // JSON object for Spanish strings
        UIStrings.ES =
        {
            "Greeting": "Bienvenido",
            "Introduction": "Esta es mi aplicación localizada."
        };
    
        UIStrings.getLocaleStrings = function (locale)
        {
            let text;
    
            // Get the resource strings that match the language.
            switch (locale)
            {
                case 'en-US':
                    text = UIStrings.EN;
                    break;
                case 'es-ES':
                    text = UIStrings.ES;
                    break;
                default:
                    text = UIStrings.EN;
                    break;
            }
    
            return text;
        };
    
        return UIStrings;
    })();
    

El archivo de recurso UIStrings.js crea un objeto, UIStrings, que contiene cadenas localizadas para la interfaz de usuario del complemento.

Localizar texto usado para la IU del complemento

Para usar el archivo de recurso en su complemento, deberá agregar una etiqueta de script para él en Home.html. Cuando se carga Home.html, UIStrings.js se ejecuta y el objeto UIStrings que se usa para obtener las cadenas está disponible para el código. Agregue el siguiente código HTML en la etiqueta head de Home.html para que UIStrings esté instalado para su código.

<!-- Resource file for localized strings: -->
<script src="../UIStrings.js" type="text/javascript"></script>

Ahora puede usar el objeto UIStrings para establecer las cadenas para la IU de su complemento.

Si desea cambiar la localización del complemento en función del idioma que se usa para mostrar en los menús y comandos de la aplicación cliente de Office, use la propiedad Office.context.displayLanguage para obtener la configuración regional de ese idioma. Por ejemplo, si el idioma de la aplicación usa español para mostrarse en menús y comandos, la propiedad Office.context.displayLanguage devolverá el código de idioma es-ES.

Si desea cambiar la localización del complemento en función del idioma que se usa para editar el contenido del documento, use la propiedad Office.context.contentLanguage para obtener la configuración regional de ese idioma. Por ejemplo, si el idioma de la aplicación usa el español para editar el contenido del documento, la propiedad Office.context.contentLanguage devolverá el código de idioma es-ES.

Una vez que sepa el idioma que usa la aplicación, puede usar UIStrings para obtener el conjunto de cadenas localizadas que coincida con el idioma de la aplicación.

Sustituya el código del archivo Home.js con el siguiente código. El código muestra cómo puede cambiar las cadenas usadas en los elementos de la interfaz de usuario en Home.html en función del idioma para mostrar de la aplicación o del idioma de edición de la aplicación.

Nota:

Para cambiar entre cambiar la localización del complemento en función del idioma utilizado para la edición, quite la marca de comentario de la línea de código const myLanguage = Office.context.contentLanguage; y comente la línea de código. const myLanguage = Office.context.displayLanguage;

/// <reference path="../App.js" />
/// <reference path="../UIStrings.js" />


(function () {
    "use strict";

    // The initialize function must be run each time a new page is loaded.
    Office.initialize = function (reason)
    {

        $(document).ready(function () {
            // Get the language setting for editing document content.
            // To test this, uncomment the following line and then comment out the
            // line that uses Office.context.displayLanguage.
            // const myLanguage = Office.context.contentLanguage;

            // Get the language setting for UI display in the Office application.
            const myLanguage = Office.context.displayLanguage;
            let UIText;

            // Get the resource strings that match the language.
            // Use the UIStrings object from the UIStrings.js file
            // to get the JSON object with the correct localized strings.
            UIText = UIStrings.getLocaleStrings(myLanguage);

            // Set localized text for UI elements.
            $("#greeting").text(UIText.Greeting);
            $("#about").text(UIText.Introduction);
        });
    };
})();

Pruebe su complemento localizado

Para probar el complemento localizado, cambie el idioma usado para mostrar o editar en la aplicación de Office y, a continuación, ejecute el complemento.

  1. En Word, seleccione Archivo>Opciones>Idioma. La figura siguiente muestra el cuadro de diálogo Opciones de Word abierto en la pestaña Idioma.

    Figura 2. Opciones de idioma en el cuadro de diálogo Opciones de Word

    Word cuadro de diálogo Opciones.

  2. En Elegir idioma para mostrar, seleccione el idioma que quiera para la interfaz de usuario, por ejemplo, español, y luego elija la flecha arriba para desplazar español a la primera posición en la lista. Como alternativa, para cambiar el idioma utilizado para la edición, en Elegir idiomas de edición, elija el idioma que desea usar para la edición, por ejemplo, español y, a continuación, elija Establecer como predeterminado.

  3. Elija Aceptar para confirmar su selección y luego cierre Word.

  4. Presione F5 en Visual Studio para ejecutar el complemento de ejemplo o elija Depurar>Iniciar depuración en la barra de menús.

  5. En Word, seleccione Inicio>Mostrar Panel de tareas.

Una vez en ejecución, las cadenas de la interfaz de usuario del complemento cambian para que coincidan con el idioma usado por la aplicación, como se muestra en la ilustración siguiente.

Figura 3. IU del complemento con texto localizado

Aplicación con texto de interfaz de usuario localizado.

Consulte también