diff --git a/data/doc/documentation.xml b/data/doc/documentation.xml index eff69bba..28cedefd 100644 --- a/data/doc/documentation.xml +++ b/data/doc/documentation.xml @@ -3727,7 +3727,8 @@ declare function pmf:code($config as map(*), $node as element(), $class as xs:st A note on history handling It is important that only one central text component on the page writes and reads the URL. Usually this will be the main pb-view. Other components, e.g. for the translation, should be made dependent and restore their state based on the state of the main component. If multiple components write their state, browsing back via the browser history may not work properly, or you may see undesired effects due to conflicting parameters. - To prevent a dependent pb-view from writing to the URL, use the attribute disable-history. To make a pb-view load its contents after the main text view, set attribute on-update and make sure, the dependent component listens to the event channel written by the main component. + TEI Publisher supports different ways to make one pb-view depend on another, e.g. via a mapping function (map attribute). A mapped view will never write to the browser history. + In other cases, to explicitely prevent a dependent pb-view from writing to the URL, use the attribute disable-history. To make a pb-view load its contents after the main text view, set attribute on-update and make sure, the dependent component listens to the event channel written by the main component.