tkinterweb 4.17.4__py3-none-any.whl → 4.17.5__py3-none-any.whl

tkinterweb/bindings.py

@@ -584,7 +584,7 @@ It is likely that not all dependencies are installed. Make sure Cairo is install
     # --- HTML/CSS parsing ----------------------------------------------------
 
     def parse(self, html, thread_safe=False):
-        "Parse HTML code. reset() must be called before running parse() for the first time."
+        "Parse HTML code. Call :meth:`TkinterWeb.reset` before calling this method for the first time."
         # NOTE: when thread_safe=True, this method is thread-safe
 
         self.downloads_have_occured = False
@@ -769,20 +769,20 @@ It is likely that not all dependencies are installed. Make sure Cairo is install
         else:
             return None, None
 
-    def text(self, *args):
-        "Enable interaction with the text of the HTML document."
-        return self.tk.call(self._w, "text", *args)
+    def text(self, subcommand, *args):
+        "Interact with the text of the HTML document. Valid subcommands are bbox, index, offset, and text."
+        return self.tk.call(self._w, "text", subcommand, *args)
 
     def tag(self, subcommand, tag_name, *args):
-        "Return the name of the Html tag that generated this document node, or an empty string if the node is a text node."
+        "Highlight regions of text displayed by the widget. Valid subcommands are add, remove, configure, and delete."
         return self.tk.call(self._w, "tag", subcommand, tag_name, *args)
 
     def search(self, selector, *a, cnf={}, **kw):
-        """Search the document for the specified CSS selector; return a Tkhtml3 node if found."""
+        """Search the document for the specified CSS selector; return a Tkhtml node if found."""
         return self.tk.call((self._w, "search", selector)+utilities.TclOpt(a)+self._options(cnf, kw))
 
     def xview(self, *args, auto_scroll=False):
-        "Used to control horizontal scrolling."
+        "Control horizontal scrolling."
         #if args:
         #    return self.tk.call(self._w, "xview", *args)
         #coords = map(float, self.tk.call(self._w, "xview").split()) #raises an error
@@ -802,7 +802,7 @@ It is likely that not all dependencies are installed. Make sure Cairo is install
         return self.xview("moveto", number, auto_scroll=auto_scroll)
 
     def yview(self, *args, auto_scroll=False):
-        """Used to control vertical scrolling."""
+        """Control vertical scrolling."""
         yview = self.tk.call(self._w, "yview", *args)
         if args:
             self.caret_manager.update(auto_scroll=auto_scroll)
@@ -970,11 +970,11 @@ It is likely that not all dependencies are installed. Make sure Cairo is install
         self.tk.call(node, "dynamic", "set", name)
 
     def remove_node_flags(self, node, name):
-        "Set dynamic flags on the given node."
+        "remove dynamic flags on the given node."
         self.tk.call(node, "dynamic", "clear", name)
 
     def get_node_tkhtml(self, node_handle):
-        "Get the path name of node."
+        "Get the path name of the node's corresponding Tkhtml instance."
         return self.tk.call(node_handle, "html")
 
     def get_node_stacking(self, node_handle):
@@ -985,7 +985,7 @@ It is likely that not all dependencies are installed. Make sure Cairo is install
         return self.tk.call(node_handle, "stacking")
 
     def get_current_hovered_node(self, event):
-        "Get current node."
+        "Get the current node."
         if self.widget_manager.hovered_embedded_node:
             return self.widget_manager.hovered_embedded_node
 
@@ -994,11 +994,11 @@ It is likely that not all dependencies are installed. Make sure Cairo is install
         )
 
     def get_current_hovered_node_parent(self, node):
-        "Get the parent of the given node."
+        "Get the parent of the node returned by :meth:`TkinterWeb.get_current_hovered_node`."
         return self.tk.eval(f"""set node [lindex [lindex [{node} parent] end] end]""")
 
     def register_handler(self, handler_type, node_tag, callback):
-        "Register a node handler"
+        "Register a node handler."
         self.tk.call(self._w, "handler", handler_type, node_tag, self.register(callback))
 
     def _lazy_handler(self, manager, method):
@@ -1008,7 +1008,7 @@ It is likely that not all dependencies are installed. Make sure Cairo is install
         return callback
     
     def register_lazy_handler(self, handler_type, node_tag, manager_name):
-        "Register a node handler to run in the given manager"
+        "Register a node handler to run lazily in the given manager."
         if handler_type == "attribute":
             callback_name = f"_on_{node_tag}_value_change"
         else:

tkinterweb/htmlwidgets.py

@@ -1106,6 +1106,9 @@ class HtmlFrame(Frame):
         """Make all elements with the 'tkinterweb-full-page' attribute the same height as the html widget.
         This can be used in conjunction with table elements to vertical align pages,
         which is otherwise not possible with Tkhtml. Hopefully we won't need this forever."""
+        if self._html.cget("shrink"):
+            return
+
         if event:
             height = event.height
         else:
@@ -1422,18 +1425,12 @@ class HtmlLabel(HtmlFrame):
 
         self._style = Style()
 
-        if text:
-            self.load_html(text)
-        # I'd like to just make this an else statement
-        # But someone in issue 145 mentioned layout issues when that was the case
-        # I can't seem to reproduce it though...?
+        if text: self.load_html(text)
+        # I'd like to just make this an else statement to prevent the widget from being a massive white screen when text=""
         elif self.unshrink or (not self._html.using_tkhtml30 and not self._html.cget("textwrap")):
