Block Group provides organization and functionality to multiple Block components.

Overview

Sample

Usage

  • Contain related Block components, most often within a Panel
  • Support dragEnabled workflows for Blocks

API reference

Properties

PropertyAttributeDescriptionTypeDefault
canPull

When provided, the method will be called to determine whether the element can move from the component.

(detail: BlockDragDetail) => boolean | "clone"
canPut

When provided, the method will be called to determine whether the element can be added from another component.

(detail: BlockDragDetail) => boolean
disableddisabled

When true, interaction is prevented and the component is displayed with lower opacity.

booleanfalse
dragEnableddrag-enabled

When true, calcite-blocks are sortable via a draggable button.

booleanfalse
groupgroup

Specifies the component's group identifier.

To drag elements from one group into another, both groups must have the same group value.

string | undefined
labelrequiredlabel

Specifies an accessible label for the component.

When dragEnabled is true and multiple group sorting is enabled with group, specifies the component's name for dragging between groups.

string
loadingloading

When true, a busy indicator is displayed.

booleanfalse
scalescale

Specifies the size of the component.

Scale"m"
sortDisabledsort-disabled

When true, and a group is defined, calcite-blocks are no longer sortable.

booleanfalse

Slots

NameDescription
default (unnamed)

A slot for adding calcite-block elements.

Events

NameDescriptionBehavior
calciteBlockGroupDragEnd

Fires when the component's dragging has ended.

bubblescomposed
calciteBlockGroupDragStart

Fires when the component's dragging has started.

bubblescomposed
calciteBlockGroupMoveHalt
deprecatedin v3.3.0, removal target v6.0.0 - No longer necessary.

Fires when a user attempts to move an element using the sort menu and 'canPut' or 'canPull' returns falsy.

bubblescomposed
calciteBlockGroupOrderChange

Fires when the component's item order changes.

bubblescomposed

Methods

NameDescriptionSignature
componentOnReady

Creates a promise that resolves once the component is fully loaded.

componentOnReady(): Promise<this>
setFocus

Sets focus on the component's first focusable element.

setFocus(options?: FocusOptions): Promise<void>

Your browser is no longer supported. Please upgrade your browser for the best experience. See our browser deprecation post for more details.