Struct FieldItem 

pub struct FieldItem {
    pub field: Option<Field>,
    pub name: Cow<'static, str>,
    pub rename: Option<Cow<'static, str>>,
    pub flattened: bool,
    pub is_text_variant: bool,
}

A field item with runtime state for serialization.

This wraps a static Field with additional runtime state that can be modified during iteration (e.g., for flattened enums where the field name becomes the variant name, or for flattened maps where entries become synthetic fields).

Fields

field: Option<Field>

The underlying static field definition (None for flattened map entries)

name: Cow<'static, str>

Runtime-determined name (may differ from field.name for flattened enums/maps)

rename: Option<Cow<'static, str>>

Result of applying any field-level #[facet(rename = ...)] or container-level #[facet(rename_all = ...)] attributes. If None, no such attribute was encountered.

flattened: bool

Whether this field was flattened from an enum (variant name used as key)

is_text_variant: bool

Whether this is a text variant (html::text or xml::text) from a flattened enum. When true, the value should be serialized as raw text without an element wrapper.

Implementations

impl FieldItem

pub const fn new(field: Field) -> Self

Create a new FieldItem from a Field, using the field’s name

pub fn flattened_enum(field: Field, variant: &Variant) -> Self

Create a flattened enum field item with a custom name (the variant name)

pub const fn flattened_map_entry(key: String) -> Self

Create a flattened map entry field item with a dynamic key

pub fn effective_name(&self) -> &str

Returns the effective name for this field item, preferring the rename over the original name

Trait Implementations

impl Clone for FieldItem

fn clone(&self) -> FieldItem

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for FieldItem

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.