Atributos para bloques

FAQ

¿Cómo agrego un atributo?

In your selected block’s inspector controls (Block settings) scroll all the way to the bottom and click on «Advanced». It should contain a section called «Additional attributes».
Type an attribute name into the «Add attribute» field and press «Add» to add an attribute for the block. A new input with the attribute’s name should appear below, into which you can optionally insert the attribute value.
Example attributes: style, title, target, class, id, onclick, data-*, aria-*.

Why is the input disabled?

When the current user doesn’t have unfiltered_html capabilities attributes cannot be added and all existing attributes are stripped when the post is updated.

¿Cómo funciona?

Para los bloques regulares, los atributos se agregan al elemento raíz del contenido guardado del bloque, lo que significa que se representarán solo en la interfaz y no en el editor. Para los bloques dinámicos, los atributos se agregan a través de la función render_callback y también se pueden aplicar en el editor, dependiendo de si el bloque se renderiza del lado del servidor o del cliente.

¿Funciona para todos los bloques?

Debería funcionar con bloques normales que renderizan un elemento WP válido que pueda utilizar el filtro blocks.getSaveContent.extraProps, así como bloques dinámicos que utilicen un render_callback. Es posible que los bloques de terceros que hacen algo poco ortodoxo no funcionen.
Bloques no admitidos conocidos

Usage with Alpine.js

@ prefix in an attribute name is used for «override» mode in this plugin, for Alpine.js attributes use x-on:click instead of @click or use the shorthand syntax with two @ characters instead of one: @@click.

Disable block support

El filtro afb_unsupported_blocks se puede usar en el archivo functions.php de su tema hijo (Child theme) para deshabilitar el soporte de bloques para agregar atributos adicionales.

add_filter('afb_unsupported_blocks', function($blocks) {
    $blocks[] = 'core/button';
    return $blocks;
});

¿Qué pasa cuando desactivo el plugin?

Blocks with custom attributes may become invalid, depending on which attributes you’ve added. From there you can recover the block without the custom attributes by clicking «Attempt Block Recovery» or keep the block with custom attributes as HTML by choosing «Convert to HTML». If you don’t want to risk blocks becoming invalid you need to remove all custom attributes before disabling the plugin.

How do I add unfiltered_html capability to user roles?

You can modify which roles have the unfiltered_html capability using custom code in your theme’s functions.php file or via a custom plugin. Only grant this capability if you trust the current and future users of that role to not do anything malicious.

add_action('init', function() {
    if($role = get_role('contributor')) {
        $role->add_cap('unfiltered_html');
    }
});