Struct ControlProps 

pub struct ControlProps {

    pub children: Children,
    pub class: &'static str,
    pub style: &'static str,
    pub id: &'static str,
    pub input_id: &'static str,
    pub disabled: bool,
    pub error: bool,
    pub focused: bool,
    pub full_width: bool,
    pub hidden_label: bool,
    pub margin: Margin,
    pub required: bool,
    pub size: Size,
    pub variant: Variant,
    pub color: Color,
    pub data_testid: &'static str,
}

Available on crate feature lep only.

Props for the Control component.

A context provider that wraps a single form field with its label and helper text.

Provides ControlContext to FormLabel and Helper descendants so they reflect error, disabled, required, variant, and color states automatically.

Examples

use form_rs::leptos::{Control, FormLabel, Helper};
use form_rs::Variant;
use leptos::prelude::*;

#[component]
pub fn EmailField() -> impl IntoView {
    view! {
        <Control input_id="email" required=true variant=Variant::Outlined>
            <FormLabel html_for="email">"Email"</FormLabel>
            <Helper>"We'll never share your email."</Helper>
        </Control>
    }
}

Required Props

• children: Children
  • Field components: FormLabel, input, Helper.

Optional Props

• class: [&'static str]
  • Additional CSS class names on the wrapper <div>.
• style: [&'static str]
  • Inline CSS on the wrapper <div>.
• id: [&'static str]
  • id attribute on the wrapper <div>.
• input_id: [&'static str]
  • The id of the inner <input> element.
• disabled: bool
  • When true, renders all children in a disabled state.
• error: bool
  • When true, renders the label and helper text in the error color.
• focused: bool
  • When true, applies the focused style.
• full_width: bool
  • When true, the component takes up full container width.
• hidden_label: bool
  • When true, the label is hidden.
• margin: Margin
  • Vertical spacing adjustment.
• required: bool
  • Whether the field is required.
• size: Size
  • Size of the component.
• variant: Variant
  • Visual style variant.
• color: Color
  • Color theme.
• data_testid: [&'static str]
  • data-testid for automated testing.

Fields

children: Children

Field components: FormLabel, input, Helper.

class: &'static str

Additional CSS class names on the wrapper <div>.

style: &'static str

Inline CSS on the wrapper <div>.

id: &'static str

id attribute on the wrapper <div>.

input_id: &'static str

The id of the inner <input> element.

disabled: bool

When true, renders all children in a disabled state.

error: bool

When true, renders the label and helper text in the error color.

focused: bool

When true, applies the focused style.

full_width: bool

When true, the component takes up full container width.

hidden_label: bool

When true, the label is hidden.

margin: Margin

Vertical spacing adjustment.

required: bool

Whether the field is required.

size: Size

Size of the component.

variant: Variant

Visual style variant.

color: Color

Color theme.

data_testid: &'static str

data-testid for automated testing.

Implementations

impl ControlProps

pub fn builder() -> ControlPropsBuilder<((), (), (), (), (), (), (), (), (), (), (), (), (), (), (), ())>

Create a builder for building ControlProps. On the builder, call .children(...), .class(...)(optional), .style(...)(optional), .id(...)(optional), .input_id(...)(optional), .disabled(...)(optional), .error(...)(optional), .focused(...)(optional), .full_width(...)(optional), .hidden_label(...)(optional), .margin(...)(optional), .required(...)(optional), .size(...)(optional), .variant(...)(optional), .color(...)(optional), .data_testid(...)(optional) to set the values of the fields. Finally, call .build() to create the instance of ControlProps.

Trait Implementations

impl Props for ControlProps

type Builder = ControlPropsBuilder

fn builder() -> Self::Builder