flxzt/rnote · error

failed to parse `type` attribute of XoppBackground with…

Error message

failed to parse `type` attribute of XoppBackground with node id {:?}, could not find attribute

What it means

XML validation error in XoppBackground::load_from_xml: a <background> node in the imported .xopp file has no `type` attribute, so the background kind (solid/pixmap/pdf) cannot be determined. Fires when importing Xournal++ files missing the mandatory background type attribute.

Solutions

1. Add a valid `type` attribute (e.g. type="solid") to the background node in the .xopp file.
2. Re-export the file from Xournal++ to regenerate well-formed XML.
3. Check the file for truncation around the background element.

Example fix

// before
<background name="bg"/>
// after
<background name="bg" type="solid" style="plain" color="#ffffffff"/>

fn background_has_type(node: &roxmltree::Node) -> bool {
    matches!(node.attribute("type"), Some("solid") | Some("pixmap") | Some("pdf"))
}

match bg.load_from_xml(node) {
    Err(e) if e.to_string().contains("`type` attribute") => bail!("malformed xopp: background missing type"),
    other => other,
}

When it happens

Trigger: load_from_xml on a <background> node without a 'type' attribute — occurs with hand-edited XML or output from tools that omit it.

Common situations: Manually trimmed .xopp files; third-party exporters emitting incomplete background elements; corruption during text processing of the XML.

Understand the failure class

Background: "missing required argument" and "the following required arguments were not provided": what required-argument errors mean and how to fix them — this error's family across 20 libraries.

• Parsing and encoding errors: unexpected token, malformed input — why parsers reject input and how to find the real culprit.

Related errors

• failed to parse width attribute of XoppPage for node with id
• failed to parse height attribute of XoppPage with node id
• Failed to parse `domain` attribute in XoppBackground with…
• Failed to parse `filename` attribute in XoppBackground with…
• Err while parsing `style` attribute of XoppBackground

AI-assisted analysis of flxzt/rnote@bbc5354502 (2026-09-08). Data as JSON: /api/errors/2bc3268034a913b2. Report an issue: GitHub.

Appendix: source

Thrown at crates/rnote-engine/src/fileformats/xoppformat.rs:364

        Self::Absolute
    }
}

/// The Xopp Background.
#[derive(Default, Debug, Clone, Serialize, Deserialize)]
pub struct XoppBackground {
    /// Optional background name.
    pub name: Option<String>,
    /// The background type.
    pub bg_type: XoppBackgroundType,
}

impl XmlLoadable for XoppBackground {
    fn load_from_xml(&mut self, node: Node) -> anyhow::Result<()> {
        self.name = node.attribute("name").map(|name| name.to_string());

        match node.attribute("type").ok_or_else(|| {
            anyhow::anyhow!(
                "failed to parse `type` attribute of XoppBackground with node id {:?}, could not find attribute",
                node.id()
            )
        })? {
            "solid" => {
                let style = match XoppBackgroundSolidStyle::from_xml_attr_value(node.attribute("style").ok_or_else(|| {
                    anyhow::anyhow!("failed to parse `style` attribute in XoppBackground with node id {:?}, could not find attribute", node.id())
                })?) {
                    Ok(s) => s,
                    Err(e) => {
                        error!("Failed to retrieve the XoppBackgroundSolidStyle from `style` attribute, Err: {e:?}");
                        XoppBackgroundSolidStyle::Plain
                    }
                };

                let color = XoppColor::from_backgroundcolor_attr_value(
                    node.attribute("color").ok_or_else(|| {
                        anyhow::anyhow!(

View on GitHub (pinned to bbc5354502)