summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--API.md11
-rw-r--r--init.lua12
2 files changed, 19 insertions, 4 deletions
diff --git a/API.md b/API.md
index cb92f65..f275f78 100644
--- a/API.md
+++ b/API.md
@@ -404,10 +404,13 @@ this function may be deprecated if it isn't needed anymore.
#### Parameters
* `data`: Text to be written inside the widget
-* `x`: Formspec X coordinate
-* `y`: Formspec Y coordinate
-* `width`: Width of the widget in formspec units
-* `height`: Height of the widget in formspec units
+* `x`: Formspec X coordinate (optional)
+* `y`: Formspec Y coordinate (optional)
+* `width`: Width of the widget in formspec units (optional)
+* `height`: Height of the widget in formspec units (optional)
+
+The default values for the optional parameters result in a widget which fills
+nearly the entire entry page.
#### Return value
A string which contains a complete formspec definition building the widget.
diff --git a/init.lua b/init.lua
index df9641f..b1b6a03 100644
--- a/init.lua
+++ b/init.lua
@@ -424,6 +424,18 @@ doc.widgets = {}
local text_id = 1
-- Scrollable freeform text
doc.widgets.text = function(data, x, y, width, height)
+ if x == nil then
+ x = doc.FORMSPEC.ENTRY_START_X
+ end
+ if y == nil then
+ y = doc.FORMSPEC.ENTRY_START_Y
+ end
+ if width == nil then
+ width = doc.FORMSPEC.ENTRY_WIDTH
+ end
+ if height == nil then
+ height = doc.FORMSPEC.ENTRY_HEIGHT
+ end
local baselength = 80
local widget_basewidth = doc.FORMSPEC.WIDTH
local linelength = math.max(20, math.floor(baselength * (width / widget_basewidth)))