Dentro da WP_Dependencies
classe existe um método chamado add_data
. Esta função adiciona dados a scripts / estilos que foram enfileirados durante o carregamento do WordPress. Um uso comumente citado para essa função é adicionar uma condicional ao adicionar folhas de estilo direcionadas a diferentes versões do IE. Por exemplo, para segmentar o IE8 e inferior:
function test_wp_print_styles() {
global $wp_styles;
wp_enqueue_style( 'test-style', get_template_directory_uri() . '/css/test.css', array(), 1, 'all' );
$wp_styles->add_data( 'test-style', 'conditional', 'lte ie8' );
}
add_action( 'wp_print_styles', 'test_wp_print_styles' );
Isso será renderizado como:
<!--[if lte ie8]>
<link rel='stylesheet' id='test-style-css' href='http://trunkosaurus.dev/wp-content/themes/twentyeleven/css/test.css?ver=1' type='text/css' media='all' />
<![endif]-->
Quando olho pelo Core, vejo vários lugares em que esse método é usado:
WP_Styles->add_inline_style()
: adiciona estilo embutido após a folha de estilo referenciada (feita viaWP_Styles->print_inline_style()
)WP_Scripts->localize()
: adiciona um objeto codificado json (envolvido pela função mais "pública"wp_localize_script()
)wp_plupload_default_settings()
: adiciona objeto codificado json (criado a partir de uma matriz multidimensional) para o script 'wp-plupload' (observe que isso está disponível na 3.4)Ao registrar / enfileirar scripts e estilos Adicionando dados para scripts padrão (
wp-includes/script-loader.php
)
Ao ler os usos do método, ele não parece ter um caso de uso específico. Em wp_plupload_default_settings
, parece permitir a injeção arbitrária de dados. Em wp_register_script
, parece ser usado para diferenciar entre scripts de cabeçalho e rodapé. Em add_inline_style
, é usado para indicar o estilo embutido que deve ser adicionado após uma folha de estilo especificada ser enfileirada.
Um excelente uso para essa função seria algo como o código a seguir, onde você está enfileirando um script externo, mas precisa enviar alguns vars de configuração, alguns dos quais vêm do banco de dados:
function zdt_enqueue_add_this() {
global $wp_scripts;
wp_enqueue_script( 'zdt-add-this', 'http://s7.addthis.com/js/250/addthis_widget.js#pubid=myidhere' );
// Contrived example of database call to get a twitter handle stored in the db
$author_twitter_handle = zdt_get_twitter_handle();
$js = "var addthis_share = { templates : { twitter: '{{title}} {{url}} (by @" . sanitize_key( $author_twitter_handle ) . "' } };\n";
$js .= 'var addthis_config = { ui_header_color: "#FFFFFF", ui_header_background: "#FA9628", ui_cobrand: "My Site" };';
$wp_scripts->add_data( 'zdt-add-this', 'data', $js );
}
add_action( 'wp_enqueue_scripts', 'zdt_enqueue_add_this' );
Isso resultará em:
<script type='text/javascript'>
/* <![CDATA[ */
var addthis_share = { templates : { twitter: '{{title}} {{url}} (by @tollmanz' } };
var addthis_config = { ui_header_color: "#FFFFFF", ui_header_background: "#FA9628", ui_cobrand: "My Site" };
/* ]]> */
</script>
<script type='text/javascript' src='http://s7.addthis.com/js/250/addthis_widget.js?ver=3.4-beta4-20731#pubid=myidhere'></script>
Observe que isso não pode ser conseguido wp_localize_script
porque o addthis_share
objeto possui propriedades dentro de propriedades ( eu escrevi sobre uma maneira um tanto hacky de contornar isso antes ).
Edição: Eu estava errado em afirmar isso. wp_localize_script
lida com matrizes multidimensionais muito bem.
Este método parece funcionar muito bem pelos seguintes motivos:
- Ele permite anexar os dados ao identificador de script, para que eles sejam sempre enfileirados corretamente com o script. Além disso, será inteligente quanto à remoção da fila do script, ordem do script e posicionamento do script.
- Ele permite que você use o PHP para enviar vars para JS.
- Parece mais organizado do que usar
wp_print_styles
para imprimir algum script arbitrário que é posteriormente atuado por um script enfileirado.
Há algumas coisas que não funcionam como o esperado que me preocupam com esse método. Um desses problemas é que, se você usar wp_localize_script
junto $wp_scripts->add_data
, poderá obter resultados inesperados. Por exemplo:
// Contrived example of database call to get a twitter handle stored in the db
$author_twitter_handle = zdt_get_twitter_handle();
$js = "var addthis_share = { templates : { twitter: '{{title}} {{url}} (by @" . sanitize_key( $author_twitter_handle ) . "' } };\n";
$js .= 'var addthis_config = { ui_header_color: "#FFFFFF", ui_header_background: "#FA9628", ui_cobrand: "My Site" };';
$wp_scripts->add_data( 'zdt-add-this', 'data', $js );
wp_localize_script( 'zdt-add-this', 'addthis_share', array( 'var' => 'val' ) );
Produz:
<script type='text/javascript'>
/* <![CDATA[ */
var addthis_share = { templates : { twitter: '{{title}} {{url}} (by @tollmanz' } };
var addthis_config = { ui_header_color: "#FFFFFF", ui_header_background: "#FA9628", ui_cobrand: "My Site" };
var addthis_share = {"var":"val"};
/* ]]> */
</script>
<script type='text/javascript' src='http://s7.addthis.com/js/250/addthis_widget.js?ver=3.4-beta4-20731#pubid=myidhere'></script>
Considerando que este script:
// Contrived example of database call to get a twitter handle stored in the db
$author_twitter_handle = zdt_get_twitter_handle();
$js = "var addthis_share = { templates : { twitter: '{{title}} {{url}} (by @" . sanitize_key( $author_twitter_handle ) . "' } };\n";
$js .= 'var addthis_config = { ui_header_color: "#FFFFFF", ui_header_background: "#FA9628", ui_cobrand: "My Site" };';
wp_localize_script( 'zdt-add-this', 'addthis_share', array( 'var' => 'val' ) );
$wp_scripts->add_data( 'zdt-add-this', 'data', $js );
Produz:
<script type='text/javascript'>
/* <![CDATA[ */
var addthis_share = { templates : { twitter: '{{title}} {{url}} (by @tollmanz' } };
var addthis_config = { ui_header_color: "#FFFFFF", ui_header_background: "#FA9628", ui_cobrand: "My Site" };
/* ]]> */
</script>
<script type='text/javascript' src='http://s7.addthis.com/js/250/addthis_widget.js?ver=3.4-beta4-20731#pubid=myidhere'></script>
A data
chave definida por wp_localize_script
é substituída pela chamada para $wp_scripts->add_data
, enquanto que se você chamar wp_localize_script
duas vezes para o mesmo script, a sequência será concatenada corretamente.
Embora tudo isso seja uma maneira realmente útil de imprimir um script arbitrário para uso com um script enfileirado, me faz pensar que ele não deve ser amplamente utilizado devido ao potencial de conflitos. Certamente vejo um argumento para usá-lo em projetos pessoais em que o código não será usado em plugins / temas da comunidade.
Também olhei para o Core Trac para ver se havia alguma pista sobre o objetivo da função. Encontrei um ticket (http://core.trac.wordpress.org/ticket/11520) (um épico) que explorava outras maneiras de adicionar JS arbitrário. Portanto, parece que há interesse em criar uma maneira melhor de adicionar JS arbitrário, mas não tenho certeza exatamente se add_data
deve fazer parte do processo.
Minha principal pergunta é: os desenvolvedores devem usar esta função? Em alguns casos (por exemplo, wp_register_script
), parece uma função "privada" que terceiros não devem usar; no entanto, em outros casos (por exemplo, wp_plupload_default_settings
), parece uma maneira perfeitamente razoável de injetar JS arbitrário antes de um script enfileirado.
Não imagino que haja uma resposta "correta" para isso, mas gostaria de ouvir o que os outros desenvolvedores pensam. Também imagino que há peças neste quebra-cabeça que negligenciei completamente e gostaria de ouvir o que os outros têm a dizer sobre isso.
fonte
JSON2
, mas também precisa ser carregada antesjQuery
: Vamos dar um nomeUberjQuery
. Btw: Como você está se saindo muito bem com a escavação do núcleo, por que você não tira um tempo e escreve uma resposta? Eu acho que valeria a pena ler.Houve um grande debate no WP 3.3 sobre como lidar com dados de script:
http://core.trac.wordpress.org/ticket/11520
Observe que você pode passar matrizes aninhadas para
wp_localize_data()
agora:Portanto, eu usaria
add_data()
se não houvesse API de nível superior para o que eu precisava fazer, com o entendimento de que seu comportamento pode mudar em alguns casos extremos, como quando há concatenação.fonte