blockly

blockly 패키지

클래스

클래스 설명
차단 한 블록의 클래스입니다. 일반적으로 직접 호출되지 않으며 workspace.newBlock()을 사용하는 것이 좋습니다.
BlockFlyoutInflater 플라이아웃 블록을 만드는 클래스입니다.
BlockNavigationPolicy 블록에서 키보드 탐색을 제어하는 규칙 집합입니다.
BlockSvg 블록의 SVG 표현을 위한 클래스입니다. 일반적으로 직접 호출되지 않으며 workspace.newBlock()을 사용하는 것이 좋습니다.
ButtonFlyoutInflater 플라이아웃 버튼을 만드는 클래스입니다.
CodeGenerator 블록을 언어로 변환하는 코드 생성기의 클래스입니다.
CollapsibleToolboxCategory 접을 수 있는 도구 상자의 카테고리 클래스입니다.
ComponentManager 워크스페이스에 등록된 모든 항목의 관리자입니다.
연결 블록 간의 연결을 위한 클래스입니다.
ConnectionChecker 연결 유형 확인 로직의 클래스입니다.
ConnectionDB 연결 데이터베이스입니다. 연결은 세로 구성요소의 순서대로 저장됩니다. 이렇게 하면 이진 검색을 사용하여 특정 영역의 연결을 빠르게 조회할 수 있습니다.
ConnectionNavigationPolicy 연결에서 키보드 탐색을 제어하는 규칙 집합입니다.
ContextMenuRegistry 컨텍스트 메뉴 항목 레지스트리의 클래스입니다. 이는 싱글톤으로 설계되었습니다. 새 인스턴스를 만들지 말고 ContextMenuRegistry.registry에서만 이 클래스에 액세스해야 합니다.
DeleteArea 그 위에 배치된 블록이나 풍선을 삭제할 수 있는 구성요소의 추상 클래스입니다.
DragTarget 블록이나 버블이 위로 드래그되거나 그 위에 놓일 때 맞춤 동작이 있는 구성요소의 추상 클래스입니다.
FieldCheckbox 체크박스 필드의 클래스입니다.
FieldDropdown 수정 가능한 드롭다운 필드의 클래스입니다.
FieldImage 블록의 이미지 클래스입니다.
FieldLabel 수정 불가하고 직렬화 불가능한 텍스트 필드의 클래스입니다.
FieldLabelSerializable 수정할 수 없는 직렬화 가능한 텍스트 필드의 클래스입니다.
FieldNavigationPolicy 필드에서 키보드 탐색을 제어하는 규칙 집합입니다.
FieldNumber 수정 가능한 숫자 필드의 클래스입니다.
FieldTextInput 수정 가능한 텍스트 필드의 클래스입니다.
FieldVariable 변수의 드롭다운 필드 클래스입니다.
FlyoutButton 플라이아웃의 버튼 또는 라벨 클래스입니다.
FlyoutButtonNavigationPolicy 플라이아웃 버튼에서 키보드 탐색을 제어하는 규칙 집합입니다.
FlyoutItem 플라이아웃에 표시되는 항목의 표현입니다.
FlyoutMetricsManager 플라이아웃의 워크스페이스에 대한 측정항목을 계산합니다. 이 측정항목은 주로 플라이아웃의 스크롤바 크기를 조절하는 데 사용됩니다.
FlyoutNavigationPolicy 플라이아웃의 항목 간에 이동하는 일반 탐색 정책입니다.
FlyoutNavigator
FlyoutSeparator 플라이아웃의 요소 간 간격을 나타냅니다.
FlyoutSeparatorNavigationPolicy 플라이아웃 구분자에서 키보드 탐색을 제어하는 규칙 집합입니다. 플라이아웃 구분자를 탐색할 수 없으므로 이 자리표시자는 아무 작업도 하지 않습니다.
FocusableTreeTraverser 일반적인 트리 탐색을 지원하는 IFocusableTree 구현을 위한 도우미 유틸리티입니다.
FocusManager

하나 이상의 IFocusableTrees에서 Blockly 포커스를 관리하고 이 포커스를 DOM과 양방향으로 동기화하는 페이지별 싱글톤입니다.

페이지에서 선택한 Blockly 구성요소의 입력 포커스를 명시적으로 변경하려는 호출자는 이 관리자의 포커스 함수를 사용해야 합니다.

관리자는 DOM의 포커스 이벤트 (사용자가 페이지 요소를 클릭할 때 발생할 수 있음)를 처리하고 해당 IFocusableNodes가 focusNode() 호출로 표시되는 것과 동일한 방식으로 적극적으로/수동적으로 강조 표시되도록 명확하게 표시합니다.

