Idioma: HTML | XAML

Como carregar recursos de arquivos (HTML)

Applies to Windows and Windows Phone

Saiba como carregar recursos de arquivo de vários locais.

É possível acessar os recursos dos arquivos de aplicativo que você oferece como parte do pacote do aplicativo, ou inclui como parte de um SDK ou pacote de estrutura, do estado do aplicativo ou da Web. Você pode fazer referência a esses arquivos na marcação (como HTML ou XML de Notificações) ou através do código (como XmlHttpRequest ou storage file APIs). Os exemplos aqui mostram os recursos de arquivo em contextos específicos, mas você pode usar a maioria deles em vários outros contextos.

Web

Para acessar arquivos da Web, você pode usar URIs HTTP absolutos padrão.

<img src="http://www.contoso.com/images/logo.png" alt="Logo" />

Pacote do aplicativo

Para acessar arquivos de seu pacote do aplicativo, você pode usar um caminho de arquivo direto ou lógico para referenciar o recurso. Isso vale mesmo quando os arquivos têm vários idiomas, escalas, contraste ou outras variações. Veja Início rápido: usando recursos de arquivo ou imagem para ver uma introdução.

Por exemplo, você carrega

Images/en-US/homeregion-USA/logo.scale-100_contrast-white.png

fazendo referência a

Images/logo.png

Para acessar arquivos relativos ao documento atual, você pode usar URIs relativos.

<img src="images/logo.png" />

Para acessar arquivos relativos à raiz do pacote, você pode usar URIs de caminho absolutos (aqueles que começam com "/").

<img src="/images/logo.png" />

Para acessar os arquivos armazenados no mesmo pacote, mas a partir de uma biblioteca de classes, use o nome da biblioteca de classes:

<img src="/ClassLibraryName/images/logo.png" />

Para acessar arquivos armazenados dentro do pacote do aplicativo, mas a partir de código onde não há um URI de documento base, especifique o esquema ms-appx:.


var uri = new Windows.Foundation.Uri('ms-appx:///images/logo.png');
var file = Windows.Storage.StorageFile.getFileFromApplicationUriAsync(uri);

Para acessar arquivos armazenados em um pacote de estrutura, use um URI absoluto.

<script src="ms-appx://Microsoft.WinJS.1.0/js/ui.js"></script>

Para acessar arquivos que serão carregados no compartimento da Web, use o esquema ms-appx-web:.

<iframe src="ms-appx-web:///html/webcompartment.html"></iframe>

Para acessar arquivos no mesmo compartimento da Web ou local que o documento atual, não especifique um esquema.

<script src="//Microsoft.WinJS.1.0/js/ui.js"></script>

Estado do aplicativo

Para acessar os arquivos armazenados no estado do aplicativo, use o esquema ms-appdata:. O estado do aplicativo pode ser armazenado em uma pasta local, uma pasta de roaming ou uma pasta temporária.

Para acessar arquivos armazenados na pasta local:

<img src="ms-appdata:///local/images/logo.png" />

Para acessar arquivos armazenados na pasta de roaming:

<img src="ms-appdata:///roaming/images/logo.png" />

Para acessar arquivos armazenados na pasta temporária:

<img src="ms-appdata:///temp/images/logo.png" />

As storage file APIs podem acessar arquivos dentro do pacote de aplicativo do mesmo modo:


var uri = new Windows.Foundation.Uri('ms-appdata:///local/images/logo.png');
var file = Windows.Storage.StorageFile.getFileFromApplicationUriAsync(uri);

Alterações de eventos e contexto

Seu aplicativo é responsável por atualizar a exibição de seus recursos, quando necessário.

Os aplicativos da Windows Store ainda podem estar em execução quando o sistema é alterado, como quando o usuário ativa o alto contraste. O resultado é que o aplicativo usa um conjunto de qualificadores diferente. Diversas alterações do sistema invocarão eventos no objeto ResourceContext.

No JavaScript, a maneira mais simples de ouvir esses eventos é por meio de

WinJS.Resources.addEventListener('contextchanged', refresh, false);

Os elementos de imagem não são atualizados automaticamente quando o contexto muda e depende do aplicativo substituir as imagens. As consultas de mídia CSS são uma alternativa que atualiza imediatamente as propriedades CSS, como a imagem de tela de fundo.

 

 

Mostrar:
© 2014 Microsoft