dwpage.txt

来自「嵌入式浏览器Dillo源码」· 文本 代码 · 共 59 行

Nov 2001, [e-mail]

======
DwPage
======

A widget for displaying texts. It is (currently) the main widget for
rendering HTML documents.


Signals
=======

DwPage defines the same signals as DwImage, with the exception that
the coordinates are always -1. See DwImage.txt for more details.


Collapsing Spaces
=================

The idea behind this is that every text box has a specific vertical
space around, and that they are combined to one space, according to
rules stated below. A rule is either a paragraph within a DwPage
widget, or a DwPage within a DwPage widget, in a single line; the
latter is used for indented boxes and list items.

The rules:

   1. If a box is following another, the space between them is the
      maximum of both box spaces:

         +---------+
         |/////////|
         |/////////|                           +---------+
         +---------+                           |/////////|
         |    A    |                           |/////////|
         +---------+                           +---------+
         |/////////|                           |    A    |
         |/////////|                           +---------+
         +---------+  are combined like this:  |/////////|
                                               |XXXXXXXXX|
         +---------+                           +---------+
         |\\\\\\\\\|                           |    B    |
         +---------+                           +---------+
         |    B    |                           |\\\\\\\\\|
         +---------+                           +---------+
         |\\\\\\\\\|
         +---------+

   2. a) If one box is the first box within another, the upper space
      of these boxes collapse. b) The analogue is the case for the
      last box:

         +---------+                       If B and C are put into A,
         |/////////|                       the result is:
         |/////////|
         +---------+        +---------+      +---------+
         |    A    | <--+-- |\\\\\\\\\|      |/////////|
         +---------+