Localização para Suplementos do Office

Você pode implementar qualquer esquema de localização que seja apropriado para o seu Suplemento do Office. A API JavaScript e o esquema do manifesto da plataforma de Suplementos do Office oferecem algumas opções. Você pode usar a API JavaScript do Office para determinar uma localidade e exibir cadeias de caracteres com base na localidade do aplicativo do Office ou para interpretar ou exibir dados com base na localidade dos dados. Você pode usar o manifesto para especificar informações descritivas e o local do arquivo do suplemento específico da localidade. Como alternativa, você pode usar o script do Visual Studio e do Microsoft Ajax para dar suporte à globalização e à localização.

Usar a API JavaScript para determinar cadeias de caracteres específicas da localidade

A API JavaScript do Office fornece duas propriedades que dão suporte à exibição ou interpretação de valores consistentes com a localidade do aplicativo e dos dados do Office.

  • Context.displayLanguage especifica a localidade (ou idioma) da interface do usuário do aplicativo do Office. O exemplo a seguir verifica se o aplicativo do Office usa a localidade en-US ou fr-FR e exibe uma saudação específica da localidade.

    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 a localidade (ou idioma) dos dados. Estendendo o último exemplo de código, em vez de verificar a propriedade displayLanguage, atribuamyLanguage o valor da propriedade contentLanguage e use o restante do mesmo código para exibir uma saudação com base na localidade dos dados.

    const myLanguage = Office.context.contentLanguage;
    

Controlar a localização do manifesto

As técnicas de localização com o manifesto diferem dependendo se você está usando o manifesto XML ou o manifesto unificado do Microsoft 365 (versão prévia) que tem suporte apenas no Outlook para Windows.

Cada Suplemento do Office especifica um elemento DefaultLocale e uma localidade em seu manifesto. Por padrão, a plataforma suplemento do Office e os aplicativos cliente do Office aplicam os valores dos elementos Description, DisplayName, IconUrl, HighResolutionIconUrl e SourceLocation a todas as localidades. Como opção, você pode dar suporte a valores específicos para localidades específicas, especificando um elemento-filho Overridepara cada localidade adicional, para qualquer um desses cinco elementos. O valor para o elemento DefaultLocale e para o Locale atributo do elemento Override é especificado de acordo com RFC 3066, "Tags for the Identification of Languages". A Tabela 1 descreve o suporte de localização para esses elementos.

Tabela 1. Suporte de localização

Elemento Suporte de localização
Descrição Os usuários de cada localidade especificada podem ver uma descrição localizada do suplemento no AppSource (ou no catálogo privado).
Para os suplementos do Outlook, os usuários podem ver a descrição no Centro de Administração do Exchange (EAC) após a instalação.
DisplayName Os usuários de cada localidade especificada podem ver uma descrição localizada do suplemento no AppSource (ou no catálogo privado).
Para os suplementos do Outlook, os usuários podem ver o nome de exibição como um rótulo para o botão de suplemento do Outlook e no EAC após a instalação.
Para suplementos de conteúdo e painel de tarefas, os usuários podem ver o nome de exibição na faixa de opções depois de instalar o suplemento.
IconUrl A imagem do ícone é opcional. Você pode usar a mesma técnica de substituição para especificar uma determinada imagem para uma cultura específica. Se você usar e localizar um ícone, os usuários em cada localidade que você especificar podem ver uma imagem de ícone localizada para o suplemento.
Para suplementos do Outlook, os usuários podem ver o ícone no EAC depois de instalar o suplemento.
Para suplementos de conteúdo e painel de tarefas, os usuários podem ver o ícone na faixa de opções depois de instalar o suplemento.
HighResolutionIconUrlImportante: este elemento só fica disponível ao usar a versão 1.1 do manifesto do suplemento. A imagem de ícone de alta resolução é opcional, mas, se for especificada, ela deve ocorrer após o elemento IconUrl . Quando HighResolutionIconUrl for especificado e o suplemento estiver instalado em um dispositivo que ofereça suporte à resolução dpi alto, o valor HighResolutionIconUrl é usado em vez do valor para IconUrl.
Você pode usar a mesma técnica de substituição para especificar uma determinada imagem para uma cultura específica. Se você usar e localizar um ícone, os usuários em cada localidade que você especificar podem ver uma imagem de ícone localizada para o suplemento.
Para suplementos do Outlook, os usuários podem ver o ícone no EAC depois de instalar o suplemento.
Para suplementos de conteúdo e painel de tarefas, os usuários podem ver o ícone na faixa de opções depois de instalar o suplemento.
RecursosImportante: este elemento só fica disponível ao usar a versão 1.1 do manifesto do suplemento. Os usuários em cada localidade especificada podem ver recursos de cadeias de caracteres e de ícones que você projetou especificamente para o suplemento dessa localidade.
SourceLocation Os usuários em cada localidade especificada podem ver uma página da Web que você projetou especificamente para o suplemento dessa localidade.

