Chip     

The Chip component is basically a simple UI block entity, representing for example more advanced underlying data, such as a contact, in a compact way.

Chips can contain entities such as an avatar, text or an icon, optionally having a pointer too. They can also be closed or removed if configured so.

Installation

Edit /quasar.conf.js:

framework: {
components: ['QChip']
}

Basic Usage

Some basic examples:

<!-- icon on left side -->
<q-chip icon="alarm" color="primary">
q-chip
</q-chip>

<!-- icon on right side -->
<q-chip icon-right="alarm" color="primary">
q-chip
</q-chip>

<!-- avatar on left side -->
<q-chip avatar="/statics/some.png" color="primary">
q-chip
</q-chip>

<!-- floating chip applied to a button (v0.15.7+) -->
<q-btn round dense color="dark" icon="announcement">
<q-chip floating color="red">1</q-chip>
</q-btn>

Vue Properties

There are a number of properties available:

Vue PropertyTypeDescription
floatingBooleanAllows the chip to float over other elements on top-right side of them.
tagBooleanMakes it a “tag” type.
detailBooleanHighlights the area on the right (icon or avatar), should there be one.
iconStringIcon for left side.
icon-rightStringIcon for right side.
avatarStringURL pointing to statics folder for an image which gets placed on left side.
smallBooleanReduces the size of the chip. Makes it compact. Use this or “dense”, but not both.
denseBoolean(Quasar v0.15.7+) Makes chip small, with minimum padding. Use this or “small”, but not both.
squareBooleanGives the chip right-angled corners. Rounded corners are default.
pointingStringAdds a carat to the chip, pointing either up, right, down or left.
colorStringThe color the chip should be.
text-colorStringOverride the text color of the chip.
closableBooleanAdds a close button to the right of the chip, which when clicked, will emit @hide event.

Vue Events

Vue PropertyDescription
@hideThe close button has been clicked/tapped.
@focusThe chip has been focused.
@clickChip has been clicked/tapped outside of close button.

When using closable property a close button will be displayed on the right side. When clicking/tapping on the button the @hide event will be triggered. This does not removes the chip by itself. You will have to handle it yourself.

The two events fire independently but not both simultaneously, depending on where the user has clicked/tapped (on close button or anywhere else within the Chip).

More Examples

You can add the ability to hide the chip too.

<q-chip closable color="red">
Joe
</q-chip>

You can also use a chip to label a button.

<q-btn color="light" label="Inbox">
<q-chip floating color="primary">22</q-chip>
</q-btn>

Or to label anything you want, as long as the container has position: relative (hint: use relative-position Quasar CSS helper class):

<div class="relative-position">
....content...
<q-chip floating color="primary">22</q-chip>
</div>

You can also use chips as pointing labels.

<q-chip pointing="up" color="primary">
Pointing Up
</q-chip>

You can create advanced label chips, with an avatar/image and a closeable button to delete the chip.

<q-chip closable avatar="statics/some.png" color="red">
Joe
</q-chip>

You can also create chips that look like tags.

<q-chip tag color="secondary" icon-right="mail">
New
</q-chip>

This chip highlights the icon by using the detail property.

<q-chip tag color="secondary" detail icon="mail">
10 emails
</q-chip>

One more example where we add a shadow to a chip:

<q-chip class="shadow-1" square color="primary">10k</q-chip>