Παρακάμψεις
Το Blockstudio παρέχει τη δυνατότητα παράκαμψης blocks σε πολύ λεπτομερές επίπεδο. Αυτό μπορεί να είναι χρήσιμο για κοινόχρηστες βιβλιοθήκες block, όταν θέλετε να αλλάξετε τη συμπεριφορά ενός block χωρίς να χρειάζεται να δημιουργήσετε ένα νέο από την αρχή.
block.json
Για να ξεκινήσετε, ορίστε το όνομα του block που θέλετε να παρακάμψετε ως κλειδί name και ορίστε το κλειδί override σε true.
{
"name": "blockstudio/my-block",
"title": "My overridden block title",
"blockstudio": {
"override": true
}
}
Όταν η ιδιότητα override έχει οριστεί σε true, τα δεδομένα του νέου block.json συγχωνεύονται με τα δεδομένα του αρχικού block. Αυτό σημαίνει ότι μπορείτε να παρακάμψετε οποιαδήποτε ιδιότητα του αρχικού block.
Χαρακτηριστικά
Τα χαρακτηριστικά μπορούν είτε να παρακαμφθούν μέσω του id είτε να προστεθούν επιπλέον. Για παράδειγμα, ας υποθέσουμε ότι θέλουμε να παρακάμψουμε το χαρακτηριστικό width ενός block και να προσθέσουμε ένα νέο χαρακτηριστικό height.
{
"name": "blockstudio/my-block",
"title": "My overridden block title",
"blockstudio": {
"override": true,
"attributes": [
{
"id": "width",
"type": "number",
"default": 280,
"label": "Override width"
},
{
"id": "height",
"type": "number",
"default": 280,
"label": "New height"
}
]
}
}
Όταν εντοπίζεται χαρακτηριστικό με το ίδιο id, τα δεδομένα συγχωνεύονται με το αρχικό χαρακτηριστικό. Τα χαρακτηριστικά που δεν εντοπίζονται προστίθενται στο block.
Προειδοποίηση
Κατά την παράκαμψη χαρακτηριστικών, πρέπει να παρέχετε το
typeτου αρχικού χαρακτηριστικού, ακόμη κι αν παραμένει το ίδιο.
Σύνθετες δομές
Κατά την παράκαμψη χαρακτηριστικών με σύνθετες δομές (επαναλήπτες, ομάδες, καρτέλες κ.λπ.), πρέπει να παρέχετε ολόκληρη τη δομή του χαρακτηριστικού μέχρι το στοιχείο που θέλετε να παρακάμψετε.
{
"name": "blockstudio/my-block",
"blockstudio": {
"override": true,
"attributes": [
{
"id": "tabs",
"type": "tabs",
"tabs": [
{
"id": "tab1",
"attributes": [
{
"key": "group1",
"type": "group",
"title": "Group",
"attributes": [
{
"id": "text",
"type": "text",
"label": "Override text"
}
]
}
]
},
{
"id": "tab2",
"title": "Override tab",
"attributes": [
{
"id": "group",
"type": "group",
"title": "Group ID",
"attributes": [
{
"id": "text",
"type": "text",
"label": "Override text"
}
]
}
]
}
]
}
]
}
}
Πόροι
Τα αρχεία πόρων αντικαθίστανται όταν τα ονόματα αρχείων ταιριάζουν. Για παράδειγμα, αν υπάρχει αρχείο style.css στο αρχικό block, θα αντικατασταθεί από το αρχείο style.css στο block παράκαμψης. Τα αρχεία με ονόματα που δεν αντιστοιχούν σε εκείνα του αρχικού block θα προστεθούν στο block.
Πρότυπο απόδοσης
Τα πρότυπα απόδοσης μπορούν να παρακαμφθούν παρέχοντας ένα νέο αρχείο προτύπου, είτε index.php, index.twig είτε index.blade.php.
Blocks Twig
Τα πρότυπα Twig μπορούν να παρακαμφθούν σε πιο λεπτομερές επίπεδο χρησιμοποιώντας τη λειτουργία block στο Twig.
Ας υποθέσουμε ότι έχουμε το εξής πρότυπο απόδοσης για ένα φανταστικό block εικόνας:
<h1>Images:</h1>
{% for image in a.images %}
<div class="content">
{% block image %}
<img src="{{ image.url }}" class="image" />
{% endblock %}
</div>
{% endfor %}
Αντί να αντικαταστήσουμε ολόκληρο το πρότυπο, μπορούμε να χρησιμοποιήσουμε τη λειτουργία extends του Twig για να παρακάμψουμε ορισμένα μέρη του προτύπου, διατηρώντας τα υπόλοιπα ανέπαφα.
{% extends 'index.twig' %}
{% block image %}
<figure>
<img src="{{ image.url }}" class="image" />
<figcaption>{{ image.caption }}</figcaption>
</figure>
{% endblock %}