quasar
Version:
Build high-performance VueJS user interfaces (SPA, PWA, SSR, Mobile and Desktop) in record time
424 lines • 11.1 kB
JSON
{
"type": "component",
"behavior": {
"$listeners": {
"desc": "All native events are being propagated to the inner native input element (you don't need the '.native' modifier)"
}
},
"props": {
"mask": {
"type": "String",
"desc": "Custom mask or one of the predefined mask names",
"examples": [
"###-##",
"date",
"datetime",
"time",
"fulltime",
"phone",
"card"
],
"category": "behavior"
},
"fill-mask": {
"type": [
"Boolean",
"String"
],
"desc": "Fills string with specified characters (or underscore if value is not string) to fill mask's length",
"examples": [
"true",
"'0'",
"'_'"
],
"category": "behavior"
},
"reverse-fill-mask": {
"type": "Boolean",
"desc": "Fills string from the right side of the mask",
"category": "behavior"
},
"unmasked-value": {
"type": "Boolean",
"desc": "Model will be unmasked (won't contain tokens/separation characters)",
"category": "behavior"
},
"error": {
"type": "Boolean",
"desc": "Does field have validation errors?",
"category": "behavior"
},
"error-message": {
"type": "String",
"desc": "Validation error message (gets displayed only if 'error' is set to 'true')",
"examples": [
"Username must have at least 5 characters"
],
"category": "content"
},
"no-error-icon": {
"type": "Boolean",
"desc": "Hide error icon when there is an error",
"category": "content"
},
"rules": {
"type": "Array",
"desc": "Array of Functions/Strings; If String, then it must be a name of one of the embedded validation rules",
"examples": [
":rules=\"[ val => val.length <= 3 || 'Please use maximum 3 characters' ]\"",
":rules=\"[ 'fulltime' ]\""
],
"category": "behavior"
},
"lazy-rules": {
"type": "Boolean",
"desc": "Check validation status against the 'rules' only after field loses focus for first time",
"category": "behavior"
},
"label": {
"type": "String",
"desc": "A text label that will “float” up above the input field, once the field gets focus",
"examples": [
"Username"
],
"category": "content"
},
"stack-label": {
"type": "Boolean",
"desc": "Label will be always shown above the field regardless of field content (if any)",
"category": "content"
},
"hint": {
"type": "String",
"desc": "Helper (hint) text which gets placed below your wrapped form component",
"examples": [
"Fill in between 3 and 12 characters"
],
"category": "content"
},
"hide-hint": {
"type": "Boolean",
"desc": "Hide the helper (hint) text when field doesn't have focus",
"category": "content"
},
"prefix": {
"type": "String",
"desc": "Prefix",
"examples": [
"$"
],
"category": "content"
},
"suffix": {
"type": "String",
"desc": "Suffix",
"examples": [
"@gmail.com"
],
"category": "content"
},
"color": {
"type": "String",
"desc": "Color name for component from the Quasar Color Palette",
"examples": [
"primary",
"teal-10"
],
"category": "style"
},
"bg-color": {
"type": "String",
"desc": "Color name for component from the Quasar Color Palette",
"examples": [
"primary",
"teal-10"
],
"category": "style"
},
"dark": {
"type": "Boolean",
"desc": "Notify the component that the background is a dark color",
"category": "style"
},
"loading": {
"type": "Boolean",
"desc": "Signals the user a process is in progress by displaying a spinner; Spinner can be customized by using the 'loading' slot.",
"category": "behavior|content"
},
"clearable": {
"type": "Boolean",
"desc": "Appends clearable icon when a value (not undefined or null) is set; When clicked, model becomes null",
"category": "behavior|content"
},
"clear-icon": {
"type": "String",
"desc": "Custom icon to use for the clear button when using along with 'clearable' prop",
"examples": [
"close"
],
"category": "content"
},
"filled": {
"type": "Boolean",
"desc": "Use 'filled' design for the field",
"category": "style"
},
"outlined": {
"type": "Boolean",
"desc": "Use 'outlined' design for the field",
"category": "style"
},
"borderless": {
"type": "Boolean",
"desc": "Use 'borderless' design for the field",
"category": "style"
},
"standout": {
"type": [
"Boolean",
"String"
],
"desc": "Use 'standout' design for the field; Specifies classes to be applied when focused (overriding default ones)",
"examples": [
"standout",
"standout=\"bg-primary text-white\""
],
"category": "style"
},
"bottom-slots": {
"type": "Boolean",
"desc": "Enables bottom slots ('error', 'hint', 'counter')",
"category": "content"
},
"hide-bottom-space": {
"type": "Boolean",
"desc": "Does not reserves space for hint/error/counter anymore when these are not used; as a result, it also disables the animation for those",
"category": "style"
},
"counter": {
"type": "Boolean",
"desc": "Show an automatic counter on bottom right",
"category": "content"
},
"rounded": {
"type": "Boolean",
"desc": "Applies a small standard border-radius for a squared shape of the component",
"category": "style"
},
"square": {
"type": "Boolean",
"desc": "Remove border-radius so borders are squared; Overrides 'rounded' prop",
"category": "style"
},
"dense": {
"type": "Boolean",
"desc": "Dense mode; occupies less space",
"category": "style"
},
"items-aligned": {
"type": "Boolean",
"desc": "Align content to match QItem",
"category": "content"
},
"disable": {
"type": "Boolean",
"desc": "Put component in disabled mode",
"category": "state"
},
"readonly": {
"type": "Boolean",
"desc": "Put component in readonly mode",
"category": "state"
},
"autofocus": {
"type": "Boolean",
"desc": "Focus field on initial component render",
"category": "behavior"
},
"value": {
"type": [
"String",
"Number"
],
"desc": "Model of the component; Either use this property (along with a listener for 'input' event) OR use v-model directive",
"required": true,
"examples": [
"v-model=\"myText\""
],
"category": "model"
},
"type": {
"type": "String",
"desc": "Input type",
"default": "text",
"values": [
"text",
"password",
"textarea",
"email",
"search",
"tel",
"file",
"number",
"url",
"time",
"date"
],
"examples": [
"password"
],
"category": "general"
},
"debounce": {
"type": [
"String",
"Number"
],
"desc": "Debounce amount (in milliseconds) when updating model",
"examples": [
"0",
"530"
],
"category": "model"
},
"maxlength": {
"type": [
"String",
"Number"
],
"desc": "Specify a max length of model",
"examples": [
"12"
],
"category": "model"
},
"autogrow": {
"type": "Boolean",
"desc": "Make field autogrow along with its content (uses a textarea)",
"category": "content"
},
"input-class": {
"type": [
"Array",
"String",
"Object"
],
"desc": "Class definitions to be attributed to the underlying input tag",
"examples": [
"my-special-class",
":input-class=\"{ 'my-special-class': <condition> }\""
],
"category": "style"
},
"input-style": {
"type": [
"Array",
"String",
"Object"
],
"desc": "Style definitions to be attributed to the underlying input tag",
"examples": [
"background-color: #ff0000",
":input-style=\"{ backgroundColor: '#ff0000' }\""
],
"category": "style"
}
},
"slots": {
"default": {
"desc": "Field main content"
},
"prepend": {
"desc": "Prepend inner field; Suggestions: QIcon, QBtn"
},
"append": {
"desc": "Append to inner field; Suggestions: QIcon, QBtn"
},
"before": {
"desc": "Prepend outer field; Suggestions: QIcon, QBtn"
},
"after": {
"desc": "Append outer field; Suggestions: QIcon, QBtn"
},
"error": {
"desc": "Slot for errors; Enabled only if 'bottom-slots' prop is used; Suggestion: <div>"
},
"hint": {
"desc": "Slot for hint text; Enabled only if 'bottom-slots' prop is used; Suggestion: <div>"
},
"counter": {
"desc": "Slot for counter text; Enabled only if 'bottom-slots' prop is used; Suggestion: <div>"
},
"loading": {
"desc": "Override default spinner when component is in loading mode; Use in conjunction with 'loading' prop"
}
},
"events": {
"clear": {
"desc": "When using the 'clearable' property, this event is emitted when the clear icon is clicked",
"addedIn": "v1.1.5",
"params": {
"value": {
"type": [
"Any"
],
"desc": "The previous value before clearing it"
}
}
},
"input": {
"desc": "Emitted when the component needs to change the model; Is also used by v-model",
"params": {
"value": {
"type": [
"String",
"Number"
],
"desc": "New model value",
"required": true
}
}
},
"focus": {
"desc": "Emitted when component gets focused",
"params": {
"evt": {
"type": "Object",
"desc": "JS event object"
}
}
},
"blur": {
"desc": "Emitted when component loses focus",
"params": {
"evt": {
"type": "Object",
"desc": "JS event object"
}
}
}
},
"methods": {
"resetValidation": {
"desc": "Reset validation status"
},
"validate": {
"desc": "Trigger a validation",
"params": {
"value": {
"type": "Any",
"desc": "Optional value to validate against"
}
}
},
"focus": {
"desc": "Focus underlying input tag"
},
"blur": {
"desc": "Lose focus on underlying input tag"
},
"select": {
"desc": "Select input text"
}
}
}