Τύποι πεδίων
Το Blockstudio παρέχει διάφορους τύπους πεδίων για τη δημιουργία διεπαφών μπλοκ.
Τα έργα μπορούν επίσης να καταχωρίσουν δικούς τους τύπους πεδίων με χώρο ονομάτων μέσω του
blockstudio/field_types. Χρησιμοποιήστε το
όταν χρειάζεστε ένα νέο στοιχείο ελέγχου επεξεργαστή ή μια δομημένη μορφή τιμής. Χρησιμοποιήστε
custom/{name} πεδία όταν χρειάζεται μόνο
να επαναχρησιμοποιήσετε μια ομάδα υπαρχόντων πεδίων.
Βιβλίο συνταγών για μοτίβα πεδίων
Πρακτικές συνταγές: ομάδες υπό συνθήκη, έξυπνες λίστες επιλογών, επαναλήπτες και αποθηκευτικός χώρος με δυνατότητα αναζήτησης.
Γενικές ιδιότητες
Ο παρακάτω πίνακας παραθέτει κοινές ιδιότητες και συνήθεις επιλογές τιμών. Τα default και
fallback υποστηρίζονται όπου αναφέρονται στον πίνακα ιδιοτήτων κάθε τύπου πεδίου.
| Ιδιότητα | Τύπος | Περιγραφή |
|---|---|---|
id |
string | Μοναδικό αναγνωριστικό για το γνώρισμα |
type |
string | Ο τύπος πεδίου |
label |
string | Ετικέτα εμφάνισης που προβάλλεται στον επεξεργαστή |
description |
string | Κείμενο περιγραφής που εμφανίζεται κάτω από το πεδίο |
default |
mixed | Προεπιλεγμένη τιμή για το πεδίο |
fallback |
mixed | Εναλλακτική τιμή όταν το πεδίο είναι κενό |
help |
string | Κείμενο βοήθειας που εμφανίζεται ως συμβουλή δίπλα στην ετικέτα |
hidden |
boolean | Απόκρυψη του πεδίου από το UI |
switch |
boolean | Εμφάνιση διακόπτη που μπορεί να απενεργοποιήσει το πεδίο. Η προεπιλογή είναι false. |
translate |
boolean | Ορίστε το false για να παραλείψετε το πεδίο από τη διαμόρφωση WPML |
conditions |
array | Κανόνες λογικής υπό συνθήκες |
Τα πεδία αρχείων με "returnFormat": "id" διατηρούν τις εισαγόμενες αναφορές συμβολοσειρών,
συμπεριλαμβανομένων μεμονωμένων τιμών μέσα σε επαναλήπτες. Τα ονόματα που δεν επιλύονται εμφανίζουν κάρτες εφεδρείας
χωρίς μικρογραφίες· το Blockstudio δεν τα αντιστοιχίζει σε ID συνημμένων. Δείτε
φορητές αναφορές πολυμέσων για λεπτομέρειες.
Δείτε την Φόρτωση εικονιδίων για αιτήματα επιλογέα, επαναλήψεις και υποσύνολα εικονιδίων.
χαρακτηριστικά
Αποδίδει πεδία εισαγωγής χαρακτηριστικών δεδομένων.
{
"type": "attributes"
}
Ιδιότητες
| Ιδιότητα | Τύπος | Περιγραφή |
|---|---|---|
default |
array |
Προεπιλεγμένη τιμή που εφαρμόζεται κατά την πρώτη προσθήκη του block. |
fallback |
array |
Εφεδρική τιμή που εμφανίζεται όταν η τιμή του πεδίου είναι κενή. |
link |
boolean |
Επιτρέπει την επιλογή συνδέσμου από αναπτυσσόμενη λίστα. |
media |
boolean |
Επιτρέπει την επιλογή πολυμέσων από αναπτυσσόμενη λίστα. |
μπλοκ
Αναφέρεται σε ένα άλλο block Blockstudio και εμφανίζει τα πεδία του ενσωματωμένα. Στα πρότυπα, η τιμή επιστρέφει την απόδοση του block.
{
"type": "block"
}
Ιδιότητες
| Ιδιότητα | Τύπος | Περιγραφή |
|---|---|---|
block |
string |
Το όνομα του block στο οποίο γίνεται αναφορά (π.χ. e.g, «mytheme/card»). |
returnFormat |
string |
Πώς θα επιστρέφεται η τιμή στα πρότυπα. |
πλαίσιο επιλογής
Εμφανίζει ένα σύνολο πλαισίων επιλογής.
{
"type": "checkbox",
"options": [
{
"value": "option1",
"label": "Option 1"
},
{
"value": "option2",
"label": "Option 2"
}
]
}
Ιδιότητες
| Ιδιότητα | Τύπος | Περιγραφή |
|---|---|---|
default |
array | string | number |
Προεπιλεγμένη τιμή που εφαρμόζεται κατά την πρώτη προσθήκη του block. |
fallback |
array | string | number |
Εναλλακτική τιμή που εμφανίζεται όταν η τιμή του πεδίου είναι κενή. |
options |
array |
Επιλογές από τις οποίες μπορείτε να διαλέξετε. |
returnFormat |
string |
Καθορίζει τη μορφή επιστρεφόμενης τιμής. |
populate |
object |
|
toggle |
boolean | string |
Προσθέτει ένα πλαίσιο επιλογής πάνω από τις επιλογές, το οποίο τις επιλέγει όλες ή τις αποεπιλέγει. Μια συμβολοσειρά χρησιμοποιείται ως ετικέτα του, ενώ η τιμή true χρησιμοποιεί την προεπιλεγμένη ετικέτα. |
κλάσεις
Εμφανίζει ένα πεδίο για την επιλογή κλάσεων CSS.
{
"type": "classes"
}
Ιδιότητες
| Ιδιότητα | Τύπος | Περιγραφή |
|---|---|---|
default |
string |
Προεπιλεγμένη τιμή που εφαρμόζεται κατά την πρώτη προσθήκη του block. |
fallback |
string |
Εφεδρική τιμή που εμφανίζεται όταν η τιμή του πεδίου είναι κενή. |
tailwind |
boolean |
Αν θα ενεργοποιηθούν οι κλάσεις Tailwind για αυτό το πεδίο εισαγωγής. |
κώδικας
Εμφανίζει έναν επεξεργαστή κώδικα.
{
"type": "code"
}
Ιδιότητες
| Ιδιότητα | Τύπος | Περιγραφή |
|---|---|---|
default |
string |
Προεπιλεγμένη τιμή που εφαρμόζεται κατά την πρώτη προσθήκη του μπλοκ. |
fallback |
string |
Εφεδρική τιμή που εμφανίζεται όταν η τιμή του πεδίου είναι κενή. |
autoCompletion |
boolean |
Αν θα ενεργοποιηθεί η αυτόματη συμπλήρωση. |
foldGutter |
boolean |
Αν θα εμφανίζεται το περιθώριο σύμπτυξης. |
height |
string |
Το ύψος του επεξεργαστή. |
language |
string |
Η γλώσσα που θα χρησιμοποιηθεί για την επισήμανση σύνταξης. |
lineNumbers |
boolean |
Αν θα εμφανίζονται αριθμοί γραμμών. |
maxHeight |
string |
Το μέγιστο ύψος του επεξεργαστή. |
minHeight |
string |
Το ελάχιστο ύψος του επεξεργαστή. |
popout |
boolean |
Αν θα εμφανίζεται κουμπί που ανοίγει τον επεξεργαστή σε αναδυόμενο παράθυρο. |
asset |
boolean |
Αποδίδει το CSS, το SCSS ή το JavaScript από το πεδίο ως στοιχείο του μπλοκ, ώστε το πρότυπο να μην χρειάζεται να εκτυπώνει την ετικέτα style ή script. |
χρώμα
Εμφανίζει μια παλέτα χρωμάτων και έναν επιλογέα χρωμάτων.
{
"type": "color",
"options": [
{
"value": "option1",
"label": "Option 1"
},
{
"value": "option2",
"label": "Option 2"
}
]
}
Ιδιότητες
| Ιδιότητα | Τύπος | Περιγραφή |
|---|---|---|
default |
string |
Τιμή της επιλογής που θα είναι επιλεγμένη κατά την πρώτη προσθήκη του μπλοκ. |
fallback |
string |
Τιμή της επιλογής που εμφανίζεται όταν η τιμή του πεδίου είναι κενή. |
options |
array |
|
populate |
object |
|
clearable |
boolean |
Αν η παλέτα θα διαθέτει κουμπί εκκαθάρισης. |
disableCustomColors |
boolean |
Αν θα επιτρέπεται προσαρμοσμένο χρώμα. |
ημερομηνία
Εμφανίζει έναν επιλογέα ημερομηνίας.
{
"type": "date"
}
Ιδιότητες
| Ιδιότητα | Τύπος | Περιγραφή |
|---|---|---|
default |
string |
Προεπιλεγμένη τιμή που εφαρμόζεται κατά την πρώτη προσθήκη του block. |
fallback |
string |
Εφεδρική τιμή που εμφανίζεται όταν η τιμή του πεδίου είναι κενή. |
startOfWeek |
number |
Η ημέρα έναρξης της εβδομάδας. 0 για Κυριακή, 1 για Δευτέρα κ.ο.κ. |
ημερομηνία και ώρα
Εμφανίζει έναν επιλογέα ημερομηνίας και ώρας.
{
"type": "datetime"
}
Ιδιότητες
| Ιδιότητα | Τύπος | Περιγραφή |
|---|---|---|
default |
string |
Προεπιλεγμένη τιμή που εφαρμόζεται κατά την πρώτη προσθήκη του block. |
fallback |
string |
Εφεδρική τιμή που εμφανίζεται όταν η τιμή του πεδίου είναι κενή. |
is12Hour |
boolean |
Αν χρησιμοποιείται ρολόι 12 ωρών. Με ρολόι 12 ωρών εμφανίζεται ένα στοιχείο AM/PM και θεωρείται ότι η μορφή ώρας είναι MM-DD-YYYY (αντί της προεπιλεγμένης μορφής DD-MM-YYYY). |
αρχεία
Εμφανίζει ένα κουμπί για τη βιβλιοθήκη πολυμέσων. Τα επιλεγμένα στοιχεία μπορούν να αναδιαταχθούν απευθείας.
{
"type": "files",
"min": 0,
"max": 100,
"multiple": false
}
Ιδιότητες
| Ιδιότητα | Τύπος | Περιγραφή |
|---|---|---|
default |
array | object | number |
Προεπιλεγμένη τιμή που εφαρμόζεται κατά την πρώτη προσθήκη του block. |
fallback |
array | object | number |
Εφεδρική τιμή που εμφανίζεται όταν η τιμή του πεδίου είναι κενή. |
addToGallery |
boolean |
Αν είναι true, το παράθυρο πολυμέσων της συλλογής ανοίγει απευθείας στη βιβλιοθήκη πολυμέσων, όπου ο χρήστης μπορεί να προσθέσει επιπλέον εικόνες. Αν είναι false, ανοίγει σε λειτουργία επεξεργασίας, όπου ο χρήστης μπορεί να επεξεργαστεί υπάρχουσες εικόνες αναδιατάσσοντάς τες, αφαιρώντας τες ή αλλάζοντας τα χαρακτηριστικά τους. Ισχύει μόνο αν το gallery === true. |
allowedTypes |
array | string |
Πίνακας με τους τύπους πολυμέσων που μπορούν να μεταφορτωθούν ή να επιλεγούν από τη βιβλιοθήκη πολυμέσων. Κάθε τύπος είναι μια συμβολοσειρά που μπορεί να περιέχει τον γενικό τύπο MIME e.g: ‘image’, ‘audio’, ‘text’ ή τον πλήρη τύπο MIME e.g: ‘audio/mpeg’, ‘image/gif’. Αν δεν έχει οριστεί το allowedTypes, επιτρέπονται όλοι οι τύποι MIME. |
gallery |
boolean |
Αν είναι true, το στοιχείο θα αρχικοποιήσει όλες τις καταστάσεις που απαιτούνται για την αναπαράσταση μιας συλλογής. Από προεπιλογή, το παράθυρο πολυμέσων ανοίγει στο πλαίσιο επεξεργασίας συλλογής, αλλά αυτό μπορεί να αλλάξει με τη σημαία addToGalleryflag. |
max |
number |
Μέγιστος αριθμός αρχείων που μπορούν να προστεθούν. |
min |
number |
Ελάχιστος αριθμός αρχείων που μπορούν να προστεθούν. |
multiple |
boolean |
Αν επιτρέπονται πολλαπλές επιλογές. |
size |
boolean |
Προσθέτει στο πεδίο μια αναπτυσσόμενη λίστα μεγέθους πολυμέσων. |
textMediaButton |
string |
Κείμενο κουμπιού πολυμέσων. |
title |
string |
Τίτλος που εμφανίζεται στο παράθυρο πολυμέσων. |
returnFormat |
string |
Καθορίζει τη μορφή επιστροφής της τιμής. |
returnSize |
string |
Το μέγεθος πολυμέσων που θα επιστρέφεται όταν χρησιμοποιείται η μορφή επιστροφής URL. |
διαβάθμιση χρωμάτων
Εμφανίζει μια παλέτα διαβαθμίσεων και έναν επιλογέα διαβάθμισης.
{
"type": "gradient",
"options": [
{
"value": "option1",
"label": "Option 1"
},
{
"value": "option2",
"label": "Option 2"
}
]
}
Ιδιότητες
| Ιδιότητα | Τύπος | Περιγραφή |
|---|---|---|
default |
string |
Τιμή της επιλογής που θα είναι επιλεγμένη κατά την πρώτη προσθήκη του μπλοκ. |
fallback |
string |
Τιμή της επιλογής που εμφανίζεται όταν η τιμή του πεδίου είναι κενή. |
options |
array |
|
populate |
object |
|
clearable |
boolean |
Αν η παλέτα θα διαθέτει κουμπί εκκαθάρισης. |
disableCustomGradients |
boolean |
Αν θα επιτρέπεται προσαρμοσμένο χρώμα. |
ομάδα
Εμφανίζει πολλά πεδία σε ένα (προαιρετικά) συμπτυσσόμενο πλαίσιο.
{
"type": "group"
}
Ιδιότητες
| Ιδιότητα | Τύπος | Περιγραφή |
|---|---|---|
title |
string |
Κείμενο τίτλου. Εμφανίζεται ακόμη κι όταν το στοιχείο είναι κλειστό. |
opened |
boolean |
Όταν οριστεί σε true, το στοιχείο θα παραμένει ανοιχτό ανεξάρτητα από την ιδιότητα initialOpen και την |
initialOpen |
boolean |
Αν το πλαίσιο θα είναι αρχικά ανοιχτό. |
scrollAfterOpen |
boolean |
Κάνει κύλιση του περιεχομένου ώστε να εμφανιστεί στην οθόνη όταν είναι ορατό. |
class |
string |
Προσαρμοσμένη κλάση CSS που θα εφαρμοστεί στην ομάδα. |
style |
object |
Προσαρμοσμένα στυλ CSS που θα εφαρμοστούν στην ομάδα. |
attributes |
array |
Δέχεται όλους τους άλλους τύπους πεδίων εκτός από άλλο πεδίο tabs. |
ετικέτα HTML
Εμφανίζει έναν επιλογέα ετικέτας HTML. Χρήσιμος για την επιλογή επιπέδων επικεφαλίδων ή σημασιολογικών στοιχείων.
{
"type": "html-tag"
}
Ιδιότητες
| Ιδιότητα | Τύπος | Περιγραφή |
|---|---|---|
default |
string |
Προεπιλεγμένη τιμή που εφαρμόζεται κατά την πρώτη προσθήκη του block. |
fallback |
string |
Εφεδρική τιμή που εμφανίζεται όταν η τιμή του πεδίου είναι κενή. |
tags |
string | array |
Ποιες ετικέτες θα συμπεριληφθούν. Χρησιμοποιήστε μια προκαθορισμένη συμβολοσειρά ή έναν πίνακα ονομάτων ετικετών. |
exclude |
array |
Ετικέτες που θα εξαιρεθούν από την προκαθορισμένη επιλογή. Ισχύει μόνο όταν χρησιμοποιείται προκαθορισμένη συμβολοσειρά για τις ετικέτες. |
εικονίδιο
Εμφανίζει ένα εικονίδιο SVG από ένα σύνολο εικονιδίων.
{
"type": "icon"
}
Ιδιότητες
| Ιδιότητα | Τύπος | Περιγραφή |
|---|---|---|
default |
object |
Προεπιλεγμένη τιμή που εφαρμόζεται κατά την πρώτη προσθήκη του block. |
fallback |
object |
Εφεδρική τιμή που εμφανίζεται όταν η τιμή του πεδίου είναι κενή. |
sets |
array | string |
Ποιο σύνολο εικονιδίων θα συμπεριληφθεί. Αφήστε το κενό για να συμπεριληφθούν όλα. |
subSets |
array | string |
Ποιο υποσύνολο εικονιδίων θα συμπεριληφθεί. Αφήστε το κενό για να συμπεριληφθούν όλα. |
returnFormat |
string |
Η μορφή στην οποία θα επιστρέφεται το εικονίδιο. |
σύνδεσμος
Εμφανίζει ένα στοιχείο ελέγχου συνδέσμου για την επιλογή εσωτερικών ή εξωτερικών συνδέσμων.
{
"type": "link"
}
Ιδιότητες
| Ιδιότητα | Τύπος | Περιγραφή |
|---|---|---|
default |
object |
Προεπιλεγμένη τιμή που εφαρμόζεται κατά την πρώτη προσθήκη του block. |
fallback |
object |
Εφεδρική τιμή που εμφανίζεται όταν η τιμή του πεδίου είναι κενή. |
hasRichPreviews |
boolean |
Αν θα εμφανίζονται εμπλουτισμένες προεπισκοπήσεις κατά την προσθήκη ενός URL. |
noDirectEntry |
boolean |
Αν επιτρέπεται η απευθείας μετατροπή ενός ερωτήματος αναζήτησης τύπου URL σε σύνδεσμο. |
noURLSuggestion |
boolean |
Αν θα προστεθεί μια εφεδρική πρόταση που αντιμετωπίζει το ερώτημα αναζήτησης ως URL. |
opensInNewTab |
boolean |
Προσθέτει ένα στοιχείο εναλλαγής στο παράθυρο συνδέσμων. |
showSuggestions |
boolean |
Αν θα εμφανίζονται προτάσεις κατά την πληκτρολόγηση του URL. |
textButton |
string |
Προσαρμοσμένο κείμενο που θα εμφανίζεται μέσα στο κουμπί συνδέσμου. |
withCreateSuggestion |
boolean |
Αν οι αναζητήσεις συνδέσμων χωρίς αντιστοιχία μπορούν να δημιουργούν πρόταση για νέα σελίδα πρόχειρου. |
μήνυμα
Εμφανίζει ένα μήνυμα με προσαρμοσμένο περιεχόμενο.
{
"type": "message"
}
Ιδιότητες
| Ιδιότητα | Τύπος | Περιγραφή |
|---|---|---|
default |
string |
Προεπιλεγμένη τιμή που εφαρμόζεται κατά την πρώτη προσθήκη του block. |
fallback |
string |
Εφεδρική τιμή που εμφανίζεται όταν η τιμή του πεδίου είναι κενή. |
value |
string |
Το μήνυμα προς εμφάνιση. Τα δεδομένα του block και των γνωρισμάτων είναι διαθέσιμα σε σύνταξη αγκυλών, e.g.: {block.title} ή {attributes.text} |
αριθμός
Εμφανίζει ένα πεδίο εισαγωγής αριθμού.
{
"type": "number",
"min": 0,
"max": 100,
"step": 1
}
Ιδιότητες
| Ιδιότητα | Τύπος | Περιγραφή |
|---|---|---|
default |
number |
Προεπιλεγμένη τιμή που εφαρμόζεται κατά την πρώτη προσθήκη του block. |
fallback |
number |
Εφεδρική τιμή που εμφανίζεται όταν η τιμή του πεδίου είναι κενή. |
dragDirection |
string |
Καθορίζει τον άξονα σύρσης για την αύξηση ή τη μείωση της τιμής. |
dragThreshold |
number |
Αν το isDragEnabled είναι true, καθορίζει πόσα px πρέπει να συρθεί το στοιχείο πριν αλλάξει η τιμή. |
hideHTMLArrows |
boolean |
Αν είναι true, τα προεπιλεγμένα βέλη HTML του πεδίου εισαγωγής θα αποκρύπτονται. |
isShiftStepEnabled |
boolean |
Αν είναι true, ενεργοποιείται η κίνηση σύρσης με το ποντίκι για αύξηση ή μείωση της τιμής αριθμού. Κρατώντας πατημένο το SHIFT κατά τη σύρση, η τιμή αυξάνεται κατά shiftStep. |
max |
number |
Το μέγιστο μήκος της τιμής. |
min |
number |
Το ελάχιστο μήκος της τιμής. |
required |
boolean |
Αν είναι true, επιβάλλεται έγκυρος αριθμός εντός του εύρους min/max του στοιχείου ελέγχου. Αν είναι false, η κενή συμβολοσειρά επιτρέπεται ως έγκυρη τιμή. |
shiftStep |
number |
Το ποσό αύξησης όταν κρατιέται πατημένο το πλήκτρο SHIFT. Αυτή η τιμή shift είναι πολλαπλασιαστής της τιμής step. Για παράδειγμα, αν η τιμή step είναι 5 και το shiftStep είναι 10, κάθε μεταβολή θα αυξάνει ή θα μειώνει την τιμή κατά 50. |
step |
number |
Το ποσό κατά το οποίο αλλάζει η τιμή με την αύξηση ή τη μείωσή της. Αποτελεί επίσης παράγοντα επικύρωσης, καθώς η τιμή πρέπει να είναι πολλαπλάσιο του step (με μετατόπιση κατά min, αν έχει οριστεί) για να είναι έγκυρη. Δέχεται την ειδική τιμή συμβολοσειράς any, η οποία καταργεί τον περιορισμό επικύρωσης και κάνει τις ενέργειες αύξησης ή μείωσης να μεταβάλλουν την τιμή κατά 1. |
κουμπί επιλογής
Εμφανίζει ένα σύνολο κουμπιών επιλογής.
{
"type": "radio",
"options": [
{
"value": "option1",
"label": "Option 1"
},
{
"value": "option2",
"label": "Option 2"
}
]
}
Ιδιότητες
| Ιδιότητα | Τύπος | Περιγραφή |
|---|---|---|
default |
string | number |
Προεπιλεγμένη τιμή που εφαρμόζεται κατά την πρώτη προσθήκη του μπλοκ. |
fallback |
string | number |
Εφεδρική τιμή που εμφανίζεται όταν η τιμή του πεδίου είναι κενή. |
options |
array |
Επιλογές προς επιλογή. |
returnFormat |
string |
Καθορίζει τη μορφή επιστροφής της τιμής. |
populate |
object |
|
display |
string |
Ορίστε την τιμή buttonGroup για να εμφανίζονται οι επιλογές ως ομάδα κουμπιών αντί για κουμπιά επιλογής. |
allowNull |
boolean |
Επιτρέπει στον χρήστη να εκκαθαρίσει την τιμή κάνοντας ξανά κλικ στο επιλεγμένο κουμπί επιλογής. |
εύρος τιμών
Εμφανίζει ένα πεδίο εισαγωγής εύρους για τον ορισμό μιας αριθμητικής τιμής μεταξύ δύο σημείων.
{
"type": "range",
"min": 0,
"max": 100,
"step": 1
}
Ιδιότητες
| Ιδιότητα | Τύπος | Περιγραφή |
|---|---|---|
default |
number |
Προεπιλεγμένη τιμή που εφαρμόζεται κατά την πρώτη προσθήκη του block. |
fallback |
number |
Εφεδρική τιμή που εμφανίζεται όταν η τιμή του πεδίου είναι κενή. |
allowReset |
boolean |
Αν αυτή η ιδιότητα είναι true, εμφανίζεται κουμπί επαναφοράς του ρυθμιστικού. |
initialPosition |
number |
Η αρχική θέση του ρυθμιστικού, όταν δεν έχει δοθεί τιμή. Η initialPosition περιορίζεται μεταξύ των παρεχόμενων τιμών min και max της ιδιότητας. |
isShiftStepEnabled |
boolean |
Αν είναι true, ενεργοποιείται η κίνηση σύρσης με το ποντίκι για αύξηση ή μείωση της τιμής αριθμού. Κρατώντας πατημένο το SHIFT κατά τη σύρση, η τιμή αυξάνεται κατά shiftStep. |
marks |
array |
Εμφανίζει οπτικά τις διαβαθμίσεις του βήματος. Μπορούν να δοθούν προσαρμοσμένοι δείκτες μέσω ενός πίνακα. |
max |
number |
Το μέγιστο μήκος της τιμής. |
min |
number |
Το ελάχιστο μήκος της τιμής. |
railColor |
string |
Συμβολοσειρά χρώματος CSS για την προσαρμογή του φόντου του στοιχείου ράγας. |
resetFallbackValue |
number |
Η τιμή στην οποία θα επανέλθει αν πατηθεί το κουμπί επαναφοράς (ενεργοποιείται από το allowReset). |
separatorType |
string |
Καθορίζει αν η διαχωριστική γραμμή κάτω ή πάνω από τη σειρά του στοιχείου ελέγχου θα είναι απενεργοποιημένη ή πλήρους πλάτους. Από προεπιλογή τοποθετείται από κάτω, χωρίς να περιλαμβάνει το υπογράμμισμα του εικονιδίου ελέγχου. |
shiftStep |
number |
Το ποσό αύξησης όταν κρατιέται πατημένο το πλήκτρο SHIFT. Αυτή η τιμή shift είναι πολλαπλασιαστής της τιμής step. Για παράδειγμα, αν η τιμή step είναι 5 και το shiftStep είναι 10, κάθε μεταβολή θα αυξάνει ή θα μειώνει την τιμή κατά 50. |
showTooltip |
boolean |
Επιβάλλει την εμφάνιση ή την απόκρυψη του Tooltip UI. Αν η τιμή step οριστεί στην ειδική συμβολοσειρά any, αυτή η ρύθμιση παρακάμπτεται και γίνεται false. |
step |
number |
Το ποσό κατά το οποίο αλλάζει η τιμή με την αύξηση ή τη μείωσή της. Αποτελεί επίσης παράγοντα επικύρωσης, καθώς η τιμή πρέπει να είναι πολλαπλάσιο του step (με μετατόπιση κατά min, αν έχει οριστεί) για να είναι έγκυρη. Δέχεται την ειδική τιμή συμβολοσειράς any, η οποία καταργεί τον περιορισμό επικύρωσης και κάνει τις ενέργειες αύξησης ή μείωσης να μεταβάλλουν την τιμή κατά 1. |
trackColor |
string |
Συμβολοσειρά χρώματος CSS για την προσαρμογή του φόντου της γραμμής διαδρομής. |
withInputField |
boolean |
Καθορίζει αν το πεδίο αριθμού θα εμφανίζεται δίπλα στο RangeControl. Αν η τιμή step οριστεί στην ειδική συμβολοσειρά any, αυτή η ρύθμιση παρακάμπτεται και γίνεται false. |
αναπτυσσόμενη λίστα
Εμφανίζει ένα πεδίο επιλογής με υποστήριξη για μία ή περισσότερες επιλογές.
{
"type": "select",
"options": [
{
"value": "option1",
"label": "Option 1"
},
{
"value": "option2",
"label": "Option 2"
}
],
"multiple": false
}
Ιδιότητες
| Ιδιότητα | Τύπος | Περιγραφή |
|---|---|---|
default |
array | string | number |
Προεπιλεγμένη τιμή που εφαρμόζεται κατά την πρώτη προσθήκη του block. |
fallback |
array | string | number |
Εφεδρική τιμή που εμφανίζεται όταν η τιμή του πεδίου είναι κενή. |
multiple |
boolean |
Αν είναι true, μπορούν να επιλεγούν πολλές επιλογές. Η επιλογή «stylisedUi» ενεργοποιείται αυτόματα. |
options |
array |
Επιλογές προς επιλογή. |
returnFormat |
string |
Καθορίζει τη μορφή επιστροφής της τιμής. |
populate |
object |
|
stylisedUi |
boolean |
Εμφανίζει μια στυλιζαρισμένη έκδοση του πεδίου επιλογής με δυνατότητα αναζήτησης στα στοιχεία. |
allowNull |
boolean | string |
Επιτρέπει στον χρήστη να επιλέξει κενή επιλογή. Αν είναι true, η ετικέτα θα είναι κενή· διαφορετικά, η επιλογή θα εμφανίζει την καθορισμένη συμβολοσειρά. |
allowReset |
boolean |
Αν αυτή η ιδιότητα είναι true, εμφανίζεται κουμπί επαναφοράς του πεδίου επιλογής. |
καρτέλες
Εμφανίζει μια διεπαφή με καρτέλες για την ομαδοποίηση πεδίων.
{
"type": "tabs"
}
Ιδιότητες
| Ιδιότητα | Τύπος | Περιγραφή |
|---|---|---|
tabs |
array |
Οι καρτέλες που θα εμφανίζονται. |
κείμενο
Εμφανίζει ένα πεδίο εισαγωγής κειμένου μίας γραμμής.
{
"type": "text",
"min": 0,
"max": 100
}
Ιδιότητες
| Ιδιότητα | Τύπος | Περιγραφή |
|---|---|---|
default |
string |
Προεπιλεγμένη τιμή που εφαρμόζεται κατά την πρώτη προσθήκη του block. |
fallback |
string |
Εφεδρική τιμή που εμφανίζεται όταν η τιμή του πεδίου είναι κενή. |
max |
number |
Το μέγιστο μήκος της τιμής. |
min |
number |
Το ελάχιστο μήκος της τιμής. |
περιοχή κειμένου
Εμφανίζει ένα πεδίο εισαγωγής textarea.
{
"type": "textarea",
"min": 0,
"max": 100,
"rows": 4
}
Ιδιότητες
| Ιδιότητα | Τύπος | Περιγραφή |
|---|---|---|
default |
string |
Προεπιλεγμένη τιμή που εφαρμόζεται κατά την πρώτη προσθήκη του block. |
fallback |
string |
Εφεδρική τιμή που εμφανίζεται όταν η τιμή του πεδίου είναι κενή. |
max |
number |
Το μέγιστο μήκος της τιμής. |
min |
number |
Το ελάχιστο μήκος της τιμής. |
rows |
number |
Ο αριθμός γραμμών που θα περιέχει το textarea. |
εναλλαγή
Εμφανίζει έναν διακόπτη true/false.
{
"type": "toggle"
}
Ιδιότητες
| Ιδιότητα | Τύπος | Περιγραφή |
|---|---|---|
default |
boolean |
Προεπιλεγμένη τιμή που εφαρμόζεται κατά την πρώτη προσθήκη του block. |
fallback |
boolean |
Εφεδρική τιμή που εμφανίζεται όταν η τιμή του πεδίου είναι κενή. |
επαναλαμβανόμενη ομάδα
Αποδίδει ένα σύνολο πεδίων που μπορούν να επαναλαμβάνονται.
{
"type": "repeater",
"min": 0,
"max": 100
}
Ιδιότητες
| Ιδιότητα | Τύπος | Περιγραφή |
|---|---|---|
default |
array |
Οι γραμμές με τις οποίες ξεκινά ένα νέο μπλοκ. Κάθε γραμμή είναι ένα αντικείμενο τιμών πεδίων. Υπερισχύει των γραμμών που δημιουργεί η min. |
min |
number |
Ελάχιστος αριθμός γραμμών. |
max |
number |
Μέγιστος αριθμός γραμμών. |
minimized |
boolean |
Συμπτύσσει τις υπάρχουσες γραμμές όταν ανοίγει ο επεξεργαστής. Οι γραμμές που προστίθενται στον επεξεργαστή εμφανίζονται ανεπτυγμένες. |
textButton |
string |
Κείμενο για το κουμπί προσθήκης. |
textMinimized |
string | object |
Κείμενο που εμφανίζεται όταν οι γραμμές είναι συμπτυγμένες. |
textRemove |
string | boolean |
Ερώτηση επιβεβαίωσης που εμφανίζεται στον επεξεργαστή κατά την αφαίρεση γραμμής επαναλήπτη. Μια μη κενή συμβολοσειρά αλλάζει την ερώτηση· η τιμή false αφαιρεί τη γραμμή αμέσως, χωρίς διάλογο. Αν παραλειφθεί, είναι true ή είναι κενή συμβολοσειρά, χρησιμοποιείται η προεπιλεγμένη ερώτηση. |
attributes |
array |
Δέχεται όλους τους άλλους τύπους πεδίων εκτός από άλλο πεδίο καρτελών. |
εμπλουτισμένο κείμενο
Πεδίο χαρακτηριστικού για πεδία εμπλουτισμένου κειμένου.
{
"type": "richtext"
}
Ιδιότητες
| Ιδιότητα | Τύπος | Περιγραφή |
|---|---|---|
default |
string |
Προεπιλεγμένη τιμή που εφαρμόζεται κατά την πρώτη προσθήκη του block. |
fallback |
string |
Εφεδρική τιμή που εμφανίζεται όταν το πεδίο είναι κενό. |
μονάδα
Αποδίδει πεδίο εισαγωγής αριθμού με αναπτυσσόμενη λίστα μονάδων.
{
"type": "unit"
}
Ιδιότητες
| Ιδιότητα | Τύπος | Περιγραφή |
|---|---|---|
default |
string |
Προεπιλεγμένη τιμή που εφαρμόζεται κατά την πρώτη προσθήκη του block. |
fallback |
string |
Εφεδρική τιμή που εμφανίζεται όταν το πεδίο είναι κενό. |
disableUnits |
boolean |
Αν είναι true, το πεδίο επιλογής μονάδας είναι κρυφό. |
isPressEnterToChange |
boolean |
Αν είναι true, απαιτείται πάτημα του πλήκτρου ENTER για να ενεργοποιηθεί το onChange. Αν είναι ενεργό, η αλλαγή ενεργοποιείται επίσης κατά τη μετάβαση σε άλλο πεδίο. |
isResetValueOnUnitChange |
boolean |
Αν είναι true και η επιλεγμένη μονάδα έχει προεπιλεγμένη τιμή, αυτή η τιμή ορίζεται κατά την αλλαγή μονάδων. |
isUnitSelectTabbable |
boolean |
Καθορίζει αν το πεδίο επιλογής μονάδας είναι προσβάσιμο με Tab. |
units |
array |
επεξεργαστής WYSIWYG
Αποδίδει έναν επεξεργαστή WYSIWYG.
{
"type": "wysiwyg"
}
Ιδιότητες
| Ιδιότητα | Τύπος | Περιγραφή |
|---|---|---|
default |
string |
Προεπιλεγμένη τιμή που εφαρμόζεται κατά την πρώτη προσθήκη του μπλοκ. |
fallback |
string |
Εφεδρική τιμή που εμφανίζεται όταν η τιμή του πεδίου είναι κενή. |
toolbar |
object |
Η διαμόρφωση της γραμμής εργαλείων του επεξεργαστή. |
mode |
string |
Το code ανοίγει το πεδίο στην προβολή κώδικα. Το both προσθέτει ένα κουμπί για εναλλαγή μεταξύ της οπτικής προβολής και της προβολής κώδικα. |
Φόρτωση εικονιδίων
Ο επεξεργαστής φορτώνει ένα σύνολο εικονιδίων όταν εστιάσετε για πρώτη φορά στον επιλογέα του ή αλλάξετε το σύνολο ή το υποσύνολο, όχι όταν επιλέξετε το μπλοκ. Τα πεδία που ζητούν το ίδιο σύνολο μοιράζονται το αίτημα όσο αυτό εκτελείται. Το αποθηκευμένο όνομα του εικονιδίου παραμένει ορατό πριν από τη φόρτωση, ενώ αν αποτύχει ένα αίτημα, η εκ νέου εστίαση στον επιλογέα το επαναλαμβάνει.
Το tabler-icons υποστηρίζει τα outline και filled. Ένα υποσύνολο που έχει ρυθμιστεί ρητά για το επιλεγμένο σύνολο έχει προτεραιότητα· διαφορετικά, ο επιλογέας χρησιμοποιεί το solid, εφόσον είναι διαθέσιμο, ή το πρώτο υποσύνολο του συνόλου. Τα σύνολα χωρίς υποσύνολα παραλείπουν το subSet. Τα ονόματα των συνόλων αντιστοιχίζονται μόνο σε ενσωματωμένα αρχεία. Η απόδοση στο frontend αποθηκεύει προσωρινά μεμονωμένα εικονίδια αντί να αποθηκεύει πλήρη σύνολα εικονιδίων σε προσωρινές καταχωρίσεις της βάσης δεδομένων.
Εισαγόμενες τιμές επιλογών
Τα πλαίσια ελέγχου και τα αναπτυσσόμενα μενού επιλογών με "multiple": true συνήθως αποθηκεύουν έναν πίνακα από αντικείμενα { "value": "...", "label": "..." }. Δέχονται επίσης ένα αντικείμενο μεμονωμένης επιλογής, μια κλιμακωτή τιμή συμβολοσειράς ή αριθμού ή έναν πίνακα κλιμακωτών τιμών που εισάγονται μέσω του REST API ή εργαλείων περιεχομένου. Αυτό λειτουργεί επίσης μέσα σε γραμμές επαναλήπτη.
Ο επεξεργαστής εμφανίζει αυτές τις τιμές ως επιλογές χωρίς να αλλάζει τη μορφή των αποθηκευμένων δεδομένων τους κατά την αποθήκευση, εφόσον δεν έχουν τροποποιηθεί. Η προσθήκη ή η αφαίρεση μιας επιλογής αποθηκεύει τη συνηθισμένη διάταξη αντικειμένων επιλογών. Οι αριθμητικές τιμές 0 και οι τιμές συμβολοσειράς "0" είναι έγκυρες επιλογές. Τα πρότυπα λαμβάνουν το ρυθμισμένο returnFormat του πεδίου, όπως ακριβώς συμβαίνει και με τις τιμές που επιλέγονται στον επεξεργαστή. Οι επιλογές πρέπει και πάλι να αντιστοιχούν στις επιλογές που έχουν οριστεί ή συμπληρωθεί για το πεδίο.
Ένα εγγενές μενού μίας επιλογής χωρίς αποθηκευμένη ή προεπιλεγμένη τιμή εμφανίζει ένα απενεργοποιημένο κενό σύμβολο κράτησης θέσης και όχι την πρώτη επιλογή του. Αν επιλέξετε ρητά την πρώτη επιλογή, αποθηκεύεται. Μόλις αποθηκευτεί μια επιλογή, το σύμβολο κράτησης θέσης εξαφανίζεται. Χρησιμοποιήστε το allowNull όταν θέλετε οι συντάκτες να μπορούν επίσης να εκκαθαρίζουν μια επιλογή· το κενό σύμβολο κράτησης θέσης δεν επιτρέπει την εκκαθάριση μιας επιλογής που κατά τα άλλα είναι υποχρεωτική.
Αρχικές γραμμές επαναλήπτη
Στον επεξεργαστή, οι προεπιλογές περιλαμβάνουν τις ελάχιστες εμφωλευμένες γραμμές πριν από την εισαγωγή. Δεν χρειάζεται να ανοίξετε τις ρυθμίσεις του μπλοκ για να τις αρχικοποιήσετε, ενώ η εισαγωγή του μπλοκ δεν προσθέτει δεύτερο βήμα αναίρεσης για αυτές τις γραμμές.
Όταν ένας επαναλήπτης έχει min αλλά δεν έχει αποθηκευμένη τιμή ή ρητό default, ο διακομιστής αρχικοποιεί τόσες γραμμές, χρησιμοποιώντας τις προεπιλεγμένες τιμές των πεδίων της γραμμής. Αυτό ισχύει επίσης για ενσωματώσεις PHP, ετικέτες block και πηγές σελίδων που βασίζονται σε αρχεία και δεν έχουν ανοιχτεί ποτέ στον επεξεργαστή. Για παράδειγμα, το "min": 2 με ένα πεδίο κειμένου του οποίου η προεπιλεγμένη τιμή είναι "New item" εμφανίζει δύο γραμμές που περιέχουν αυτήν την τιμή.
Οι αποθηκευμένες γραμμές και ένα ρητό default επαναλήπτη υπερισχύουν. Μια ρητά αποθηκευμένη κενή λίστα, false ή null δεν αναδημιουργεί γραμμές που έχουν αφαιρεθεί. Η απόδοση δεν αποθηκεύει αυτές τις παραγόμενες προεπιλεγμένες τιμές πίσω στην ανάρτηση. Τα min και max περιορίζουν τα στοιχεία ελέγχου του επεξεργαστή· δεν περικόπτουν ούτε συμπληρώνουν μια αποθηκευμένη λίστα κατά την απόδοση. Χρησιμοποιήστε το bs_validate_block() για να αναφέρετε παραβιάσεις των ορίων γραμμών σε εισαγόμενο περιεχόμενο.
Τα πεδία γραμμής χωρίς default είναι false σε μια παραγόμενη γραμμή, επομένως μια τέτοια γραμμή δεν έχει περιεχόμενο. Οι γραμμές που προσθέτουν οι συντάκτες και αφήνουν κενές μοιάζουν ίδιες. Ένα πρότυπο που εμφανίζει κάρτα, επικεφαλίδα ή στοιχείο λίστας για κάθε γραμμή θα πρέπει να παραλείπει τις γραμμές χωρίς περιεχόμενο εκτός του επεξεργαστή και να τις διατηρεί μέσα σε αυτόν, ώστε τα πεδία τους να παραμένουν επεξεργάσιμα:
<?php foreach ( $a['items'] as $item ) : ?>
<?php if ( ! $isEditor && ! $item['title'] && ! $item['text'] ) continue; ?>
<div class="item">
<h3><?php echo $item['title']; ?></h3>
<p><?php echo $item['text']; ?></p>
</div>
<?php endforeach; ?>
Αφαίρεση επαναλήπτη
Η αφαίρεση μιας γραμμής ανοίγει το παράθυρο διαλόγου επιβεβαίωσης του επεξεργαστή με τα κουμπιά Διαγραφή και Ακύρωση. Η επιλογή Ακύρωση ή το Escape αφήνει τη γραμμή αμετάβλητη. Η γραμμή αφαιρείται μόνο μετά την επιβεβαίωση, ακόμη και μέσα σε ένθετους επαναλήπτες.
Το textRemove ελέγχει την ίδια συμπεριφορά για κάθε επαναλήπτη:
| Τιμή | Συμπεριφορά |
|---|---|
Παραλείπεται, true ή "" |
Εμφανίζεται η προεπιλεγμένη ερώτηση επιβεβαίωσης. |
| Μη κενή συμβολοσειρά | Εμφανίζεται αυτή η προσαρμοσμένη ερώτηση, με τον υπάρχοντα μηχανισμό μετάφρασης προσαρμοσμένου κειμένου. |
false |
Η γραμμή αφαιρείται αμέσως, χωρίς παράθυρο διαλόγου. |
Για παράδειγμα, το "textRemove": "Remove this team member?" αλλάζει την ερώτηση.
Ο υπάρχων περιορισμός min εξακολουθεί να αποτρέπει την αφαίρεση γραμμών κάτω από το ελάχιστο όριο.
Ένθεση επαναληπτών
Μια γραμμή επαναλήπτη δέχεται κάθε τύπο πεδίου εκτός από το tabs. Ένα πεδίο tabs σε μια γραμμή, ακόμη κι αν βρίσκεται μέσα σε ομάδα χωρίς id, εμφανίζει ειδοποίηση στον επεξεργαστή αντί για τα πεδία του. Η επέκταση PHPStan το αναφέρει για τα block.json και field.json. Κρατήστε τα πεδία της γραμμής σε ένα επίπεδο ή μετακινήστε τις καρτέλες έξω από τον επαναλήπτη.
Σύνδεσμοι WYSIWYG
Η γραμμή εργαλείων συνδέσμων WYSIWYG εισάγει συνδέσμους που ανοίγουν στην ίδια καρτέλα, χωρίς να προσθέτει εξ ορισμού τα target ή rel. Ενεργοποιήστε την επιλογή νέας καρτέλας με το toolbar.formats.link.opensInNewTab:
{
"id": "content",
"type": "wysiwyg",
"toolbar": {
"formats": {
"link": {
"opensInNewTab": true
}
}
}
}
Η επιλογή νέας καρτέλας προσθέτει τα target="_blank" και rel="noreferrer noopener".
Αν απενεργοποιηθεί, αφαιρούνται αυτά τα αυτόματα χαρακτηριστικά. Για να εφαρμόσετε χαρακτηριστικά σε κάθε σύνδεσμο αυτού του πεδίου, ορίστε το toolbar.formats.link.attributes, για παράδειγμα
{ "class": "content-link", "rel": "nofollow" }. Η ρητή διαμόρφωση διατηρείται και τα διακριτικά ασφαλείας για νέες καρτέλες προστίθενται στο διαμορφωμένο rel.
Η πληκτρολόγηση ενός URL δεν το μετατρέπει αυτόματα σε σύνδεσμο, ενώ το πάτημα σε έναν υπάρχοντα σύνδεσμο στο πεδίο δεν σας απομακρύνει από τον επεξεργαστή. Τα χαρακτηριστικά συνδέσμων που είχαν αποθηκευτεί προηγουμένως παραμένουν στο υπάρχον περιεχόμενο· δεν μεταφέρονται αυτόματα.