Observação

Você só pode localizar o nome de exibição e a descrição das localidades para as quais o Office oferece suporte. Consulte Visão geral da implantação de idiomas para Microsoft 365 Apps para obter uma lista de idiomas e localidades para a versão atual do Office.

Exemplos

Por exemplo, um Suplemento do Office pode especificar DefaultLocale como en-us. Para o elemento DisplayName, o suplemento pode especificar um elemento filho Override para a localidade fr-fr, como mostrado abaixo.

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

Observação

Se for preciso localizar para mais de uma área dentro de uma família de idiomas, como de-de e de-at, recomendamos que você use elementos Override separados para cada área. Usando o nome do idioma sozinho, nesse caso, denão há suporte em todas as combinações de aplicativos e plataformas cliente do Office.

Isso significa que o suplemento pressupõe a en-us localidade por padrão. Os usuários veem o nome de exibição em inglês "Video player" para todas as localidades, a menos que a localidade do computador cliente fosse fr-fr, nesse caso os usuários veria o nome de exibição em francês "Lecteur vidéo".

Observação

Você só pode especificar uma única substituição por idioma, inclusive para a localidade padrão. Por exemplo, se sua localidade padrão for en-us , você também não poderá especificar uma substituição en-us .

O exemplo a seguir aplica uma substituição de localidade para o elemento Description . Primeiro, especifica uma localidade padrão de e uma descrição en-us em inglês e especifica uma instrução Override com uma descrição em francês para a fr-fr localidade.

<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>

Isso significa que o suplemento pressupõe a en-us localidade por padrão. Os usuários veriam a descrição em inglês no atributo DefaultValue para todas as localidades, a menos que a localidade do computador cliente fosse fr-fr, nesse caso, eles veriam a descrição em francês.

No exemplo a seguir, o suplemento especifica uma imagem separada mais apropriada para a localidade e a fr-fr cultura. Os usuários verão a imagem DefaultLogo.png por padrão, exceto quando a localidade do computador cliente for fr-fr. Nesse caso, os usuários veriam a imagem 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"/>

O exemplo a seguir mostra como localizar um recurso na Resources seção. Ele aplica uma substituição de localidade para uma imagem mais apropriada para a ja-jp cultura.

<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 o elemento SourceLocation , dar suporte a localidades adicionais significa fornecer um arquivo HTML de origem separado para cada uma das localidades especificadas. Os usuários de cada localidade que você especificar poderão ver uma página da Web personalizada que foi projetada para eles.

Para suplementos do Outlook, o elemento SourceLocation também se alinha ao fator de formulário. Isso permite que você forneça um arquivo HTML de origem localizado e distinto para cada fator de foram correspondente. Você pode especificar um ou mais elementos filho Override em cada configuração aplicável (DesktopSettings, TabletSettings ou PhoneSettings). O exemplo a seguir mostra os elementos de configurações para fatores de forma de desktop, tablet e smartphone, cada um com um arquivo HTML para a localidade padrão e outro para a localidade francesa.

<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>

Localizar substituições estendidas

Observação

Esta seção não será aplicável se você estiver usando o manifesto unificado.

Alguns recursos de extensibilidade de Suplementos do Office, como atalhos de teclado, são configurados com arquivos JSON hospedados em seu servidor, em vez de com o manifesto XML do suplemento. Esta seção pressupõe que você esteja familiarizado com substituições estendidas. Consulte Trabalhar com substituições estendidas do elemento manifesto e ExtendedOverrides .

Use o ResourceUrl atributo do elemento ExtendedOverrides para apontar o Office para um arquivo de recursos localizados. Apresentamos um exemplo a seguir.

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