동작 하나의 동작에 관한 클래스입니다.
그리드 워크스페이스 그리드의 클래스입니다.
HorizontalFlyout 플라이아웃의 클래스입니다.
입력 선택사항 필드가 있는 입력의 클래스입니다.
InsertionMarkerPreviewer
LabelFlyoutInflater 플라이아웃 라벨을 만드는 클래스입니다.
LineCursor 선 커서의 클래스입니다.
Marker 마커의 클래스입니다. 키보드 탐색에서 Blockly AST에 위치를 저장하는 데 사용됩니다.
MarkerManager 워크스페이스에서 여러 마커와 커서를 관리하는 클래스입니다.
메뉴 기본 메뉴 클래스
MenuItem 메뉴의 항목을 나타내는 클래스입니다.
MetricsManager 모든 워크스페이스 측정항목 계산의 관리자입니다.
이름 항목 이름 (변수, 프로시저 등) 데이터베이스의 클래스입니다.
Navigator 키보드 탐색 명령에 대한 응답으로 포커스가 이동해야 하는 위치를 결정하는 클래스입니다.
옵션 동작이 지정되지 않은 경우 적절한 기본값을 사용하여 사용자 지정 옵션을 파싱합니다.
RenderedConnection 화면에 렌더링될 수 있는 블록 간의 연결을 위한 클래스입니다.
스크롤바 순수 SVG 스크롤바의 클래스입니다. 이 기법은 작동이 보장되지만 시스템의 스크롤바처럼 보이거나 작동하지 않을 수 있는 스크롤바를 제공합니다.
ScrollbarPair 스크롤바 쌍의 클래스입니다. 가로 및 세로
SeparatorFlyoutInflater 플라이아웃의 구분자를 만드는 클래스입니다.
ShortcutRegistry 단축키 레지스트리의 클래스입니다. 이는 싱글톤으로 설계되었습니다. 새 인스턴스를 만들지 말고 ShortcutRegistry.registry에서만 이 클래스에 액세스해야 합니다.
테마 테마의 클래스입니다.
ThemeManager 워크스페이스의 테마와 UI 구성요소를 저장하고 업데이트하는 클래스입니다.
Toast 임시 알림을 표시하고 닫을 수 있는 클래스입니다.
도구 상자 도구 상자의 클래스입니다. 도구 상자의 DOM을 만듭니다.
ToolboxCategory 도구 상자의 카테고리 클래스입니다.
ToolboxItem 도구 상자의 항목에 관한 클래스입니다.
ToolboxSeparator 도구 상자 구분자의 클래스입니다. 툴박스에 표시되는 얇은 시각적 선입니다. 이 항목은 상호작용할 수 없습니다.
휴지통 휴지통 클래스
UnattachedFieldError 필드가 실제로 블록에 연결되기 전에 블록 또는 블록에 관한 정보에 액세스하려고 시도하는 오류를 나타냅니다.
VariableMap 변수 맵의 클래스입니다. 여기에는 변수 유형이 키이고 변수 목록이 값인 사전 데이터 구조가 포함됩니다. 변수 목록은 키로 표시된 유형입니다.
VariableModel 변수 모델의 클래스입니다. 이름, ID, 유형을 비롯한 변수의 정보를 보유합니다.
VerticalFlyout 플라이아웃의 클래스입니다.
Workspace 워크스페이스의 클래스입니다. 블록을 포함하는 데이터 구조입니다. UI가 없으며 헤드리스로 만들 수 있습니다.
WorkspaceAudio 워크스페이스의 오디오를 로드, 저장, 재생하는 클래스입니다.
WorkspaceDragger 워크스페이스 드래거의 클래스입니다. 마우스나 터치로 드래그할 때 작업공간을 움직입니다.
WorkspaceNavigationPolicy 워크스페이스에서 키보드 탐색을 제어하는 규칙 집합입니다.
WorkspaceSvg 워크스페이스의 클래스입니다. 휴지통, 스크롤바, 풍선, 드래그(선택사항)가 있는 화면 영역입니다.
ZoomControls 확대/축소 컨트롤 클래스

추상 클래스

추상 클래스 설명
필드 수정 가능한 필드의 추상 클래스입니다.
플라이아웃 플라이아웃의 클래스입니다.

열거

열거 설명
ConnectionType 연결 또는 입력 유형의 enum입니다.

함수

