Modelos de item em JavaScript para aplicativos da Loja

Applies to Windows and Windows Phone

Modelos de item são arquivos de aplicativo que contêm um código usado com frequência que pode ser adicionado a um modelo de projeto para reduzir o tempo de desenvolvimento..

Importante  As informações desse tópico foram atualizadas para o Windows Phone 8, Atualização do Windows 8.1. e Microsoft Visual Studio 2013 Atualização 2. Para obter informações sobre como migrar para novos modelos, consulte a seção de modelo do aplicativo Universal em Modelos de projeto JavaScript e Fazendo a portabilidade de seu aplicativo de Tempo de Execução do Windows para Windows Phone.

Os modelos de item para aplicativos da Windows Phone Store contêm as referências apropriadas e as marcas de script para dar suporte à Biblioteca do Windows para JavaScript. Alguns dos modelos de item implementam um contrato, que funciona como um acordo entre um ou mais aplicativos para usar APIs específicas. Quando você adiciona um modelo de contrato (Contrato do Seletor de Abertura de Arquivos, Contrato de Compartilhamento de Destino), o manifesto do aplicativo é atualizado com as declarações apropriadas. Você pode ver as configurações dessas declarações na guia Declarações do Designer de Manifesto.

Você pode adicionar um modelo de item a um projeto existente abrindo o menu de contexto do projeto no Gerenciador de Soluções e depois selecionando Adicionar > Novo Item.

Para saber mais sobre os modelos de item para outros idiomas, veja Modelos de item C#, VB, e C++.

Modelo de item Controle de Página

Este modelo de item possui o mínimo de conteúdo e marcação para uma página em seu aplicativo. A marcação HTML inclui uma seção de cabeçalho com um botãoVoltar e uma seção de conteúdo principal.

Quando você adiciona um modelo de item Controle de Página, o Visual Studio adiciona 3 arquivos ao seu projeto:

  • um arquivo HTML (nomeado pagecontrol.html por padrão) que inclui uma seção de cabeçalho e a seção de conteúdo principal da sua página.
  • um arquivo JavaScript que fornece código compatível com a página. Esse arquivo inclui um código que dá suporte para o modelo de navegação recomendado para os aplicativos da Windows Store.
  • um arquivo CSS que especifica estilos CSS para a página.

O modelo de navegação usado no modelo de item Controle de Página também é usado nos modelos de projeto Hub/Pivô, Hub, Pivô, Grade, Dividido e Navegação. Recomendamos que você utilize esse modelo de item ao adicionar páginas a esses modelos de projeto. Para obter mais informações, veja Guia de início rápido: usar navegação de página simples e a seção "Modelo de navegação" nos modelos de projeto JavaScript.

Cuidado  Para usar o modelo de item de Controle de Página com o modelo em Branco, adicione o navigator.js ao projeto e adicione o código de host de conteúdo ao default.html (obtenha o navigator.js e o código de host de conteúdo de outro modelo de projeto, como Hub/Pivô).

Modelo de item Contrato de Destino de Compartilhamento

O modelo de item Contrato de Destino de Compartilhamento permite que um aplicativo coordene o compartilhamento de dados entre outros aplicativos. Por exemplo, você pode usar esse modelo para permitir que os usuários publiquem uma foto do Flickr no Facebook. Esse modelo inclui código que permite que o aplicativo receba conteúdo compartilhado. O aplicativo que contém esse modelo de item é iniciado quando selecionado na interface de usuário de compartilhamento.

Quando você adiciona um modelo de item Contrato de Destino de Compartilhamento, o Visual Studio adiciona três arquivos ao seu projeto:

  • um arquivo HTML (nomeado shareTarget.html por padrão) que é exibido quando o aplicativo é selecionado na interface de usuário de compartilhamento.
  • um arquivo JavaScript que fornece código para gerenciar o conteúdo compartilhado.
  • um arquivo CSS que especifica estilos para a página.

A página HTML inclui uma seção de conteúdo principal com marcação para exibir uma pequena parte do conteúdo compartilhado: um elemento IMG para uma imagem de miniatura compartilhada, um título e uma descrição para as propriedades compartilhadas e uma caixa de entrada padrão para permitir que o usuário inclua comentários ao processar o conteúdo compartilhado.

O código JavaScript usa o evento activated para verificar se o aplicativo está ativado para receber dados compartilhados e, depois, usa o objeto ShareOperationpara acessar dados compartilhados e definir as propriedades do modelo inicial: o título, a descrição e a imagem de miniatura. Use a função onShareSubmit no arquivo JavaScript para processar os dados compartilhados junto com os comentários.

