Funções para inclusão de estilos

Funções auxiliares para inclusão de folhas de estilo no template. Permitem inserir CSS diretamente no HTML, carregar arquivos CSS do template ou incluir uma folha de estilos através de uma URL.

Essas funções são recursos independentes e não substituem outras formas de gerenciamento de estilos disponíveis no Opus Core. O desenvolvedor pode utilizá-las conforme a necessidade do template, utilizar a classe Stylesheets, seus hooks ou inserir os elementos diretamente no HTML.

Funções:

• block_style() insere o conteúdo de um arquivo CSS diretamente em um elemento <style>
• append_style() adiciona uma folha de estilos localizada no template através de um elemento <link>
• import_style() adiciona uma folha de estilos a partir de uma URL através de um elemento <link>

block_style()

Lê um arquivo CSS e insere seu conteúdo diretamente no HTML dentro de um elemento <style>. O conteúdo é comprimido antes de ser exibido.

Parâmetros:
$css string Caminho do arquivo CSS. Por padrão, o caminho é considerado relativo ao diretório do template.
$abs_path bool Define se o caminho informado deve ser combinado com TEMPLATE_PATH. Padrão: true.

Retorno: void

block_style('assets/css/custom.css');

block_style('/var/www/site/custom.css', false);

<style></style>
    /* CSS comprimido */
</style>

append_style()

Adiciona uma folha de estilos localizada dentro do template através de um elemento <link>. Permite informar uma versão para controle de cache e atributos adicionais para o elemento.

Parâmetros:
$path string Caminho do arquivo CSS dentro do template.
$v string Versão do arquivo utilizada na URL. Opcional.
$attrs string Atributos HTML adicionais para o elemento <link>. Opcional.

Retorno: void

append_style('assets/css/style.css');

append_style(
    'assets/css/style.css',
    '1.2.0',
    'media="screen"'
);

<link rel="stylesheet" href="https://example.com/templates/assets/css/style.css" />;

<link rel="stylesheet" href="https://example.com/templates/assets/css/style.css?v=1.2.0" media="screen" />;

import_style()

Adiciona uma folha de estilos através de uma URL informada diretamente.

Parâmetros:
$url string URL da folha de estilos.
$attrs string Atributos HTML adicionais para o elemento <link>. Opcional.

Retorno: void

import_style('https://cdn.example.com/library.css');

import_style(
    'https://cdn.example.com/library.css',
    'media="print"'
);

<link rel="stylesheet" href="https://cdn.example.com/library.css" />;

<link rel="stylesheet" href="https://cdn.example.com/library.css" media="print" />;