Blockly | Google for Developers

Blockly verrà trasferito alla Raspberry Pi Foundation il 10 novembre 2025. Leggi il blog e le domande frequenti.

Questa pagina è stata tradotta dall'API Cloud Translation.

Classe Toolbox

Classe per una cassetta degli attrezzi. Crea il DOM della barra degli strumenti.

Firma:

export declare class Toolbox extends DeleteArea implements IAutoHideable, IKeyboardAccessible, IStyleable, IToolbox, IFocusableNode

Estende: DeleteArea

Implementa: IAutoHideable, IKeyboardAccessible, IStyleable, IToolbox, IFocusableNode

Costruttori

Costruttore	Modificatori	Descrizione
(constructor)(workspace)		Crea una nuova istanza della classe `Toolbox`

Proprietà

Proprietà	Modificatori	Tipo	Descrizione
boundEvents_	`protected`	browserEvents.Data[]	Array contenente le informazioni necessarie per annullare il binding dei gestori di eventi. Utilizzato per lo smaltimento. Esempio: [[node, name, func], [node, name, func]].
contenuti	`protected`	Map<string, IToolboxItem>	Mappa dall'ID all'elemento della casella degli strumenti corrispondente.
contentsDiv_	`protected`	HTMLDivElement \| null	Il contenitore HTML per i contenuti di una casella degli strumenti.
height_	`protected`	numero	L'altezza della barra degli strumenti.
HtmlDiv		HTMLDivElement \| null	Il contenitore HTML per la casella degli strumenti.
id		stringa	L'ID univoco di questo componente utilizzato per la registrazione in ComponentManager.
isVisible_	`protected`	booleano	Se la cassetta degli attrezzi è visibile.
previouslySelectedItem_	`protected`	ISelectableToolboxItem \| null	L'elemento selezionato in precedenza.
RTL		booleano
selectedItem_	`protected`	ISelectableToolboxItem \| null	L'elemento attualmente selezionato.
toolboxDef_	`protected`	toolbox.ToolboxInfo
toolboxPosition		toolbox.Position
width_	`protected`	numero	La larghezza della barra degli strumenti.
workspace_	`protected` `readonly`	WorkspaceSvg	Lo spazio di lavoro in cui si trova questo riquadro degli strumenti.

Metodi