Para saber mais sobre contratos de compartilhamento, veja Guia de início rápido: recebendo conteúdo compartilhado.

Modelo de item Página de Resultados de Pesquisa

Esse modelo de item possibilita que um aplicativo apresente uma página de resultados de uma pesquisa iniciada pelo controle WinJS.UI.SearchBox.

Importante  O modelo de item para pesquisa no Microsoft Visual Studio 2013 não implementa mais um contrato. O nome do modelo de item também mudou (no Contrato de Pesquisa).

Quando você adiciona um modelo de item Página de Resultados de Pesquisa, o Visual Studio acrescenta 3 arquivos ao seu projeto:

  • um arquivo HTML (nomeado searchResults.html por padrão) que inclui um controle ListView para exibir os resultados da pesquisa.
  • um arquivo JavaScript que fornece código compatível com a página de pesquisa. O arquivo de origem inclui código compatível com o modelo de navegação recomendado para os aplicativos da Windows Store.
  • um arquivo CSS que especifica estilos CSS para a página de pesquisa.

O modelo de navegação usado no modelo de item também é usado nos modelos de projeto Hub, Grade, Dividido e Navegação. Recomendamos o uso desse modelo de item quando você adicionar um modelo de item de Página de Resultados de Pesquisa a esses modelos de projeto. Para obter mais informações, consulte a seção "modelo de Navegação" nos modelos de projeto JavaScript.

A Página de Resultados de Pesquisa exibe os resultados em um ListView. Ele funciona de forma semelhante aos modelos WinJS usados nos modelos de projeto Grade e Dividido. Para saber mais, veja Personalizando dados nos modelos do Visual Studio e a seção "Estilos de CSS" em Modelos de projetos JavaScript para aplicativos da Windows Store.

Para saber mais, veja Adicionando um modelo de item de Resultados de Pesquisa e Guia de início rápido: adicionando pesquisa.

Modelo de item de Contrato do Seletor de abertura de arquivos

O modelo de item de Contrato do Seletor de abertura de arquivos permite que um aplicativo exponha seus dados como arquivos para outros aplicativos. Por exemplo, você pode usar esse modelo para criar uma caixa de diálogo seletora de fotos na qual o usuário pode escolher uma foto do Facebook, mesmo que essa foto não esteja armazenada na unidade de disco local.

Quando você adiciona um modelo de item de Contrato do Seletor de abertura de arquivos, o Visual Studio adiciona 3 arquivos ao seu projeto:

  • um arquivo HTML (nomeado fileOpenPicker.html por padrão) que inclui um controle ListView para exibir a lista de arquivos.
  • um arquivo JavaScript que fornece código para gerenciar a seleção de itens na lista de arquivos.
  • um arquivo CSS que especifica estilos para a página HTML que contém a lista de arquivos.

O modelo de Contrato do Seletor de Abertura de Arquivos mostra a lista de arquivos em um ListView. Ele funciona de forma semelhante a modelos WinJS usados em modelos de projetos de Grade e Dividido. Para saber mais, veja Adicionando dados a um modelo de projeto e a seção "Estilos de CSS" em Modelos de projetos JavaScript para aplicativos da Windows Store.

Para saber mais sobre contratos de Seletor de abertura de arquivo, veja Guia de início rápido: integrando contratos de seletor de arquivos.

Outros modelos de item no Visual Studio

A maioria dos outros modelos de item, como Página HTML, Arquivo JavaScript e Arquivo XML, são arquivos padrão que não têm recursos específicos para aplicativos da Windows Store. Aqui estão algumas informações adicionais sobre 2 desses modelos.

Arquivo de Recurso

Para ajudar a localizar um aplicativo da Windows Store, você pode adicionar um ou mais modelos de item de Arquivo de Recursos (arquivos .resjson) ao seu projeto. Para saber mais, veja o tópico sobre como globalizar seu aplicativo.

Trabalho dedicado

Se estiver usando Trabalhos da Web HTML5 em seu aplicativo da Windows Store, nós recomendamos que você inclua o modelo de item Trabalho dedicado ao seu projeto. Esse modelo inclui uma diretiva de referência para habilitar o suporte a IntelliSense para a API de Web Worker. Para saber mais sobre o uso de Trabalhos da Web em seu aplicativo da Windows Store, veja Trabalhos da Web.

Tópicos relacionados

Modelos de projeto em JavaScript para aplicativos da Windows Store
Adicionando um modelo de item de Resultados de Pesquisa

 

 

Mostrar:
© 2014 Microsoft