Attributes for Blocks

FAQ

Wie füge ich ein Attribut hinzu?

Scrolle in den Inspektor-Steuerelementen deines ausgewählten Blocks (Block-Einstellungen) ganz nach unten und klicke auf „Erweitert“. Dort sollte ein Abschnitt namens „Zusätzliche Attribute“ zu finden sein.
Gib einen Attributnamen in das Feld „Attribut hinzufügen” ein und klicke auf „Hinzufügen”, um ein Attribut für den Block hinzuzufügen. Darunter sollte ein neues Eingabefeld mit dem Namen des Attributs erscheinen, in das du optional den Attributwert eingeben kannst.
Beispielattribute: style, title, target, class, id, onclick, data-*, aria-*.

Wieso ist die Eingabe deaktiviert?

Wenn der aktuelle Benutzer nicht über die Berechtigung unfiltered_html verfügt, können keine Attribute hinzugefügt werden, und alle vorhandenen Attribute werden bei der Aktualisierung des Beitrags entfernt.

Wie funktioniert es?

Bei regulären Blöcken werden Attribute zum Stammelement des gespeicherten Blockinhalts hinzugefügt, was bedeutet, dass sie nur im Frontend und nicht im Editor dargestellt werden. Bei dynamischen Blöcken werden die Attribute über die Funktion render_callback hinzugefügt und können auch im Editor angewendet werden, je nachdem, ob der Block serverseitig oder clientseitig gerendert wird.

Funktioniert das bei jedem Block?

Es sollte mit normalen Blöcken funktionieren, die ein gültiges WP-Element darstellen, das den Filter blocks.getSaveContent.extraProps verwenden kann, sowie mit dynamischen Blöcken, die einen render_callback verwenden. Blöcke von Drittanbietern, die etwas Unorthodoxes tun, funktionieren möglicherweise nicht.
Bekannte nicht unterstützte Blöcke

Verwendung mit Alpine.js

Das Präfix @ in einem Attributnamen wird im Modus „Überschreiben” dieses Plugins verwendet. Für Alpine.js-Attribute verwendest du x-on:click anstelle von @click oder verwende die Kurzschreibweise mit zwei @-Zeichen anstelle von einem: @@click.

Blockunterstützung deaktivieren

Der Filter afb_unsupported_blocks kann in der Datei functions.php deines untergeordneten Themes verwendet werden, um die Blockunterstützung für das Hinzufügen zusätzlicher Attribute zu deaktivieren.

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

Was passiert, wenn ich dieses Plugin deaktiviere?

Blöcke mit individuellen Attributen können ungültig werden, je nachdem, welche Attribute du hinzugefügt hast. Von dort aus kannst du den Block ohne die individuellen Attribute wiederherstellen, indem du auf „Blockwiederherstellung versuchen“ klickst, oder den Block mit den individuellen Attributen als HTML behalten, indem du „In HTML umwandeln“ auswählst. Wenn du nicht riskieren möchtest, dass Blöcke ungültig werden, musst du alle individuellen Attribute entfernen, bevor du das Plugin deaktivierst.

Wie füge ich Benutzerrollen die Berechtigung „unfiltered_html“ hinzu?

Du kannst festlegen, welche Rollen über die Berechtigung unfiltered_html verfügen, indem du individuellen Code in der Datei functions.php deines Themes oder über ein individuelles Plugin verwendest. Gewähre diese Berechtigung nur, wenn du darauf vertraust, dass die aktuellen und zukünftigen Benutzer dieser Rolle keine böswilligen Handlungen vornehmen.

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