blockly > Blocca

Blocca corso

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

Firma:

export declare class Block implements IASTNodeLocation 

Implementa:IASTNodeLocation

Costruttori

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

Proprietà

Proprietà	Modificatori	Tipo	Descrizione
childBlocks_	protected	questo[]
collapsed_	protected	booleano
COLLAPSED_FIELD_NAME	static readonly	stringa	L'ID indipendente dalla lingua assegnato al campo compresso.
COLLAPSED_INPUT_NAME	static readonly	stringa	L'ID indipendente dalla lingua assegnato all'input compresso.
colour_	protected	stringa	Colore del blocco in "#RRGGBB" formato.
comporre?		(p1: Blocca) => null	(Facoltativo) Una funzione facoltativa che riconfigura il blocco in base ai contenuti della finestra di dialogo del mutatore.
contextMenu		booleano
dati		stringa | null	Dati di testo facoltativi che eseguono andata e ritorno tra i blocchi e il codice XML. Non ha alcun effetto. Possono essere utilizzati da terze parti per fornire metadati.
scomporre?		(p1: Area di lavoro) => Blocca	(Facoltativo) Una funzione facoltativa che compila la finestra di dialogo del mutatore con i componenti del blocco.
di eliminare?		() => null	(Facoltativo) Un metodo facoltativo chiamato durante lo smaltimento.
smaltire	protected	booleano	Il blocco attuale è attualmente in fase di eliminazione?
domToMutation?		(p1: Elemento) => null	(Facoltativo) Un metodo di deserializzazione facoltativo per definire la modalità di deserializzazione dello stato di mutazione da XML. Questo deve essere abbinato alla definizione di mutationToDom.
getDeveloperVariables?		() => stringa[]	(Facoltativo) Una proprietà facoltativa per dichiarare le variabili sviluppatore. Restituisce un elenco di nomi di variabili utilizzati dai generatori. Le variabili sviluppatore non vengono mai mostrate all'utente, ma vengono dichiarate come variabili globali nel codice generato.
cappello?		stringa	(Facoltativo) Nome del tipo di cappello.
helpUrl		stringa | Funzione | null	Stringa per la guida al blocco o funzione che restituisce un URL. Null per nessun aiuto.
icone		IIcon[]
id		stringa
init?		() => null	(Facoltativo) Un metodo facoltativo chiamato durante l'inizializzazione.
inputList		Ingresso[]
inputsInline?		booleano	(Facoltativo)
inputsInlineDefault?		booleano	(Facoltativo)
isInFlyout		booleano
isInMutator		booleano
isInsertionMarker_	protected	booleano	True se questo blocco è un indicatore di inserimento.
loadExtraState?		(p1: qualsiasi) => null	(Facoltativo) Un metodo di serializzazione facoltativo per definire come deserializzare lo stato aggiuntivo del blocco (ad esempio lo stato di mutazione) da un elemento compatibile con JSON. Questo deve essere abbinato alla definizione di saveExtraState.
mutationToDom?		(...p1: qualsiasi[]) => Elemento	(Facoltativo) Un metodo di serializzazione facoltativo per definire la modalità di serializzazione dello stato della mutazione in XML. Questo deve essere abbinato alla definizione di domToMutation.
nextConnection		Connessione | null
onchange?		((p1: Riassunto) => void) | null	(Facoltativo) Un metodo di callback facoltativo da utilizzare ogni volta che l'area di lavoro principale del blocco viene modificata. Di solito viene chiamato solo dal costruttore, dalla funzione di inizializzazione del tipo di blocco o da una funzione di inizializzazione delle estensioni.
outputConnection		Connessione | null
outputShape_	protected	numero | null
parentBlock_	protected	questo | null
previousConnection		Connessione | null
renderizzati	readonly	booleano	Questo blocco è un blocco SVG?
RTL		booleano
saveExtraState?		(doFullSerialization?: boolean) => qualsiasi	(Facoltativo) Un metodo di serializzazione facoltativo per definire come serializzare lo stato aggiuntivo del blocco (ad esempio lo stato di mutazione) in un formato compatibile con JSON. Questo deve essere abbinato alla definizione di loadExtraState.
styleName_	protected	stringa	Nome dello stile del blocco.
suppressPrefixSuffix		boolean | null	Una proprietà facoltativa per eliminare l'aggiunta di STATEMENT_POINTS e STATEMENT_SUFFIX al codice generato.
descrizione comando		Tooltip.TipInfo
type		stringa
workspace		Workspace

