blockly > Blocca

Blocca corso

Classe per un blocco. Normalmente non viene chiamato direttamente, è preferibile workspace.newBlock().

Firma:

export declare class Block implements IASTNodeLocation, IDeletable 

Implementa: IASTNodeLocation, IDeletable

Costruttori

Costruttore Modificatori Descrizione
(constructor)(workspace, prototypeName, opt_id) Crea una nuova istanza della classe Block

Proprietà

Proprietà Modificatori Tipo Descrizione
childBlocks_ protected questo[]
collapsed_ protected boolean
COLLAPSED_FIELD_NAME

static

readonly

stringa L'ID neutrale della lingua assegnato al campo compresso.
COLLAPSED_INPUT_NAME

static

readonly

stringa L'ID neutro per la lingua assegnato all'input compresso.
colour_ protected stringa Colore del blocco in formato "#RRGGBB".
compose? (p1: Blocca) => void (Facoltativo) Una funzione facoltativa che riconfigura il blocco in base ai contenuti della finestra di dialogo "mutatore".
contextMenu boolean
dati stringa | null Dati di testo facoltativi che evolvono tra blocchi e XML. Non ha alcun effetto. Possono essere utilizzate da terze parti per le meta informazioni.
decomporre? (p1: Area di lavoro) => Blocca (Facoltativo) Una funzione facoltativa che compila la finestra di dialogo del mutatore con i componenti di questo blocco.
destroy? () => void (Facoltativo) Metodo facoltativo chiamato durante lo smaltimento.
domToMutation? (p1: Elemento) => void (Facoltativo) Un metodo di deserializzazione facoltativo per definire come deserializzare lo stato della mutazione dal file XML. Questo deve essere associato alla definizione di mutationToDom.
getDeveloperVariables? () => stringa[] (Facoltativo) Una proprietà facoltativa per la dichiarazione delle variabili sviluppatore. Restituisce un elenco di nomi di variabili che possono essere utilizzati dai generatori. Le variabili sviluppatore non vengono mai mostrate all'utente, ma vengono dichiarate come variabili globali nel codice generato.
cappello? stringa (Facoltativo) Il nome del tipo di cappello.
helpUrl string | Function | null Stringa per la guida ai blocchi o funzione che restituisce un URL. Null senza assistenza.
icone IIcon[]
id stringa
init? () => void (Facoltativo) Un metodo facoltativo chiamato durante l'inizializzazione.
inputList Ingresso[]
inputsInline? boolean (Facoltativo)
inputsInlineDefault? boolean (Facoltativo)
isInFlyout boolean
isInMutator boolean
isInsertionMarker_ protected boolean True se questo blocco è un indicatore di inserimento.
loadExtraState? (p1: any) => void (Facoltativo) Un metodo di serializzazione facoltativo per definire come deserializzare lo stato aggiuntivo del blocco (ad esempio lo stato di mutazione) da qualcosa di compatibile JSON. Questo deve essere associato alla definizione di saveExtraState.
mutationToDom? (...p1: any[]) => Elemento (Facoltativo) Un metodo di serializzazione facoltativo per definire come serializzare lo stato di mutazione in XML. Questo deve essere associato alla definizione di domToMutation.
nextConnection Connessione | null
invariato? ((p1: Abstract) => void) | null (Facoltativo) Un metodo facoltativo di callback da utilizzare ogni volta che cambia l'area di lavoro principale del blocco. Solitamente viene richiamata solo dal costruttore, dalla funzione di inizializzazione del tipo di blocco o da una funzione di inizializzazione dell'estensione.
outputConnection Connessione | null
outputShape_ protected numero | null
parentBlock_ protected questo | null
previousConnection Connessione | null
rendering eseguito boolean | null
RTL boolean
saveExtraState? (doFullSerialization?: booleano) => any (Facoltativo) Un metodo di serializzazione facoltativo per definire come serializzare lo stato aggiuntivo del blocco (ad esempio lo stato di mutazione) in modo che sia compatibile con JSON. Questo deve essere associato alla definizione di loadExtraState.
styleName_ protected stringa Nome dello stile del blocco.
suppressPrefixSuffix boolean | null Una proprietà facoltativa per eliminare l'aggiunta di STATEMENT_PREFIX e STATEMENT_SUFFIX al codice generato.
descrizione comando Tooltip.TipInfo
type stringa
workspace Workspace

Metodi