함수 설명
getFocusManager() FocusManager.getFocusManager의 편의 함수입니다.
hasBubble(obj) 지정된 객체가 IHasBubble인지 확인하는 유형 가드입니다.
hideChaff(opt_onlyClosePopups) 도움말, 컨텍스트 메뉴, 드롭다운 선택사항 등을 닫습니다.
inject(container, opt_options) 지정된 컨테이너 요소 (일반적으로 div)에 Blockly 편집기를 삽입합니다.
isCopyable(obj)
isDeletable(obj) 지정된 객체가 IDeletable인지 여부를 반환합니다.
isDraggable(obj) 지정된 객체가 IDraggable인지 여부를 반환합니다.
isIcon(obj) 지정된 객체가 IIcon인지 확인하는 유형 가드입니다.
isPaster(obj)
isRenderedElement(obj)
isSelectable(obj) 지정된 객체가 ISelectable인지 확인합니다.
isSerializable(obj) 지정된 객체가 ISerializable인지 확인하는 유형 가드입니다.
isVariableBackedParameterModel(param) 지정된 객체가 변수 홀더인지 여부를 반환합니다.
setLocale(locale)

언어 (예: 현지화된 메시지/블록 텍스트 등)를 지정된 언어로 설정합니다.

메시지는 Blockly.Msg 객체에 자동으로 연결되므로 스크립트 태그에서 로드할 때는 유용하지도 필요하지도 않습니다. 하지만 tscompiler가 유형 정의 파일을 올바르게 만들 수 있도록 스크립트 태그 컨텍스트와 스크립트 태그가 아닌 컨텍스트 모두에 제공합니다.

인터페이스

인터페이스 설명
BlocklyOptions Blockly 옵션
FieldCheckboxConfig 체크박스 필드의 구성 옵션입니다.
FieldCheckboxFromJsonConfig 체크박스 필드의 fromJson 구성 옵션
FieldConfig 기본 필드의 추가 구성 옵션입니다.
FieldDropdownFromJsonConfig 드롭다운 필드의 fromJson 구성
FieldImageConfig 이미지 필드의 구성 옵션입니다.
FieldImageFromJsonConfig 이미지 필드의 fromJson 구성 옵션입니다.
FieldLabelConfig 라벨 필드의 구성 옵션입니다.
FieldLabelFromJsonConfig 라벨 필드의 fromJson 구성 옵션
FieldNumberConfig 숫자 필드의 구성 옵션입니다.
FieldNumberFromJsonConfig 숫자 필드의 fromJson 구성 옵션
FieldTextInputFromJsonConfig 텍스트 입력란의 fromJson 구성 옵션
FieldVariableConfig 변수 필드의 구성 옵션입니다.
FieldVariableFromJsonConfig 변수 필드의 fromJson 구성 옵션
IAutoHideable 자동으로 숨길 수 있는 구성요소의 인터페이스입니다.
IBoundedElement 결합된 요소 인터페이스
IBubble 풍선 인터페이스
ICollapsibleToolboxItem 축소할 수 있는 도구 상자의 항목을 위한 인터페이스입니다.
IComponent ComponentManager에 등록할 수 있는 워크스페이스 구성요소의 인터페이스입니다.
IConnectionChecker 연결 유형 확인 로직의 클래스입니다.
IConnectionPreviewer 블록을 배치할 때 연결될 위치의 시각적 '미리보기'를 표시합니다.
IContextMenu
ICopyable
IDeletable 삭제할 수 있는 객체의 인터페이스입니다.
IDeleteArea 그 위에 드롭된 블록이나 풍선을 삭제할 수 있는 구성요소의 인터페이스입니다.
IDraggable 드래그할 수 있는 객체를 나타냅니다.
IDragger
IDragStrategy
IDragTarget 블록이나 버블이 위로 드래그되거나 그 위에 놓일 때 맞춤 동작이 있는 구성요소의 인터페이스입니다.
IFlyout 플라이아웃의 인터페이스입니다.
IFlyoutInflater
IFocusableNode 입력 포커스를 가질 수 있는 모든 항목을 나타냅니다.
IFocusableTree

자체 활성/수동 포커스 컨텍스트가 있는 포커스할 수 있는 요소의 트리를 나타냅니다.

포커스는 FocusManager에서 처리하며, 트리 구현은 한 번에 하나의 IFocusableNode에 포커스를 설정할 수 있습니다. 트리 자체에 포커스가 있는 경우 트리의 포커스가 있는 노드는 '활성'으로 간주됩니다(다른 트리에 포커스가 있는 경우 '수동').

