Update component docs

druid/base/lang_text.lua

@@ -2,6 +2,15 @@
 -- Good working with localization system
 -- @module druid.lang_text
 
+--- Component events
+-- @table Events
+-- @tfield druid_event on_change On change text callback
+
+--- Component fields
+-- @table Fields
+-- @tfield druid.text text The text component
+
+local Event = require("druid.event")
 local const = require("druid.const")
 local settings = require("druid.system.settings")
 local component = require("druid.component")
@@ -9,31 +18,23 @@ local component = require("druid.component")
 local M = component.create("lang_text", { const.ON_CHANGE_LANGUAGE })
 
 
-function M.init(self, node, lang_id, no_adjust)
+--- Component init function
+-- @function lang_text:init
+-- @tparam node node The text node
+-- @tparam string locale_id Default locale id
+-- @tparam bool no_adjust If true, will not correct text size
+function M.init(self, node, locale_id, no_adjust)
 	self.druid = self:get_druid()
-	self.text = self.druid:new_text(node, lang_id, no_adjust)
-	self:translate(lang_id)
+	self.text = self.druid:new_text(node, locale_id, no_adjust)
+
+	self.on_change = Event()
+
+	self:translate(locale_id)
 
 	return self
 end
 
 
-function M.set_to(self, text)
-	self.last_locale = false
-	self.text:set_to(text)
-end
-
-
---- Translate the text by locale_id
--- @function text:translate
--- @tparam table self Component instance
--- @tparam string locale_id Locale id
-function M.translate(self, locale_id)
-	self.last_locale = locale_id or self.last_locale
-	self.text:set_to(settings.get_text(self.last_locale))
-end
-
-
 function M.on_change_language(self)
 	if self.last_locale then
 		M.translate(self)
@@ -41,4 +42,23 @@ function M.on_change_language(self)
 end
 
 
+--- Setup raw text to lang_text component
+-- @function lang_text:set_to
+-- @tparam string text Text for text node
+function M.set_to(self, text)
+	self.last_locale = false
+	self.text:set_to(text)
+	self.on_change:trigger()
+end
+
+
+--- Translate the text by locale_id
+-- @function lang_text:translate
+-- @tparam string locale_id Locale id
+function M.translate(self, locale_id)
+	self.last_locale = locale_id or self.last_locale
+	self.text:set_to(settings.get_text(self.last_locale))
+end
+
+
 return M