# HeadStyle Helper

O elemento HTML `<style>` é usado para incluir folhas de estilo CSS de forma inline no elemento HTML `<head>`.

## Use o HeadLink para "linkar" arquivos CSS

O HeadLink deve ser usado para criar elementos `<link>` para a inclusão de folhas de estilo externas. `HeadScript` é usado quando você deseja definir folhas de estilo inline.

O assistente `HeadStyle` dá suporte aos seguintes métodos para a configuração e adição de declarações de folhas de estilo:

- `appendStyle($content, $attributes = array())`

- `offsetSetStyle($index, $content, $attributes = array())`

- `prependStyle($content, $attributes = array())`

- `setStyle($content, $attributes = array())`

Em todos os casos, `$content` é a verdadeira declaração CSS. $attributes são quaisquer atributos adicionais que você dejesa prover para a tag `style`: lang, title, media, ou dir são todos admissíveis.

`HeadStyle` também permite a captura de declarações de estilo; isso pode ser útil se você quiser criar as declarações através de programação, e então colocalas em outro lugar. A utilização disso será mostrada em um exemplo abaixo.

Finalmente, você pode usar o método `headStyle()` para acrescentar rapidamente elementos de declaração; a assinatura para isso é `headStyle($content$placement = 'APPEND', $attributes = array())`. `$placement` deve ser 'APPEND', 'PREPEND', ou 'SET'.

`HeadStyle` sobrescreve `append()`, `offsetSet()`, `prepend()`, e `set()` para forçar o uso dos métodos especiais listados acima. Internamente ele armazena cada item como um token `stdClass` , que depois é serializado usando o método `itemToString()`. Isso permite que você faça verificações nos itens da pilha, e opcionalmente modifique estes itens simplesmente modificando o objeto retornado.

O assistente `HeadStyle` é uma implementação concreta do assistente Placeholder.

## Uso Básico do Assistente HeadStyle

Você pode especificar uma nova tag de estilo a qualquer momento:

    <?php // adding scripts
    $this->headStyle()->appendStyle($styles);
    ?>

A ordenação é muito importante no CSS; você talvez tenha que assegurar que as declarações sejam carregadas em uma ordem específica devido à ordem do CSS; use as diretivas append, prepend, e offsetSet para lhe auxiliar nessa tarefa:

    <?php // Putting styles in order

    // place at a particular offset:
    $this->headStyle()->offsetSetStyle(100, $customStyles);

    // place at end:
    $this->headStyle()->appendStyle($finalStyles);

    // place at beginning
    $this->headStyle()->prependStyle($firstStyles);
    ?>

When you're finally ready to output all style declarations in your layout script, simply echo the helper:

    <?= $this->headStyle() ?>

## Capturing Style Declarations Using the HeadStyle Helper

Sometimes you need to generate CSS style declarations programmatically. While you could use string concatenation, heredocs, and the like, often it's easier just to do so by creating the styles and sprinkling in PHP tags. `HeadStyle` lets you do just that, capturing it to the stack:

    <?php $this->headStyle()->captureStart() ?>
    body {
        background-color: <?= $this->bgColor ?>;
    }
    <?php $this->headStyle()->captureEnd() ?>

The following assumptions are made:

- The style declarations will be appended to the stack. If you wish for them to replace the stack or be added to the top, you will need to pass 'SET' or 'PREPEND', respectively, as the first argument to `captureStart()`.

- If you wish to specify any additional attributes for the `<style>` tag, pass them in an array as the third argument to `captureStart()`.