Metodo	Modificatori	Descrizione
addToolboxItem_(toolboxItem)	`protected`	Aggiunge un elemento alla casella degli strumenti.
attachEvents_(container, contentsContainer)	`protected`	Aggiunge listener di eventi al contenitore div della casella degli strumenti.
autoHide(onlyClosePopups)		Nasconde il componente. Chiamato in WorkspaceSvg.hideChaff.
canBeFocused()		Consulta IFocusableNode.canBeFocused.
clearSelection()		Deseleziona qualsiasi elemento selezionato in precedenza.
createContainer_()	`protected`	Crea il div del contenitore per la casella degli strumenti.
createContentsContainer_()	`protected`	Crea il contenitore per tutti i contenuti della casella degli strumenti.
createDom_(workspace)	`protected`	Crea il DOM per la casella degli strumenti.
createFlyout_()	`protected`	Crea il riquadro basato sul layout della barra degli strumenti.
deselectItem_(item)	`protected`	Deseleziona l'elemento specificato, lo contrassegna come non selezionato e aggiorna lo stato aria.
dispose()		Elimina questo riquadro degli strumenti.
getClientRect()		Restituisce il rettangolo di selezione dell'area di destinazione del trascinamento in unità di pixel rispetto al viewport.
getFlyout()		Visualizza il riquadro a comparsa della cassetta degli attrezzi.
getFocusableElement()		Vedi IFocusableNode.getFocusableElement.
getFocusableTree()		Consulta IFocusableNode.getFocusableTree.
getHeight()		Restituisce l'altezza della barra degli strumenti.
getNestedTrees()		Vedi IFocusableTree.getNestedTrees.
getPreviouslySelectedItem()		Recupera l'elemento selezionato in precedenza.
getRestoredFocusableNode(previousNode)		Vedi IFocusableTree.getRestoredFocusableNode.
getRootFocusableNode()		Vedi IFocusableTree.getRootFocusableNode.
getSelectedItem()		Recupera l'elemento selezionato.
getToolboxItemById(id)		Recupera l'elemento della casella degli strumenti con l'ID specificato.
getToolboxItems()		Recupera gli elementi nella casella degli strumenti.
getWidth()		Restituisce la larghezza della barra degli strumenti.
getWorkspace()		Recupera lo spazio di lavoro per la casella degli strumenti.
init()		Inizializza la casella degli strumenti
isHorizontal()		Indica se la barra degli strumenti è orizzontale.
lookUpFocusableNode(id)		Vedi IFocusableTree.lookUpFocusableNode.
onClick_(e)	`protected`	Gestisce gli eventi di clic quando si fa clic sulla barra degli strumenti o sui relativi elementi.
onDragEnter(_dragElement)		Gestisce l'ingresso di un cursore con un blocco o una bolla in questa destinazione di trascinamento.
onDragExit(_dragElement)		Gestisce l'uscita di un cursore con un blocco o una bolla da questa destinazione di trascinamento.
onDrop(_dragElement)		Gestisce quando un blocco o una bolla viene rilasciato su questo componente. Should not handle delete here.
onKeyDown_(e)	`protected`	Gestisce gli eventi di pressione dei tasti per la casella degli strumenti.
onNodeBlur()		Vedi IFocusableNode.onNodeBlur.
onNodeFocus()		Consulta IFocusableNode.onNodeFocus.
onShortcut(_shortcut)		Gestisce la scorciatoia da tastiera specificata.
onTreeBlur(nextTree)		Consulta IFocusableTree.onTreeBlur.
onTreeFocus(node, _previousTree)		Consulta IFocusableTree.onTreeFocus.
position()		Posiziona la barra degli strumenti in base al fatto che sia orizzontale e che lo spazio di lavoro sia in modalità da destra a sinistra.
refreshSelection()		Aggiorna i contenuti del riquadro senza chiuderlo. Deve essere utilizzato in risposta a una modifica di una delle categorie dinamiche, ad esempio variabili o procedure.
renderContents_(toolboxDef)	`protected`	Aggiunge tutti gli elementi della casella degli strumenti alla casella degli strumenti.
selectItem_(oldItem, newItem)	`protected`	Seleziona l'elemento specificato, lo contrassegna come selezionato e aggiorna lo stato aria.
selectItemByPosition(position)		Seleziona l'elemento della casella degli strumenti in base alla sua posizione nell'elenco degli elementi della casella degli strumenti.
setSelectedItem(newItem)		Imposta l'elemento specificato come selezionato. Nessuna operazione se l'elemento non è selezionabile.
setVisible(isVisible)		Mostra o nasconde la casella degli strumenti.
shouldDeselectItem_(oldItem, newItem)	`protected`	Decide se il vecchio elemento deve essere deselezionato.
shouldSelectItem_(oldItem, newItem)	`protected`	Determina se il nuovo elemento deve essere selezionato.
updateCursorDeleteStyle_(addStyle)	`protected`	Aggiunge o rimuove lo stile CSS del cursore sopra la casella degli strumenti in base al fatto che il blocco o la bolla sopra di esso debba essere eliminato se rilasciato (utilizzando la proprietà interna this.wouldDelete_).
updateFlyout_(oldItem, newItem)	`protected`	Decide se nascondere o mostrare il riquadro in base all'elemento selezionato.
updateWouldDelete_(wouldDelete)	`protected`	Aggiorna lo stato interno wouldDelete_.
wouldDelete(element)		Restituisce un valore che indica se il blocco o la bolla forniti verrebbero eliminati se rilasciati in questa area. Questo metodo deve verificare se l'elemento è eliminabile e viene sempre chiamato prima di onDragEnter/onDragOver/onDragExit.