Metodi

Metodo	Modificatori	Descrizione
addIcon(icon)		Aggiunge al blocco l'icona specificata.
allInputsFilled(opt_shadowBlocksAreFilled)		Controlla in modo ricorsivo se tutti gli input di istruzioni e valori sono pieni di blocchi. Controlla anche tutti i seguenti blocchi di istruzioni in questo stack.
appendDummyInput(name)		Accede una riga di input fittizia.
appendEndRowInput(name)		Aggiunge un input che termina la riga.
appendInput(input)		Aggiunge la riga di input specificata. Consente di aggiungere input personalizzati al blocco.
appendStatementInput(name)		Accede una riga di input dell'istruzione.
appendValueInput(name)		Aggiunge una riga di input del valore.
bumpNeighbours()		Colpisci i blocchi scollegati fuori dall'allineamento. Due blocchi che non sono effettivamente collegati non dovrebbero necessariamente allinearsi sullo schermo.
dispose(healStack)		Smaltire questo blocco.
disposeInternal()	protected	Elimina questo blocco senza eseguire le operazioni richieste dal blocco in alto. Ad es. non attiva gli eventi, 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 valore e istruzioni, nonché qualsiasi istruzione riportata di seguito. Esclude qualsiasi connessione su una scheda di output o qualsiasi istruzione precedente. I blocchi sono facoltativamente ordinati per posizione; dall'alto verso il basso.
getColour()		Ottieni il colore di un blocco.
getCommentText()		Restituisce il commento su questo blocco (o null se non sono presenti commenti).
getDescendants(ordered)		Trova tutti i blocchi direttamente o indirettamente nidificati all'interno di questo. Include questo blocco nell'elenco. Include input di valore e istruzioni, nonché eventuali istruzioni riportate di seguito. Esclude qualsiasi connessione su una scheda di output o qualsiasi istruzione precedente. I blocchi sono facoltativamente ordinati per posizione; dall'alto verso il basso.
getDisabledReasons()		Scopri una serie di motivi per cui il blocco è attualmente disattivato, se presente. Se il blocco è attivato, questo insieme sarà vuoto.
getField(name)		Restituisce il campo denominato da un blocco.
getFieldValue(name)		Restituisce il valore indipendente dalla lingua del campo specificato.
getHue()		Consente di ottenere il valore di tonalità HSV di un blocco. Nullo se la tonalità non è impostata.
getIcon(type)
getIcons()
getInheritedDisabled()		Scopri se il blocco è stato disattivato o meno a causa dei genitori. 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 collegato all'input denominato.
getInputWithBlock(block)		Restituisce l'input che si collega al blocco specificato.
getNextBlock()		Restituisce il blocco di istruzioni successivo collegato direttamente a questo blocco.
getOutputShape()		Recupera la forma di output del blocco.
getParent()		Restituisce il blocco principale o nullo se questo blocco è al livello superiore. Il blocco padre è il blocco connesso alla connessione precedente (per un blocco istruzioni) o il blocco connesso alla connessione di output (per un blocco di valori).
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), in unità dell'area di lavoro.
getRootBlock()		Restituisci il blocco più in alto nell'albero del blocco. L'elemento verrà ripristinato se il blocco si trova al livello più alto.
getStyleName()		Visualizza il nome dello stile del blocco.
getSurroundParent()		Restituisce il blocco principale che circonda il blocco corrente oppure null se questo blocco non è circondato. Un blocco padre potrebbe essere semplicemente l'istruzione precedente, mentre il blocco circostante è un'istruzione if, un ciclo mentre e così via.
getTooltip()		Restituisce il testo della descrizione comando per questo blocco.
getVars()		Restituisce tutte le variabili a cui fa riferimento questo blocco.
hasDisabledReason(reason)		Scopri se il blocco è attualmente disattivato per il motivo specificato.
hasIcon(type)
initModel()		Richiama initModel in tutti i campi del blocco. Può essere chiamato più di una volta. È necessario chiamare initModel o initSvg dopo la creazione di un blocco e prima della prima interazione con questo. Le interazioni includono le azioni nell'interfaccia utente (ad es. clic e trascinamento) e gli eventi di attivazione (ad es. creazione, eliminazione e modifica).
isCollapsed()		Determina se il blocco è compresso o meno.
isDeletable()		Determina se il blocco può essere eliminato o meno.
isDisposed()		Restituisce un valore se questo blocco è stato eliminato / eliminato.
isDuplicatable()		Indica se il blocco è duplicato o meno. Se duplica questo blocco e i relativi discendenti, questo blocco verrà sovrapposto alla capacità dell'area di lavoro. Questo blocco non può essere duplicato. Se duplicando questo blocco e discendenti verrà inserito qualsiasi tipo sui rispettivi maxInstances questo blocco non è ripetibile.
isEnabled()		Scopri se questo blocco è attivato o meno. Un blocco viene considerato attivato se non ci sono motivi per cui viene disattivato. Un blocco può essere comunque disattivato per altri motivi anche se l'utente tenta di attivarlo manualmente, ad esempio quando il blocco si trova in una posizione non valida.
isInsertionMarker()		Determina se questo blocco è un blocco di indicatori di inserimento o meno.
isOwnDeletable()		Indica se la proprietà eliminabile del blocco è true o false.
isOwnEditable()		Indica se la proprietà modificabile del blocco è true o false.
isShadow()		Scopri se questo blocco è o meno un blocco ombra.
jsonInit(json)		Inizializza questo blocco utilizzando una descrizione JSON multipiattaforma e adatta all'internazionalizzazione.
mixin(mixinObj, opt_disableCheck)		Aggiungi coppie chiave-valore da mixinObj a questo oggetto blocco. Per impostazione predefinita, questo metodo verificherà che le chiavi in mixinObj non sovrascrivano i valori esistenti nel blocco, compresi i valori di prototipo. In questo modo si garantisce una certa sicurezza contro le incompatibilità tra combinazioni o estensioni con le future funzionalità di blocco. Questo controllo può essere disabilitato passando true come secondo argomento.
moveBy(dx, dy, reason)		Spostare un blocco di un offset relativo.
moveInputBefore(name, refName)		Sposta un input con nome in una posizione diversa di questo blocco.
moveNumberedInputBefore(inputIndex, refIndex)		Sposta un input numerato in un'altra posizione di 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 una variabile è stata rinominata. Se l'ID corrisponde a una delle variabili di questo blocco, rinominalo.
setCollapsed(collapsed)		Indica se il blocco è compresso o meno.
setColour(colour)		Modificare il colore di un blocco.
setCommentText(text)		Imposta il testo del commento di questo blocco.
setDeletable(deletable)		Imposta se il blocco può essere eliminato o meno.
setDisabledReason(disabled, reason)		Aggiungi o rimuovi un motivo per cui il blocco potrebbe essere disattivato. Se un blocco può essere disattivato, il blocco stesso verrà considerato disattivato. Un blocco può essere disattivato contemporaneamente per più motivi indipendenti, ad esempio quando l'utente lo disattiva manualmente o non è valido.
setEditable(editable)		Scegli se il blocco può essere modificato o meno.
setEnabled(enabled)
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 impostare se i valori inseriti sono disposti orizzontalmente o verticalmente.
setMovable(movable)		Specifica se il blocco è spostabile o meno.
setMutator(_mutator)		Aggiungi a questo blocco una finestra di dialogo mutatore.
setNextStatement(newBoolean, opt_check)		Consente di stabilire se un altro blocco può essere concatenato alla parte inferiore di questo blocco.
setOnChange(onchangeFn)		Imposta una funzione di callback da utilizzare ogni volta che l'area di lavoro principale del blocco cambia, sostituendo qualsiasi gestore onchange precedente. Di solito viene chiamato solo dal costruttore, dalla funzione di inizializzazione del tipo di blocco o da una funzione di inizializzazione delle estensioni.
setOutput(newBoolean, opt_check)		Imposta se questo blocco restituisce un valore.
setOutputShape(outputShape)		Imposta la forma di output del blocco.
setPreviousStatement(newBoolean, opt_check)		Imposta se questo blocco può essere concatenato alla 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 questo Blocco in termini di sviluppo (digita il nome e l'ID; solo in inglese). Da utilizzare nei log e negli errori della console. Se hai bisogno di una stringa che utilizzi la lingua nativa dell'utente (inclusi testo a blocchi, 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 blocco superiore. Se questo blocco è un'istruzione, facoltativamente ricollega il blocco sottostante a quello in alto.