O arquivo de substituições estendidas usa tokens em vez de cadeias de caracteres. Os tokens nomeia cadeias de caracteres no arquivo de recurso. Veja a seguir um exemplo que atribui um atalho de teclado a uma função (definida em outro lugar) que exibe o painel de tarefas do suplemento. Observação sobre essa marcação:

  • O exemplo não é muito válido. (Adicionamos uma propriedade adicional necessária a ela abaixo.)
  • Os tokens devem ter o formato ${resource.name-of-resource}.
{
    "actions": [
        {
            "id": "SHOWTASKPANE",
            "type": "ExecuteFunction",
            "name": "${resource.SHOWTASKPANE_action_name}"
        }
    ],
    "shortcuts": [
        {
            "action": "SHOWTASKPANE",
            "key": {
                "default": "${resource.SHOWTASKPANE_default_shortcut}"
            }
        }
    ] 
}

O arquivo de recurso, que também é formatado por JSON, tem uma propriedade de nível resources superior dividida em subpropertidades por localidade. Para cada localidade, uma cadeia de caracteres é atribuída a cada token usado no arquivo de substituições estendidas. A seguir está um exemplo que tem cadeias de caracteres para en-us e fr-fr. Neste exemplo, o atalho de teclado é o mesmo em ambas as localidades, mas isso nem sempre será o caso, especialmente quando você está localizando para localidades que têm um alfabeto ou sistema de escrita diferente e, portanto, um 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",
              } 
        }
    }
}

Não há nenhuma default propriedade no arquivo que seja um par para as en-us seções e fr-fr . Isso ocorre porque as cadeias de caracteres padrão, que são usadas quando a localidade do aplicativo host do Office não corresponde a nenhuma das propriedades ll-cc no arquivo de recursos, devem ser definidas no próprio arquivo de substituições estendidas. Definir as cadeias de caracteres padrão diretamente no arquivo de substituições estendidas garante que o Office não baixe o arquivo de recurso quando a localidade do aplicativo do Office corresponder à localidade padrão do suplemento (conforme especificado no manifesto). A seguir está uma versão corrigida do exemplo anterior de um arquivo de substituições estendidas que usa tokens de recurso.

{
    "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",
            } 
        }
    }
}

Fazer a correspondência entre o formato de data/hora e a localidade do cliente

Você pode obter a localidade da interface do usuário do aplicativo cliente do Office usando a propriedade displayLanguage . Em seguida, você pode exibir valores de data e hora em um formato consistente com a localidade atual do aplicativo do Office. Uma maneira de fazer isso é preparar um arquivo de recurso que especifica o formato de exibição de data/hora a ser usado em cada localidade com suporte do seu Suplemento do Office. Em tempo de execução, seu suplemento pode usar o arquivo de recurso e corresponder ao formato de data/hora apropriado com a localidade obtida da propriedade displayLanguage .

Você pode obter a localidade dos dados do aplicativo cliente do Office usando a propriedade contentLanguage . Com base nesse valor, você pode, então, interpretar ou exibir adequadamente as cadeias de caracteres de data/hora. Por exemplo, a localidade jp-JP expressa valores de data/hora como yyyy/MM/dd, e a localidade fr-FR como dd/MM/yyyy.

Usar o Visual Studio para criar um suplemento localizado e globalizado

Se você usar o Visual Studio para criar Suplementos do Office, o .NET Framework e Ajax fornecem maneiras de globalizar e localizar arquivos de script de cliente.

Você pode globalizar e utilizar as extensões do tipo JavaScript de Data e Número e o objeto Data do JavaScript no código do JavaScript para um suplemento do Office para exibir valores com base nas configurações de localização do navegador atual. Para saber mais, confira Passo a passo: como globalizar uma data usando o script de cliente.

Você pode incluir cadeias de caracteres de recurso localizadas diretamente em arquivos de JavaScript autônomos para fornecer arquivos de script de cliente para diferentes locais, que são definidos no navegador ou fornecidos pelo usuário. Crie um arquivo de script separado para cada localidade com suporte. Em cada arquivo de script, inclua um objeto no formato JSON que contenha as cadeias de caracteres de recursos para essa localidade. Os valores localizados serão aplicados quando o script for executado no navegador.

Exemplo: Criar um Suplemento do Office localizado

