Función wp_enqueue_style()

Por
David Carrero Fernández-Baillo
-

Un camino seguro para añadir/embeber un fichero con estilos CSS en una página generada con WordPress. Si previamente ha sido registrada con wp_register_style() puedes añadirlo usando esta función.

¿Cómo usar wp_enqueue_style()?

<?php
wp_enqueue_style( $handle, $src, $deps, $ver, $media );
?>

Parámetros

$handle
(string) (requerido) Nombre de la hoja de estilos
Por defecto: Nada

$src
(string|boolean) (opcional) URL de la hoja de estilo. Ejemplo: ‘http://ejemplo.com/css/miestilo.css‘.
Este parámetro solo es necesario cuando WordPress no conoce nada acerca del estilo.
Nunca deberías forzar la URL en tu estilos locales, utiliza la Referencia de funciones/plugins_url (para Plugins) y Referencia de funciones/get_template_directory_uri (para Temas) para capturar la URL correcta.
Por defecto: false

$deps
(array) (opcional) Matriz (Array) de identificadores de cualquier hoja de estilo que dependa de la hoja de estilo. Las hojas de estilo debe ser cargadas antes. False si no hay ninguna dependencia.
Por defecto: array()

$ver
(string|boolean) (opcional) Cadena para especificar la versión de la hoja de estilo, si hay una.
Este parámetro es utilizado para indicar la versión correcta para enviar a clientes de cara temas de cacheo, y debería incluirse el número de versión disponible en cada momento.
Por defecto: false

$media
(string|boolean) (opcional) Cadena para especificar cual de las hojas de estilos está definida. Ejemplos: ‘all’ (todas), ‘screen’ (pantalla), ‘handheld’, ‘print’ (imprimir). Ver la lista para conocer todos los tipos de media CSS válidos.
Por defecto: ‘all’

Valores que devuelve

(void)
Esta función no devuelve ningún valor.

Ejemplos de uso de wp_enqueue_style()

Leyendo hojas de estilos de un tema de WordPress.

function theme_styles()
{
  // Registro el estilo que te gusta para el tema:
  // (Primero con un nombre único para el
  // estilo (custom-style) después el src,
  // dependencias y número versión y tipo de media)
  wp_register_style( 'custom-style',
    get_template_directory_uri() . '/css/custom-style.css',
    array(),
    '20120208',
    'all' );

  // enqueing:
  wp_enqueue_style( 'custom-style' );
}
add_action('wp_print_styles', 'theme_styles');

Más información en codex.wordpress.

Si te gustó esta función compartela en redes sociales con nosotros, también puedes comprar algunos libros interesantes sobre WordPress como son:

fuente: The Daily WordPress Reference

Artículo relacionadosMás del autor