font awesome php

Uma biblioteca PHP para a fonte incrível.

Este repositório contém os dados necessários para trabalhar com a fonte impressionante no PHP.

Requisitos:

• Fonte Awesome 4.7.0
• Php 5.3+.

Licença

• MIT - Detalhes

Instalação

Com compositor:

composer require awps/font-awesome-php

Manualmente:

 require_once ' src/load.php ' ;

Uso

A biblioteca contém 2 classes principais criadas para o público:

• AwpsFontAwesome() - usa uma matriz estática de ícones da FA. (Recomendado)
• AwpsFontAwesomeReader( $css_path ) - gera a matriz do arquivo font-awesome.css . Você deve definir o caminho para este arquivo.

Crie uma instância:

 // Using the reader to dynamically get the icons array. It's resource intensive and you must cache the result.
$ css_path = __DIR__ . ' /css/font-awesome.css ' ;
$ icons    = new Awps  FontAwesomeReader ( $ css_path );

// .... or better use the static class

$ icons = new Awps  FontAwesome ();

Em seguida, é fácil. Você pode obter a variedade de ícones apenas fazendo isso.

 $ icons -> getArray ();

// Result:
/*
array (
  'fa-glass' => '\f000',
  'fa-music' => '\f001',
  'fa-search' => '\f002',
  ...
*/

API:

->getAllData()

 $ icons -> getAllData ();

// Result:
/*
array (
  'fa-glass' => 
  array (
    'unicode' => '\f000',
    'name' => 'Glass',
    'class' => 'fa-glass',
  ),
  'fa-music' => 
  array (
    'unicode' => '\f001',
    'name' => 'Music',
    'class' => 'fa-music',
  ),
  ...
*/ 

->getCssClasses()

 $ icons -> getCssClasses ();

// Result:
/*
array (
  'fa-glass' => 'fa-glass',
  'fa-music' => 'fa-music',
  'fa-search' => 'fa-search',
  ...
*/ 

->getUnicodeKeys()

 $ icons -> getUnicodeKeys ();

// Result:
/*
array (
  'fa-glass' => '\f000',
  'fa-music' => '\f001',
  'fa-search' => '\f002',
  'fa-envelope-o' => '\f003',
  ...
*/ 

->getReadableNames()

 $ icons -> getReadableNames ();

// Result:
/*
array (
  'fa-glass' => 'Glass',
  'fa-music' => 'Music',
  'fa-search' => 'Search',
  ...
*/ 

->sortByName()

Atenção: isso modifica a matriz original. Você pode redefini -lo usando o método ->reset() .

 $ icons -> sortByName ();

// Result:
/*
array (
  'fa-500px' => '\f26e',
  'fa-address-book' => '\f2b9',
  'fa-address-book-o' => '\f2ba',
  'fa-address-card' => '\f2bb',
  'fa-address-card-o' => '\f2bc',
  'fa-adjust' => '\f042',
  ...
*/ 

Utilitários:

->total()

Retorne o número total de ícones da matriz original.

->getIconUnicode( $icon_class )

Obtenha o unicode por classe de ícone.

Exemplo:

 $ icons -> getIconUnicode ( ' fa-address-card ' );

// Result
// 'f2bb' 

->getIconName( $icon_class )

Obtenha o nome do ícone legível por classe.

Exemplo:

 $ icons -> getIconName ( ' fa-address-card ' );

// Result
// 'Address card' 

->getIcon( $icon_class )

Obtenha os detalhes de um único ícone por classe.

Exemplo:

 $ icons -> getIcon ( ' fa-address-card ' );

// Result
/*
array (
  'unicode' => '\f2bb',
  'name' => 'Address card',
  'class' => 'fa-address-card',
)
*/ 

->getIconByUnicode( $unicode )

Obtenha os detalhes de um único ícone da Unicode.

Exemplo:

 $ icons -> getIconByUnicode ( '\ f004 ' )

// Result
/*
array (
  'unicode' => '\f004',
  'name' => 'Heart',
  'class' => 'fa-heart',
)
*/ 

->reset()

Redefina a matriz atual para seu estado original

Exemplo:

 $ icons -> sortByName ();

// Array is sorted:
$ icons -> getArray ();

/*
array (
  'fa-500px' => '\f26e',
  'fa-address-book' => '\f2b9',
  'fa-address-book-o' => '\f2ba',
  'fa-address-card' => '\f2bb',
  ...
);
*/

// Reset it
$ icons -> reset ();

// This one will return the original array
$ icons -> getArray ();

// Result:
/*
array (
  'fa-glass' => '\f000',
  'fa-music' => '\f001',
  'fa-search' => '\f002',
  ...
);
*/