포커스는 하나 이상의 트리 간에 공유되며, 각 트리에는 활성 노드 또는 패시브 노드가 정확히 하나씩 있을 수 있습니다. 또한 특정 시점에 전체 페이지에 활성 노드는 하나만 있을 수 있습니다. 수동 포커스의 개념은 이전에 포커스가 설정된 트리로 다시 이동할 때 포커스가 복원되는 위치에 관한 컨텍스트를 사용자에게 제공하는 것입니다.

트리의 현재 포커스가 있는 노드 (수동 또는 활성)가 필요한 경우 FocusableTreeTraverser.findFocusedNode를 사용할 수 있습니다.

이 트리에서 특정 노드를 검색해야 하는 경우 lookUpFocusableNode 또는 FocusableTreeTraverser.findFocusableNodeFor를 사용하세요.

IHasBubble
IIcon
IKeyboardAccessible 단축키를 처리하는 객체의 인터페이스입니다.
ImageProperties 사람이 읽을 수 있는 이미지 드롭다운 옵션의 정의입니다.
IMetricsManager 측정항목 관리자의 인터페이스입니다.
IMovable 이동 가능한 객체의 인터페이스입니다.
INavigationPolicy 키보드 탐색이 진행되어야 하는 위치를 지정하는 규칙 집합입니다.
IPaster 데이터를 워크스페이스에 붙여넣을 수 있는 객체입니다.
IPositionable 워크스페이스 위에 배치되는 구성요소의 인터페이스입니다.
IRegistrable 등록할 수 있는 Blockly 구성요소의 인터페이스입니다.
IRenderedElement
ISelectable

선택 가능한 객체의 인터페이스입니다.

일반적으로 구현은 선택이 올바르게 업데이트되고 선택 변경 이벤트가 실행되도록 하기 위해 onNodeFocus() 및 onNodeBlur() 구현을 사용하여 각각 자신과 null로 setSelected()를 호출해야 합니다.

ISelectableToolboxItem 선택할 수 있는 도구 상자 항목의 인터페이스입니다.
ISerializable
IStyleable 스타일을 추가할 수 있는 객체의 인터페이스입니다.
IToolbox 도구 상자의 인터페이스입니다.
IToolboxItem 도구 상자의 항목을 위한 인터페이스입니다.
IVariableBackedParameterModel 변수 모델을 보유하는 매개변수 모델의 인터페이스입니다.
IVariableMap

변수 맵은 워크스페이스에서 참조되는 변수 집합을 저장하고 관리하는 컨테이너 객체입니다.

이러한 메서드는 유효한 이름과 유형에 관한 불변식을 정의하고 충족되지 않으면 발생할 수 있습니다.

IVariableModel
IVariableState 지정된 변수의 상태를 나타냅니다.
ToastOptions 토스트 알림의 표시/구성 옵션입니다.

네임스페이스

네임스페이스 설명
차단
blockAnimations
blockRendering
browserEvents
거품
bumpObjects
클립보드
CollapsibleToolboxCategory
comments
common
ComponentManager
상수
ContextMenu
ContextMenuItems
ContextMenuRegistry
CSS
dialog
드래그
이벤트
확장 프로그램
fieldRegistry
geras
아이콘
ICopyable
inputs
레이어
libraryBlocks
MetricsManager
이름
옵션
절차
registry
RenderedConnection
renderManagement
직렬화
ShortcutItems
ShortcutRegistry
테마
ThemeManager
테마
thrasos
Toast 스크린 리더에서 토스트를 얼마나 적극적으로 읽어줄지 지정하는 옵션입니다. 값은 aria-live의 값에 해당합니다.
ToolboxCategory
ToolboxSeparator
도움말
터치
uiPosition
utils
변수
VariablesDynamic
WidgetDiv
Xml
zelos

변수

