How to hide a paragraph conditionally
How to hide a paragraph conditionally
Since Carbone v4.3.0
, the drop
formatter is available to delete paragraphs conditionally from a document. Be sure to request version 4 (or higher) of Carbone:
- For the Cloud API: set the header
"carbone-version":4
- For the Cloud Studio: Click on the top-right "settings" icon > click on "version" > Select
4.X.X
.
For the following exemple, we want to drop a paragraph if the value is empty.
Include the marker {d.desc:ifEM:drop(p)}
within a paragraph, and all the elements it comprises are also removed if the condition is validated.
- the
d.desc
value is a description as a string type coming from a JSON dataset - the
:ifEM
is a conditional formatter checking if the value is empty. - the
:drop(p)
formatter is fired it the previous condition is true and will drop the paragraph. The first argumentp
is required to defined the element to drop.
On the screenshot below, the paragraph includes a title, description and an image thank to break-lines (ctrl+enter). If the description is empty, the paragraph is removed on the generated document.
The drop(p)
can be used to remove tables or any element. Make sure the formatter is located in the same paragraph as the element.
:drop
formatter on the documentationUpdated on: 03/07/2025
Thank you!