Uma barra lateral é um elemento da interface do usuário (uma pequena área vertical) que aparece à esquerda ou à direita da janela maior ou na tela do usuário para exibir informações relacionadas ou uma lista de escolhas ou opções de navegação.
A barra lateral no Planilhas Google é um painel da interface do usuário que é exibido no lado direito do Planilhas Google. O Google oferece um editor de script integrado chamado Apps Script, que pode criar vários complementos e elementos para aplicativos do G-Suite. Ele também pode ser usado para criar suas próprias barras laterais personalizadas nas planilhas do Google.
Este artigo mostrará como fazer uma barra lateral personalizada no Planilhas Google usando o editor de Script do Google Apps.
Criar uma barra lateral no Planilhas Google usando o Apps Script
Se quiser fazer uma barra lateral personalizada, você precisa inserir e executar determinados códigos no editor do Apps Script. Em seguida, você pode construir seus próprios widgets na barra lateral usando códigos HTML, CSS e Javascript.
Primeiro, abra as planilhas do Google. No menu de planilhas do Google, clique em ‘Ferramentas’ e selecione ‘Editor de scripts’.
Isso abrirá o editor do Apps Script em uma nova guia do navegador, onde você pode escrever o código da interface do usuário.
Escreva o seguinte código na página Code.gs:
function onOpen () {SpreadsheetApp.getUi () .createMenu ('Meu novo menu') .addItem ('Minha barra lateral 1', 'showSidebar') .addToUi (); } function showSidebar () {var html = HtmlService.createHtmlOutputFromFile ('Sidebar') .setTitle ('Calculation Sidebar'); SpreadsheetApp.getUi () .showSidebar (html); }
No código de script Code.gs acima, a função OnOpen () cria um menu personalizado chamado ‘Meu novo menu’ na barra de menus do Google Sheets. Esse menu conterá um item de menu denominado ‘My sidebar-1’. Ao clicar neste item de menu, a função showAdminSidebar () (a segunda parte do código) será executada e a barra lateral será exibida no lado direito da janela da planilha do Google.
Em seguida, precisamos criar um arquivo HTML no editor de scripts e, em seguida, com este arquivo, você pode criar a barra lateral.
Para criar o arquivo HTML, clique no ícone de adição (+) ao lado de Arquivos no editor do Apps Script e selecione ‘HTML’.
Isso criará um arquivo HTML abaixo de Code.gs. Renomeie o arquivo como ‘Barra lateral’. Este nome deve ser igual ao adicionado na função showSidebar () (var html = HtmlService.createHtmlOutputFromFile (‘Sidebar’)).
Escreva o seguinte código na seção do arquivo Sidebar.html:
Esta é minha nova barra lateral
O código acima exibe a sequência de texto ‘Esta é minha nova barra lateral’ e o botão ‘Fechar’ que fecha a barra lateral quando clicado nela.
Depois de terminar de escrever o código acima na seção do Sidebar.html, ele deve conter o seguinte código:
Esta é minha nova barra lateral.
A captura de tela:
Quando terminar de inserir os dois códigos, salve o projeto clicando no ícone Salvar na barra de ferramentas (veja a captura de tela abaixo). Em seguida, execute as funções clicando no ícone ‘Executar’.
Quer você execute o script aqui ou selecione o item de menu personalizado na barra de ferramentas do Google Sheets (pela primeira vez), o Google solicitará que você autorize a execução do script. Como você está executando um widget personalizado de terceiros, o Google solicitará sua autorização. Depois de autorizar o script, ele exibirá a barra lateral em sua planilha do Google.
Como autorizar o código do Apps Script no Google
Para autorizar seu script personalizado, siga estas etapas:
Depois de executar o script, o Google solicitará que você selecione sua conta do Google. Depois de selecioná-lo, um pequeno pop-up aparecerá, clicando em ‘Permissões de revisão’.
Outro pop-up aparecerá, aqui selecione ‘Mostrar avançado’ e clique em ‘Ir para o projeto sem título (inseguro)’ (ele mostrará o nome do seu projeto).
Na próxima janela, clique em "Permitir" e o Google Sheet executará seu script.
Depois de fazer isso, volte para sua planilha do Google e atualize-a. O novo menu personalizado (Meu Novo Menu) será adicionado à barra de ferramentas da planilha do Google, que adicionamos por meio do script Code.gs. Clique em ‘Meu novo menu’ e selecione o item de menu ‘Minha barra lateral 1’ para exibir a barra lateral.
Agora, sua barra lateral personalizada aparecerá no lado direito de sua planilha do Google com o texto e o botão que adicionamos (conforme mostrado abaixo). Ao clicar no botão, a barra lateral será fechada.
Bem, agora você sabe como construir sua própria barra lateral no Google Sheets.