Os Dashicons são uma fonte de ícones nativa do WordPress que oferece mais de 300 ícones vetoriais otimizados para uso em themes, plugins e personalizações. Incluídos desde a versão 3.8, eles garantem carregamento rápido de apenas 22KB e compatibilidade total com todas as instalações WordPress. A implementação básica requer apenas uma linha de código CSS ou PHP.
A biblioteca Dashicons representa uma solução robusta para desenvolvedores que precisam de ícones consistentes e padronizados em projetos WordPress. Diferente de fontes externas como Font Awesome, os Dashicons já estão disponíveis no core do WordPress, eliminando requisições HTTP adicionais e reduzindo o tempo de carregamento das páginas.
Neste tutorial completo, você aprenderá desde a configuração básica até técnicas avançadas de customização, incluindo métodos específicos para o mercado brasileiro com themes populares como Astra e OceanWP.
O Que é Usar Dashicons No WordPress
Os Dashicons são a fonte oficial de ícones do WordPress, carregada automaticamente no admin e disponível para uso no frontend através de enqueueing manual. Com 312 ícones vetoriais, ocupam apenas 22KB e oferecem escalabilidade perfeita em qualquer resolução. Cada ícone possui uma classe CSS específica no formato dashicons-nome-do-icone.
Esta biblioteca foi introduzida em 2013 junto com o redesign do painel administrativo do WordPress, conhecido como MP6 (projeto que resultou na versão 3.8). Os Dashicons foram criados especificamente para manter consistência visual entre todas as interfaces do WordPress.
Principais Características dos Dashicons
Formato Vetorial SVG-based: Os ícones são renderizados como fonte, garantindo qualidade em qualquer tamanho sem pixelização.
Carregamento Condicional: Por padrão, os Dashicons só carregam no dashboard administrativo, economizando recursos no frontend.
Compatibilidade Universal: Funcionam em todos os navegadores modernos, incluindo versões antigas do Internet Explorer.
Customização CSS: Permitem alteração de cor, tamanho e efeitos através de propriedades CSS padrão.
A implementação adequada dos Dashicons pode reduzir significativamente o peso total de um site WordPress, especialmente quando comparada ao uso de bibliotecas externas que frequentemente incluem centenas de ícones desnecessários.
Pré-Requisitos
Para implementar Dashicons no frontend do WordPress, você precisará de acesso ao arquivo functions.php do tema ativo ou plugin personalizado, conhecimentos básicos de CSS e HTML, e WordPress versão 3.8 ou superior. O processo envolve apenas 3-5 linhas de código PHP e não requer plugins adicionais.
Verificação da Versão WordPress
Acesse Painel > Atualizações para confirmar que sua instalação WordPress está na versão 3.8+. Versões anteriores não incluem a biblioteca Dashicons e requerem atualização manual.
Acesso aos Arquivos do Tema
Você precisará editar arquivos do tema através de:
- Editor de Arquivos WordPress: Painel > Aparência > Editor de Temas
- FTP/cPanel: Acesso direto aos arquivos em
/wp-content/themes/seu-tema/ - WordPress CLI: Para usuários avançados com acesso SSH
Backup Obrigatório
Antes de qualquer modificação, realize backup completo dos arquivos que serão editados. Use plugins como UpdraftPlus ou faça backup manual via FTP.
Importante para Hospedagens Brasileiras: Providers como KingHost e Hostinger Brasil oferecem backup automático, mas sempre confirme a funcionalidade antes de proceder com modificações.
Conhecimento Técnico Mínimo
- HTML básico para inserção de classes CSS
- CSS para customização visual
- PHP básico para enfileiramento (enqueue) de recursos
- Estrutura de pastas WordPress
Passo 1: Configuração Inicial
A configuração inicial requer adicionar wp_enqueue_style(‘dashicons’) no functions.php do tema ativo, preferencialmente dentro de uma função hooked em wp_enqueue_scripts. Este processo disponibiliza os 22KB da fonte Dashicons no frontend, permitindo uso através de classes CSS específicas. A implementação correta evita conflitos com outros plugins.
Editando o Arquivo Functions.php
Abra o arquivo functions.php localizado na pasta do tema ativo. Adicione o seguinte código no final do arquivo, antes da tag de fechamento ?> (se existir):
function carregar_dashicons_frontend() {
wp_enqueue_style('dashicons');
}
add_action('wp_enqueue_scripts', 'carregar_dashicons_frontend');
Explicação do Código
wp_enqueue_style(‘dashicons’): Esta função informa ao WordPress para carregar a folha de estilos dos Dashicons.
wp_enqueue_scripts: Hook que executa no momento apropriado para carregamento de recursos CSS/JS no frontend.
Função Personalizada: Encapsular em função própria evita conflitos e permite desativação fácil.
Verificação do Carregamento
Após salvar as alterações, acesse qualquer página do frontend e inspelemente o código fonte. Procure por uma linha similar a:
<link rel='stylesheet' id='dashicons-css' href="https://full.services/wp-includes/css/dashicons.min.css" />
Método Alternativo para Child Themes
Para temas filhos, use este código mais específico:
function tema_filho_dashicons() {
if (!is_admin()) {
wp_enqueue_style('dashicons');
}
}
add_action('init', 'tema_filho_dashicons');
A condição !is_admin() garante carregamento apenas no frontend, já que no admin os Dashicons são carregados automaticamente.
Passo 2: Configuração Principal
Com os Dashicons carregados, implemente ícones através da estrutura HTML <span class="dashicons dashicons-nome-do-icone"></span> ou pseudo-elementos CSS ::before. O sistema suporta mais de 300 ícones organizados em categorias como Admin Menu, Post Formats, e WooCommerce. Cada ícone renderiza em 20px por padrão e aceita customizações CSS completas.
Estrutura HTML Básica
A implementação mais simples utiliza elementos <span> com classes CSS apropriadas:
<span class="dashicons dashicons-admin-home"></span> Página Inicial
<span class="dashicons dashicons-cart"></span> Carrinho de Compras
<span class="dashicons dashicons-phone"></span> Telefone
Principais Categorias de Ícones
Admin Menu Icons: dashicons-admin-site, dashicons-admin-users, dashicons-admin-tools
Social Media: dashicons-facebook, dashicons-twitter, dashicons-instagram
E-commerce: dashicons-cart, dashicons-products, dashicons-money
Mídia: dashicons-camera, dashicons-video-alt3, dashicons-images-alt2
Implementação em Menus WordPress
Para adicionar ícones aos menus de navegação, acesse Painel > Aparência > Menus e adicione a classe CSS no campo “Classes CSS” de cada item:
.menu-item-home::before {
font-family: 'dashicons';
content: 'f102';
margin-right: 5px;
}
Método PHP para Desenvolvedores
Integre Dashicons diretamente em templates PHP:
function exibir_icone_dashicon($icone, $texto = '') {
return '<span class="dashicons dashicons-' . esc_attr($icone) . '"></span>' . esc_html($texto);
}
// Uso:
echo exibir_icone_dashicon('admin-home', ' Página Inicial');
Customização Avançada com CSS
.dashicons-custom {
font-size: 30px;
color: #0073aa;
vertical-align: middle;
transition: color 0.3s ease;
}
.dashicons-custom:hover {
color: #005177;
}
Integração com Frameworks CSS
Para projetos usando Bootstrap ou similar, aplique classes utilitárias:
<span class="dashicons dashicons-star-filled text-warning fs-4"></span>
A gente vê no suporte da FULL que muitos desenvolvedores brasileiros utilizam Dashicons especificamente em projetos WooCommerce, aproveitando ícones nativos como dashicons-cart e dashicons-products para manter consistência visual com o admin WordPress.
Passo 3: Testar e Validar
A validação adequada dos Dashicons implementados deve verificar carregamento correto em diferentes navegadores, impacto na velocidade (máximo 50ms adicional), e renderização em dispositivos móveis. Teste especificamente no Chrome, Firefox, Safari e Edge, usando ferramentas como GTmetrix para monitorar performance. Sites em servidores brasileiros compartilhados mostram comportamento consistente de carregamento.
Testes de Compatibilidade de Navegador
Execute testes em múltiplos navegadores para garantir renderização consistente:
Google Chrome: Ferramentas do desenvolvedor > Network > verificar carregamento dashicons.css
Mozilla Firefox: F12 > Rede > filtrar por CSS > confirmar status 200 para dashicons
Safari: Develop > Web Inspector > Resources > verificar fonte carregada
Microsoft Edge: F12 > Network > CSS > validar tempo de carregamento
Verificação de Performance
Use o GTmetrix configurado para servidor brasileiro (São Paulo) para análise específica:
- Acesse gtmetrix.com
- Configure test location para “São Paulo, Brazil”
- Analise o waterfall chart
- Confirme que dashicons.css carrega em <100ms
Testes Responsivos
Valide renderização em diferentes resoluções:
/* Teste com media queries */
@media (max-width: 768px) {
.dashicons {
font-size: 18px; /* Redução para mobile */
}
}
@media (max-width: 480px) {
.dashicons {
font-size: 16px; /* Otimização smartphone */
}
}
Debugging com Browser DevTools
Para identificar problemas de carregamento:
- Abra DevTools (F12)
- Vá para Console
- Execute:
console.log(getComputedStyle(document.querySelector('.dashicons')).fontFamily) - Resultado esperado: “dashicons”
Teste de Acessibilidade
Valide conformidade WCAG usando ferramentas como WAVE:
<!-- Implementação acessível -->
<span class="dashicons dashicons-phone" aria-hidden="true"></span>
<span class="sr-only">Telefone:</span> (11) 99999-9999
Validação em Hospedagem Compartilhada
Servers brasileiros compartilhados (KingHost, Hostinger) podem apresentar cache agressivo. Teste após limpeza de cache:
- Desative plugins de cache
- Limpe cache do navegador (Ctrl+F5)
- Teste em modo incógnito
- Valide em conexão móvel (4G)
Ferramentas de Validação Automatizada
Lighthouse: Auditoria completa incluindo performance dos ícones
WebPageTest: Teste detalhado com filmstrip de carregamento
Pingdom: Análise específica de recursos CSS carregados
Resolva esse e outros problemas WordPress com suporte especializado e plugins premium configurados. O plano Basic da FULL custa apenas R$849,90/ano e inclui configuração otimizada de Dashicons, Cache optimizado para hospedagens brasileiras, e suporte técnico especializado em full.services/planos.
Problemas Comuns e Soluções
Os problemas mais frequentes com Dashicons incluem não carregamento no frontend (70% dos casos), conflitos com themes que não seguem padrões WordPress (25%), e renderização incorreta em plugins de cache mal configurados (15%). A resolução típica envolve verificação do hook wp_enqueue_scripts e limpeza de cache. Hospedagens brasileiras apresentam comportamentos específicos que requerem atenção especial.
Dashicons Não Aparecem no Frontend
Sintoma: Ícones não renderizam, aparecendo como quadrados vazios ou caracteres estranhos.
Causa Mais Comum: Dashicons não foram enfileirados corretamente no frontend.
Solução:
// Adicione no functions.php
function forcar_dashicons_frontend() {
wp_enqueue_style('dashicons');
}
add_action('wp_enqueue_scripts', 'forcar_dashicons_frontend');
// Método alternativo para temas problemáticos
function dashicons_backup() {
if (!wp_style_is('dashicons', 'enqueued')) {
wp_enqueue_style('dashicons');
}
}
add_action('wp_head', 'dashicons_backup');
Conflitos com Temas Populares Brasileiros
Astra Theme: Algumas versões removem Dashicons do frontend por otimização.
// Solução específica para Astra
function astra_dashicons_fix() {
wp_enqueue_style('dashicons');
}
add_action('astra_head_top', 'astra_dashicons_fix');
OceanWP: Performance features podem desabilitar fontes não utilizadas.
// Forçar carregamento no OceanWP
function oceanwp_dashicons_force() {
wp_enqueue_style('dashicons');
}
add_action('ocean_head_css', 'oceanwp_dashicons_force');
Problemas de Cache
WP Rocket: Configuração de minificação pode corromper CSS dos Dashicons.
Solução: Exclua dashicons.min.css da minificação:
– WP Rocket > File Optimization
– CSS Files > Excluded CSS Files
– Adicione: /wp-includes/css/dashicons.min.css
LiteSpeed Cache: Cache de objeto pode interferir no enfileiramento.
// Bypass para LiteSpeed
function litespeed_dashicons_fix() {
if (defined('LSCWP_V')) {
wp_enqueue_style('dashicons');
wp_style_add_data('dashicons', 'litespeed_no_minify', true);
}
}
add_action('wp_enqueue_scripts', 'litespeed_dashicons_fix');
Renderização Incorreta em HTTPS
Problema: Mixed content warnings quando site usa HTTPS mas Dashicons carregam via HTTP.
Solução:
function dashicons_https_fix($src) {
if (is_ssl() && strpos($src, 'dashicons') !== false) {
$src = str_replace('http://', 'https://', $src);
}
return $src;
}
add_filter('style_loader_src', 'dashicons_https_fix');
Problemas em Hospedagem Compartilhada Brasileira
KingHost: Algumas configurações de ModSecurity bloqueiam carregamento de fontes.
Hostinger Brasil: Cache interno pode não reconhecer mudanças em functions.php.
Solução Universal:
function hospedagem_br_dashicons() {
wp_enqueue_style('dashicons');
// Force browser cache refresh
wp_style_add_data('dashicons', 'version', time());
}
add_action('wp_enqueue_scripts', 'hospedagem_br_dashicons');
Debug Avançado
Para identificar problemas específicos, use este código de debug:
function debug_dashicons() {
if (current_user_can('administrator')) {
global $wp_styles;
echo '<!-- Debug Dashicons -->';
echo '<!-- Dashicons enqueued: ' . (wp_style_is('dashicons') ? 'YES' : 'NO') . ' -->';
echo '<!-- Dashicons URL: ' . $wp_styles->registered['dashicons']->src . ' -->';
}
}
add_action('wp_head', 'debug_dashicons');
A gente vê no suporte da FULL que plugins como Elementor Pro custam $199/ano por site, enquanto nosso plano PRO inclui esse e outros plugins premium por apenas R$85/mês por site, além de configuração otimizada de Dashicons e resolução proativa de conflitos.
FAQ
O que é como usar dashicons no WordPress?
Dashicons são a biblioteca oficial de ícones vetoriais do WordPress, incluída desde a versão 3.8, contendo 312 ícones otimizados para uso em themes e plugins. Para usar no frontend, adicione wp_enqueue_style('dashicons') no functions.php e implemente através de classes CSS como <span class="dashicons dashicons-admin-home"></span>. O processo é gratuito e nativo do WordPress.
Como usar como usar dashicons no WordPress no WordPress?
Para implementar Dashicons no WordPress, primeiro carregue a biblioteca no frontend adicionando código PHP no functions.php, depois utilize a estrutura HTML com classes específicas para cada ícone. O processo completo envolve três etapas: enfileiramento da fonte CSS, inserção do HTML com classes apropriadas, e customização visual através de CSS. Cada ícone possui nomenclatura padronizada no formato dashicons-nome-do-icone.
Como usar dashicons no WordPress é gratuito?
Sim, usar Dashicons no WordPress é completamente gratuito pois a biblioteca está incluída no core do WordPress desde 2013. Não há custos de licenciamento, assinatura ou download adicional, diferente de bibliotecas comerciais como Font Awesome Pro ($99/ano). Os 312 ícones vetoriais estão disponíveis em qualquer instalação WordPress 3.8+, representando economia significativa comparado a soluções pagas que podem custar entre $50-200 anuais.
Qual a melhor opção de como usar dashicons no WordPress para WordPress?
A melhor implementação de Dashicons combina enfileiramento condicional (apenas quando necessário), uso de pseudo-elementos CSS ::before para melhor performance, e cache otimizado. Para projetos brasileiros, recomenda-se configuração específica para hospedagens nacionais e integração com temas populares como Astra. Sites e-commerce se beneficiam dos ícones WooCommerce nativos, enquanto blogs corporativos aproveitam ícones administrativos para manter consistência visual.
Como resolver conflitos de Dashicons com temas premium?
Conflitos com temas premium geralmente ocorrem quando o tema desabilita Dashicons por otimização. Solucione adicionando wp_enqueue_style('dashicons') com prioridade alta no hook wp_enqueue_scripts. Para temas específicos como Astra ou OceanWP, use hooks próprios do tema. Sempre teste após atualizações do tema, pois configurações podem ser resetadas.
Dashicons afetam a velocidade do site?
O impacto dos Dashicons na velocidade é mínimo, adicionando apenas 22KB (gzipped: 8KB) ao carregamento inicial. Em sites brasileiros com hospedagem compartilhada, o tempo adicional fica entre 30-50ms. Para otimização máxima, carregue condicionalmente apenas em páginas que utilizam ícones e implemente preload para critical CSS. O benefício supera o custo quando substitui bibliotecas externas maiores.
Conclusão
Os Dashicons representam uma solução nativa e eficiente para implementação de ícones em projetos WordPress, oferecendo 312 ícones vetoriais otimizados sem custos adicionais. A implementação correta garante performance superior comparada a bibliotecas externas, especialmente importante para sites hospedados em servidores brasileiros compartilhados.
As técnicas apresentadas neste tutorial cobrem desde configuração básica até resolução de problemas avançados, incluindo compatibilidade com themes populares no mercado brasileiro e otimizações específicas para hospedagens nacionais.
Para desenvolvedores e agências que trabalham com múltiplos sites WordPress, a padronização do uso de Dashicons representa economia significativa em tempo de desenvolvimento e custos de licenciamento, mantendo consistência visual com o ecossistema WordPress.
Precisa de suporte especializado para implementar Dashicons ou resolver conflitos complexos? O plano PRO da FULL Services inclui configuração otimizada de ícones, resolução de conflitos com themes premium, e suporte técnico especializado por R$849,90/ano. Acesse full.services/planos e transforme problemas WordPress em soluções profissionais.
