Esta seção fornece exemplos que mostram como localizar uma descrição do Suplemento do Office, o nome de exibição e interface do usuário.

Observação

Para baixar o Visual Studio, consulte a página IDE do Visual Studio. Durante a instalação, você precisará selecionar a carga de trabalho de desenvolvimento do Office/SharePoint.

Configurar o Office para usar idiomas adicionais para exibição ou edição

Para executar o código de exemplo fornecido, configure o Office em seu computador para usar idiomas adicionais para que você possa testar seu suplemento alternando o idioma usado para exibição em menus e comandos, para edição e revisão ou ambos.

Você pode usar um Office Language Pack para instalar um idioma adicional. Para saber mais sobre os Pacotes de Idiomas e onde obtê-los, veja Language Accessory Pack do Office.

Depois de instalar o Language Accessory Pack, você pode configurar o Office para usar o idioma instalado para exibir na interface do usuário, para edição de conteúdo do documento ou ambos. O exemplo neste artigo usa uma instalação do Office que tenha o Pacote de Idiomas de espanhol aplicado.

Criar um projeto de Suplemento do Office

Você precisará criar um projeto de suplemento do Visual Studio Office.

Observação

Se você ainda não instalou o Visual Studio, consulte a página IDE do Visual Studio para obter instruções de download. Durante a instalação, você precisará selecionar a carga de trabalho de desenvolvimento do Office/SharePoint. Se você tiver instalado anteriormente o Visual Studio 2019 ou posterior, use o Instalador do Visual Studio para garantir que a carga de trabalho de desenvolvimento do Office/SharePoint esteja instalada.

  1. Escolha Criar um novo projeto.

  2. Usando a caixa de pesquisa, insira suplemento. Escolha Suplemento do Word Web , em seguida, selecione Próximo.

  3. Nomeie seu projeto WorldReadyAddIn e selecione Create.

  4. O Visual Studio cria uma solução, e os dois projetos dele aparecem no Gerenciador de Soluções. O arquivo Home.html é aberto no Visual Studio.

Localizar o texto usado no seu suplemento

O texto que você deseja localizar para outro idioma aparece em duas áreas.

  • Nome de exibição e descrição do suplemento. Isso é controlado por entradas no arquivo do manifesto do suplemento.

  • Interface do usuário do suplemento. Você pode localizar as cadeias de caracteres que aparecem na interface do usuário do seu suplemento usando códigos do JavaScript, por exemplo, usando um arquivo de recurso separado que contenha as cadeias de caracteres localizadas.

Localize o nome e a descrição da exibição do suplemento
  1. Em Gerenciador de Soluções, expanda WorldReadyAddIn, WorldReadyAddInManifest e escolha WorldReadyAddIn.xml.

  2. Em WorldReadyAddInManifest.xml, substitua os elementos DisplayName e Description pelo seguinte bloco de código.

    Observação

    Você pode substituir as cadeias de caracteres do idioma espanhol localizado usadas neste exemplo dos elementos DisplayName e Description pelas cadeias de caracteres localizados para qualquer outro 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. Quando você altera o idioma de exibição do Microsoft 365 de inglês para espanhol, por exemplo, e executa o suplemento, o nome de exibição e a descrição do suplemento são mostrados com texto localizado.

Definir a interface do usuário do suplemento
  1. No Visual Studio, no Gerenciador de Soluções, selecione Home.html.

  2. Substitua o conteúdo do elemento <body> no Home.html com o HTML a seguir e salve o arquivo.

    <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>
    

A figura a seguir mostra o elemento do cabeçalho (h1) e o elemento do parágrafo (p) que exibirá o texto localizado quando concluir as etapas restantes e executar o suplemento.

Figura 1. A interface do usuário do suplemento

Interface do usuário do aplicativo com seções realçadas.

Adicionar o arquivo de recurso que contém as cadeias de caracteres localizadas

O arquivo de recurso do JavaScript contém as cadeias de caracteres usadas para a interface do usuário do suplemento. O HTML da interface do usuário do suplemento de amostra tem um elemento <h1> que exibe uma saudação e um elemento <p> que apresenta o suplemento ao usuário.

