Struct Content 

pub struct Content(/* private fields */);

A piece of document content.

Implementations

impl Content

pub fn new<T>(elem: T) -> Content

where T: NativeElement,

Creates a new content from an element.

pub fn empty() -> Content

Creates a empty sequence content.

pub fn elem(&self) -> Element

Get the element of this content.

pub fn span(&self) -> Span

Get the span of the content.

pub fn spanned(self, span: Span) -> Content

Set the span of the content.

pub fn label(&self) -> Option<Label>

Get the label of the content.

pub fn labelled(self, label: Label, labelled_at: Span) -> Content

Attach a label to the content.

pub fn labelled_at(&self) -> Span

Get the span where the label is attached.

pub fn set_label(&mut self, label: Label)

Set the label of the content.

pub fn located(self, loc: Location) -> Content

Assigns a location to the content.

This identifies the content and e.g. makes it linkable by .linked(Destination::Location(loc)).

Useful in combination with [Location::variant].

pub fn set_location(&mut self, location: Location)

Set the location of the content.

pub fn is_guarded(&self, index: RecipeIndex) -> bool

Check whether a show rule recipe is disabled.

pub fn guarded(self, index: RecipeIndex) -> Content

Disable a show rule recipe.

pub fn is_prepared(&self) -> bool

Whether this content has already been prepared.

pub fn mark_prepared(&mut self)

Mark this content as prepared.

