προσθήκη
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