Para habilitar cadeias de caracteres para o cabeçalho e parágrafo, coloque as cadeias de caracteres em um arquivo de recurso separado. O arquivo de recurso cria um objeto do JavaScript que contém um objeto JSON (JavaScript Object Notation) separado para cada conjunto de cadeias de caracteres localizadas. O arquivo de recurso também fornece um método para obter o objeto JSON apropriado de volta para uma determinada localidade.

Adicionar o arquivo de recurso ao projeto de suplemento

  1. No Gerenciador de Soluções no Visual Studio, clique com o botão direito no projeto WorldReadyAddInWeb e escolha Adicionar>Novo Item.

  2. Na caixa de diálogo Adicionar Novo Item, escolha Arquivo JavaScript.

  3. Insira UIStrings.js como nome do arquivo e escolha Adicionar.

  4. Adicione o código a seguir ao arquivo UIStrings.js e salve-o.

    /* 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;
    })();
    

O arquivo de recurso UIStrings.js cria o objeto, UIStrings, que contém as cadeias de caracteres localizadas para a interface do usuário do suplemento.

Localizar o texto usado na interface do usuário do suplemento

Para usar o arquivo de recurso no seu suplemento, você precisará adicionar uma marca de script para ele em Home.html. Quando Home.html é carregado, UIStrings.js executa e o objeto UIStrings que você usa para obter as cadeias de caracteres está disponível para o código. Adicione o seguinte HTML à marca de cabeçalho do Home.html para tornar UIStrings disponível para seu código.

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

Agora você pode usar o objeto UIStrings para definir as cadeias de caracteres da interface do usuário do seu suplemento.

Se você quiser alterar a localização do suplemento com base em qual idioma é usado para exibição em menus e comandos no aplicativo cliente do Office, use a propriedade Office.context.displayLanguage para obter a localidade desse idioma. Por exemplo, se o idioma do aplicativo usar espanhol para exibição em menus e comandos, a propriedade Office.context.displayLanguage retornará o código de idioma es-ES.

Se você quiser alterar a localização do suplemento com base em qual idioma está sendo usado para editar conteúdo do documento, use a propriedade Office.context.contentLanguage para obter a localidade desse idioma. Por exemplo, se o idioma do aplicativo usar o espanhol para editar o conteúdo do documento, a propriedade Office.context.contentLanguage retornará o código de idioma es-ES.

Depois de saber o idioma que o aplicativo está usando, você pode usar UIStrings para obter o conjunto de cadeias de caracteres localizadas que correspondem ao idioma do aplicativo.

Substitua o código no arquivo Home.js pelo código a seguir. O código mostra como você pode alterar as cadeias de caracteres usadas nos elementos da interface do usuário no Home.html com base na linguagem de exibição do aplicativo ou na linguagem de edição do aplicativo.

Observação

Para alternar entre alterar a localização do suplemento com base no idioma usado para edição, descompactar a linha de código const myLanguage = Office.context.contentLanguage; e comentar a linha 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);
        });
    };
})();

Testar seu suplemento localizado

Para testar o suplemento localizado, altere o idioma usado para exibição ou edição no aplicativo do Office e execute o suplemento.

  1. No Word, escolha Arquivo>Opções>Idioma. A figura a seguir mostra a caixa de diálogo Opções do Word aberta na guia Idioma.

    Figura 2. Opções de idioma na caixa de diálogo Opções Word

    caixa de diálogo Opções Word.

  2. Em Escolher Idioma de Exibição, selecione o idioma desejado para exibição, por exemplo, espanhol, e selecione a seta para cima para mover o idioma espanhol para a primeira posição na lista. Como alternativa, para alterar o idioma usado para edição, em Escolher Linguagens de Edição, escolha o idioma que você deseja usar para edição, por exemplo, espanhol e escolha Definir como Padrão.

  3. Escolha OK para confirmar sua seleção e feche o Word.

  4. Pressione F5 no Visual Studio para executar o suplemento de amostra ou escolha Depurar>Iniciar Depuração na barra de menus.

  5. No Word, escolha Página Inicial>Mostrar Painel de Tarefas.

Após a execução, as cadeias de caracteres na interface do usuário do suplemento são alteradas para corresponder ao idioma usado pelo aplicativo, conforme mostrado na figura a seguir.

Figura 3. Interface do usuário de suplemento com texto localizado

Aplicativo com texto de interface do usuário localizado.

Confira também