From 074785cea106179cb3305637055ab0a009ca74f2 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 14:42:52 -0500 Subject: initial commit --- files/pt-br/web/api/storage/clear/index.html | 131 ++++++++++++++++++++++ files/pt-br/web/api/storage/getitem/index.html | 79 +++++++++++++ files/pt-br/web/api/storage/index.html | 119 ++++++++++++++++++++ files/pt-br/web/api/storage/key/index.html | 72 ++++++++++++ files/pt-br/web/api/storage/length/index.html | 130 +++++++++++++++++++++ files/pt-br/web/api/storage/removeitem/index.html | 124 ++++++++++++++++++++ files/pt-br/web/api/storage/setitem/index.html | 131 ++++++++++++++++++++++ 7 files changed, 786 insertions(+) create mode 100644 files/pt-br/web/api/storage/clear/index.html create mode 100644 files/pt-br/web/api/storage/getitem/index.html create mode 100644 files/pt-br/web/api/storage/index.html create mode 100644 files/pt-br/web/api/storage/key/index.html create mode 100644 files/pt-br/web/api/storage/length/index.html create mode 100644 files/pt-br/web/api/storage/removeitem/index.html create mode 100644 files/pt-br/web/api/storage/setitem/index.html (limited to 'files/pt-br/web/api/storage') diff --git a/files/pt-br/web/api/storage/clear/index.html b/files/pt-br/web/api/storage/clear/index.html new file mode 100644 index 0000000000..7542b3873a --- /dev/null +++ b/files/pt-br/web/api/storage/clear/index.html @@ -0,0 +1,131 @@ +--- +title: Storage.clear() +slug: Web/API/Storage/clear +tags: + - API + - Armazenamento + - Armazenamento web + - Referencia + - metodo +translation_of: Web/API/Storage/clear +--- +

{{APIRef("Web Storage API")}}

+ +

O método clear() da interface {{domxref("Storage")}}, quando realizado uma chamada, todas as chaves do armazenamento são esvaziadas.

+ +

Syntaxe

+ +
storage.clear();
+ +

Parametros

+ +

Nenhum parametro..

+ +

Retorno

+ +

Nenhum retorno.

+ +

 

+ +

Exemplo

+ +

 

+ +

A função abaixo cria três itens e armazenam localmente, depois remove todos utilizando a função clear().

+ +
function populateStorage() {
+  localStorage.setItem('bgcolor', 'red');
+  localStorage.setItem('font', 'Helvetica');
+  localStorage.setItem('image', 'myCat.png');
+
+  localStorage.clear();
+}
+ +
+

Nota: Para visualizar um exemplo real, veja nossa seção Demonstração de Web Storage.

+
+ +

Especificações

+ + + + + + + + + + + + + + +
EspecificaçãoStatusComentário
{{SpecName('Web Storage', '#dom-storage-clear', 'clear()')}}{{Spec2('Web Storage')}} 
+ +

Compatibilidade de navegador

+ +

{{ CompatibilityTable() }}

+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + +
FuncionalidadeChromeFirefox (Gecko)Internet ExplorerOperaSafari (WebKit)
localStorage43.5810.504
sessionStorage52810.504
+
+ +
+ + + + + + + + + + + + + + + + + + + +
FuncionalidadeAndroidFirefox Mobile (Gecko)IE PhoneOpera MobileSafari Mobile
Basic support2.1{{ CompatUnknown }}811iOS 3.2
+
+ +

Todos os navegadores possuem diferentes capacidades tanto para o localSotrage quanto para sessionSotrage. Você pode verificar uma lista detalhada de capacidades de diversos navegadores.

+ +
+

Nota: a versão iOS 5.1, Safari Mobile utiliza a pasta cache para armazenar os dados do localStorage, onde possivelmente podem perder os dados quando ocorrer pouco espaço no SO.

+
+ +

Veja também

+ +

Utilizando a API Web Storage

diff --git a/files/pt-br/web/api/storage/getitem/index.html b/files/pt-br/web/api/storage/getitem/index.html new file mode 100644 index 0000000000..46c49c6e0c --- /dev/null +++ b/files/pt-br/web/api/storage/getitem/index.html @@ -0,0 +1,79 @@ +--- +title: localStorage.getItem() +slug: Web/API/Storage/getItem +translation_of: Web/API/Storage/getItem +--- +

