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

προσθήκη

Κέλυφος
npx blockstudio add <blocks...> [options]

Κατεβάζει μπλοκ από ένα μητρώο και τα γράφει στον κατάλογο μπλοκ του έργου σας.

Ορίσματα

Όρισμα Περιγραφή
blocks Ένα ή περισσότερα μπλοκ για προσθήκη. Μορφή: namespace/block ή απλώς block.

Επιλογές

Επιλογή Περιγραφή
-y, --yes Παράλειψη όλων των προτροπών (αντικατάσταση, επίλυση συγκρούσεων).
--dry-run Προεπισκόπηση όσων θα εγκατασταθούν, χωρίς εγγραφή αρχείων.

Επίλυση namespace

Όταν ορίζετε namespace, το CLI αναζητά στο συγκεκριμένο μητρώο:

Κέλυφος
npx blockstudio add ui/tabs

Όταν παραλείπετε το namespace, το CLI αναζητά σε όλα τα ρυθμισμένα μητρώα:

Κέλυφος
npx blockstudio add tabs

Αν το μπλοκ βρεθεί σε ένα μόνο μητρώο, χρησιμοποιείται αυτόματα. Αν βρεθεί σε περισσότερα, το CLI εμφανίζει διαδραστική προτροπή επιλογής.

Με το --yes, χρησιμοποιείται το πρώτο μητρώο που ταιριάζει, σύμφωνα με τη σειρά blocks.json. Χωρίς τερματικό και με το --dry-run, ένα αμφίσημο όνομα διακόπτει την εντολή με σφάλμα που παραθέτει τα μητρώα:

Κώδικας
Block "hero" found in multiple registries: acme, starter. Specify one: blockstudio add acme/hero

Πριν επιλύσει οποιοδήποτε μπλοκ, το add ανακτά όλα τα ρυθμισμένα μητρώα. Αν κάποιο δεν είναι προσβάσιμο ή δεν είναι έγκυρο, η εντολή αποτυγχάνει, ακόμη και για μπλοκ με ρητό namespace.

Εξαρτήσεις

Τα μπλοκ μπορούν να δηλώνουν εξαρτήσεις από άλλα μπλοκ στο ίδιο μητρώο. Όταν προσθέτετε ένα μπλοκ, οι εξαρτήσεις του επιλύονται και εγκαθίστανται αυτόματα.

Κέλυφος
npx blockstudio add ui/tabs

Αν το tabs εξαρτάται από το tab-item, και τα δύο μπλοκ κατεβαίνουν και εγκαθίστανται. Οι εξαρτήσεις εγκαθίστανται πάντα πριν από τα μπλοκ που εξαρτώνται από αυτές.

Οι κυκλικές εξαρτήσεις εντοπίζονται και απορρίπτονται με σφάλμα.

Συμπεριφορά αντικατάστασης

Αν υπάρχει ήδη φάκελος μπλοκ στον κατάλογο προορισμού:

  • Διαδραστική λειτουργία: σας ζητά να επιβεβαιώσετε την αντικατάσταση
  • Σημαία --yes: αντικαθιστά χωρίς ερώτηση
  • Σημαία --dry-run: αναφέρει τι θα αντικατασταθεί
  • Μη διαδραστική λειτουργία χωρίς --yes: διακόπτεται πριν από τη λήψη, με Block "<name>" already exists at <path>. Use --yes to overwrite.

Ο έλεγχος καλύπτει και τις εξαρτήσεις, επομένως η προσθήκη του tabs όταν το tab-item είναι ήδη εγκατεστημένο απαιτεί το --yes.

Πολλαπλά μπλοκ

Τα μπλοκ που δίνονται σε μία εντολή επεξεργάζονται με τη σειρά. Αν κάποιο αποτύχει, η εντολή σταματά εκεί και τα μπλοκ που εγκαταστάθηκαν νωρίτερα στην ίδια εκτέλεση παραμένουν στον δίσκο.

Παραδείγματα

Προσθήκη ενός μπλοκ:

Κέλυφος
npx blockstudio add ui/hero

Προσθήκη πολλών μπλοκ:

Κέλυφος
npx blockstudio add ui/tabs ui/hero ui/accordion

Προεπισκόπηση χωρίς εγγραφή:

Κέλυφος
npx blockstudio add ui/tabs --dry-run

Παράλειψη όλων των προτροπών:

Κέλυφος
npx blockstudio add ui/tabs --yes