Web Design

Kanban iterativo

20/01/202516/01/2025 Por antonino

Veremos hoje um Kanban iterativo, criando componentes javascript em tempo de execução no front-end.

Criando componentes em tempo de execução

O Kanban iterativo é uma metodologia ágil amplamente utilizada para gerenciar projetos de forma visual e eficiente. Com sua abordagem intuitiva, ele facilita a organização e acompanhamento de tarefas em diferentes etapas. Recentemente, construí um Kanban digital, o que trouxe uma nova perspectiva sobre como gerenciar atividades e melhorar a produtividade. Neste post, explorarei os principais recursos e a importância dessa ferramenta na minha jornada de desenvolvimento.

Primeiramente, o Kanban digital oferece uma interface prática e fácil de usar. A estrutura da ferramenta permite a criação de grupos (como “Em andamento”, “Concluído” e “A Fazer”) para organizar os itens de trabalho. Cada grupo pode ter múltiplos itens, que representam tarefas específicas. Além disso, o sistema oferece a funcionalidade de “drag-and-drop”, ou arrastar e soltar, permitindo que os itens sejam movidos entre os grupos com facilidade. Com isso, a visualização do progresso do projeto se torna clara e dinâmica.

Outro ponto importante é a possibilidade de personalizar o Kanban conforme as necessidades de cada usuário. Ao adicionar e editar grupos ou itens, é possível ajustar o quadro conforme a evolução do projeto. Para garantir que as informações não se percam, implementei um sistema de salvamento dos dados no cookie do navegador, o que possibilita carregar e recuperar o quadro sempre que necessário, mantendo o histórico de alterações.

Menu flutuante nos objetos

Além disso, a integração de menus contextuais para cada grupo e item proporciona um nível extra de interação. O usuário pode, por exemplo, excluir ou editar itens diretamente no menu de contexto, sem precisar abrir outras interfaces ou se distrair com processos complicados. Dessa forma, as ações tornam-se mais diretas e práticas.

Em termos de usabilidade, o Kanban digital é acessível a qualquer pessoa que precise de uma forma visual e ágil de gerenciar tarefas. A integração de criptografia para salvar os dados no navegador é outra medida que proporciona segurança e confiabilidade ao sistema.

Por fim, a possibilidade de personalizar e salvar os dados em cookies oferece flexibilidade e autonomia ao usuário. Assim, além de ser uma ferramenta eficaz para gerenciamento de tarefas, ela também se torna uma aliada indispensável para quem busca produtividade e organização. Concluindo, o Kanban digital não é apenas uma plataforma de gerenciamento, mas um reflexo da constante busca por aprimoramento nas metodologias ágeis.

Vejamos um exemplo de KanBan que podemos fazer de forma dinâmica abaixo.

JAVASCRIPT:

/**
 * Obtém os elementos do DOM para manipulação posterior
 * @type {HTMLElement}
 */
const addGrupoButton = document.getElementById('add-grupo');
const addItemButton = document.getElementById('add-item');
const nomeNovoGrupoInput = document.getElementById('nome-novo-grupo');
const nomeNovoItemInput = document.getElementById('nome-novo-item');
const kanban = document.getElementById('kanban');
const contextMenu = document.getElementById('contextMenu');
const contextMenuGrupo = document.getElementById('contextMenuGrupo');
const editarItemOption = document.getElementById('editarItem');
const excluirItemOption = document.getElementById('excluirItem');
const editarGrupoOption = document.getElementById('editarGrupo');
const excluirGrupoOption = document.getElementById('excluirGrupo');

let itemCounter = 3; // Começa após o último item existente
let currentItem = null; // Referência ao item atual do menu de contexto
let currentGrupo = null; // Referência ao grupo atual do menu de contexto

/**
 * Função para salvar o estado atual do Kanban no cookie
 * @function
 */