{{APIRef("Web Storage API")}}

+ +

Passar o nome da chave para o método getItem() da interface {{domxref("Storage")}} retornará o seu valor.

+ +

Sintaxe

+ +
var aValue = localStorage.getItem(keyName);
+
+ +

Parâmetros

+ +
+
keyName
+
Um {{domxref("DOMString")}} contendo o nome da chave cujo valor você quer obter.
+
+ +

Retorno

+ +

Um {{domxref("DOMString")}} contendo o valor da chave. Se a chave não existe, é retornado null.

+ +

Exemplo

+ +

A função seguinte recupera três itens armazenados no local storage e usa-os para definir estilos customizados em uma página.

+ +
function setStyles() {
+  var currentColor = localStorage.getItem('bgcolor');
+  var currentFont = localStorage.getItem('font');
+  var currentImage = localStorage.getItem('image');
+
+  document.getElementById('bgcolor').value = currentColor;
+  document.getElementById('font').value = currentFont;
+  document.getElementById('image').value = currentImage;
+
+  htmlElem.style.backgroundColor = '#' + currentColor;
+  pElem.style.fontFamily = currentFont;
+  imgElem.setAttribute('src', currentImage);
+}
+ +
+

Nota: Para ver essa funcionalidade aplicada a um exemplo real, veja nossa Web Storage Demo.

+
+ +

Especificações

+ + + + + + + + + + + + + + +
EspecificaçãoStatusComment
{{SpecName('Web Storage', '#dom-storage-getitem', 'getItem()')}}{{Spec2('Web Storage')}}
+ +

Compatibilidade

+ +
{{Compat("api.Storage.getItem")}}
+ +
+ +

Os níveis de compatibilidade podem variar em todos os navegadores, tanto para o localStorage quanto para o sessionStorage. Aqui temos estatísticas detalhadas dos níveis de compatibilidade para vários navegadores.

+ +
+

Nota: A partir da versão 5.1 do iOS, o Safari Mobile armazena os dados do localStorage na pasta do cache, sujeito a ser apagado em caso de espaço insificiente.

+
+ +

Veja também

+ +

Usando a API Web Storage

diff --git a/files/pt-br/web/api/storage/index.html b/files/pt-br/web/api/storage/index.html new file mode 100644 index 0000000000..e500e88cfa --- /dev/null +++ b/files/pt-br/web/api/storage/index.html @@ -0,0 +1,119 @@ +--- +title: Storage +slug: Web/API/Storage +tags: + - API + - Interface + - NeedsTranslation + - Reference + - Storage + - TopicStub + - Web Storage + - data +translation_of: Web/API/Storage +--- +

{{APIRef("Web Storage API")}}

+ +

A interface de Armazenamento da Web Storage API fornece acesso ao armazenamento de sessão ou armazenamento local para um domínio específico, permitindo que você, por exemplo, adicione, modifique ou exclua itens de dados armazenados.

+ +

Se você quiser manipular o armazenamento de sessão para um domínio, você chama o método {{domxref ("Window.sessionStorage")}}; Se você quiser manipular o armazenamento local para um domínio, você chama {{domxref ("Window.localStorage")}}.

+ +

Propriedades

+ +
+
{{domxref("Storage.length")}} {{readonlyInline}}
+
Retorna um número inteiro que representa o número de itens de dados armazenados no objeto Storage.
+
+ +

Métodos

+ +
+
{{domxref("Storage.key()")}}
+
Quando passado um número n, este método retornará o nome da n-ésima chave no armazenamento..
+
+ +
+
{{domxref("Storage.getItem()")}}
+
Quando passado um nome de chave, retornará o valor dessa chave.
+
{{domxref("Storage.setItem()")}}
+
Quando passado um nome de chave e valor, irá adicionar essa chave para o armazenamento, ou atualizar o valor dessa chave, se já existir.
+
{{domxref("Storage.removeItem()")}}
+
Quando passado um nome de chave, irá remover essa chave do armazenamento.
+
{{domxref("Storage.clear()")}}
+
Quando chamado, irá esvaziar todas as chaves fora do armazenamento.
+
+ +

Exemplos

+ +

