IftaLabel
An unstyled wrapper that creates an infield top-aligned label for its form element.
Build an infield top-aligned label positioned inside the input boundary with complete control over layout and styling.
Features#
- Wraps a form element and its
Labelto create an infield top-aligned label - Label stays visible inside the input boundary, above the value
- Works with any compatible input component
Usage#
import { IftaLabel } from 'primereact/iftalabel';
import { InputText } from 'primereact/inputtext';
import { Label } from 'primereact/label';<IftaLabel>
<InputText id="username" />
<Label htmlFor="username">Username</Label>
</IftaLabel>API#
IftaLabel#
| Name | Type | Default |
|---|---|---|
ref | Ref<unknown> | — |
| The reference to the component instance. | ||
pIf | boolean | true |
| Whether the component should be rendered. | ||
style | CSSProperties | ((instance?: IftaLabelInstance) => undefined | CSSProperties) | — |
| The style to apply to the component. | ||
className | string | ((instance?: IftaLabelInstance) => undefined | string) | — |
| The class name to apply to the component. | ||
as | null | string | number | bigint | boolean | ComponentClass<any, any> | FunctionComponent<any> | ReactElement<unknown, string | JSXElementConstructor<any>> | Iterable<ReactNode, any, any> | ReactPortal | Promise<AwaitedReactNode> | — |
| The component type to render. | ||
asChild | boolean | false |
| Whether the component should be rendered as a child component. | ||
instance | IftaLabelInstance | — |
| The instance to pass to the component. | ||
pt | SafeRecord<IftaLabelPassThrough> | — |
| The pass-through props to pass to the component. | ||
ptOptions | PassThroughOptions | — |
| The pass-through options to pass to the component. | ||
unstyled | boolean | — |
| Whether the component should be rendered without classes. | ||
dt | unknown | — |
| The design token to use for the component. | ||
styles | StylesOptions<ComponentInstance> | — |
| The styles to use for the component. | ||
render | (instance: IftaLabelInstance) => ReactNode | — |
| The render function to render the component with instance access. | ||
children | any | — |
| The children to render. Accepts `React.ReactNode` for static content or a render function `(instance: I) => React.ReactNode` for instance access. Typed as `any` to avoid JSX type errors when used directly in templates. | ||
[key: string] | any | — |
pt-{optionName}-* | - | — |
| Pass through attributes for customizing component. For more info, see Pass Through tab. | ||
| Attribute | Value |
|---|---|
data-scope | "iftalabel" |
data-part | "root" |
Accessibility#
Screen Reader#
IftaLabel does not require any roles and attributes.
Keyboard Support#
Component does not include any interactive elements.