Μετάβαση στο περιεχόμενο

Τύποι πεδίων

Το 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 συνημμένων. Δείτε φορητές αναφορές πολυμέσων για λεπτομέρειες.

Δείτε την Φόρτωση εικονιδίων για αιτήματα επιλογέα, επαναλήψεις και υποσύνολα εικονιδίων.

χαρακτηριστικά

Αποδίδει πεδία εισαγωγής χαρακτηριστικών δεδομένων.

JSON
{
  "type": "attributes"
}

Ιδιότητες

Ιδιότητα Τύπος Περιγραφή
default array Προεπιλεγμένη τιμή που εφαρμόζεται κατά την πρώτη προσθήκη του block.
fallback array Εφεδρική τιμή που εμφανίζεται όταν η τιμή του πεδίου είναι κενή.
link boolean Επιτρέπει την επιλογή συνδέσμου από αναπτυσσόμενη λίστα.
media boolean Επιτρέπει την επιλογή πολυμέσων από αναπτυσσόμενη λίστα.

μπλοκ

Αναφέρεται σε ένα άλλο block Blockstudio και εμφανίζει τα πεδία του ενσωματωμένα. Στα πρότυπα, η τιμή επιστρέφει την απόδοση του block.

JSON
{
  "type": "block"
}

Ιδιότητες

Ιδιότητα Τύπος Περιγραφή
block string Το όνομα του block στο οποίο γίνεται αναφορά (π.χ. e.g, «mytheme/card»).
returnFormat string Πώς θα επιστρέφεται η τιμή στα πρότυπα.

πλαίσιο επιλογής

Εμφανίζει ένα σύνολο πλαισίων επιλογής.