Aqui acessamos um objeto Storage chamando localStorage. Primeiro testamos se o armazenamento local contém itens de dados usando! localStorage.getItem ('bgcolor'). Se isso acontecer, executaremos uma função chamada setStyles () que agarra os itens de dados usando {{domxref("localStorage.getItem()")}} E usa esses valores para atualizar estilos de página. Se não, executamos outra função, populateStorage (), que usa {{domxref("localStorage.setItem()")}} Para definir os valores do item, em seguida, executa setStyles ().

+ +
if(!localStorage.getItem('bgcolor')) {
+  populateStorage();
+} else {
+  setStyles();
+}
+
+function populateStorage() {
+  localStorage.setItem('bgcolor', document.getElementById('bgcolor').value);
+  localStorage.setItem('font', document.getElementById('font').value);
+  localStorage.setItem('image', document.getElementById('image').value);
+
+  setStyles();
+}
+
+function setStyles() {
+  var currentColor = localStorage.getItem('bgcolor');
+  var currentFont = localStorage.getItem('font');
+  var currentImage = localStorage.getItem('image');
+
+  document.getElementById('bgcolor').value = currentColor;
+  document.getElementById('font').value = currentFont;
+  document.getElementById('image').value = currentImage;
+
+  htmlElem.style.backgroundColor = '#' + currentColor;
+  pElem.style.fontFamily = currentFont;
+  imgElem.setAttribute('src', currentImage);
+}
+ +
+

Nota: Para ver isso funcionando como um exemplo completo de trabalho, consulte nossa Demonstração de armazenamento na Web.

+
+ +

Especificações

+ + + + + + + + + + + + + + +
EspecificaçãoEstadoComentário
{{SpecName('Web Storage', '#the-storage-interface', 'Storage')}}{{Spec2('Web Storage')}} 
+ +

Compatibilidade com navegadores

+ +

 

+ + + +

{{Compat("api.Storage")}}

+ +

 

+ +
 
+ +

[1] Desde o iOS 5.1, o Safari Mobile armazena os dados localStorage na pasta de cache, que está sujeita a limpeza ocasional a pedido do sistema operacional, normalmente se o espaço for curto.

+ +

Todos os navegadores têm diferentes níveis de capacidade para o localStorage e sessionStorage. Aqui está um resumo detalhado de todas as capacidades de armazenamento para vários navegadores.

+ +

Veja também

+ +

Using the Web Storage API

diff --git a/files/pt-br/web/api/storage/key/index.html b/files/pt-br/web/api/storage/key/index.html new file mode 100644 index 0000000000..9ed50459ad --- /dev/null +++ b/files/pt-br/web/api/storage/key/index.html @@ -0,0 +1,72 @@ +--- +title: Storage.key() +slug: Web/API/Storage/key +translation_of: Web/API/Storage/key +--- +
{{APIRef("Web Storage API")}}
+ +

O método key() da interface {{domxref("Storage")}}, quando passado um número n, retorna o nome da n-ésima chave no dado objeto Storage. A ordem das chaves é definida pelo user-agent, então não deve-se confiar nela.

+ +

Syntax

+ +
var aKeyName = storage.key(index);
+ +

Parâmetros

+ +
+
index
+
Um inteiro representando o número da chave que deseja obter. Esse é um índice que começa em zero.
+
+ +

Retorno

+ +

Uma {{domxref("DOMString")}} contendo o nome da chave. Se o index não existir, retornará null.

+ +

Exemplos

+ +

A função a seguir itera sobre as chaves do armazenamento local:

+ +
function forEachKey(callback) {
+  for (var i = 0; i < localStorage.length; i++) {
+    callback(localStorage.key(i));
+  }
+}
+ +

A função a seguir itera sobre as chaves do armazenamento local e obtém o valor de cada chave:

+ +
for(var i =0; i < localStorage.length; i++){
+  console.log(localStorage.getItem(localStorage.key(i)));
+}
+ +
+

Nota: Pra ver um exemplo real, consulte nossa Demonstração de armazenamento na Web.

+
+ +

Especificações

+ + + + + + + + + + + + + + +
EspecificaçãoEstadoComentário
{{SpecName('HTML WHATWG', 'webstorage.html#dom-storage-key', 'Storage.key')}}{{Spec2('HTML WHATWG')}}
+ +