+            # A fellow in issue 145 mentioned layout issues when this was used
+            # I can't seem to reproduce it though...?
             self.load_html("<body></body>", _relayout=False)
-
-    def _handle_html_resize(self, *args, **kwargs):
-        # Overwrite HtmlFrame._handle_html_resize, which is not necessary when shrink is set to True
-        # HtmlFrame._handle_html_resize also causes weird behaviour when tables are present and shrink set to True
-        return
     
     def load_html(self, *args, _relayout=True, **kwargs):
         ""

tkinterweb/utilities.py

@@ -31,7 +31,7 @@ __title__ = "TkinterWeb"
 __author__ = "Andrew Clarke"
 __copyright__ = "(c) 2021-2025 Andrew Clarke"
 __license__ = "MIT"
-__version__ = "4.17.4"
+__version__ = "4.17.5"
 
 
 ROOT_DIR = os.path.join(os.path.abspath(os.path.dirname(__file__)), "resources")

{tkinterweb-4.17.4.dist-info → tkinterweb-4.17.5.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: tkinterweb
-Version: 4.17.4
+Version: 4.17.5
 Summary: HTML/CSS viewer, editor, and app builder for Tkinter
 Home-page: https://github.com/Andereoo/TkinterWeb
 License: MIT

{tkinterweb-4.17.4.dist-info → tkinterweb-4.17.5.dist-info}/RECORD

@@ -1,17 +1,17 @@
 tkinterweb/__init__.py,sha256=mKnt2RjNd0zMntvkmT4dn5iyytsko7fJJb-rnx4H82E,4690
-tkinterweb/bindings.py,sha256=XE0CPX28YtwBW9g9l0nsVVSHe3O3pX19w6POxorX8_k,73563
+tkinterweb/bindings.py,sha256=dmWC_fnkA8Byg68KmapVUuA6b-xo4tHgbLgDrjE2HFU,73721
 tkinterweb/dom.py,sha256=6zEZUGMSdWuwu1-MQOpt1XJN-w_Aku1HGY5P2iM2ksE,43546
 tkinterweb/extensions.py,sha256=QfV13omkMoeXe17JPbeJjykwXtWTcZ24mKuB7NoBgVI,46555
 tkinterweb/handlers.py,sha256=3ptECxVAiSarldfi4_C_mqd7A9xyTzpqvgwOKcBCX_I,42583
-tkinterweb/htmlwidgets.py,sha256=oY54k7MHh-h0vv2f1ueKKLFQ_xdzMncxy_iP2dPvi6M,104583
+tkinterweb/htmlwidgets.py,sha256=f0BYn73_L--qIvgBY71M_rRgbMhw1CaBccWcC3JNGdc,104412
 tkinterweb/imageutils.py,sha256=Du6vX00Isx7z1Q6sVV4po9ycYrP_iDG22ScG04U_huQ,5368
 tkinterweb/js.py,sha256=Wlameh5KGK3GKzBCczaWYWT1L6-5uOWHt1HCZmzrjLk,3597
 tkinterweb/subwidgets.py,sha256=wT4gtUnUE5j9UA8lrKCjLaysWqHav-_46NF97uMswDo,28200
-tkinterweb/utilities.py,sha256=qbIa6pVBcszMGUnADQS3FWNRUNGfh7WqeslcDms76Qs,43431
+tkinterweb/utilities.py,sha256=n9P2abX9zxx2R4p9uYZpBugh1FtpXHsc5bQaEL7zB98,43431
 tkinterweb/resources/combobox-2.3.tm,sha256=flofzRxHJMeEj0I--4iLT9SWIo9G1MSIwY0h940tG-U,65083
 tkinterweb/resources/pkgIndex.tcl,sha256=Zp99aTL170d0TbVrWS-6uzaIaykUQbRO0krvmJhcduA,77
-tkinterweb-4.17.4.dist-info/LICENSE.md,sha256=Jf8BR3uTR9RLMAA2osul_ZRkvoYRgmlqq1Pd-xt0uMY,1074
-tkinterweb-4.17.4.dist-info/METADATA,sha256=GEebp4G7WKDAUcdRFPjqgJTstCS5qnw20In6nMXyVg0,3133
-tkinterweb-4.17.4.dist-info/WHEEL,sha256=oiQVh_5PnQM0E3gPdiz09WCNmwiHDMaGer_elqB3coM,92
-tkinterweb-4.17.4.dist-info/top_level.txt,sha256=QVZQjAzSgzBGwOl41qcOyvkYAwy1FXLlnvwtYvE9Ur4,11
-tkinterweb-4.17.4.dist-info/RECORD,,
+tkinterweb-4.17.5.dist-info/LICENSE.md,sha256=Jf8BR3uTR9RLMAA2osul_ZRkvoYRgmlqq1Pd-xt0uMY,1074
+tkinterweb-4.17.5.dist-info/METADATA,sha256=q2ho2BAvubwNmZEdY1NS8f9fLFyUKwsw3QDTd69UMZ0,3133
+tkinterweb-4.17.5.dist-info/WHEEL,sha256=oiQVh_5PnQM0E3gPdiz09WCNmwiHDMaGer_elqB3coM,92
+tkinterweb-4.17.5.dist-info/top_level.txt,sha256=QVZQjAzSgzBGwOl41qcOyvkYAwy1FXLlnvwtYvE9Ur4,11
+tkinterweb-4.17.5.dist-info/RECORD,,