Metodo Modificatori Descrizione
addIcon(icon) Aggiunge l'icona specificata al blocco.
allInputsFilled(opt_shadowBlocksAreFilled) Verifica in modo ricorsivo se tutte le istruzioni e gli input di valori sono pieni di blocchi. Controlla anche tutti i seguenti blocchi di istruzioni in questo stack.
appendDummyInput(name) Accoda una riga di input fittizia.
appendEndRowInput(name) Accoda un input che termina la riga.
appendInput(input)

Accoda la riga di input specificata.

Consente di aggiungere input personalizzati al blocco.

appendStatementInput(name) Accoda una riga di input dell'istruzione.
appendValueInput(name) Accoda una riga di input di valore.
bumpNeighbours() Sposta i blocchi scollegati non allineati. Due blocchi che non sono effettivamente collegati non dovrebbero allinearsi per caso sullo schermo.
eliminazione(healStack) Smaltisci questo blocco.
disposeInternal() protected Consente di eliminare questo blocco senza eseguire le operazioni richieste dal blocco in alto. Ad es. non attiva eventi, non scollega il blocco e così via.
doInit_() protected Richiama la funzione init() e gestisce l'attivazione degli eventi associati e così via.
getChildren(ordered) Trova tutti i blocchi direttamente nidificati all'interno di questo. Include input di valori ed istruzioni, nonché qualsiasi istruzione successiva. Esclude qualsiasi connessione in una scheda di output o qualsiasi istruzione precedente. Facoltativamente, i blocchi vengono ordinati in base alla posizione, dall'alto verso il basso.
getColour() Prendi il colore di un blocco.
getCommentText() Restituisce il commento in questo blocco (o null se non ci sono commenti).
getDescendants(ordered) Trova tutti i blocchi nidificati direttamente o indirettamente all'interno di questo. Include questo blocco nell'elenco. Include input di valori ed istruzioni, nonché eventuali istruzioni seguenti. Esclude qualsiasi connessione in una scheda di output o eventuali istruzioni precedenti. Facoltativamente, i blocchi vengono ordinati in base alla posizione, dall'alto verso il basso.
getField(name) Restituisce il campo denominato da un blocco.
getFieldValue(name) Restituisce il valore indipendente dalla lingua del campo specificato.
getHue() Ottieni il valore della tonalità HSV di un blocco. Null se la tonalità non è impostata.
getIcon(type)
getIcons()
getInheritedDisabled() Scopri se il blocco è disattivato o meno a causa di elementi padre. La proprietà disattivata del blocco non viene considerata.
getInput(name) Recupera l'oggetto di input denominato.
getInputsInline() Scopri se gli input dei valori sono disposti orizzontalmente o verticalmente.
getInputTargetBlock(name) Recupera il blocco associato all'input denominato.
getInputWithBlock(block) Restituisce l'input che si connette al blocco specificato.
getNextBlock() Restituisce il blocco di istruzione successivo collegato direttamente a questo blocco.
getOutputShape() Ottieni la forma di output del blocco.
getParent() Restituisci il blocco principale oppure null se questo blocco si trova al livello superiore. Il blocco padre è il blocco connesso alla connessione precedente (per un blocco di istruzione) o il blocco connesso alla connessione di output (per un blocco di valore).
getPreviousBlock() Restituisce il blocco connesso alla connessione precedente.
getRELATIVEToSurfaceXY() Restituisce le coordinate dell'angolo in alto a sinistra di questo blocco rispetto all'origine della superficie di disegno (0,0), nelle unità dell'area di lavoro.
getRootBlock() Restituisce il blocco più in alto nell'albero di questo blocco. Se il blocco si trova al livello più alto, verrà visualizzato automaticamente.
getStyleName() Ottieni il nome dello stile di blocco.
getSurroundParent() Return the parent block that surrounds the current block, or null if this block has no surrounding block. Un blocco padre potrebbe essere solo l'istruzione precedente, mentre il blocco circostante è un'istruzione if, loop many e così via.
getTooltip() Restituisce il testo della descrizione comando per questo blocco.
getVars() Restituisce tutte le variabili a cui fa riferimento questo blocco.
hasIcon(type)
initModel() Chiama initModel su tutti i campi del blocco. Potrebbe essere chiamato più di una volta. È necessario richiamare initModel o initSvg dopo aver creato un blocco e prima della prima interazione. Le interazioni includono azioni dell'interfaccia utente (ad es. clic e trascinamento) ed eventi di attivazione (ad es. creazione, eliminazione e modifica).
isCollapsed() Scopri se il blocco è compresso o meno.
isDeletable() Scopri se è possibile eliminare questo blocco.
isDisposed() Restituisce un valore che indica se questo blocco è stato eliminato / eliminato.
isDuplicatable() Scopri se il blocco è duplicabile o meno. Se la duplica del blocco e dei discendenti lo supererà la capacità dell'area di lavoro, questo blocco non è duplicabile. Se duplicando questo blocco e i discendenti, qualsiasi tipo verrà sovrapposto al valore maxInstance di questo blocco, questo blocco non è duplicabile.
isEnabled() Scopri se questo blocco è abilitato o meno.
isInsertionMarker() Scopri se questo blocco è un blocco indicatore inserito o meno.
isOwnDeletable() Indica se la proprietà eliminabile di questo blocco è true o false.
isOwnEditable() Indica se la proprietà modificabile di questo blocco è true o false.
isShadow() Scopri se questo blocco è un blocco shadow o meno.
jsonInit(json) Inizializza questo blocco utilizzando una descrizione JSON multipiattaforma e ottimizzata per l'internazionalizzazione.
mixin(mixinObj, opt_disableCheck) Aggiungi coppie chiave-valore da mixinObj a questo oggetto blocco. Per impostazione predefinita, questo metodo verifica che le chiavi in mixinObj non sovrascrivano i valori esistenti nel blocco, inclusi i valori dei prototipi. Ciò garantisce un'assicurazione contro l'incompatibilità di mixin / estensione con le funzionalità di blocco future. Questo controllo può essere disattivato passando true come secondo argomento.
moveBy(dx, dy, reason) Sposta un blocco di un offset relativo.
moveInputBefore(name, refName) Sposta un input denominato in una posizione diversa su questo blocco.
moveNumberedInputBefore(inputIndex, refIndex) Sposta un input numerato in una posizione diversa in questo blocco.
removeIcon(type) Rimuove dal blocco l'icona il cui getType corrisponde al tipo iconType specificato.
removeInput(name, opt_quiet) Rimuovi un input da questo blocco.
renameVarById(oldId, newId) Notifica che la variabile viene rinominata. Se l'ID corrisponde a una delle variabili di questo blocco, rinominalo.
setCollapsed(collapsed) Specifica se il blocco è compresso o meno.
setColour(colour) Modifica il colore di un blocco.
setCommentText(text) Imposta il testo del commento di questo blocco.
setDeletable(deletable) Stabilisci se è possibile eliminare questo blocco.
setEditable(editable) Stabilisci se questo blocco può essere modificato o meno.
setEnabled(enabled) Specifica se il blocco è attivato o meno.
setFieldValue(newValue, name) Imposta il valore del campo specificato per questo blocco.
setHelpUrl(url) Imposta l'URL della pagina di assistenza di questo blocco.
setInputsInline(newBoolean) Consente di stabilire se gli input dei valori devono essere disposti orizzontalmente o verticalmente.
setMovable(movable) Specifica se il blocco può essere spostato o meno.
setMutator(_mutator) Aggiungi una finestra di dialogo mutatore a questo blocco.
setNextStatement(newBoolean, opt_check) Specifica se un altro blocco può concatenarsi in fondo a questo blocco.
setOnChange(onchangeFn) Imposta una funzione di callback da utilizzare ogni volta che l'area di lavoro principale del blocco viene modificata, sostituendo qualsiasi gestore onchange precedente. Solitamente viene richiamata solo dal costruttore, dalla funzione di inizializzazione del tipo di blocco o da una funzione di inizializzazione dell'estensione.
setOutput(newBoolean, opt_check) Stabilisci se questo blocco restituisce un valore.
setOutputShape(outputShape) Imposta la forma di output del blocco.
setPreviousStatement(newBoolean, opt_check) Specifica se questo blocco può concatenarsi nella parte inferiore di un altro blocco.
setStyle(blockStyleName) Imposta i valori di stile e colore di un blocco.
setTooltip(newTip) Imposta la descrizione comando per questo blocco.
setWarningText(_text, _opt_id) Imposta il testo di avviso di questo blocco.
toDevString()

Questo metodo restituisce una stringa che descrive il blocco nei termini sviluppatore (tipo nome e ID; solo in inglese).

Destinato a essere utilizzato nei log e negli errori della console. Se hai bisogno di una stringa che utilizza la lingua nativa dell'utente (inclusi blocco di testo, valori dei campi e blocchi secondari), utilizza [toString()].

toString(opt_maxLength, opt_emptyToken) Crea una rappresentazione testuale leggibile di questo blocco e di eventuali elementi secondari.
unplug(opt_healStack) Scollega questo blocco dal suo blocco superiore. Se questo blocco è un'istruzione, puoi ricollegare il blocco sottostante con quello in alto.