meta data for this page
  •  

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
section:section-widget [2026/07/20 16:18] – ↷ Links adapted because of a move operation dorepssection:section-widget [2026/07/28 22:56] (current) – doreps
Line 1: Line 1:
-<WRAP hide>%%<!-- googleoff: index -->%%</WRAP>+<Withinide>%%<!-- googleoff: index -->%%</WRAP>
 <WRAP center notice centeralign> <WRAP center notice centeralign>
 **⚠️ v4.0 UI Transition Notice - In Process:** **⚠️ v4.0 UI Transition Notice - In Process:**
Line 52: Line 52:
         * offers a full menu bar         * offers a full menu bar
  
-      *++**App Drawer (pager)**|{{:ui:ui-widget-app_drawer_pager-image.webp?direct&200}}++ [[:section:section-widget#widget:_-_app_drawer_(pager)|(jump to full discussion)]] is a newer type of app drawer widget which scrolls horizontally. It does have differences from the app drawer widget.+      *++**App Drawer (pager)**|{{:ui:ui-widget-app_drawer_pager-image.webp?direct&200}}++ [[:section:section-widget#widget:_-_app_drawer_(pager)|(jump to full discussion)]] is a newer type of app drawer widget which scrolls horizontally. It differs from the app drawer widget.
  
       *++**App Group**|{{:ui:ui-widget-app_group-image.webp?direct&200}}++ [[:section:section-widget#widget:_-_app_group|(jump to full discussion)]] functions similarly to the App Drawer but allows for grouping its items (apps, windows, folders, shortcuts) by user-defined criteria (mostly folders). It offers a customizable layout, icons, labels, and background.       *++**App Group**|{{:ui:ui-widget-app_group-image.webp?direct&200}}++ [[:section:section-widget#widget:_-_app_group|(jump to full discussion)]] functions similarly to the App Drawer but allows for grouping its items (apps, windows, folders, shortcuts) by user-defined criteria (mostly folders). It offers a customizable layout, icons, labels, and background.
Line 124: Line 124:
 The design options are, again, available once the widget is selected and the **Option icon** {{ui:ui-icon_option-v4.webp?direct&15}} is tapped. The design options are, again, available once the widget is selected and the **Option icon** {{ui:ui-icon_option-v4.webp?direct&15}} is tapped.
  
-== Layout & Scrolling ==+== Layout & Quick Scrolling ==
  
   ***View Type** - Toggle between **Grid type** (customizable columns/rows from 1 to 16) or **List type** (vertical list with icon and name).   ***View Type** - Toggle between **Grid type** (customizable columns/rows from 1 to 16) or **List type** (vertical list with icon and name).
-  ***Scrolling** - Behavior is vertical. Options include **System scroll animation**, **Snap scroll** (prevents items from being cut off), or **Hide scrollbar**.+  ***Scrolling** - Vertical scrolling. Options include **System scroll animation**, **Snap scroll** (prevents items from being cut off), **Hide scrollbar**, or **Quick scroll** (see demo ++here|A nice alpha-visual scrolling search effect: {{:ui:ui-widget-app_drawer-quick_scroll-video-v4.gif}}++)
 <WRAP center round tip> <WRAP center round tip>
 Widgets placed in windows that have native scrolling will retain their own internal scrolling characteristics. Widgets placed in windows that have native scrolling will retain their own internal scrolling characteristics.
Line 176: Line 176:
 While the standard "App drawer" is highly customizable, the **App drawer (pager)** widget provides a different structural approach and unique features. A user may prefer this format for the following reasons: While the standard "App drawer" is highly customizable, the **App drawer (pager)** widget provides a different structural approach and unique features. A user may prefer this format for the following reasons:
  
-  ***Paging versus Scrolling:** The fundamental difference is the paginated layout. Instead of a single continuous list, applications are organized across distinct pages that are navigated with a swipe. This can improve organization by allowing users to group apps by category or frequency of use on separate pages.+  ***Paging versus Scrolling:** The fundamental difference is the paginated layout. Instead of a single continuous list, applications are organized across distinct pages that are navigated with a swipe. This can improve organization by allowing users to group apps by category or frequency of use on separate pages. **Quick scrolling** is also offered as in this ++demo|{{:section:section-widget-app_pager-quick_scroll_horiz-v4.gif}} ⇔ {{:section:section-widget-app_pager-quick_scroll_vert-v4.gif}}++ of both vertical //and// horizontal scrolling.
   ***Built-in Search Functionality:** The 'App drawer (pager)' widget includes an integrated app search feature. This provides a significant advantage for users who want to quickly find an application without scrolling through pages or returning to the home screen to use a separate search widget.   ***Built-in Search Functionality:** The 'App drawer (pager)' widget includes an integrated app search feature. This provides a significant advantage for users who want to quickly find an application without scrolling through pages or returning to the home screen to use a separate search widget.
   ***Display Customization:** This widget allows for specific display configurations that differ from the standard drawer.   ***Display Customization:** This widget allows for specific display configurations that differ from the standard drawer.
Line 190: Line 190:
 === Customizable Application Container === === Customizable Application Container ===
  
-The App Group widget is primarily used to display a focused selection of icons, relying heavily on user organization and selection. This selection can include applications, windows, folders, or shortcuts.+The App Group widget primarily displays a focused selection of icons, relying heavily on user organization and selection. This selection can include applications, windows, folders, or shortcuts.
  
 ===  Functions and Tagging === ===  Functions and Tagging ===
Line 198: Line 198:
   ***Tagging:** App Group differs from App Drawer in that tagging is //not// available within the drawer since there is no menu system. Tagging can still be done through the App Drawer but cannot be set anew within the App Group. This should not be a significant loss when deciding to use this widget, since the quasi-tag system by group already populates the widget with the desired objects/folders.   ***Tagging:** App Group differs from App Drawer in that tagging is //not// available within the drawer since there is no menu system. Tagging can still be done through the App Drawer but cannot be set anew within the App Group. This should not be a significant loss when deciding to use this widget, since the quasi-tag system by group already populates the widget with the desired objects/folders.
  
-=== Layout and Display ===+=== Layout, Display, and Quick Scrolling ===
  
 The App Group widget provides extensive control over its layout, supporting both grid and list formats: The App Group widget provides extensive control over its layout, supporting both grid and list formats:
Line 204: Line 204:
   ***Layout Type:** The widget can be toggled between **Grid type** or **List type**.   ***Layout Type:** The widget can be toggled between **Grid type** or **List type**.
   ***Grid Dimensions:** When set to **Grid type**, users can define the number of **Columns** (ranging from 1 to 16) and **Rows** (ranging from 1 to 16) to fit the required space on the page, window, or sliding drawer.   ***Grid Dimensions:** When set to **Grid type**, users can define the number of **Columns** (ranging from 1 to 16) and **Rows** (ranging from 1 to 16) to fit the required space on the page, window, or sliding drawer.
- ***Scrolling:** The layout supports vertical scrolling, which is essential for displaying numerous items. Users can customize the scrolling experience using options such as **system scroll animation**, **snap scroll** (to ensure items settle without being cut off), and **hide scrollbar**. Notably, the App Group currently **does not** support horizontal scrolling (paging) like the specialized App Drawer (pager).+ ***Scrolling:** The layout supports vertical scrolling, which is essential for displaying numerous items. Users can customize the scrolling experience using options such as **system scroll animation**, **snap scroll** (to ensure items settle without being cut off), **hide scrollbar**. Notably, the App Group currently **does not** support horizontal scrolling (paging) like the specialized App Drawer (pager).
   ***Menu: Search, Tag, Sort**: //No// menu system for tag, search, or sort is available.   ***Menu: Search, Tag, Sort**: //No// menu system for tag, search, or sort is available.
  
Line 344: Line 344:
   * **Animation**   * **Animation**
     * **Enter animation** for the analog clock widget. **See more discussion on enter animation here**.     * **Enter animation** for the analog clock widget. **See more discussion on enter animation here**.
-      * If the clock is on the designated home page and the phone is on the home page, the enter animation is affected after a system doze and "awakened" by the power button or phone unlock.+      * If the clock is on the designated home page and the phone is on the home page, the enter animation is affected after a system doze and "awakened" by the power button or phone unlock.  
 +      * Returning to home screen from exiting 'recent apps', enter animation activates.  
 +      * 'Quick Exit' swipe: swiping up from bottom navigation bar wipes the immediate app to backround and brings forth the home screen, in which enter animation also activates, creating a clean transition. 
       * **Fixme ... hopefully, some creative soul will insert another way that this is used or useful!**       * **Fixme ... hopefully, some creative soul will insert another way that this is used or useful!**
  
Line 386: Line 388:
     * Shape - Easily, a user-specific shape could be customized. See [[:ui:ui-resources-shape|here.]]     * Shape - Easily, a user-specific shape could be customized. See [[:ui:ui-resources-shape|here.]]
     * Image - Be creative in selecting an image for the compass needle. North is the top of the image! See [[:ui:ui-resources-image|here.]]     * Image - Be creative in selecting an image for the compass needle. North is the top of the image! See [[:ui:ui-resources-image|here.]]
-  * **Color**: A color can be applied to filter (draw over the skin) the image, providing control over the final appearance of the compass graphic. If using a color, an opaque selection will obscure the skin, whereas a transparent selection (where the # begins with ''00 through ''99'') would cover the compass needle. This uses the launcher's Color Picker utility shown [[:ui:ui-color_picker|here.]] +  * **Color**: A color can be applied to filter (draw over the skin) the image, providing control over the final appearance of the compass graphic. If using a color, an opaque selection will obscure the skin, whereas a transparent selection (where the # begins with ''00'' through ''99'') would cover the compass needle. This uses the launcher's Color Picker utility shown [[:ui:ui-color_picker|here.]] 
-    * Dynamic color: This option will cause the skin/needle colors to harmonize or contrast with changing wallpapers in accordance with Android Material You standards. See the TL screen[[:ui:ui-resources-dynamic_color|here*]] or the concept discussed [[:section:section3-1-customize-dynamic_color|here.]]+    * Dynamic color: This option will cause the skin/needle colors to harmonize or contrast with changing wallpapers in accordance with Android Material You standards. See the TL screen[[:ui:ui-resources-dynamic_color|here*]] or the concept discussed [[section:section-dynamic_color_customize|here.]]
   * **Background**: The background of the widget can be customized.   * **Background**: The background of the widget can be customized.
     * The default background is transparent but can be modified with any of the six options shown above.     * The default background is transparent but can be modified with any of the six options shown above.
Line 394: Line 396:
     * **Enter animation** for the analog clock widget. See [[admin:drafts:section-animations_construction|Page and Object Animation]] and [[:ui:ui-object-animation|UI Object Animation]] for an overview of animations available.     * **Enter animation** for the analog clock widget. See [[admin:drafts:section-animations_construction|Page and Object Animation]] and [[:ui:ui-object-animation|UI Object Animation]] for an overview of animations available.
       * If the compass is on the designated home page and the phone is viewing on the home page, the enter animation is effected after a system doze and "awakened" by the power button or phone unlock.       * If the compass is on the designated home page and the phone is viewing on the home page, the enter animation is effected after a system doze and "awakened" by the power button or phone unlock.
-      * **Fixme ... hopefully, some creative soul will insert another way that this is used or useful!** 
  
 ---- ----
Line 412: Line 413:
 Customization options for the widget container and indicator appearance are: Customization options for the widget container and indicator appearance are:
  
-  * **Color** - Sets the color of the displayed graphic elements using either the launcher's [[:ui:ui-color_picker|Color Picker utility]] or [[:ui:ui-resources-dynamic_color|Dynamic Colors.]]  Learn about the dynamic color scheme [[:section:section3-1-customize-dynamic_color|here.]]+  * **Color** - Sets the color of the displayed graphic elements using either the launcher's [[:ui:ui-color_picker|Color Picker utility]] or [[:ui:ui-resources-dynamic_color|Dynamic Colors.]]  Learn about the dynamic color scheme [[section:section-dynamic_color_customize|here.]]
   * **Background** - Defines the background selections (color, dynamic color, icon pack, shape, image and dynamic image) for the widget container.  See [[:ui:ui-generic-background|Background]] for more details if desired.   * **Background** - Defines the background selections (color, dynamic color, icon pack, shape, image and dynamic image) for the widget container.  See [[:ui:ui-generic-background|Background]] for more details if desired.
   * **Margins**: Allows adjustment of the margins surrounding the widget in its container. See [[:section:section-margins-page_and_object|Understanding Margins in Total Launcher.]]   * **Margins**: Allows adjustment of the margins surrounding the widget in its container. See [[:section:section-margins-page_and_object|Understanding Margins in Total Launcher.]]
Line 479: Line 480:
   * .jpg   * .jpg
   * .png   * .png
 +  * .webp
 </WRAP> </WRAP>
 <WRAP clearb></WRAP> <WRAP clearb></WRAP>
Line 488: Line 490:
   * **Rounded corner radius** - The widget's container defaults to a square but can be resized by tap-hold and grab. The user can choose to round corners by selecting a desired radius, ranging from 0 (square) to 300 (circle). Again, the diameter can be adjusted, even making an ellipse.   * **Rounded corner radius** - The widget's container defaults to a square but can be resized by tap-hold and grab. The user can choose to round corners by selecting a desired radius, ranging from 0 (square) to 300 (circle). Again, the diameter can be adjusted, even making an ellipse.
   * **Disable 3D animation**  - This option disables the default presentation of images in 3D animation consisting of randomly selected launcher animations such as cube, sliding (4 directions), flip, and more. Images will only change by sliding in four random directions.   * **Disable 3D animation**  - This option disables the default presentation of images in 3D animation consisting of randomly selected launcher animations such as cube, sliding (4 directions), flip, and more. Images will only change by sliding in four random directions.
-  * **Keep photo centered** - This keeps all images (some peripheral objects may not be shown), while the default shows images larger than the widget's container in a pan-type view roaming the full image in a random manner.+  * **Keep photo centered** - This keeps all images (some peripheral objects may not be shown), while the default shows images larger than the widget's container in a pan-type view randomly roaming the full image.
   * **Random pick** - Presentation of images defaults to the directory's alpha-numerical order. Activating this option will cause random viewing.   * **Random pick** - Presentation of images defaults to the directory's alpha-numerical order. Activating this option will cause random viewing.
   * **Grayscale** - This option, if activated, displays each image as a gray-scaled image.   * **Grayscale** - This option, if activated, displays each image as a gray-scaled image.
Line 502: Line 504:
 === Functional Characteristics === === Functional Characteristics ===
  
-<WRAP toby>+<WRAP toby rounded>
 <WRAP centeralign>**Toby says: Scroll with RSS in Windows!**</WRAP> <WRAP centeralign>**Toby says: Scroll with RSS in Windows!**</WRAP>
-  * **Scrolling in Windows:** Although windows themselves do //not// scroll their contents, widgets placed inside a window that possess **native scrolling** functionality will scroll correctly. This allows users to view long news feeds within a floating pop-up window or sliding panel.+• **Scrolling in Windows:** Although windows themselves do //not// scroll their contents, widgets placed inside a window that possess **native scrolling** functionality will scroll correctly. This allows users to view long news feeds within a floating pop-up window or sliding panel.
 </WRAP> </WRAP>