spacr.qt.widgets.tile
=====================

.. py:module:: spacr.qt.widgets.tile

.. autoapi-nested-parse::

   Tile — a large square button + caption used on the startup screen.

   Hovering the tile animates its icon so the glyph appears to grow
   inside the button frame — the button itself stays the same size.

   Signals:
       clicked() — emitted when the tile is pressed.





Module Contents
---------------

.. py:class:: Tile(text: str, icon: Optional[PySide6.QtGui.QIcon] = None, icon_size: int = 64, tile_size: int = 120, caption: str = '', parent=None)

   Bases: :py:obj:`PySide6.QtWidgets.QWidget`


   Large square tile with an icon and a caption, used on the startup grid.

   :param text: fallback label (also used to derive initials if no icon).
   :param icon: optional QIcon to render inside the tile.
   :param icon_size: base icon side length in px; animates on hover.
   :param tile_size: fixed side length of the tile button in px.
   :param caption: caption shown under the tile; defaults to ``text``.
   :ivar clicked: emitted when the tile button is pressed.


   .. py:attribute:: clicked


   .. py:property:: text
      :type: str


      The tile's text label as passed to the constructor.


