From 0afeeba9c3de3707e4eda6430ce68d419ba05f19 Mon Sep 17 00:00:00 2001 From: Mike Taylor Date: Mon, 11 Aug 2014 14:28:45 +0100 Subject: [PATCH] Document the subwidget() method. --- doc/mkws-developer.markdown | 16 +++++++++++++++- 1 file changed, 15 insertions(+), 1 deletion(-) diff --git a/doc/mkws-developer.markdown b/doc/mkws-developer.markdown index d4e8162..00a5b59 100644 --- a/doc/mkws-developer.markdown +++ b/doc/mkws-developer.markdown @@ -151,7 +151,21 @@ be used by the derived widget. * `expandValue()` -- TODO: either document this or remove it from the API. -* TODO subwidget() +* `subwidget(type, overrides, defaults)` -- + Returns the HTML of a subwidget of the specified type, which + can then be inserted into the widget using the + `this.node.html` function. The subwidget is given the same + attributes at the parent widget that invokes this function, + except where overrides are passed in. If defaults are also + provided, then these are used when the parent widget provides + no values. Both the `overrides` and `defaults` arguments are + hashes: the latter is optional. + + See for example the `Credo` widget defined in the example + area's `mkws-widget-credo.js` file. This uses several + invocations of `subwidget` to create a complex compound widget + with numerous text, facet and image panes. TODO: rename this + widget and everything related to it. In addition to these properties and methods of the bare widget object, some kinds of specific widget add other properties of their own. For -- 1.7.10.4