Clickable
A generic interactive container component that provides a flexible alternative for custom interactive elements not achievable with existing components like Button or Link. Use it to apply specific styling such as backgrounds, padding, or borders.
Anchor to propertiesProperties
A label that describes the purpose or contents of the element. When set, it will be announced to users using assistive technologies and will provide them with more context.
Only use this when the element's content is not enough context for users using assistive technologies.
Sets the semantic meaning of the component’s content. When set, the role will be used by assistive technologies to help users navigate the page.
Changes the visibility of the element.
visible
: the element is visible to all users.hidden
: the element is removed from the accessibility tree but remains visible.exclusive
: the element is visually hidden but remains in the accessibility tree.
Adjust the background of the element.
Adjust the block size.
Set the border via the shorthand property.
This can be a size, optionally followed by a color, optionally followed by a style.
If the color is not specified, it will be base
.
If the style is not specified, it will be auto
.
Values can be overridden by ,
, and
.
Set the color of the border.
If set, it takes precedence over the border
property's color.
Set the radius of the border.
1-to-4-value syntax is supported. Note that, contrary to the CSS, it uses flow-relative values and the order is:
- 4 values:
start-start start-end end-end end-start
- 3 values:
start-start (start-end & end-start) start-end
- 2 values:
(start-start & end-end) (start-end & end-start)
For example:
small-100
means start-start, start-end, end-end and end-start border radii aresmall-100
.small-100 none
means start-start and end-end border radii aresmall-100
, start-end and end-start border radii arenone
.small-100 none large-100
means start-start border radius issmall-100
, start-end border radius isnone
, end-end border radius islarge-100
and end-start border radius isnone
.small-100 none large-100 small-100
means start-start border radius issmall-100
, start-end border radius isnone
, end-end border radius islarge-100
and end-start border radius issmall-100
.
Set the style of the border.
If set, it takes precedence over the border
property's style.
Like CSS, up to 4 values can be specified.
If one value is specified, it applies to all sides.
If two values are specified, they apply to the block sides and inline sides respectively.
If three values are specified, they apply to the block-start, both inline sides, and block-end respectively.
If four values are specified, they apply to the block-start, block-end, inline-start, and inline-end sides respectively.
Set the width of the border.
If set, it takes precedence over the border
property's width.
Like CSS, up to 4 values can be specified.
If one value is specified, it applies to all sides.
If two values are specified, they apply to the block sides and inline sides respectively.
If three values are specified, they apply to the block-start, both inline sides, and block-end respectively.
If four values are specified, they apply to the block-start, block-end, inline-start, and inline-end sides respectively.
Sets the action the should take when this clickable is activated.
See the documentation of particular components for the actions they support.
--auto
: a default action for the target component.--show
: shows the target component.--hide
: hides the target component.--toggle
: toggles the target component.
ID of a component that should respond to activations (e.g. clicks) on this component.
See command
for how to control the behavior of the target.
Disables the clickable, meaning it cannot be clicked or receive focus.
In this state, onClick will not fire. If the click event originates from a child element, the event will immediately stop propagating from this element.
However, items within the clickable can still receive focus and be interacted with.
This has no impact on the visual state by default, but developers are encouraged to style the clickable accordingly.
Sets the outer display type of the component. The outer type sets a component's participation in flow layout.
auto
the component's initial value. The actual value depends on the component and context.none
hides the component from display and removes it from the accessibility tree, making it invisible to screen readers.
Causes the browser to treat the linked URL as a download with the string being the file name. Download only works for same-origin URLs, or the blob: and data: schemes.
The URL to link to.
- If set, it will navigate to the location specified by
href
after executing theclick
event. - If a
is set, the
command
will be executed instead of the navigation.
Adjust the inline size.
Disables the clickable, and indicates to assistive technology that the loading is in progress.
This also disables the clickable.
Adjust the maximum block size.
Adjust the maximum inline size.
Adjust the minimum block size.
Adjust the minimum inline size.
Sets the overflow behavior of the element.
hidden
: clips the content when it is larger than the element’s container. The element will not be scrollable and the users will not be able to access the clipped content by dragging or using a scroll wheel on a mouse.visible
: the content that extends beyond the element’s container is visible.
Adjust the padding of all edges.
1-to-4-value syntax (@see https://developer.mozilla.org/en-US/docs/Web/CSS/Shorthand_properties#edges_of_a_box) is supported. Note that, contrary to the CSS, it uses flow-relative values and the order is:
- 4 values:
block-start inline-end block-end inline-start
- 3 values:
block-start inline block-end
- 2 values:
block inline
For example:
large
means block-start, inline-end, block-end and inline-start paddings arelarge
.large none
means block-start and block-end paddings arelarge
, inline-start and inline-end paddings arenone
.large none large
means block-start padding islarge
, inline-end padding isnone
, block-end padding islarge
and inline-start padding isnone
.large none large small
means block-start padding islarge
, inline-end padding isnone
, block-end padding islarge
and inline-start padding issmall
.
A padding value of auto
will use the default padding for the closest container that has had its usual padding removed.
padding
also accepts a container query string with the supported PaddingKeyword as a query value e.g. (@container (inline-size > 500px) large-300, small-300
)
This also accepts up to 4 values (e.g. @container (inline-size > 500px) large-300 small-300 large-100 small-100, small-200
)
Adjust the block-padding.
large none
means block-start padding islarge
, block-end padding isnone
.
This overrides the block value of padding
.
also accepts a container query string with the supported PaddingKeyword as a query value e.g. (
@container (inline-size > 500px) large-300, small-300
)
This also accepts up to 2 values (e.g. @container (inline-size > 500px) large-300 small-300, small-200
)
Adjust the block-end padding.
This overrides the block-end value of .
also accepts a container query string with the supported PaddingKeyword as a query value e.g. (
@container (inline-size > 500px) large-300, small-300
)
This only accepts up to 1 value per predicate (e.g. @container (inline-size > 500px) large-300, small-200
)
Adjust the block-start padding.
This overrides the block-start value of .
also accepts a container query string with the supported PaddingKeyword as a query value e.g. (
@container (inline-size > 500px) large-300, small-300
)
This only accepts 1 value per predicate (e.g. @container (inline-size > 500px) large-300, small-200
)
Adjust the inline padding.
large none
means inline-start padding islarge
, inline-end padding isnone
.
This overrides the inline value of padding
.
also accepts a container query string with the supported PaddingKeyword as a query value e.g. (
@container (inline-size > 500px) large-300, small-300
)
This also accepts up to 2 values (e.g. @container (inline-size > 500px) large-300 small-300, small-200
)
Adjust the inline-end padding.
This overrides the inline-end value of .
also accepts a container query string with the supported PaddingKeyword as a query value e.g. (
@container (inline-size > 500px) large-300, small-300
) This only accepts 1 value per predicate (e.g. @container (inline-size > 500px) large-300, small-200
)
Adjust the inline-start padding.
This overrides the inline-start value of .
also accepts a container query string with the supported PaddingKeyword as a query value e.g. (
@container (inline-size > 500px) large-300, small-300
) This only accepts 1 value per predicate (e.g. @container (inline-size > 500px) large-300, small-200
)
Specifies where to display the linked URL.
The behavior of the button.
submit
: Used to indicate the component acts as a submit button, meaning it submits the closest form.button
: Used to indicate the component acts as a button, meaning it has no default action.reset
: Used to indicate the component acts as a reset button, meaning it resets the closest form (returning fields to their default values).
This property is ignored if the component supports href
or /
command
and one of them is set.
Anchor to eventsEvents
Learn more about registering events.