Porsche Design SystemSearchNavigate to GitHub repository of Porsche Design SystemOpen sidebar
ConfiguratorExamplesUsageAccessibilityAPI
Input Tel Table of ContentsPropertiestype BreakpointCustomizable<T> = { base: T; xs?: T; s?: T; m?: T; l?: T; xl?: T; xxl?: T; };PropertyAttributeDescriptionTypeDefaultautoComplete auto-completeProvides a hint to the browser about what type of data the field expects, which can assist with autofill features (e.g., autocomplete='tel').stringundefinedcompact compactA boolean value that, if present, renders the input field as a compact version.booleanfalsedescription descriptionSupplementary text providing more context or explanation for the input.string''disabled disabledA boolean value that, if present, makes the input field unusable and unclickable. The value will not be submitted with the form.booleanfalseform formSpecifies the id of the
element that the input belongs to (useful if the input is not a direct descendant of the form).stringundefinedhideLabel 🛠hide-labelControls the visibility of the label.boolean
BreakpointCustomizable<boolean>
false
indicator indicatorControls the visibility of the phone icon.booleanfalselabel labelText content for a user-facing label.string''loading 🧪loadingexperimental Shows a loading indicator.booleanfalsemaxLength max-lengthA non-negative integer specifying the maximum number of characters the user can enter into the input.numberundefinedmessage messageDynamic feedback text for validation or status.string''minLength min-lengthA non-negative integer specifying the minimum number of characters required for the input's value to be considered valid.numberundefinedname nameThe name of the input field, used when submitting the form data.stringundefinedpattern patternSpecifies a regular expression that the input's value must match for the value to pass constraint validation. This allows for more specific tel validation rules than the browser's default. If provided, it overrides the browser's default tel validation.stringundefinedplaceholder placeholderA string that provides a brief hint to the user about what kind of information is expected in the field (e.g., placeholder='(123) 456-7890')string''readOnly read-onlyA boolean value that, if present, makes the input field uneditable by the user, but its value will still be submitted with the form.booleanfalserequired requiredA boolean value that, if present, indicates that the input field must be filled out before the form can be submitted.booleanfalsestate stateIndicates the validation or overall status of the input component.type InputTelState =
'none'
'error'
'success'
'none'
theme themeControls the visual appearance of the component.type Theme =
'light'
'dark'
'auto'
'light'
value valueThe tel input value.string''EventsEventDescriptionTypeblur Emitted when the tel input has lost focus.type InputTelBlurEventDetail = Event
CustomEvent<InputTelBlurEventDetail>
change Emitted when the tel input loses focus after its value was changed.type InputTelChangeEventDetail = Event
CustomEvent<InputTelChangeEventDetail>
input Emitted when the value has been changed as a direct result of a user action.type InputTelInputEventDetail = InputEvent
CustomEvent<InputTelInputEventDetail>
SlotsSlotDescriptionisRequiredaltPropallowedTagNames<slot name="label"> Shows a label. Only [phrasing content](https://developer.mozilla.org/en-US/docs/Web/Guide/HTML/Content_categories#Phrasing_content) is allowed.<slot name="description"> Shows a description. Only [phrasing content](https://developer.mozilla.org/en-US/docs/Web/Guide/HTML/Content_categories#Phrasing_content) is allowed.<slot name="message"> Shows a state message. Only [phrasing content](https://developer.mozilla.org/en-US/docs/Web/Guide/HTML/Content_categories#Phrasing_content) is allowed.<slot name="start"> Shows content at the start of the input (e.g. unit prefix).<slot name="end"> Shows content at the end of the input (e.g. toggle button, unit suffix).CSS VariablesCSS VariableDescriptiondefaultValue--ref-p-input-slotted-padding When slotting a `p-button-pure` or `p-link-pure` this variable needs to be set as `padding` in oder to adjust the alignment correctly.--ref-p-input-slotted-margin When slotting a `p-button-pure` or `p-link-pure` this variable needs to be set as `margin` in oder to adjust the spacings correctly.
Global settingsThemeChanges the theme of the application and any Porsche Design System component. It's possible to choose between forced theme light and dark. It's also possible to use auto, which applies light or dark theme depending on the operating system settings automatically.LightDarkAuto (sync with operating system)DirectionThe dir global attribute in HTML changes the direction of text and other content within an element. It's most often used on the <html> tag to set the entire page's direction, which is crucial for supporting languages that are written from right to left (RTL), such as Arabic and Hebrew. For example, using <html dir="rtl"> makes the entire page display from right to left, adjusting the layout and text flow accordingly.LTR (left-to-right)RTL (right-to-left)Text ZoomTo ensure accessibility and comply with WCAG 2.2 AA standards, it is mandatory for web content to support text resizing up to at least 200% without loss of content or functionality. Using relative units like rem is a best practice for achieving this, as they allow the text to scale uniformly based on the user's browser settings.100%130%150%200%