Tutorial: Como Criar uma Busca Inteligente no Google Planilhas

Tutorial – Adicione uma Busca Inteligente às suas Planilhas Google

Navegar por abas é o primeiro passo para organizar seus dados, mas o que acontece quando sua planilha cresce e passa a ter centenas de linhas? O “Scroll” infinito e o Ctrl+F padrão são ferramentas lentas que travam sua produtividade. Neste tutorial, vamos dar um Upgrade de Performance no nosso projeto anterior e criar uma Interface com Busca Inteligente em Tempo Real.

Você aprenderá como inserir um campo de pesquisa que filtra milhares de dados instantaneamente enquanto você digita. Essa é a mesma tecnologia de ponta que utilizamos em nossos sistemas premium para garantir que qualquer informação seja encontrada em milissegundos, sem a necessidade de recarregar a página.

O que você vai aprender:

Filtro Instantâneo (Client-Side): O segredo para realizar buscas no navegador, tornando o processo muito mais rápido que o método tradicional.
Manipulação de Dados com JavaScript: Como salvar os dados da sua planilha na memória da interface para uma resposta imediata ao usuário.
Design de UX Profissional: Como adicionar uma barra de busca elegante com ícone de limpeza dinâmica e feedback visual.

Código.gs

// ==========================================================================
// ARQUIVO: Código.gs
// ==========================================================================

const PROJECT_TITLE = "Gestor de Estoque";

function doGet(e) {
  const tpl = HtmlService.createTemplateFromFile('Index');
  return tpl.evaluate()
      .setTitle(PROJECT_TITLE)
      .addMetaTag('viewport', 'width=device-width, initial-scale=1.0')
      .setXFrameOptionsMode(HtmlService.XFrameOptionsMode.ALLOWALL);
}

/**
 * Função genérica para buscar dados de qualquer aba.
 * Usa getDisplayValues() para trazer os dados já formatados (R$, Datas) como texto.
 */
function getSheetData(sheetName) {
  try {
    const ss = SpreadsheetApp.getActiveSpreadsheet();
    const sheet = ss.getSheetByName(sheetName);
    
    if (!sheet) return { error: `Aba "${sheetName}" não encontrada.` };
    
    const lastRow = sheet.getLastRow();
    const lastCol = sheet.getLastColumn();
    
    if (lastRow<1||lastCol<1) return { headers:[], data:[] }; // Aba vazia
    
    // Pega cabeçalhos e dados
    const headers = sheet.getRange(1, 1, 1, lastCol).getValues()[0];
    
    // Se tiver dados além do cabeçalho
    let data =[];
    if (lastRow>1) {
      data = sheet.getRange(2, 1, lastRow - 1, lastCol).getDisplayValues();
    }
    
    return { headers: headers, data: data, sheetName: sheetName };
    
  } catch (e) {
    return { error: e.message };
  }
}

Index.html

