WordPress : Tirets dans functions.php

WordPress 5.0.3

Je lis mon premier livre sur WordPress.

Je suis en train de créer un thème enfant d’un thème Twenty Seventeen existant.

Dans le livre, il est dit pour moi de créer functions.php et de coller ceci :

add_action( 'wp_enqueue_scripts', 'wpquickstart_enqueue_styles' );
function wpquickstart_enqueue_styles() {
    wp_enqueue_style( 'twenty-seventeen-style', get_template_directory_uri() . '/style.css' );
    wp_enqueue_style( 'wpquickstart-style',    get_stylesheet_directory_uri() . '/style.css',
        array('twenty-seventeen-style')    );
}

Eh bien, être encadré fonctionne, ce qui m’est étrange. Ce qui me dérange, c’est le premier tiret dans le style vingt-sept.

Je veux dire que cela fonctionne aussi (attention au style vingt-sept, aux tirets):

<?php
add_action( 'wp_enqueue_scripts', 'wpquickstart_enqueue_styles' );
function wpquickstart_enqueue_styles() {
    wp_enqueue_style( 'twentyseventeen-style', get_template_directory_uri() . '/style.css' );
    wp_enqueue_style( 'wpquickstart-style',    get_stylesheet_directory_uri() . '/style.css',
        array('twentyseventeen-style')    );
}
?>

Pourriez-vous me dire si les tirets sont ignorés ? Où puis-je lire de la documentation sur ce moment ?

Solution n°1 trouvée

Puisque vous passez un deuxième argument à wp_enqueue_style(), il définit le ha dlecomme cela source. Si vous avez enregistré un handle et une source avec wp_register_style()précédemment, vous n’auriez pas besoin de passer un argument source wp_enqueue_style()tant que vous avez appelé le handle de manière identique.

Sinon, puisque vous définissez le handle et la source en même temps, c’est effectivement arbitraire. Cependant, si jamais vous avez besoin de retirer de la file d’attente, de modifier, d’ajouter des styles en ligne, etc., votre style en file d’attente, vous le ferez en utilisant la poignée que vous avez passée ici (avec ou sans les tirets).

Edit : Pour simplifier un peu :

Lorsque vous écrivez :

wp_enqueue_style( 'twentyseventeen-style', get_template_directory_uri() . '/style.css' );

Vous, Michael, ajoutez une feuille de style nommée twentyseventeen-stylequi se trouve dans /template/style.css.

Vous pouvez le nommer comme vous voulez, et il se chargera toujours. Par exemple, cela fonctionnera aussi :

wp_enqueue_style( 'blahblah-michaels-2k17-style', get_template_directory_uri() . '/style.css' );

Ce premier argument est le nom que VOUS donnez à la feuille de style située à l’emplacement du deuxième argument.