function saveKanbanToCookie() {
  const grupos = [];
  const grupoElements = document.querySelectorAll('.titulo-grupo');

  grupoElements.forEach(grupoElement => {
    const grupo = {
      nome: grupoElement.querySelector('h1').textContent,
      itens: []
    };

    const itemElements = grupoElement.querySelectorAll('.grupo .item');
    itemElements.forEach(item => {
      grupo.itens.push(item.textContent);
    });

    grupos.push(grupo);
  });

  // Converte os dados em JSON
  const jsonData = JSON.stringify(grupos);

  // Criptografa os dados
  const encryptedData = CryptoJS.AES.encrypt(jsonData, 'secret-key').toString();

  // Salva os dados criptografados no cookie
  document.cookie = `kanbanData=${encryptedData}; path=/; max-age=${60 * 60 * 24 * 365}`;
}

/**
 * Função para carregar o Kanban a partir do cookie
 * @function
 */
function loadKanbanFromCookie() {
  const cookies = document.cookie.split('; ');
  const kanbanCookie = cookies.find(cookie => cookie.startsWith('kanbanData='));

  if (kanbanCookie) {
    // Extrai e descriptografa os dados do cookie
    const encryptedData = kanbanCookie.split('=')[1];
    const bytes = CryptoJS.AES.decrypt(encryptedData, 'secret-key');
    const jsonData = bytes.toString(CryptoJS.enc.Utf8);

    // Converte de volta para um objeto
    const kanbanData = JSON.parse(jsonData);

    // Cria os grupos e itens a partir dos dados
    kanbanData.forEach(grupo => {
      createGrupo(grupo.nome); // Cria o grupo
      const grupoElement = document.querySelector(`#kanban .titulo-grupo:last-child .grupo`);
      grupo.itens.forEach(item => {
        createItem(item, grupoElement); // Cria os itens dentro do grupo
      });
    });
  }
}

/**
 * Função para criar um novo grupo
 * @param {string} nome - Nome do grupo a ser criado
 * @function
 */
function createGrupo(nome) {
  const tituloGrupo = document.createElement('div');
  tituloGrupo.className = 'titulo-grupo';

  const grupo = document.createElement('div');
  grupo.className = 'grupo';
  grupo.addEventListener('dragover', handleDragOver);

  const titulo = document.createElement('h1');
  titulo.textContent = nome;
  titulo.addEventListener('contextmenu', handleContextMenuGrupo); // Adicionando o menu de contexto para o título do grupo

  tituloGrupo.appendChild(titulo);
  tituloGrupo.appendChild(grupo);
  kanban.appendChild(tituloGrupo);
}

/**
 * Função para criar um novo item dentro de um grupo
 * @param {string} nome - Nome do item a ser criado
 * @param {HTMLElement} grupo - O grupo onde o item será adicionado
 * @function
 */
function createItem(nome, grupo) {
  const item = document.createElement('div');
  item.className = 'item';
  item.draggable = true;
  item.id = `item-${++itemCounter}`;
  item.textContent = nome;

  item.addEventListener('dragstart', () => item.classList.add('dragging'));
  item.addEventListener('dragend', () => item.classList.remove('dragging'));
  item.addEventListener('contextmenu', handleContextMenu); // Menu de contexto para o item

  grupo.appendChild(item);
}

// Evento de adicionar grupo
addGrupoButton.addEventListener('click', () => {
  const nomeGrupo = nomeNovoGrupoInput.value.trim();
  if (nomeGrupo) {
    createGrupo(nomeGrupo);
    nomeNovoGrupoInput.value = '';
    saveKanbanToCookie(); // Salva o estado após adicionar o grupo
  }
});

// Evento de adicionar item
addItemButton.addEventListener('click', () => {
  const nomeItem = nomeNovoItemInput.value.trim();
  const grupoInicial = document.getElementById('grupo-inicial');
  if (nomeItem && grupoInicial) {
    createItem(nomeItem, grupoInicial);
    nomeNovoItemInput.value = '';
    saveKanbanToCookie(); // Salva o estado após adicionar o item
  }
});

/**
 * Gerencia o menu de contexto para itens
 * @param {Event} event - O evento de clique com o botão direito
 * @function
 */
function handleContextMenu(event) {
  event.preventDefault();
  const { clientX, clientY } = event;
  currentItem = event.target; // Armazena o item atual
  contextMenu.style.left = `${clientX}px`;
  contextMenu.style.top = `${clientY}px`;
  contextMenu.style.display = 'block';
}

