DEV Community

Cover image for Vue 3: Como funcionam os Renderless Components.
Yasmim Correa
Yasmim Correa

Posted on

Vue 3: Como funcionam os Renderless Components.

O que são Renderless Components?

Um componente renderless nada mais é do que um componente que não possui HTML próprio, ele existe apenas para estruturar e/ou tratar informações que são passadas para ele.
Resumidamente, você separa a lógica da UI do seu app, utilizando slots.
Isso permite que haja uma flexibilidade no jeito em que as coisas são renderizadas e a lógica passa a ser reutilizável.

E como eles funcionam?

Let's code!

Pra entender como esses componentes funcionam, imagine que você deseja criar uma to-do list igual a essa da imagem:

Essa imagem possui um fundo azul escuro, quase preto e escrito em branco o título da aplicação em inglês "Todo list Example", abaixo tem o input para adicionar uma nova tarefa e logo em seguida, as tarefas já adicionadas anteriormente também escritas em branco, com a checkbox em verde quando selecionada e em branco quando não selecionada.

Primeiro vamos começar criando um componente super simples chamado TodoList.vue.

Dentro da tag script, vamos criar um array com alguns ítens e duas funções. Uma para marca-los dependendo se status for "true" ou "false" e outra para adicionar novos ítens ao array:

<script setup>
import { ref } from "vue";

const todos = ref([
  { id: 0, title: "Create an article about renderless components", done: false },
  { id: 1, title: "Write some code", done: false },
  { id: 2, title: "Publish the article on linkedin", done: false },
]);

const toggleTodo = (id) => {
  const todo = todos.value.find((todo) => todo.id === id);
  if (todo) {
    todo.done = !todo.done;
  }
};
const addTodo = (event) => {
  const data = new FormData(event.target);
  event.target.reset();
  todos.value.push({
    id: todos.value.length,
    title: data.get("title"),
    done: false,
  });
};
</script>
Enter fullscreen mode Exit fullscreen mode

Agora, ainda no arquivo TodoList.vue, vamos criar o template responsável por renderizar esses ítens e executar as funções:

<template>
  <ul>
    <li>
      <form @submit.prevent="addTodo" class="mb-6 mt-3">
        <input
          type="text"
          name="title"
          class="bg-transparent border-b-2 
          outline-none accent-green-300"
          placeholder="New Todo"
        />
      </form>
    </li>
    <li v-for="todo in todos" :key="todo.title" class="py-1">
      <input
        class="accent-green-300"
        type="checkbox"
        :value="todo.done"
        @click="toggleTodo(todo.id)"
      />
      {{ todo.title }}
    </li>
  </ul>
</template>
Enter fullscreen mode Exit fullscreen mode

O código inteiro do arquivo TodoList.vue ficará assim:

<script setup>
import { ref } from "vue";

const todos = ref([
  {
    id: 0,
    title: "Create an article about renderless components",
    done: false,
  },
  { id: 1, title: "Write some code", done: false },
  { id: 2, title: "Publish the article on linkedin", done: false },
]);

const toggleTodo = (id) => {
  const todo = todos.value.find((todo) => todo.id === id);
  if (todo) {
    todo.done = !todo.done;
  }
};
const addTodo = (event) => {
  const data = new FormData(event.target);
  event.target.reset();
  todos.value.push({
    id: todos.value.length,
    title: data.get("title"),
    done: false,
  });
};
</script>
<template>
  <ul>
    <li>
      <form @submit.prevent="addTodo" class="mb-6 mt-3">
        <input
          type="text"
          name="title"
          class="bg-transparent border-b-2 
          outline-none accent-green-300"
          placeholder="New Todo"
        />
      </form>
    </li>
    <li v-for="todo in todos" :key="todo.title" class="py-1">
      <input
        class="accent-green-300"
        type="checkbox"
        :value="todo.done"
        @click="toggleTodo(todo.id)"
      />
      {{ todo.title }}
    </li>
  </ul>
</template>
Enter fullscreen mode Exit fullscreen mode

Repare que esse componente possui toda a lógica para criar a nossa to-do list e também possui a UI responsável por exibi-la.

Então, a partir de agora vamos separar tudo, passando toda a lógica de pai pra filho, utilizando slots.

Mas antes disso, se você não sabe o que são slots, você pode dar uma olhadinha na documentação oficial do Vue.js: Slots

A primeira coisa que vamos fazer é criar um componente pai e importar nosso componente filho TodoList.vue dentro dele.

✨Dica: Você pode utilizar o arquivo App.vue, que já existe por padrão, para importar o componente TodoList.✨

<script setup>
import TodoList from "./components/TodoList.vue";

</script>
<template>
  <main>
     <TodoList />
  </main>
</template>
Enter fullscreen mode Exit fullscreen mode

Depois, no componente filho TodoList.vue, vamos substituir o código por um <slot> e então fazer um bind com os nossos to-do's e as funções que criamos, dessa forma:

<template>
  <ul>
    <slot 
    :todos="todos" 
    :toggleTodo="toggleTodo" 
    :addTodo="addTodo">
    </slot>
  </ul>
</template>

Enter fullscreen mode Exit fullscreen mode

Agora precisamos fazer com que o componente pai tenha acesso aos dados do componente filho, então voltamos ao componente pai e adicionamos ao componente <TodoList/> um v-slot, passando nossa lista de to-do's e as funções addTodo e toggleTodo, dessa forma:

<TodoList v-slot="{ todos, addTodo, toggleTodo }">
 //...
</TodoList>

Enter fullscreen mode Exit fullscreen mode

A partir daí, podemos adicionar o HTML que removemos do componente TodoList.vue ao nosso v-slot:

<TodoList v-slot="{ todos, addTodo, toggleTodo }">
        <li>
          <form @submit.prevent="addTodo" class="mb-6 mt-3">
            <input
              type="text"
              name="title"
              class="bg-transparent border-b-2 outline-none accent-green-300"
              placeholder="New Todo"
            />
          </form>
        </li>
        <li v-for="todo in todos" :key="todo.title" class="py-1">
          <input
            class="accent-green-300"
            type="checkbox"
            :value="todo.done"
            @click="toggleTodo(todo.id)"
          />
          {{ todo.title }}
        </li>
      </TodoList>
Enter fullscreen mode Exit fullscreen mode

Basicamente o código que antes estava dentro do componente TodoList.vue, agora ficará dentro do v-slot no componente pai.

Agora o componente pai ficará responsável por "injetar" as informações no componente filho e isso é o que vai permitir que a lógica seja reutilizada para a criação de novas listas, que podem possuir uma UI completamente diferente da que criamos nesse exemplo.

Você pode tentar modificar a UI, deixando totalmente diferente e me falar depois o que achou :)

Muito legal, né? Espero que você tenha entendido e gostado de ler até aqui, pois essa foi a forma que encontrei de fixar conteúdos na minha cabeça e ainda contribuir de alguma forma com a comunidade.

Grande abraço e tchauuu

Top comments (0)