diff options
| -rw-r--r-- | doc/dw-fixed-positions.doc | 63 | ||||
| -rw-r--r-- | doc/dw-miscellaneous.doc | 14 | ||||
| -rw-r--r-- | doc/dw-out-of-flow.doc | 6 | ||||
| -rw-r--r-- | doc/dw-pos-elements-outside-container.doc | 2 |
4 files changed, 82 insertions, 3 deletions
diff --git a/doc/dw-fixed-positions.doc b/doc/dw-fixed-positions.doc new file mode 100644 index 00000000..d62565ff --- /dev/null +++ b/doc/dw-fixed-positions.doc @@ -0,0 +1,63 @@ +/** \page dw-fixed-positions Fixed positions + +In some cases, widgets or widget content must be positioned relative +to the viewport. As in the CSS specification, these positions will be +called "fixed positions". This must not be confused with "fixedly +positioned elements" (see \ref dw-out-of-flow), which are a special +case of fixed positions. + + +Applications +============ + +As defined by CSS +----------------- + +- "position: fixed"; see \ref dw-out-of-flow. +- "background-attachment: fixed"; see \ref dw-images-and-backgrounds. + +Idea for tables +--------------- + +Often, tables have a header, which contains informations necessary to +interpret the columns in the table body. For this, HTML defines the elements +<thead> and <tbody> +<sup><a href="#note-table-footer" id="ref-table-footer">[1]</a></sup>. + +For large tables, the problem occurs that the table header gets out of +the reader's view. In paged media, where a large table covers multiple +pages, this is often solved by *repeating* the table header on each +page occupied by the table. When using a viewport, a table larger than +the vieport could be displayed like this: + +1. If the top of the table is within the viewport, show the table + header at the usual position. +2. As soon as top of the table gets above the top border of the + viewport, keep the table header at the viewport top, so that it is + still visible (this means, it moves down, relative to the + *canvas*). This way, the header is still visible, so our objective + is achieved. +3. When scrolling further down, at some point the table body gets out + of the viewport again, and so should the table header. + +(Some images would be nice.) + +These ideas should be considered when developing a design for fixed +positions. + + +Design sketch +============== + +[...] + + +---------------------------------------------------------------------- + +<sup><a href="#ref-table-footer" id="note-table-footer">[1]</a></sup> +... and also <tfoot>, which is not discussed here, for reasons +of simplicity. However, it is obvious that <tfoot> should be +dealt with in an analogue way as <thead>. + + +*/
\ No newline at end of file diff --git a/doc/dw-miscellaneous.doc b/doc/dw-miscellaneous.doc index 233a1459..e6dcf4c0 100644 --- a/doc/dw-miscellaneous.doc +++ b/doc/dw-miscellaneous.doc @@ -136,10 +136,20 @@ Positioned elements outside of the container Relative positions ------------------ -... +Relatively positioned elements are currently not supported. Some notes +for an implementation: + +- It is important to find a suitable parent widget. Ideas described in + \ref dw-pos-elements-outside-container may be useful. +- At the original position, a space as large as the positioned element + should be left. This may be implemented by assigning a size to the + widget *reference*. Also, handling changes of the size of the + positioned element may become tricky. Fixed positions --------------- -... +Currently, fixedly positioned elements are positioned relative to the +canvas, not to the viewport. For a complete implementation, see \ref +dw-fixed-positions. */ diff --git a/doc/dw-out-of-flow.doc b/doc/dw-out-of-flow.doc index f5eade21..f5b73317 100644 --- a/doc/dw-out-of-flow.doc +++ b/doc/dw-out-of-flow.doc @@ -232,4 +232,10 @@ Absolute and fixed positiones To be documented. + +See also +======== + +→ \ref dw-miscellaneous. + */
\ No newline at end of file diff --git a/doc/dw-pos-elements-outside-container.doc b/doc/dw-pos-elements-outside-container.doc index 35b4163e..341842f3 100644 --- a/doc/dw-pos-elements-outside-container.doc +++ b/doc/dw-pos-elements-outside-container.doc @@ -95,7 +95,7 @@ defined by CSS, so the rules defined there apply. [...] How is the container widget defined? ------------------------------------ - [...] +[...] ---------------------------------------------------------------------- |