Adiciona um item à sessão da aba do navegador por meio de uma chave definida pelo usuário. O item criado é eliminado ao fechar o navegador e é visível apenas na aba onde foi criado. Este bloco utiliza a propriedade window.sessionStorage do Javascript, consulte a documentação para mais informações.
O item criado é do tipo chave/valor, ou seja, contém um valor associado a uma chave. Caso a chave atribuída a um item já esteja associada a outro item armazenado, o valor deste será atualizado na chave existente em vez de ser adicionado como um novo item.
Figura 1 – Bloco Adicionar Item na Sessão da Aba
O bloco recebe um valor e guarda na sessão da aba em uma chave temporária criada pelo usuário no navegador.
Parâmetros
Compatibilidade
Cliente
Exemplo
| Informações |
|---|
Se for necessário que o item criado seja compartilhado entre diferentes abas, utilize o bloco Adicionar Item na Sessão do Navegador. |
Compatibilidade
Bloco cliente: cronapi.util.setSessionStorage()
Retorno
Bloco sem retorno.
Parâmetros
Chave
Chave do item que será armazenado ou atualizado.
- Posição: 1
- Inglês: Key
- Tipo: Texto / String
- Exemplo: "nome"
Valor
Conteúdo que será associado à chave do item.
- Posição: 2
- Inglês: Value
- Tipo: Texto / String
- Exemplo: "Pedro"
Exemplo
A função abaixo mostra um exemplo de uso do O bloco Adicionar Item na Sessão da aba (Figura1) irá receber "nomeuser" no parâmetro Chave, que será usada para armazenar o valor que será inserido no parâmetro Valor, que é o "valorx". Esse valor será armazenado na sessão da aba, usaremos Aba, ela irá armazenar, na sessão da aba do navegador, o item representado pelo par chave/valor, "nome" e "Pedro" respectivamente. Caso queira obter o valor armazenado utilize o bloco Obter Item da Sessão da Aba para acessar o valor armazenado e atribuir à variável item, com o bloco imprime, iremos imprimir no console do navegador o valor que foi armazenado.(Figura 2)
Figura 1 2 - Exemplo de uso do bloco Adicionar Item na Sessão da Aba
Figura 2 - Impressão no console após clicar no botão alimentado com a função da figura 1
Após a execução da função da Figura 2, o item será criado na aba Application (destaque 1 da Figura 2.1) das ferramentas de desenvolvedor do navegador. Ao abrir a aba Application, clique duas vezes sobre a Session storage (destaque 2) e, em seguida, na url da aplicação exibida. Após esta ação, o item criado poderá ser visualizado (destaque 3).
Figura 2.1 - Item criado na session storage do navegador
Nesta página
| Índice |
|---|
Sobre o bloco
Função que adiciona um item na sessão local do navegador. Esse Item é limpo ao fechar o navegador e é visível apenas na aba em que for criado.