Skip to content

Button ⚠️ Experimental

The Button component can be used imported from:

Playground

Parameters

Events

This component has events. Check the documentation about how to use the events.

NamePayloadDescription
onClickMouseEvent...

Slots

This component has slots. Check the documentation about how to use the slots.

NameTagsDescription
defaultspanContent of the button.
popoverspanUsed for popover content

Parameters use

Check the documentation about how to use the parameters.

content

The text or content inside the button. It uses the default slot too.

Button

Attention!

Make sure the content is available when the WebComponent is being rendered if you use the slotted content, otherwise it can cause that the button looks round. To avoid this, use the property content instead.

config

type

The z-button component will use the primary type as default, matching the primary type of the specifications.

Button

There are four more types of buttons, secondary, negative, positive, and link

ButtonButtonButtonButtonButton
size

The first modifier is size defines the size of the button. The value is m, being omitted from the parameter. The possible values for size are: xs, s or l. Check the size section.

ButtonButtonButtonButton
round

The second modifier is round, that can receive the value round to implement a round styling to the button.

BTN

This configuration is also applied by default if the button doesn't have text. For example, only having an icon:

TIP

Make sure the content of the round button it's short and concise. Best approach would be to use a simple call to action icon

icon

The attribute icon it's useful to insert a specific CTA icon. Check the icon list here. This attribute will receive the name of the icon to be show. You can use both solid or line (outlined) version.

Button
Only icon

If we use only the icon, the config can still be set:

href

Button can directly be used as links. Just provide a href attribute. The target attribute will be also available.

Button

Flags

icon-right

This flag will display the icon on the right side of the text.

Button

disabled

This flag will block the interaction with the component.

ButtonButton

loading

This flag can be added to a button by setting the loading attribute.

Button

wide

This flag will make the button take the full width of the parent container.

Button

There's an option of using spread value to distribute the items with the elements apart, becoming then an attribute:

ButtonButtonButton

Browser support

Detected engine:  

  • Chromium

  • Webkit

  • Gecko

CodeSandbox example

Sorry, not available yet ☹️