pub fn get( &self, id: u8, styles: Option<StyleChain<'_>>, ) -> Result<Value, FieldAccessError>

Get a field by ID.

This is the preferred way to access fields. However, you can only use it if you have set the field IDs yourself or are using the field IDs generated by the #[elem] macro.

pub fn get_by_name(&self, name: &str) -> Result<Value, FieldAccessError>

Get a field by name.

If you have access to the field IDs of the element, use Self::get instead.

pub fn field(&self, id: u8) -> Result<Value, EcoString>

Get a field by ID, returning a missing field error if it does not exist.

This is the preferred way to access fields. However, you can only use it if you have set the field IDs yourself or are using the field IDs generated by the #[elem] macro.

pub fn field_by_name(&self, name: &str) -> Result<Value, EcoString>

Get a field by name, returning a missing field error if it does not exist.

If you have access to the field IDs of the element, use Self::field instead.

pub fn materialize(&mut self, styles: StyleChain<'_>)

Resolve all fields with the styles and save them in-place.

pub fn sequence(iter: impl IntoIterator<Item = Content>) -> Content

Create a new sequence element from multiples elements.

pub fn is<T>(&self) -> bool

where T: NativeElement,

Whether the contained element is of type T.

pub fn to_packed<T>(&self) -> Option<&Packed<T>>

where T: NativeElement,

Downcasts the element to a packed value.

pub fn to_packed_mut<T>(&mut self) -> Option<&mut Packed<T>>

where T: NativeElement,

Downcasts the element to a mutable packed value.

pub fn into_packed<T>(self) -> Result<Packed<T>, Content>

where T: NativeElement,

Downcasts the element into an owned packed value.

pub fn unpack<T>(self) -> Result<T, Content>

where T: NativeElement,

Extract the raw underlying element.

pub fn can<C>(&self) -> bool

where C: 'static + ?Sized,

Whether the contained element has the given capability.

pub fn with<C>(&self) -> Option<&C>

where C: 'static + ?Sized,

Cast to a trait object if the contained element has the given capability.

pub fn with_mut<C>(&mut self) -> Option<&mut C>

where C: 'static + ?Sized,

Cast to a mutable trait object if the contained element has the given capability.

pub fn is_empty(&self) -> bool

Whether the content is an empty sequence.

pub fn sequence_recursive_for_each<'a>( &'a self, f: &mut impl FnMut(&'a Content), )

Also auto expands sequence of sequences into flat sequence

pub fn styled_with_recipe( self, engine: &mut Engine<'_>, context: Tracked<'_, Context<'_>>, recipe: Recipe, ) -> Result<Content, EcoVec<SourceDiagnostic>>

Style this content with a recipe, eagerly applying it if possible.

pub fn repeat(&self, count: usize) -> Content

Repeat this content count times.

pub fn set<E, const I: u8>( self, field: Field<E, I>, value: <E as SettableProperty<I>>::Type, ) -> Content

where E: SettableProperty<I>, <E as SettableProperty<I>>::Type: Debug + Clone + Hash + Send + Sync + 'static,

Sets a style property on the content.

pub fn styled(self, style: impl Into<Style>) -> Content

Style this content with a style entry.

pub fn styled_with_map(self, styles: Styles) -> Content

Style this content with a full style map.

pub fn style_in_place(&mut self, styles: Styles)

Style this content with a full style map in-place.

pub fn query_first_naive(&self, selector: &Selector) -> Option<Content>

Queries the content tree for the first element that match the given selector.

This is a naive hack because contextual content and elements produced in show rules will not be included in the results. It’s used should be avoided.

pub fn plain_text(&self) -> EcoString

Extracts the plain text of this content.

pub fn traverse<F, B>(&self, f: &mut F) -> ControlFlow<B>

where F: FnMut(Content) -> ControlFlow<B>,

Traverse this content.

impl Content

pub fn strong(self) -> Content

Strongly emphasize this content.

pub fn emph(self) -> Content

Emphasize this content.

pub fn underlined(self) -> Content

Underline this content.

pub fn linked(self, dest: Destination, alt: Option<EcoString>) -> Content

Link the content somewhere.

pub fn aligned(self, align: Alignment) -> Content

Set alignments for this content.

pub fn padded(self, padding: Sides<Rel>) -> Content

Pad this content at the sides.

pub fn moved(self, delta: Axes<Rel>) -> Content

Transform this content’s contents without affecting layout.

pub fn artifact(self, kind: ArtifactKind) -> Content

Mark content as a PDF artifact.

impl Content

pub fn func(&self) -> Element

The content’s element function.

pub fn has(&self, field: Str) -> bool

Whether the content has the specified field.

pub fn at(&self, field: Str, default: Option<Value>) -> Result<Value, EcoString>

Access the specified field on the content.

pub fn fields(&self) -> Dict

Returns the fields of this content.

pub fn location(&self) -> Option<Location>

The location of the content.

Trait Implementations

impl<'a> Add<&'a Content> for Content

type Output = Content

The resulting type after applying the + operator.

fn add(self, rhs: &'a Content) -> <Content as Add<&'a Content>>::Output

Performs the + operation.

impl Add for Content

type Output = Content

The resulting type after applying the + operator.

fn add(self, rhs: Content) -> <Content as Add>::Output

Performs the + operation.

impl AddAssign<&Content> for Content

fn add_assign(&mut self, rhs: &Content)

Performs the += operation.

impl AddAssign for Content

fn add_assign(&mut self, rhs: Content)

Performs the += operation.

impl Clone for Content

fn clone(&self) -> Content

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Content

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

Formats the value using the given formatter.

impl Default for Content

fn default() -> Content

Returns the “default value” for a type.

impl<T> From<T> for Content

where T: NativeElement,

fn from(value: T) -> Content

Converts to this type from the input type.

impl FromValue for Content

fn from_value(value: Value) -> Result<Content, HintedString>

Try to cast the value into an instance of Self.

impl Hash for Content

fn hash<__H>(&self, state: &mut __H)

where __H: Hasher,

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl IntoValue for Content

fn into_value(self) -> Value

Cast this type into a value.

impl NativeScope for Content

fn constructor() -> Option<&'static NativeFuncData>

The constructor function for the type, if any.

fn scope() -> Scope

Get the associated scope for the type.

impl NativeType for Content

const NAME: &'static str = "content"

The type’s name.

fn data() -> &'static NativeTypeData

fn ty() -> Type

Get the type for the native Rust type.

impl PartialEq for Content

fn eq(&self, other: &Content) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Reflect for Content

fn input() -> CastInfo

Describe what can be cast into this value.

fn output() -> CastInfo

Describe what this value can be cast into.

fn castable(value: &Value) -> bool

Whether the given value can be converted to T.

fn error(found: &Value) -> HintedString

Produce an error message for an unacceptable value type.

impl Repr for Content

fn repr(&self) -> EcoString

Return the debug representation of the value.

impl Serialize for Content

fn serialize<S>( &self, serializer: S, ) -> Result<<S as Serializer>::Ok, <S as Serializer>::Error>

where S: Serializer,

Serialize this value into the given Serde serializer.

impl Sum for Content

fn sum<I>(iter: I) -> Content

where I: Iterator<Item = Content>,

Takes an iterator and generates Self from the elements by “summing up” the items.

impl StructuralPartialEq for Content