|author||Michael Drake <email@example.com>||2017-06-11 12:38:13 +0100|
|committer||Michael Drake <firstname.lastname@example.org>||2017-06-11 12:38:13 +0100|
Docs: Update architecture with plan for text handling.
1 files changed, 46 insertions, 14 deletions
diff --git a/docs/architecture.md b/docs/architecture.md
index c45d355..7c5b091 100644
@@ -1,7 +1,7 @@
-`LibNSLayout` is a library for performing layout on a Document Object Model
+LibNSLayout is a library for performing layout on a Document Object Model
for HTML. Its purpose is to allow client applications to provide DOM
information and convert that into a render list, which can be displayed
by the client.
@@ -9,8 +9,8 @@ by the client.
-Clients of `LibNSLayout` must use the following additional libraries, because
-their types are used in the `LibNSLayout` interface:
+Clients of LibNSLayout must use the following additional libraries, because
+their types are used in the LibNSLayout interface:
* `LibDOM` is used to provide the DOM interface.
* `LibCSS` is used to provide the CSS handling.
@@ -19,7 +19,7 @@ their types are used in the `LibNSLayout` interface:
-The devision of responsibilities between `LibNSLayout` and its clients are
+The devision of responsibilities between LibNSLayout and its clients are
@@ -27,34 +27,66 @@ as follows:
* Fetching the document to be displayed.
* Creating a CSS selection context (with default user-agent, and user CSS).
* Generating DOM.
-* Creating a `LibNSLayout` layout for the document, passing the DOM document,
- CSS selection context, and appropriate CSS media descriptor.
+* Creating a LibNSLayout layout for the document, passing the DOM document,
+ CSS selection context, appropriate CSS media descriptor, and scale.
* Listening to DOM changes.
* Fetching resources needed by DOM.
* CSS (STYLE elements, and LINK elements):
* Parsing the CSS.
* Updating CSS selection context as stylesheets are fetched,
- and notifying `LibNSLayout`.
+ and notifying LibNSLayout.
* Favicons (LINK elements.)
* Images, Frames, Iframes.
- * Notifying `LibNSLayout` of DOM changes.
+ * Notifying LibNSLayout of DOM changes.
* Performing resource fetches on behalf of LibNSLayout.
* (Such as when LibNSLayout requires a background image or web font for
an element due to CSS.)
-* Asking `LibNSLayout` to perform layout.
+* Asking LibNSLayout to perform layout.
* Displaying the returned render list.
-* Passing mouse actions to `LibNSLayout`.
-* Passing keyboard input to `LibNSLayout`.
-* Measuring text???
+* Passing mouse actions to LibNSLayout.
+* Passing keyboard input to LibNSLayout.
+* Passing scale changes to LibNSLayout.
+* Performing measurement of text; given a string & style, calculating its
+ width in pixels.
* Creates a layout object that's opaque to the client, and returns its
* Performs CSS selection as appropriate when DOM changes.
* Asking client to fetch a resource that's needed for a computed style.
+* Asking client to measure text.
+* Performs line breaking.
* Performs layout (if required) when asked by client and returns render list.
* Performs layout (if required) when asked by client for layout info.
+### Text layout
+LibNSLayout is responsible for performing line-breaking. It uses a third
+party library ([libunibreak](https://github.com/adah1972/libunibreak)) to
+provide the Unicode line breaking algorithm implementation. LibNSLayout
+1. Pass the text of a paragraph to the `libunibreak` and get back a list of
+ possible break points.
+2. Ask the client to measure each non-breakable section.
+3. Try to fit as many non-breakable sections on a line as possible, given
+ the available width.
+Note that some breaks may not be permissable, since they will fall inside
+inline elements which are styled to prevent wrap. Also, to measure each
+non-breakable section, there may be multiple calls to the client to measure
+sub-sections of the non-breakable section according to different parts of the
+text having different styles. We can probably avoid this depending on which
+CSS properties are different. (e.g. `color` and `text-decoration` won't affect
+> 1. How to do justified text?