Idioma: HTML | XAML

Início rápido: usando recursos de cadeia de caracteres (HTML)

Applies to Windows and Windows Phone

Coloque recursos de cadeias de caracteres em arquivos de recursos e faça referência a essas cadeias de caracteres do seu código ou marcação.

Instruções

  1. Coloque as cadeias de caracteres em arquivos de recurso em vez de colocá-las diretamente no código ou na marcação.
    1. Abra package.appxmanifest no Visual Studio, vá para a guia Aplicativo e defina seu idioma padrão como "pt-br". Se esse for um aplicativo universal, faça isso para cada package.appxmanifest em sua solução.

      Observação  Isso especifica o idioma padrão do projeto. Os recursos de idioma padrão serão usados se o idioma de preferência do usuário ou os idiomas de exibição não corresponderem aos recursos de idioma fornecidos no aplicativo. Veja Páginas de propriedades, JavaScript.

    2. Crie uma pasta para conter os arquivos de recursos.
      1. No Gerenciador de Soluções, clique com o botão direito no projeto (o projeto compartilhado se esse foro um aplicativo universal) e selecione Adicionar > Nova Pasta.
      2. Dê um nome para a nova pasta "cadeias de caracteres".
      3. Se a nova pasta não estiver visível no Gerenciador de Soluções, selecione Projeto > Mostrar Todos os Arquivos no menu do Microsoft Visual Studio enquanto o projeto ainda está selecionado.
    3. Crie uma subpasta e um arquivo de recursos para inglês (Estados Unidos).
      1. Clique com o botão direito na pasta de cadeias de caracteres e adicione uma nova pasta abaixo dela. Dê o nome "en-US". O arquivo de recursos é colocado em uma pasta que foi nomeada para a marca de idioma BCP-47. Veja Como nomear recursos usando qualificadores para saber mais sobre o qualificador de idioma e uma lista de marcas de idioma comuns.
      2. Clique om o botão direito na pasta en-US e selecione Adicionar > Novo Item….
      3. Selecione "Aquivo de recursos (.resjson)".
      4. Clique em Adicionar. Isso adiciona um arquivo de recursos com o nome padrão resources.rejson. Recomendamos que você use esse nome de arquivo padrão. Os aplicativos podem particionar seus recursos em outros arquivos, mas você deve ter cuidado de fazer a referência a eles corretamente (veja Como carregar recursos de cadeias de caracteres).
      5. O novo arquivo contém conteúdo padrão. Substitua o conteúdo pelo seguinte (que pode ser muito similar ao padrão):

        strings/en-US/resources.resjson

        
        {
            "greeting"              : "Hello",
            "_greeting.comment"     : "A welcome greeting.",
        
            "farewell"              : "Goodbye",
            "_farewell.comment"     : "A goodbye."
        }
        
        

        Essa é a sintaxe da cadeia de caracteres JavaScript Object Notation (JSON) em que uma vírgula deve ser colocada depois de cada par nome/valor, exceto o último. Neste exemplo, "saudação" e "adeus" identificam as cadeias de caracteres a serem exibidas. Os outros pares ("_greeting.comment" e "_farewell.comment") são comentários que descrevem as cadeias de caracteres. Os comentários são um bom lugar para fornecer qualquer instrução especial para tradutores que localizarem as cadeias de caracteres para outros idiomas.

  2. Adicione identificadores de recurso ao código e à marcação.
    1. Adicione referências à Biblioteca do Windows para JavaScript ao seu arquivo HTML, caso ainda não estejam lá.

      • Applies to Windows

      O seguinte código de exemplo mostra o HTML do arquivo default.html do projeto Windows que é gerado quando você cria um novo projeto Aplicativo em Branco (Aplicativos Universais) no Visual Studio. Observe que ele já contém referências ao WinJS.

      
      <!-- WinJS references -->
      <link href="//Microsoft.WinJS.2.0/css/ui-dark.css" rel="stylesheet" />
      <script src="//Microsoft.WinJS.2.0/js/base.js"></script>
      <script src="//Microsoft.WinJS.2.0/js/ui.js"></script>
      
      
      

      • Applies to Windows Phone

      O seguinte código de exemplo mostra o HTML do arquivo default.html do projeto WindowsPhone que é gerado quando você cria um novo projeto Aplicativo em Branco (Aplicativos Universais) no Visual Studio. Observe que ele já contém referências ao WinJS.

      
      <!-- WinJS references -->
      <link href="/css/ui-themed.css" rel="stylesheet" />
      <script src="//Microsoft.Phone.WinJS.2.1/js/base.js"></script>
      <script src="//Microsoft.Phone.WinJS.2.1/js/ui.js"></script>
      
      
      
    2. No código JavaScript que acompanha seu arquivo HTML, chame a função WinJS.Resources.processAll quando o HTML for carregado.

      
      WinJS.Application.onloaded = function(){
          WinJS.Resources.processAll();
      }
      
      
      

      Se HTML adicional for carregado em um objeto WinJS.UI.Pages.PageControl, chame WinJS.Resources.processAll(element) no método IPageControlMembers.ready do controle da página, ondeelement é o elemento HTML (e seus elementos filhos) que está sendo carregado. Este exemplo se baseia no cenário 6 de Exemplo de recursos e de localização de aplicativo:

      
      var output;
      
      var page = WinJS.UI.Pages.define("/html/scenario6.html", {
          ready: function (element, options) {
              output = document.getElementById('output');
              WinJS.Resources.processAll(output); // Refetch string resources
              WinJS.Resources.addEventListener("contextchanged", refresh, false);
          }
          unload: function () { 
              WinJS.Resources.removeEventListener("contextchanged", refresh, false); 
          } 
      });
      
      
    3. No HTML, consulte os recursos da cadeia de caracteres usando os identificadores de recurso ('greeting' e 'farewell') dos arquivos de recurso.
      
      <h2><span data-win-res="{textContent: 'greeting'}"></span></h2>
      <h2><span data-win-res="{textContent: 'farewell'}"></span></h2>
      
      
      
    4. Consulte os recursos da cadeia de caracteres para atributos.
      
      <div data-win-res="{attributes: {'aria-label' : 'String1'}}" >
      
      
    5. Consulte os recursos da cadeia de caracteres em JavaScript.
      
      var el = document.getElementById('header');
      var res = WinJS.Resources.getString('greeting');
      el.textContent = res.value;
      el.setAttribute('lang', res.lang);
      
      
      

    O padrão geral do atributo data-win-res para a substituição de HTML é data-win-res="{propertyname1: 'resource ID', propertyname2: 'resource ID2'}".

    Observação  Se a cadeia de caracteres não contiver marcação, associe o recurso onde for possível para a propriedade textContent em vez de innerHTML. A propriedade textContent é muito mais rápida para substituir do que innerHTML.

Para mais detalhes sobre como adicionar idiomas adicionais e localização, veja Guia de início rápido: Traduzindo reecursos de interface do usuário.

Tópicos relacionados

Como nomear recursos usando qualificadores
Como carregar recursos de cadeias de caracteres
WinJS.Resources.processAll
Guia de início rápido: Traduzindo recursos da interface do usuário
Recursos de aplicativos e amostra de localização
Páginas de Propriedades, JavaScript
A tag do idioma BCP-47

 

 

Mostrar:
© 2014 Microsoft