/**
 * Gerencia o menu de contexto para grupos
 * @param {Event} event - O evento de clique com o botão direito
 * @function
 */
function handleContextMenuGrupo(event) {
  event.preventDefault();
  const { clientX, clientY } = event;
  currentGrupo = event.target.closest('.titulo-grupo'); // Armazena o grupo atual
  contextMenuGrupo.style.left = `${clientX}px`;
  contextMenuGrupo.style.top = `${clientY}px`;
  contextMenuGrupo.style.display = 'block';
}

/**
 * Fechar os menus de contexto ao clicar fora deles
 * @param {Event} event - O evento de clique
 * @function
 */
document.addEventListener('click', (event) => {
  if (!contextMenu.contains(event.target) && !contextMenuGrupo.contains(event.target)) {
    contextMenu.style.display = 'none';
    contextMenuGrupo.style.display = 'none';
  }
});

/**
 * Função para gerenciar o drag-and-drop de itens entre grupos
 * @param {Event} event - O evento de arrastar
 * @function
 */
function handleDragOver(event) {
  event.preventDefault();
  const dragging = document.querySelector('.dragging');
  const target = event.target.closest('.grupo');
  if (target) {
    target.appendChild(dragging);
  }
}

/**
 * Funcionalidade de Editar Item
 * @function
 */
editarItemOption.addEventListener('click', () => {
  if (currentItem) {
    const novoTexto = prompt('Editar Item:', currentItem.textContent);
    if (novoTexto) {
      currentItem.textContent = novoTexto;
      saveKanbanToCookie(); // Salva o estado após editar o item
    }
    contextMenu.style.display = 'none';
  }
});

/**
 * Funcionalidade de Excluir Item
 * @function
 */
excluirItemOption.addEventListener('click', () => {
  if (currentItem) {
    currentItem.remove(); // Remove o item atual
    saveKanbanToCookie(); // Salva o estado após excluir o item
    contextMenu.style.display = 'none';
  }
});

/**
 * Funcionalidade de Editar Grupo
 * @function
 */
editarGrupoOption.addEventListener('click', () => {
  if (currentGrupo) {
    const tituloGrupo = currentGrupo.querySelector('h1');
    const novoNome = prompt('Editar nome do Grupo:', tituloGrupo.textContent);
    if (novoNome) {
      tituloGrupo.textContent = novoNome;
      saveKanbanToCookie(); // Salva o estado após editar o grupo
    }
    contextMenuGrupo.style.display = 'none';
  }
});

/**
 * Funcionalidade de Excluir Grupo
 * @function
 */
excluirGrupoOption.addEventListener('click', () => {
  if (currentGrupo) {
    currentGrupo.remove(); // Remove o grupo
    saveKanbanToCookie(); // Salva o estado após excluir o grupo
    contextMenuGrupo.style.display = 'none';
  }
});

/**
 * Carregar o Kanban quando a página for carregada
 * @function
 */
window.onload = () => {
  loadKanbanFromCookie(); // Carrega o Kanban do cookie
};

100

101

102

103

104

105

106

107

108

109

110

111

112

113

114

115

116

117

118

119

120

121

122

123

124

125

126

127

128

129

130

131

132

133

134

135

136

137

138

139

140

141

142

143

144

145

146

147

148

149

150

151

152

153

154

155

156

157

158

159

160

161

162

163

164

165

166

167

168

169

170

171

172

173

174

175

176

177

178

179

180

181

182

183

184

185

186

187

188

189

190

191

192

193

194

195

196

197

198

199

200

201

202

203

204

205

206

207

208

209

210

211

212

213

214

215

216

217

218

219

220

221

222

223

224

225

226

227

228

229

230

231

232

233

234

235

236

237

238

239

240

241

242

243

244

245

246

247

248

249

250

251

252

253

254

255

256

257

258

259