변수 설명
차단 블록 유형 이름을 블록 프로토타입 객체에 매핑합니다.
COLLAPSE_CHARS
COLLAPSED_FIELD_NAME
COLLAPSED_INPUT_NAME
config 개발자가 변경할 수 있는 것으로 예상되는 Blockly의 모든 값을 보유하는 객체입니다.
defineBlocksWithJsonArray Blockly 개발자 도구에서 생성할 수 있는 JSON 블록 정의 배열에서 블록을 정의합니다.
DELETE_VARIABLE_ID
DropDownDiv
getMainWorkspace 기본 워크스페이스를 반환합니다. 포커스를 기반으로 마지막으로 사용된 기본 워크스페이스를 반환합니다. 특히 페이지에 Blockly 인스턴스가 여러 개인 경우 이 함수를 사용하지 않는 것이 좋습니다.
getSelected 현재 선택된 복사 가능한 객체를 반환합니다.
INPUT_VALUE
자바스크립트
Msg 현지화된 메시지의 사전입니다.
NEXT_STATEMENT
OPPOSITE_TYPE
OUTPUT_VALUE
PREVIOUS_STATEMENT
PROCEDURE_CATEGORY_NAME 툴박스 XML의 카테고리 '맞춤' 속성에 사용할 문자열입니다. 이 문자열은 카테고리를 프로시저 블록으로 동적으로 채워야 함을 나타냅니다.
RENAME_VARIABLE_ID
setParentContainer 상위 컨테이너를 설정합니다. Blockly.inject가 처음 호출될 때 WidgetDiv, dropDownDiv, Tooltip이 렌더링되는 컨테이너 요소입니다. 이 메서드는 첫 번째 Blockly.inject 후에 호출되면 NOP입니다.
svgResize 컨테이너를 완전히 채우도록 SVG 이미지의 크기를 조정합니다. 뷰의 크기가 실제로 변경될 때 (예: 창 크기 조절/기기 방향 변경 시) 호출합니다. 콘텐츠가 변경될 때 (예: 블록이 추가되거나 삭제될 때) 작업공간 크기를 조절하려면 workspace.resizeContents를 참고하세요. SVG 이미지의 높이/너비를 기록합니다.
TOOLBOX_AT_BOTTOM
TOOLBOX_AT_LEFT
TOOLBOX_AT_RIGHT
TOOLBOX_AT_TOP
VARIABLE_CATEGORY_NAME 툴박스 XML의 카테고리 '맞춤' 속성에 사용할 문자열입니다. 이 문자열은 카테고리를 변수 블록으로 동적으로 채워야 함을 나타냅니다.
VARIABLE_DYNAMIC_CATEGORY_NAME 툴박스 XML의 카테고리 '맞춤' 속성에 사용할 문자열입니다. 이 문자열은 카테고리를 변수 블록으로 동적으로 채워야 함을 나타냅니다.
버전 Blockly 핵심 버전입니다. 이 상수는 빌드 스크립트 (npm run build)에 의해 package.json의 버전 값으로 재정의됩니다. 이는 buildCompressed gulp 작업에서 Closure 컴파일러에 의해 실행됩니다. 로컬 빌드의 경우 컴파일러에 --define='Blockly.VERSION=X.Y.Z'를 전달하여 이 상수를 재정의할 수 있습니다.

유형 별칭

유형 별칭 설명
FieldCheckboxValidator 필드 값의 변경사항을 설정하기 전에 검사하기 위해 호출되는 함수입니다.
FieldDropdownConfig 드롭다운 필드의 구성 옵션입니다.
FieldDropdownValidator 필드 값의 변경사항을 설정하기 전에 검사하기 위해 호출되는 함수입니다.
FieldNumberValidator 필드 값의 변경사항을 설정하기 전에 검사하기 위해 호출되는 함수입니다.
FieldTextInputConfig 텍스트 입력란의 구성 옵션입니다.
FieldTextInputValidator 필드 값의 변경사항을 설정하기 전에 검사하기 위해 호출되는 함수입니다.
FieldValidator 필드 값의 변경사항을 설정하기 전에 검사하기 위해 호출되는 함수입니다.
FieldVariableValidator 필드 값의 변경사항을 설정하기 전에 검사하기 위해 호출되는 함수입니다.
ICopyData
MenuGenerator 메뉴 옵션 배열 또는 FieldDropdown 또는 그 하위 요소의 메뉴 옵션 배열을 생성하는 함수입니다.
MenuGeneratorFunction FieldDropdown 또는 그 하위 요소의 메뉴 옵션 배열을 생성하는 함수입니다.
MenuOption 드롭다운 메뉴의 개별 옵션입니다. 메뉴 구분자 항목의 경우 문자열 리터럴 separator이고 일반 작업 메뉴 항목의 경우 배열일 수 있습니다. 후자의 경우 첫 번째 요소는 사람이 읽을 수 있는 값 (텍스트, ImageProperties 객체 또는 HTML 요소)이고 두 번째 요소는 언어 중립적인 값입니다.
ReturnEphemeralFocus

일시적인 UI 흐름 (예: 대화상자)을 완료할 때 FocusManager에 포커스를 반환하기 위한 유형 선언입니다.

자세한 내용은 FocusManager.takeEphemeralFocus를 참고하세요.