Back to library

Text field

Use a text field for a short entry such as a project name or a search term.

Recommended API

Property or elementTypeExample initial valueDescription
maxlengthNumber60Limit the project name to 60 characters.
LabelTextProject nameName the text field while its value is empty or filled.

States

StateTriggerResult
editingType in the field.The counter updates with the number of characters entered.

CSS variables

VariableTypeDefaultDescription
--q-textcolor #28302aMain text and foreground color.
--q-mutedcolor #70776fColor for secondary text.
--q-font-sizelength 13pxBase size for the component text.
--q-accentcolor #344e41Accent for active controls, indicators and focus.
--q-surfacecolor #ffffffSurface for controls and cards.
--q-bordercolor #dce0d8Color for outlines and dividers.
--q-border-widthlength 1pxThickness of the outline.
--q-radiuslength 10pxBase corner radius.
--q-gaplength calc(var(--q-space) * 2)Space between items, based on the spacing unit.
--q-control-pxlength calc(var(--q-space) * 4)Horizontal padding for controls.
--q-control-pylength calc(var(--q-space) * 2.5)Vertical padding for controls.
--q-shadowshadow 0 4px 16px rgb(0 0 0 / 8%)Shadow behind raised elements.
--q-spacelength 4pxBase unit for gaps and padding.