Compatibilidade com navegadores

+ + + +

{{Compat("api.Storage.key")}}

+ +

Veja também

+ + diff --git a/files/pt-br/web/api/storage/length/index.html b/files/pt-br/web/api/storage/length/index.html new file mode 100644 index 0000000000..fad990d9a8 --- /dev/null +++ b/files/pt-br/web/api/storage/length/index.html @@ -0,0 +1,130 @@ +--- +title: Storage.length +slug: Web/API/Storage/length +tags: + - API + - Armazenamento + - Armazenamento web + - Propriedade + - Referencia + - Somente Leitura + - Web Storage +translation_of: Web/API/Storage/length +--- +

{{APIRef("Web Storage API")}}

+ +

A propriedade length, que é somente leitura, da interface {{domxref("Storage")}} retorna um inteiro que representa o número de itens armazenados no objeto Storage.

+ +

Sintaxe

+ +
var aLength = storage.length;
+ +

Retorno

+ +

Um inteiro

+ +

Exemplo

+ +

A função a seguir adiciona três itens ('bgcolor', 'font' e 'image') ao local storage do domínio atual, em seguida retorna o número de itens no storage:

+ +
function populateStorage() {
+  localStorage.setItem('bgcolor', 'yellow');
+  localStorage.setItem('font', 'Helvetica');
+  localStorage.setItem('image', 'cats.png');
+
+  localStorage.length; // should return 3
+}
+ +
+

Nota: Para um exemplo do mundo real, veja nosso Web Storage Demo.

+
+ +

Especificações

+ + + + + + + + + + + + + + +
EspecificaçãoStatusComentário
{{SpecName('Web Storage', '#dom-storage-length', 'length')}}{{Spec2('Web Storage')}} 
+ +

Compatibilidade com browsers

+ +

{{ CompatibilityTable() }}

+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
FeatureChromeEdgeFirefox (Gecko)Internet ExplorerOperaSafari (WebKit)
localStorage4{{CompatVersionUnknown}}3.5810.504
sessionStorage5{{CompatUnknown}}2810.504
+
+ +
+ + + + + + + + + + + + + + + + + + + + + +
FeatureAndroidEdgeFirefox Mobile (Gecko)IE PhoneOpera MobileSafari Mobile
Basic support2.1{{CompatVersionUnknown}}{{ CompatUnknown }}811iOS 3.2
+
+ +

Cada browser tem uma capacidade variada para localStorage e sessionStorage. Aqui existe um tabela detalhada sobre a capacidade de armazenamento de cada browser.

+ +
+

Nota: desde o iOS 5.1, o Safari Mobile armazena os dados do localStorage no folder de cache, que está sujeito a uma limpeza ocasional baseada em regras do SO, tipicamente, quando o espaço está se esgotando.

+
+ +

Veja também

+ +

Usando a API Web Storage

diff --git a/files/pt-br/web/api/storage/removeitem/index.html b/files/pt-br/web/api/storage/removeitem/index.html new file mode 100644 index 0000000000..851f926173 --- /dev/null +++ b/files/pt-br/web/api/storage/removeitem/index.html @@ -0,0 +1,124 @@ +--- +title: Storage.removeItem() +slug: Web/API/Storage/removeItem +translation_of: Web/API/Storage/removeItem +--- +

{{APIRef("Web Storage API")}}

+ +

O método removeItem() da interface {{domxref("Storage")}}, quando passado um nome de chave, irá remover essa chave do armazenamento.

+ +

Syntax

+ +
storage.removeItem(keyName);
+ +

Parâmetros

+ +
+
keyName
+
A {{domxref("DOMString")}} contendo o nome da chave que você deseja remover.
+
+ +

Retorno

+ +

Nenhum valor de retorno.

+ +

Exemplo

+ +

A função a seguir cria três itens de dados no armazenamento local, em seguida, remove o item "image".

+ +
function populateStorage() {
+  localStorage.setItem('bgcolor', 'red');
+  localStorage.setItem('font', 'Helvetica');
+  localStorage.setItem('image', 'myCat.png');
+
+  localStorage.removeItem('image');
+}
+ +
+

Nota: Para ver o uso em um exemplo prático veja nosso Web Storage Demo.

+
+ +

