I would like to revisit this. Initially I thought I can solve it by other means but then a tingle on the back of my mind was pointing me back to this .
We have implemented a revision bar / change bar in Browser purely with CSS. We had to adjust our html a bit to allow for this but it all is driven from pseudo elements.
To explain the implementation with words, the html element that needs to have revision bar is assigned a special class (class='arc-revision-element-added').
A css pseudo element (:after) is created that draws a black background that spans the height of the parent and runs all the way to the side on the left. This black background is z-indexed underneath so that it flows under the whole area of the parent and wide enough that it doesn't matter where the element is located on the x-axis.
.arc-revision-element-added:after {
z-index: -1;
content: "|";
position: absolute;
background: black;
color: transparent;
width: 5000px;
height: 100%;
left: -5000px;
top: 0;
bottom: 0;
}
There is some trickery on left of the element that only shows a part of the black background and this then appears as a line next to the unit that has revision. Basically the 'body' of the html is placed on a container div that is z-index elevated so that the :after can run underneath, with a dummy left container on the same z-index plane with background white that hides the unnecessary black leftover thus creating a narrow slit between left and right container that allows the black pseudo element to show through. This then creates the illusion that a black line is placed on the left of the unit for the corresponding element's height regardless where this element is placed on the x-axis.
We are currently drawing change bars in Prince with javascript, but this means that we need to run Prince twice. With a similar adapted CSS only solution, prince generates almost the same revision bars with 40-50% faster.
In Prince, instead of having the left container, we use a page rule @left-middle that hides the leftover of the revision bars that are flowing to the left.
@left-middle {
content: " ";
margin-right: 1mm;
height: 100%;
background-color: white;
}
Because of the limitation in Prince where pseudo element :after is not drawn on all pages if such element spans more than one page, we changed our pseudo element that drives the changebar to include all the relevant sub-elements that may be contained inside a revised element/unit like so:
.arc-revision-element-added:not(.disabled):after,
.arc-revision-element-added:not(.disabled) div[class^="arc-"]:after,
.arc-revision-element-added:not(.disabled) caption:after,
.arc-revision-element-added:not(.disabled) figcaption:after,
.arc-revision-element-added:not(.disabled) td:after,
.arc-revision-element-added:not(.disabled) li.arc-li:after,
.arc-revision-element-added:not(.disabled) p.arc-paragraph:after {
z-index: -1;
content: "|";
position: absolute;
background: black;
color: transparent;
width: 5000px;
height: 100%;
left: -5000px;
top: 0;
bottom: 0;
}
This works fine with the exception where a revision bar element spans more than one page in which case only the second page draws revision bar.
A simple example would be a paragraph with 4 lines that it happens to end up at the end of the current page. The first 2 lines are rendered on the first page and the next 2 lines are rendered on the second. Because of the :after pseudo-element, in Prince only the second page has revision bar on those 2 lines of the paragraph. Since paragraph is a singular element, the only way to fix it is to force the break-inside : avoid, but then this can change the layout of the PDF for existing documents.
Since this works in browser and also in Prince as long as element is not broken on multiple pages, I feel this is a bug in Prince since the pseudo element whether :before or :after is overlapping the original element but is not honoured on all pages if original element ends up being split because of unforced page breaks.
I'm attaching an example of what I'm describing, both resulting PDF and sourced html. This is just an example with minimal styles to show the behaviour.
- example.pdf 21.7 kB
- result.html 3.7 kB