/**

* Obtém os elementos do DOM para manipulação posterior

* @type {HTMLElement}

const addGrupoButton = document.getElementById('add-grupo');

const addItemButton = document.getElementById('add-item');

const nomeNovoGrupoInput = document.getElementById('nome-novo-grupo');

const nomeNovoItemInput = document.getElementById('nome-novo-item');

const kanban = document.getElementById('kanban');

const contextMenu = document.getElementById('contextMenu');

const contextMenuGrupo = document.getElementById('contextMenuGrupo');

const editarItemOption = document.getElementById('editarItem');

const excluirItemOption = document.getElementById('excluirItem');

const editarGrupoOption = document.getElementById('editarGrupo');

const excluirGrupoOption = document.getElementById('excluirGrupo');

let itemCounter = 3; // Começa após o último item existente

let currentItem = null; // Referência ao item atual do menu de contexto

let currentGrupo = null; // Referência ao grupo atual do menu de contexto

/**

* Função para salvar o estado atual do Kanban no cookie

* @function

function saveKanbanToCookie() {

const grupos = [];

const grupoElements = document.querySelectorAll('.titulo-grupo');

grupoElements.forEach(grupoElement => {

const grupo = {

nome: grupoElement.querySelector('h1').textContent,

itens: []

};

const itemElements = grupoElement.querySelectorAll('.grupo .item');

itemElements.forEach(item => {

grupo.itens.push(item.textContent);

});

grupos.push(grupo);

});

// Converte os dados em JSON

const jsonData = JSON.stringify(grupos);

// Criptografa os dados

const encryptedData = CryptoJS.AES.encrypt(jsonData, 'secret-key').toString();

// Salva os dados criptografados no cookie

document.cookie = `kanbanData=${encryptedData}; path=/; max-age=${60 * 60 * 24 * 365}`;

}

/**

* Função para carregar o Kanban a partir do cookie

* @function

function loadKanbanFromCookie() {

const cookies = document.cookie.split('; ');

const kanbanCookie = cookies.find(cookie => cookie.startsWith('kanbanData='));

if (kanbanCookie) {

// Extrai e descriptografa os dados do cookie

const encryptedData = kanbanCookie.split('=')[1];

const bytes = CryptoJS.AES.decrypt(encryptedData, 'secret-key');

const jsonData = bytes.toString(CryptoJS.enc.Utf8);

// Converte de volta para um objeto

const kanbanData = JSON.parse(jsonData);

// Cria os grupos e itens a partir dos dados

kanbanData.forEach(grupo => {

createGrupo(grupo.nome); // Cria o grupo

const grupoElement = document.querySelector(`#kanban .titulo-grupo:last-child .grupo`);

grupo.itens.forEach(item => {

createItem(item, grupoElement); // Cria os itens dentro do grupo

});

}

/**

* Função para criar um novo grupo

* @param {string} nome - Nome do grupo a ser criado

* @function

function createGrupo(nome) {

const tituloGrupo = document.createElement('div');

tituloGrupo.className = 'titulo-grupo';

const grupo = document.createElement('div');

grupo.className = 'grupo';

grupo.addEventListener('dragover', handleDragOver);

const titulo = document.createElement('h1');

titulo.textContent = nome;

titulo.addEventListener('contextmenu', handleContextMenuGrupo); // Adicionando o menu de contexto para o título do grupo

tituloGrupo.appendChild(titulo);

tituloGrupo.appendChild(grupo);

kanban.appendChild(tituloGrupo);

}

/**

* Função para criar um novo item dentro de um grupo

* @param {string} nome - Nome do item a ser criado

* @param {HTMLElement} grupo - O grupo onde o item será adicionado

* @function

function createItem(nome, grupo) {

const item = document.createElement('div');

item.className = 'item';

item.draggable = true;

item.id = `item-${++itemCounter}`;

item.textContent = nome;

item.addEventListener('dragstart', () => item.classList.add('dragging'));

item.addEventListener('dragend', () => item.classList.remove('dragging'));

item.addEventListener('contextmenu', handleContextMenu); // Menu de contexto para o item

grupo.appendChild(item);

}

// Evento de adicionar grupo

addGrupoButton.addEventListener('click', () => {

const nomeGrupo = nomeNovoGrupoInput.value.trim();

if (nomeGrupo) {

createGrupo(nomeGrupo);

nomeNovoGrupoInput.value = '';

saveKanbanToCookie(); // Salva o estado após adicionar o grupo

}

});

// Evento de adicionar item

addItemButton.addEventListener('click', () => {

const nomeItem = nomeNovoItemInput.value.trim();

const grupoInicial = document.getElementById('grupo-inicial');

if (nomeItem && grupoInicial) {

createItem(nomeItem, grupoInicial);

nomeNovoItemInput.value = '';

saveKanbanToCookie(); // Salva o estado após adicionar o item

}

});

/**

* Gerencia o menu de contexto para itens

* @param {Event} event - O evento de clique com o botão direito

* @function

function handleContextMenu(event) {

event.preventDefault();

const { clientX, clientY } = event;

currentItem = event.target; // Armazena o item atual

contextMenu.style.left = `${clientX}px`;

contextMenu.style.top = `${clientY}px`;

contextMenu.style.display = 'block';

}

/**

* Gerencia o menu de contexto para grupos

* @param {Event} event - O evento de clique com o botão direito

* @function

function handleContextMenuGrupo(event) {

event.preventDefault();

const { clientX, clientY } = event;

currentGrupo = event.target.closest('.titulo-grupo'); // Armazena o grupo atual

contextMenuGrupo.style.left = `${clientX}px`;

contextMenuGrupo.style.top = `${clientY}px`;

contextMenuGrupo.style.display = 'block';

}

/**

* Fechar os menus de contexto ao clicar fora deles

* @param {Event} event - O evento de clique

* @function

document.addEventListener('click', (event) => {

if (!contextMenu.contains(event.target) && !contextMenuGrupo.contains(event.target)) {

contextMenu.style.display = 'none';

contextMenuGrupo.style.display = 'none';

}

});

/**

* Função para gerenciar o drag-and-drop de itens entre grupos

* @param {Event} event - O evento de arrastar

* @function

function handleDragOver(event) {

event.preventDefault();

const dragging = document.querySelector('.dragging');

const target = event.target.closest('.grupo');

if (target) {

target.appendChild(dragging);

}

/**

* Funcionalidade de Editar Item

* @function

editarItemOption.addEventListener('click', () => {

if (currentItem) {

const novoTexto = prompt('Editar Item:', currentItem.textContent);

if (novoTexto) {

currentItem.textContent = novoTexto;

saveKanbanToCookie(); // Salva o estado após editar o item

}

contextMenu.style.display = 'none';

}

});

/**

* Funcionalidade de Excluir Item

* @function

excluirItemOption.addEventListener('click', () => {

if (currentItem) {

currentItem.remove(); // Remove o item atual

saveKanbanToCookie(); // Salva o estado após excluir o item

contextMenu.style.display = 'none';

}

});

/**

* Funcionalidade de Editar Grupo

* @function

editarGrupoOption.addEventListener('click', () => {

if (currentGrupo) {

const tituloGrupo = currentGrupo.querySelector('h1');

const novoNome = prompt('Editar nome do Grupo:', tituloGrupo.textContent);

if (novoNome) {

tituloGrupo.textContent = novoNome;

saveKanbanToCookie(); // Salva o estado após editar o grupo

}

contextMenuGrupo.style.display = 'none';

}

});

/**

* Funcionalidade de Excluir Grupo

* @function

excluirGrupoOption.addEventListener('click', () => {

if (currentGrupo) {

currentGrupo.remove(); // Remove o grupo

saveKanbanToCookie(); // Salva o estado após excluir o grupo

contextMenuGrupo.style.display = 'none';

}

});

/**

* Carregar o Kanban quando a página for carregada

* @function

window.onload = () => {

loadKanbanFromCookie(); // Carrega o Kanban do cookie

};

CSS:

:root {
  --kanban-bg: #FFF4CF;
  --grupo-bg: #5FA06D;
  --item-bg: #ffffff;
  --context-menu-bg: #ffffff;
  --context-menu-border: #ccc;
}

* {
  margin: 0;
  padding: 0;
  box-sizing: border-box;
  font-family: 'Poppins', sans-serif;
}

body {
  font-size: 12px;
}

.kanban {
  display: flex;
  gap: 10px;
  padding: 10px;
  background: var(--kanban-bg);
  width: 100%;
  min-height: 400px;
}

.grupo {
  display: flex;
  flex-direction: column;
  gap: 10px;
  padding: 10px;
  background-color: var(--grupo-bg);
  border-radius: 5px;
  min-width: 200px;
  margin: 20px;
}

.item {
  background-color: var(--item-bg);
  padding: 10px;
  border-radius: 5px;
  cursor: grab;
}

.dragging {
  opacity: 0.5;
}

#formulario {
  display: flex;
  justify-content: space-around;
  padding: 10px;
  gap: 10px;
}

#formulario input,
#formulario button {
  padding: 5px;
  border-radius: 3px;
  border: 1px solid #ccc;
}

.context-menu {
  position: absolute;
  display: none;
  background: var(--context-menu-bg);
  border: 1px solid var(--context-menu-border);
  padding: 5px;
  border-radius: 3px;
}

.context-menu ul {
  list-style: none;
  padding: 0;
}

.context-menu li {
  padding: 5px;
  cursor: pointer;
}

.context-menu li:hover {
  background-color: #f0f0f0;
}

:root {

--kanban-bg: #FFF4CF;

--grupo-bg: #5FA06D;

--item-bg: #ffffff;

--context-menu-bg: #ffffff;

--context-menu-border: #ccc;

}

* {

margin: 0;

padding: 0;

box-sizing: border-box;

font-family: 'Poppins', sans-serif;

}

body {

font-size: 12px;

}

.kanban {

display: flex;

gap: 10px;

padding: 10px;

background: var(--kanban-bg);

width: 100%;

min-height: 400px;

}

.grupo {

display: flex;

flex-direction: column;

gap: 10px;

padding: 10px;

background-color: var(--grupo-bg);

border-radius: 5px;

min-width: 200px;

margin: 20px;

}

.item {

background-color: var(--item-bg);

padding: 10px;

border-radius: 5px;

cursor: grab;

}

.dragging {

opacity: 0.5;

}

#formulario {

display: flex;

justify-content: space-around;

padding: 10px;

gap: 10px;

}

#formulario input,

#formulario button {

padding: 5px;

border-radius: 3px;

border: 1px solid #ccc;

}

.context-menu {

position: absolute;

display: none;

background: var(--context-menu-bg);

border: 1px solid var(--context-menu-border);

padding: 5px;

border-radius: 3px;

}

.context-menu ul {

list-style: none;

padding: 0;

}

.context-menu li {

padding: 5px;

cursor: pointer;

}

.context-menu li:hover {

background-color: #f0f0f0;

}

HTML:

<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="UTF-8">
  <meta http-equiv="X-UA-Compatible" content="IE=edge">
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
  <title>Kanban</title>
  <link rel="stylesheet" href="style.css" />
</head>
<body>
  <div id="contextMenu" class="context-menu">
    <ul>
      <li id="editarItem">Editar Item</li>
      <li id="excluirItem">Excluir Item</li>
    </ul>
  </div>

  <div id="contextMenuGrupo" class="context-menu">
    <ul>
      <li id="editarGrupo">Editar Grupo</li>
      <li id="excluirGrupo">Excluir Grupo</li>
    </ul>
  </div>

  <div id="formulario">
    <input id="nome-novo-grupo" type="text" placeholder="Nome do Grupo" />
    <button id="add-grupo">Adicionar Grupo</button>
    <input id="nome-novo-item" type="text" placeholder="Nome do Item" />
    <button id="add-item">Adicionar Item</button>
  </div>

  <div id="kanban" class="kanban">
    <div class="titulo-grupo">
      <h1>Start</h1>
      <div class="grupo" id="grupo-inicial"></div>
    </div>
  </div>

  <script src="script.js"></script>
  <script src="https://cdnjs.cloudflare.com/ajax/libs/crypto-js/3.1.9-1-crypto-js.min.js"></script
</body>
</html>

<!DOCTYPE html>

<head>

<title>Kanban</title>

</head>

<body>

<ul>

<li id="editarItem">Editar Item</li>

<li id="excluirItem">Excluir Item</li>

</ul>

</div>

<ul>

<li id="editarGrupo">Editar Grupo</li>

<li id="excluirGrupo">Excluir Grupo</li>

</ul>

</div>

<button id="add-grupo">Adicionar Grupo</button>

<button id="add-item">Adicionar Item</button>

</div>

<h1>Start</h1>

</div>

</body>

</html>

Referências:

Documentação JSDoc

livros sobre JavaScript

GitHub:

Projeto kanban_js

Interno:

Quem somos

Formatação em Markdown e MathML

18/01/202512/01/2025 Por antonino

O Markdown e o MathML são linguagens de marcação que servem, basicamente, para nos auxiliar a escrever um HTML simples e para adicionarmos fórmulas ao HTML. A seguir, falaremos da formatação em Markdown e MathML. Ambas possuem vantagens significativas, além de algumas restrições que devem ser consideradas.

Markdown

Markdown e MathML oferecem formatações práticas para criar conteúdos bem estruturados e visualmente agradáveis. Além disso, ambas são úteis em diferentes contextos e propósitos. **Portanto**, podem ser aplicadas em diversos tipos de projetos digitais, o que torna o processo de desenvolvimento mais ágil e prático para os profissionais da área. **Ademais**, o uso dessas linguagens promove organização e facilita a manutenção do código.

Algumas Restrições

**Contudo**, ao trabalhar com imagens, é importante considerar que frameworks como o Next.js não suportam imagens diretamente via Markdown. **Por outro lado**, eles utilizam o componente Image, que otimiza o carregamento de forma assíncrona. **Da mesma forma**, no WordPress, é necessário o uso de plugins específicos para otimizar imagens e convertê-las para o formato WEBP. **Portanto**, é essencial avaliar as necessidades do projeto ao escolher a abordagem mais adequada. **Assim**, deve-se levar em consideração tanto as vantagens quanto as limitações de cada plataforma antes de decidir.

Markdown em Projetos com React, Angular e Next.js

**Em resumo**, Markdown é uma excelente opção para quem deseja escrever de forma rápida e descomplicada, especialmente ao utilizar ferramentas como React ou Next.js. **Além disso**, sua simplicidade e eficiência são suas maiores qualidades. **Portanto**, ele continua sendo uma escolha popular no desenvolvimento de projetos digitais modernos. **Assim**, destaca-se pela facilidade de uso e pela compatibilidade com diversos ambientes de desenvolvimento. **Dessa forma**, Markdown permanece como uma solução prática e eficiente para os desenvolvedores que buscam agilidade no dia a dia.

Formatação em Markdown

Títulos ( h1, h2, h3 ,h4 ,h5 ,h6 )

# h1

## h2

### h3

#### h4

##### h5

###### h6

Negrito

**texto**

Itálico

__texto__

Link

[texto](https://site.com/)

Lista não ordenada de Itens

* 1 item

* 2 item

Lista ordenada de Itens

1. 1 novo item

2. 2 novo item

Imagens

![Alt ou título da imagem](URL da imagem)

Observação:

Nextjs não utilizar imagens pelo markdown (como acima mencionado) , pois utiliza 'Image' que permite otimizar o seu carregamento de forma assíncrona

WordPress também não se utiliza Markdown, pois existe um editor de texto para as postagens, ademais, existem plugins específicos para transformar as imagens em WEBP e carregá-las de forma assíncrona

Citação

>Citação de um autor de um livro

>que faz parte de um trabalho acadêmico

Código

~~~javascript

Linha de código em Javascript.

~~~

```javascript

Código em Javascript.

```

Tabela

Exemplo | Valor do exemplo

--------- | ------

caneta | R$ 10

lápis | R$ 8

borracha | R$ 7

Alinhado a esquerda | Centralizado | Alinhado a direita

:--------- | :------: | -------:

Paulo | 1 | 10.00

Patrícia | 1 | 40.00

José | 1 | 5.00

Maria | 1 | 3.00

MathML:

Significa Mathematical Markup Language, uma linguagem de marcação baseada em XML destinada a representar expressões matemáticas de forma estruturada e compreensível para máquinas. **Assim como** o HTML facilita a criação de páginas web, o MathML possibilita a criação de documentos matemáticos interativos. **Além disso**, é amplamente usado em ambientes acadêmicos e científicos. **Dessa forma**, ele oferece uma maneira eficaz de integrar a matemática em ambientes digitais. **Portanto**, é particularmente útil para documentos complexos que requerem a exibição precisa de fórmulas matemáticas e outros tipos de conteúdo técnico.

Vantagens e Flexibilidade do MathML em Ambientes Acadêmicos e Científicos

Uma das principais vantagens do MathML é sua capacidade de exibir equações matemáticas de forma precisa em navegadores. **Embora** o MathML seja suportado por alguns navegadores modernos, ele ainda não é universalmente compatível com todos, o que, **portanto**, pode limitar seu uso em determinadas plataformas. **No entanto**, em ambientes controlados, como sistemas de ensino ou publicações científicas, ele se destaca pela precisão. **Dessa forma**, sua utilidade cresce em áreas especializadas, onde a exibição exata de fórmulas é essencial. **Portanto**, o MathML continua sendo uma ferramenta valiosa nesses contextos, especialmente em disciplinas que exigem o uso extensivo de equações matemáticas complexas.

**Além disso**, podemos dividi-lo em duas partes: **Presentation MathML** e **Content MathML**. **Por exemplo**, o Presentation MathML é usado para exibir visualmente a matemática, garantindo que a equação apareça da maneira correta. **Já** o Content MathML é focado em representar o significado da equação, facilitando a manipulação de dados e a integração com outros sistemas. **Dessa forma**, essas duas divisões permitem que o MathML atenda a diferentes necessidades em contextos acadêmicos e científicos.

math

Elemento	Descrição
math	É a tag de nível superior (raiz) de todos os elementos MathML.

Resultado	Tag MathML
$Exemplo$	`<math> <mi>Exemplo</mi> </math>`

mrow

Elemento	Descrição
mrow	Indica linha de uma determinada tabela ou matriz.

Resultado	Tag MathML
$x + y$	`<math> <mrow> <mi>x</mi> <mo>+</mo> <mi>y</mi> </mrow> </math>`

msqrt

Elemento	Descrição
msqrt	Exibe o símbolo de raízes quadradas em uma expressão.

Resultado	Tag MathML
$\sqrt{9}$	`<math> <msqrt> <mn>9</mn> </msqrt> </math>`

msub

Elemento	Descrição
msub	É usado para adicionar subscrito em uma determinada expressão.

Resultado	Tag MathML
$x_{2}$	`<math> <msub> <mi>x</mi> <mn>2</mn> </msub> </math>`

msup

Elemento	Descrição
msup	É usado para adicionar sobrescrito em uma determinada expressão.

Resultado	Tag MathML
$y^{3}$	`<math> <msup> <mi>y</mi> <mn>3</mn> </msup> </math>`

mo

Elemento	Descrição
mo	Descrever o símbolo ou operador matemático e pode ser combinado com outros elementos como <mi> (identificadores matemáticos) ou (números).

Resultado	Tag MathML
$=$	`<math> <mo>=</mo> </math>`

mi

Elemento	Descrição
mi	Representa identificadores como variável ou constante.

Resultado	Tag MathML
$z$	`<math> <mi>z</mi> </math>`

mtable

Elemento	Descrição
mtable	É usado para criar tabela ou matriz.

Resultado	Tag MathML
$\begin{matrix} a & b \\ c & d \end{matrix}$	`<math> <mtable> <mtr> <mtd> <mi>a</mi> </mtd> <mtd> <mi>b</mi> </mtd> </mtr> <mtr> <mtd> <mi>c</mi> </mtd> <mtd> <mi>d</mi> </mtd> </mtr> </mtable> </math>`

Markdown e MathML: saiba mais nos links abaixo.

Referências:

Documentação MatML
Tutorial MarkDown

livros sobre Markdown
livros sobre MathML

Interno:

Quem somos