<!DOCTYPE html>
<html>
<head>
  <base target="_top">
  <!-- Fonte Google (Roboto) -->
  <link href="https://fonts.googleapis.com/css2?family=Roboto:wght@300;400;500;700&display=swap" rel="stylesheet">
  <!-- Ícones Material Design -->
  <link href="https://fonts.googleapis.com/icon?family=Material+Icons" rel="stylesheet">
 
  <style>
    :root {
      --primary-color: #1a73e8; /* Azul Google */
      --header-height: 60px;
      --bg-color: #f8f9fa;
      --card-bg: #ffffff;
      --text-color: #202124;
      --border-color: #dadce0;
    }
 
    * { box-sizing: border-box; }
     
    body {
      margin: 0;
      padding: 0;
      font-family: 'Roboto', sans-serif;
      background-color: var(--bg-color);
      color: var(--text-color);
      padding-top: var(--header-height); /* Espaço para o menu fixo */
    }
 
    /* --- MENU SUPERIOR FIXO --- */
    .navbar {
      position: fixed;
      top: 0;
      left: 0;
      width: 100%;
      height: var(--header-height);
      background-color: var(--primary-color);
      color: white;
      display: flex;
      align-items: center;
      padding: 0 20px;
      box-shadow: 0 2px 4px rgba(0,0,0,0.2);
      z-index: 1000;
    }
 
    .nav-title {
      font-size: 1.2rem;
      font-weight: 500;
      margin-right: 40px;
      display: flex;
      align-items: center;
      gap: 10px;
    }
 
    .nav-links {
      display: flex;
      gap: 5px;
      overflow-x: auto; /* Permite rolar no mobile */
    }
 
    .nav-btn {
      background: none;
      border: none;
      color: rgba(255,255,255,0.7);
      padding: 8px 16px;
      border-radius: 4px;
      cursor: pointer;
      font-size: 0.95rem;
      font-weight: 500;
      transition: all 0.2s;
      white-space: nowrap;
    }
 
    .nav-btn:hover { color: white; background-color: rgba(255,255,255,0.1); }
    .nav-btn.active { color: var(--primary-color); background-color: white; }
 
    /* --- ÁREA DE CONTEÚDO --- */
    .container {
      max-width: 1200px;
      margin: 20px auto;
      padding: 0 15px;
    }
 
    .content-header {
      display: flex;
      justify-content: space-between;
      align-items: center;
      margin-bottom: 20px;
    }
 
    h2 { margin: 0; font-weight: 400; color: #5f6368; }
 
    /* --- TABELA ESTILIZADA --- */
    .table-responsive {
      overflow-x: auto;
      background: var(--card-bg);
      border-radius: 8px;
      box-shadow: 0 1px 3px rgba(0,0,0,0.1);
      border: 1px solid var(--border-color);
    }
 
    table {
      width: 100%;
      border-collapse: collapse;
      min-width: 600px; /* Garante largura mínima */
    }
 
    th, td {
      padding: 12px 15px;
      text-align: left;
      border-bottom: 1px solid var(--border-color);
    }
 
    th {
      background-color: #f1f3f4;
      font-weight: 600;
      color: #5f6368;
      position: sticky;
      top: 0;
    }
 
    tr:hover { background-color: #f8f9fa; }
    tr:last-child td { border-bottom: none; }

    /* --- CAMPO DE BUSCA --- */
    .search-wrapper {
      position: relative;
      margin-bottom: 20px;
      max-width: 100%;
    }
    
    .search-wrapper input {
      width: 100%;
      padding: 12px 40px 12px 45px; /* Espaço para ícones esq/dir */
      border: 1px solid var(--border-color);
      border-radius: 8px;
      font-size: 1rem;
      outline: none;
      transition: border-color 0.2s, box-shadow 0.2s;
    }

    .search-wrapper input:focus {
      border-color: var(--primary-color);
      box-shadow: 0 0 0 2px rgba(26, 115, 232, 0.2);
    }

    .search-icon {
      position: absolute;
      left: 12px;
      top: 50%;
      transform: translateY(-50%);
      color: #5f6368;
      pointer-events: none; /* O clique passa através dele */
    }

    .clear-icon {
      position: absolute;
      right: 12px;
      top: 50%;
      transform: translateY(-50%);
      color: #5f6368;
      cursor: pointer;
      display: none; /* Escondido por padrão */
    }

    .clear-icon:hover { color: #202124; }
 
    /* --- LOADER --- */
    #loader {
      display: none;
      justify-content: center;
      padding: 40px;
    }
    .spinner {
      border: 4px solid #f3f3f3;
      border-top: 4px solid var(--primary-color);
      border-radius: 50%;
      width: 40px;
      height: 40px;
      animation: spin 1s linear infinite;
    }
    @keyframes spin { 0% { transform: rotate(0deg); } 100% { transform: rotate(360deg); } }
 
  </style>
</head>
<body>
 
  <!-- Menu Superior -->
  <nav class="navbar">
    <div class="nav-title">
      <span class="material-icons">inventory_2</span> Estoque
    </div>
    <div class="nav-links">
      <button class="nav-btn active" onclick="loadTab('Produtos', this)">Produtos</button>
      <button class="nav-btn" onclick="loadTab('Estoque', this)">Estoque</button>
      <button class="nav-btn" onclick="loadTab('Vendas', this)">Vendas</button>
      <button class="nav-btn" onclick="loadTab('Histórico', this)">Histórico</button>
    </div>
  </nav>
 
  <!-- Área Principal -->
  <div class="container">
    <div class="content-header">
      <h2 id="pageTitle">Produtos</h2>
      <button onclick="refreshData()" style="border:none; background:none; cursor:pointer; color: #1a73e8;">
        <span class="material-icons">refresh</span>
      </button>
    </div>

    <!-- CAMPO DE BUSCA (NOVO) -->
    <div class="search-wrapper">
      <span class="material-icons search-icon">search</span>
      <input type="text" id="searchInput" placeholder="Buscar na lista..." oninput="filterTable()">
      <span class="material-icons clear-icon" id="searchClear" onclick="clearSearch()">close</span>
    </div>
 
    <!-- Loading -->
    <div id="loader"><div class="spinner"></div></div>
 
    <!-- Tabela Dinâmica -->
    <div id="tableContainer" class="table-responsive">
      <!-- Tabela inserida aqui via JS -->
    </div>
  </div>
 
  <script>
    let currentTab = 'Produtos';
    let currentData = [];    // Armazena os dados originais da aba atual
    let currentHeaders = []; // Armazena os cabeçalhos

    // Ao carregar a página
    document.addEventListener('DOMContentLoaded', () => {
      loadTab('Produtos', document.querySelector('.nav-btn.active'));
    });

    function loadTab(sheetName, btnElement) {
      currentTab = sheetName;
      
      // Limpa a busca ao trocar de aba
      clearSearch();

      // Atualiza visual do menu
      if (btnElement) {
        document.querySelectorAll('.nav-btn').forEach(b => b.classList.remove('active'));
        btnElement.classList.add('active');
      }

      document.getElementById('pageTitle').textContent = sheetName;
      document.getElementById('tableContainer').innerHTML = '';
      document.getElementById('loader').style.display = 'flex';

      google.script.run
        .withSuccessHandler(processDataAndRender) // Mudamos para processar antes de renderizar
        .withFailureHandler(showError)
        .getSheetData(sheetName);
    }

    function refreshData() {
      const activeBtn = document.querySelector('.nav-btn.active');
      loadTab(currentTab, activeBtn);
    }

    // Recebe os dados, salva na memória e chama a renderização
    function processDataAndRender(response) {
      document.getElementById('loader').style.display = 'none';
      const container = document.getElementById('tableContainer');

      if (response.error) {
        container.innerHTML = `<p style="padding:20px; color:red;">${response.error}</p>`;
        return;
      }

      // Salva nas variáveis globais
      currentHeaders = response.headers || [];
      currentData = response.data || [];

      if (currentData.length === 0) {
        container.innerHTML = `<p style="padding:20px; text-align:center; color:#888;">Nenhum registro encontrado.</p>`;
        return;
      }

      // Renderiza a tabela completa inicialmente
      renderTableHTML(currentData);
    }

    // Função que filtra os dados da memória (Instantâneo)
    function filterTable() {
      const term = document.getElementById('searchInput').value.toLowerCase();
      const clearBtn = document.getElementById('searchClear');

      // Mostra ou esconde o botão X
      clearBtn.style.display = term ? 'block' : 'none';

      // Filtra: Verifica se ALGUMA coluna da linha contém o termo digitado
      const filteredData = currentData.filter(row => {
        return row.some(cell => String(cell).toLowerCase().includes(term));
      });

      renderTableHTML(filteredData);
    }

    // Limpa a busca e reseta a tabela
    function clearSearch() {
      const input = document.getElementById('searchInput');
      const clearBtn = document.getElementById('searchClear');
      
      input.value = '';
      clearBtn.style.display = 'none';
      
      // Se tiver dados carregados, restaura a lista completa
      if (currentData.length > 0) {
        renderTableHTML(currentData);
      }
    }

    // Função pura para gerar o HTML da tabela (Reutilizável)
    function renderTableHTML(dataToRender) {
      const container = document.getElementById('tableContainer');

      if (dataToRender.length === 0) {
        container.innerHTML = `<p style="padding:20px; text-align:center; color:#888;">Nenhum resultado para a busca.</p>`;
        return;
      }

      let html = '<table><thead><tr>';
      
      currentHeaders.forEach(h => {
        html += `<th>${h}</th>`;
      });
      html += '</tr></thead><tbody>';

      dataToRender.forEach(row => {
        html += '<tr>';
        row.forEach(cell => {
          html += `<td>${cell}</td>`;
        });
        html += '</tr>';
      });

      html += '</tbody></table>';
      container.innerHTML = html;
    }

    function showError(err) {
      document.getElementById('loader').style.display = 'none';
      document.getElementById('tableContainer').innerHTML = `<p style="color:red; padding:20px;">Erro de conexão: ${err.message}</p>`;
    }
  </script>
</body>
</html>

Soluções prontas para você

Controle Financeiro para Google Planilhas