Especificações

+ + + + + + + + + + + + + + +
EspecificaçãoStatusComentários
{{SpecName('Web Storage', '#dom-storage-removeitem', 'removeItem()')}}{{Spec2('Web Storage')}} 
+ +

Compatibilidade

+ +

{{ CompatibilityTable() }}

+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + +
FeatureChromeFirefox (Gecko)Internet ExplorerOperaSafari (WebKit)
localStorage43.5810.504
sessionStorage52810.504
+
+ +
+ + + + + + + + + + + + + + + + + + + +
FeatureAndroidFirefox Mobile (Gecko)IE PhoneOpera MobileSafari Mobile
Basic support2.1{{ CompatUnknown }}811iOS 3.2
+
+ +

All browsers have varying capacity levels for both localStorage and sessionStorage. Here is a detailed rundown of all the storage capacities for various browsers.

+ +
+

Note: since iOS 5.1, Safari Mobile stores localStorage data in the cache folder, which is subject to occasional clean up, at the behest of the OS, typically if space is short.

+
+ +

Veja também

+ +

Usando a API Web Storage

diff --git a/files/pt-br/web/api/storage/setitem/index.html b/files/pt-br/web/api/storage/setitem/index.html new file mode 100644 index 0000000000..90a964fbc8 --- /dev/null +++ b/files/pt-br/web/api/storage/setitem/index.html @@ -0,0 +1,131 @@ +--- +title: Storage.setItem() +slug: Web/API/Storage/setItem +tags: + - Referencia +translation_of: Web/API/Storage/setItem +--- +

{{APIRef("Web Storage API")}}

+ +

O método setItem() da interface {{domxref("Storage")}}, quando passado 'chave' e 'valor', irá adicionar esta chave ao storage, ou atualizar o valor caso a chave já exista.

+ +

Syntax

+ +
storage.setItem(keyName, keyValue);
+ +

Parâmetros

+ +
+
keyName
+
Um {{domxref("DOMString")}} contendo o nome da chave que você deseja criar ou alterar.
+
keyValue
+
Um {{domxref("DOMString")}} contendo o valor da chave que você está criando ou atualizando.
+
+ +

Retornos

+ +

Sem retorno.

+ +

Exceções

+ +

setItem() poderá lançar uma exceção caso o storage esteja cheio. Particularmente, no Safari Mobile (desde o iOS 5) sempre irá lançar quando o usuário entrar em modo privado (Safari define a quota para 0 bytes no modo privado ao contrário de outros navegadores que permitem o armazenamento em modo privado, usando recipientes de dados separados).
+ Assim os desenvolvedores devem certificar-se de sempre tratar as possíveis exceções do setItem().

+ +

Exemplo

+ +

A função abaixo irá criar três dados dentro do local storage.

+ +
function populateStorage() {
+  localStorage.setItem('bgcolor', 'red');
+  localStorage.setItem('font', 'Helvetica');
+  localStorage.setItem('image', 'myCat.png');
+}
+ +
+

Nota: Para ver ele sendo usado em um exemplo real, consulte nosso Web Storage Demo.

+
+ +

Especificações

+ + + + + + + + + + + + + + +
SpecificationStatusComment
{{SpecName('Web Storage', '#dom-storage-setitem', 'setItem()')}}{{Spec2('Web Storage')}} 
+ + + +

{{ CompatibilityTable() }}

+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + +
FeatureChromeFirefox (Gecko)Internet ExplorerOperaSafari (WebKit)
localStorage43.5810.504
sessionStorage52810.504
+
+ +
+ + + + + + + + + + + + + + + + + + + +
FeatureAndroidFirefox Mobile (Gecko)IE PhoneOpera MobileSafari Mobile
Basic support2.1{{ CompatUnknown }}811iOS 3.2
+
+ +

Todos os navegadores têm diferentes níveis de capacidade para tanto localStorage e sessionStorage. Aqui você encontra uma detalhada a capacidade detalhada para vários browsers.

+ +
+

Nota: desde a versão iOS 5.1, Mobile Safari os dados na pasta 'cache' estão sujeito a limpezas ocasionais devido ao pouco espaço disponível.

+
+ +

Veja também

+ +

Usando a Web Storage API

-- cgit v1.2.3-54-g00ecf