JSON
{
  "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.

JSON
{
  "type": "classes"
}

Ιδιότητες

Ιδιότητα Τύπος Περιγραφή
default string Προεπιλεγμένη τιμή που εφαρμόζεται κατά την πρώτη προσθήκη του block.
fallback string Εφεδρική τιμή που εμφανίζεται όταν η τιμή του πεδίου είναι κενή.
tailwind boolean Αν θα ενεργοποιηθούν οι κλάσεις Tailwind για αυτό το πεδίο εισαγωγής.

κώδικας

Εμφανίζει έναν επεξεργαστή κώδικα.

JSON
{
  "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.

χρώμα

Εμφανίζει μια παλέτα χρωμάτων και έναν επιλογέα χρωμάτων.

JSON
{
  "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 Αν θα επιτρέπεται προσαρμοσμένο χρώμα.

ημερομηνία

Εμφανίζει έναν επιλογέα ημερομηνίας.

JSON
{
  "type": "date"
}

Ιδιότητες

Ιδιότητα Τύπος Περιγραφή
default string Προεπιλεγμένη τιμή που εφαρμόζεται κατά την πρώτη προσθήκη του block.
fallback string Εφεδρική τιμή που εμφανίζεται όταν η τιμή του πεδίου είναι κενή.
startOfWeek number Η ημέρα έναρξης της εβδομάδας. 0 για Κυριακή, 1 για Δευτέρα κ.ο.κ.

ημερομηνία και ώρα

Εμφανίζει έναν επιλογέα ημερομηνίας και ώρας.

JSON
{
  "type": "datetime"
}

Ιδιότητες

Ιδιότητα Τύπος Περιγραφή
default string Προεπιλεγμένη τιμή που εφαρμόζεται κατά την πρώτη προσθήκη του block.
fallback string Εφεδρική τιμή που εμφανίζεται όταν η τιμή του πεδίου είναι κενή.
is12Hour boolean Αν χρησιμοποιείται ρολόι 12 ωρών. Με ρολόι 12 ωρών εμφανίζεται ένα στοιχείο AM/PM και θεωρείται ότι η μορφή ώρας είναι MM-DD-YYYY (αντί της προεπιλεγμένης μορφής DD-MM-YYYY).

αρχεία

Εμφανίζει ένα κουμπί για τη βιβλιοθήκη πολυμέσων. Τα επιλεγμένα στοιχεία μπορούν να αναδιαταχθούν απευθείας.

JSON
{
  "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.

διαβάθμιση χρωμάτων

Εμφανίζει μια παλέτα διαβαθμίσεων και έναν επιλογέα διαβάθμισης.

JSON
{
  "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 Αν θα επιτρέπεται προσαρμοσμένο χρώμα.

ομάδα

Εμφανίζει πολλά πεδία σε ένα (προαιρετικά) συμπτυσσόμενο πλαίσιο.

JSON
{
  "type": "group"
}

Ιδιότητες

Ιδιότητα Τύπος Περιγραφή
title string Κείμενο τίτλου. Εμφανίζεται ακόμη κι όταν το στοιχείο είναι κλειστό.
opened boolean Όταν οριστεί σε true, το στοιχείο θα παραμένει ανοιχτό ανεξάρτητα από την ιδιότητα initialOpen και την
initialOpen boolean Αν το πλαίσιο θα είναι αρχικά ανοιχτό.
scrollAfterOpen boolean Κάνει κύλιση του περιεχομένου ώστε να εμφανιστεί στην οθόνη όταν είναι ορατό.
class string Προσαρμοσμένη κλάση CSS που θα εφαρμοστεί στην ομάδα.
style object Προσαρμοσμένα στυλ CSS που θα εφαρμοστούν στην ομάδα.
attributes array Δέχεται όλους τους άλλους τύπους πεδίων εκτός από άλλο πεδίο tabs.

ετικέτα HTML

Εμφανίζει έναν επιλογέα ετικέτας HTML. Χρήσιμος για την επιλογή επιπέδων επικεφαλίδων ή σημασιολογικών στοιχείων.

JSON
{
  "type": "html-tag"
}

Ιδιότητες

Ιδιότητα Τύπος Περιγραφή
default string Προεπιλεγμένη τιμή που εφαρμόζεται κατά την πρώτη προσθήκη του block.
fallback string Εφεδρική τιμή που εμφανίζεται όταν η τιμή του πεδίου είναι κενή.
tags string | array Ποιες ετικέτες θα συμπεριληφθούν. Χρησιμοποιήστε μια προκαθορισμένη συμβολοσειρά ή έναν πίνακα ονομάτων ετικετών.
exclude array Ετικέτες που θα εξαιρεθούν από την προκαθορισμένη επιλογή. Ισχύει μόνο όταν χρησιμοποιείται προκαθορισμένη συμβολοσειρά για τις ετικέτες.

εικονίδιο

Εμφανίζει ένα εικονίδιο SVG από ένα σύνολο εικονιδίων.

JSON
{
  "type": "icon"
}

Ιδιότητες

Ιδιότητα Τύπος Περιγραφή
default object Προεπιλεγμένη τιμή που εφαρμόζεται κατά την πρώτη προσθήκη του block.
fallback object Εφεδρική τιμή που εμφανίζεται όταν η τιμή του πεδίου είναι κενή.
sets array | string Ποιο σύνολο εικονιδίων θα συμπεριληφθεί. Αφήστε το κενό για να συμπεριληφθούν όλα.
subSets array | string Ποιο υποσύνολο εικονιδίων θα συμπεριληφθεί. Αφήστε το κενό για να συμπεριληφθούν όλα.
returnFormat string Η μορφή στην οποία θα επιστρέφεται το εικονίδιο.

Εμφανίζει ένα στοιχείο ελέγχου συνδέσμου για την επιλογή εσωτερικών ή εξωτερικών συνδέσμων.

JSON
{
  "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 Αν οι αναζητήσεις συνδέσμων χωρίς αντιστοιχία μπορούν να δημιουργούν πρόταση για νέα σελίδα πρόχειρου.

μήνυμα

Εμφανίζει ένα μήνυμα με προσαρμοσμένο περιεχόμενο.

JSON
{
  "type": "message"
}

Ιδιότητες

Ιδιότητα Τύπος Περιγραφή
default string Προεπιλεγμένη τιμή που εφαρμόζεται κατά την πρώτη προσθήκη του block.
fallback string Εφεδρική τιμή που εμφανίζεται όταν η τιμή του πεδίου είναι κενή.
value string Το μήνυμα προς εμφάνιση. Τα δεδομένα του block και των γνωρισμάτων είναι διαθέσιμα σε σύνταξη αγκυλών, e.g.: {block.title} ή {attributes.text}

αριθμός

Εμφανίζει ένα πεδίο εισαγωγής αριθμού.

JSON
{
  "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.

κουμπί επιλογής

Εμφανίζει ένα σύνολο κουμπιών επιλογής.

JSON
{
  "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 Επιτρέπει στον χρήστη να εκκαθαρίσει την τιμή κάνοντας ξανά κλικ στο επιλεγμένο κουμπί επιλογής.

εύρος τιμών

Εμφανίζει ένα πεδίο εισαγωγής εύρους για τον ορισμό μιας αριθμητικής τιμής μεταξύ δύο σημείων.

JSON
{
  "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.

αναπτυσσόμενη λίστα

Εμφανίζει ένα πεδίο επιλογής με υποστήριξη για μία ή περισσότερες επιλογές.

JSON
{
  "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, εμφανίζεται κουμπί επαναφοράς του πεδίου επιλογής.

καρτέλες

Εμφανίζει μια διεπαφή με καρτέλες για την ομαδοποίηση πεδίων.

JSON
{
  "type": "tabs"
}

Ιδιότητες

Ιδιότητα Τύπος Περιγραφή
tabs array Οι καρτέλες που θα εμφανίζονται.

κείμενο

Εμφανίζει ένα πεδίο εισαγωγής κειμένου μίας γραμμής.

JSON
{
  "type": "text",
  "min": 0,
  "max": 100
}

Ιδιότητες

Ιδιότητα Τύπος Περιγραφή
default string Προεπιλεγμένη τιμή που εφαρμόζεται κατά την πρώτη προσθήκη του block.
fallback string Εφεδρική τιμή που εμφανίζεται όταν η τιμή του πεδίου είναι κενή.
max number Το μέγιστο μήκος της τιμής.
min number Το ελάχιστο μήκος της τιμής.

περιοχή κειμένου

Εμφανίζει ένα πεδίο εισαγωγής textarea.

JSON
{
  "type": "textarea",
  "min": 0,
  "max": 100,
  "rows": 4
}

Ιδιότητες

Ιδιότητα Τύπος Περιγραφή
default string Προεπιλεγμένη τιμή που εφαρμόζεται κατά την πρώτη προσθήκη του block.
fallback string Εφεδρική τιμή που εμφανίζεται όταν η τιμή του πεδίου είναι κενή.
max number Το μέγιστο μήκος της τιμής.
min number Το ελάχιστο μήκος της τιμής.
rows number Ο αριθμός γραμμών που θα περιέχει το textarea.

εναλλαγή

Εμφανίζει έναν διακόπτη true/false.

JSON
{
  "type": "toggle"
}

Ιδιότητες

Ιδιότητα Τύπος Περιγραφή
default boolean Προεπιλεγμένη τιμή που εφαρμόζεται κατά την πρώτη προσθήκη του block.
fallback boolean Εφεδρική τιμή που εμφανίζεται όταν η τιμή του πεδίου είναι κενή.

επαναλαμβανόμενη ομάδα

Αποδίδει ένα σύνολο πεδίων που μπορούν να επαναλαμβάνονται.

JSON
{
  "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 Δέχεται όλους τους άλλους τύπους πεδίων εκτός από άλλο πεδίο καρτελών.

εμπλουτισμένο κείμενο

Πεδίο χαρακτηριστικού για πεδία εμπλουτισμένου κειμένου.

JSON
{
  "type": "richtext"
}

Ιδιότητες

Ιδιότητα Τύπος Περιγραφή
default string Προεπιλεγμένη τιμή που εφαρμόζεται κατά την πρώτη προσθήκη του block.
fallback string Εφεδρική τιμή που εμφανίζεται όταν το πεδίο είναι κενό.

μονάδα

Αποδίδει πεδίο εισαγωγής αριθμού με αναπτυσσόμενη λίστα μονάδων.

JSON
{
  "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.

JSON
{
  "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
<?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 εισάγει συνδέσμους που ανοίγουν στην ίδια καρτέλα, χωρίς να προσθέτει εξ ορισμού τα target ή rel. Ενεργοποιήστε την επιλογή νέας καρτέλας με το toolbar.formats.link.opensInNewTab:

JSON
{
  "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 δεν το μετατρέπει αυτόματα σε σύνδεσμο, ενώ το πάτημα σε έναν υπάρχοντα σύνδεσμο στο πεδίο δεν σας απομακρύνει από τον επεξεργαστή. Τα χαρακτηριστικά συνδέσμων που είχαν αποθηκευτεί προηγουμένως παραμένουν στο υπάρχον περιεχόμενο· δεν μεταφέρονται αυτόματα.