gsferro/chartsexcell

There is no license information available for the latest version (v1.3) of this package.

Facade para criar facilmente charts utilizando o pacote Laravel Excell

v1.3 2021-01-18 14:29 UTC

Requires

• maatwebsite/excel: ^3.1

Unknown License

• Guilherme Ferro

README

Um pacote para simplificar a criação de gráficos dentro do excell utilizando o pacote laravel-excell, visto que nem a propria documentação do pacote fala sobre a implementação de gráficos e tão pouco encontrasse formas de implementar na internet.

Instalação

composer require gsferro/chartsexcell

Dependências

maatwebsite/excel": "^3.1

coloque no arquivo app.php:

• providers

Maatwebsite\Excel\ExcelServiceProvider::class,

• aliases

'Excel' => Maatwebsite\Excel\Facades\Excel::class,

Uso

• Para iniciarlizar:

$createChart = chartsexcell();

Paramentros gerais:

• Layout

/**
 * Possibilidade de mudar o layout do gráfico
 *
 * @param Layout $layout
 * @return ChartsExcell
 */
 ->setLayout(Layout $layout) // default: null

• porcentagem show

  ->setLayout((new Layout())->setShowPercent(true))

• valores show

  ->setLayout((new Layout())->setShowVal(true))

• Legend

/**
 * Possibilidade de mudar a Legend
 *
 * @param Legend $legend
 * @return ChartsExcell
 */
->setLegend(Legend $legend = null) // default: new Legend('r')

• sem legenda

->setLegend(null)

• legenda RIGHT

->setLegend((new Legend('r'))

• legenda LEFT

->setLegend((new Legend('l'))

• legenda BOTTOM

->setLegend((new Legend('b'))

• legenda TOP

->setLegend((new Legend('t'))

• legenda TOPRIGHT

->setLegend((new Legend('tr'))

• Informações Gerais

/**
 * Cabelhaço do excell
 * Adicionar +1 no $index para buscar os valores
 *
 * @param int $linesHeader
 * @return ChartsExcell
 */
->setLinesHeader(int $linesHeader) // default 1

/**
 * Posição para começar a busca pelos dados
 *
 * @param int $index
 * @return ChartsExcell
 */
->setIndex(int $index) // default 2

/**
 * Titulo da aba - (Não pode ter espaços)
 *
 * @param string $titleSheet
 * @return ChartsExcell
 */
->setTitleSheet(string $titleSheet) // default: "Worksheet"

/**
 * Tipo do chart via DataSeries const
 *
 * @param string $typeChart DataSeries::TYPE_PIECHART / pieChart
 * @return ChartsExcell
 */
->setTypeChart(string $typeChart) // default: DataSeries::TYPE_PIECHART / pieChart

Dados do Gráfico

/**
 * Monta o grafico
 *
 * @param string $title       "Titulo do gráfico"
 * @param int $countLines     "Qtde linhas de registro"
 * @param string $columnLabel "Letra da Coluna para os labels do chart"
 * @param string $columnValue "Letra da Coluna para os valores do chart"
 *
 * @return Chart
 */
->chart(string $title, int $countLines, string $columnLabel, string $columnValue) : Chart