======  Layout Options - List ======

<wrap bigger>**This is a LONG dialog.**</wrap> Selections are discussed below the image. To navigate to an item, select it in the Layout List Options image.

{{imapmarkers>:ui:ui-layout-list-dialog_options-gen_sound_icon-v4.webp?300|Layout Options - List 1 of 2}}
[[:|ID1|Launch animation@20,142,289,190]]
[[:|ID1|Sound - All navigate to the same dialog@20,273,173,513]]
[[:|ID2|Icon color filter@20,1012,277,1058]]
{{cfg>}}
{
}
{{<cfg}}
{{<imapmarkers}}
{{imapmarkers>:ui:ui-layout-list-dialog_options-label_background-v4.webp?300|Layout Options - List 2 of 2}}
[[:|ID1|Typeface@20,111,275,153]]
[[:|ID2|Text color@22,478,277,515]]
[[:|ID3|Text color (pressed)@22,548,276,584]]
[[:|ID4|Shadow color@20,615,277,653]]
[[:|ID5|Background@21,1042,275,1078]]
[[:|ID6|Margins@20,1105,275,1138]]
[[:|ID7|Item background@21,1167,275,1207]]
[[:|ID8|Item background (pressed)@22,1234,274,1276]]
[[:|ID9|Item background (focused)@22,1305,276,1343]]
{{cfg>}}
{
}
{{<cfg}}
{{<imapmarkers}}
<wrap hi>**Layout Options - List dialog. Make selection above.**</wrap>

====== Layout Options - List ======

Dialog selections are discussed below the images. To navigate to an item, select it in the List Layout Options images.

The Layout Options - List dialog configures spatial dimensions, sound behaviors, typography, and container backgrounds for vertical linear layouts:

  * **General:**
    * **Rows:** Defines the number of visible item rows displayed simultaneously within the container boundaries (default is 5; range is 1 to 16). Scrolling reveals additional rows.
    * **Launch animation (PRO):** Sets the visual transition animation triggered when launching an item from the list (defaults to ''System default'').

  * **Launch sound:** Assigns sound effects to specific touch and directional gestures performed on any item within the layout.
    * **Tap:** Audio file played upon a single tap interaction.
    * **Swipe up / Swipe down:** Audio files triggered by upward or downward vertical swipes.
    * **Swipe left / Swipe right:** Audio files triggered by horizontal swipes across list items.

  * **Icon:** Controls global sizing, spacing, and color styling for all item icons within the list.
    * **Icon size:** Scales the display dimensions of the icons (default is 180).
    * **Icon padding:** Adjusts internal padding surrounding each icon within its bounding box.
    * **Icon opacity (%):** Sets global transparency for all icons (0% to 100%).
    * **Icon saturation (%):** Adjusts color intensity from grayscale (0%) to full color (100%).
    * **Icon color filter:** Applies a uniform color tint overlay across all contained icons.

  * **Label & Shadow:** Controls typography, line clamping, and text contrast.
    * **Show label:** Master toggle to enable or disable text label visibility.
    * **Typeface:** Selects the font family applied to all labels.
    * **Label lines:** Sets the maximum permitted text lines (1 to 3) before truncating.
    * **Font size:** Adjusts label point size (0 uses the global theme default).
    * **Scale X (%):** Horizontally compresses or expands label text (50% to 200%).
    * **Text color / Text color (pressed):** Defines resting and active-tap hex colors (e.g., ''#FFFFFFFF'').
    * **Shadow color / Shadow radius:** Configures blur radius and hue for underlying text drop shadows.
    * **Shadow offset X / Shadow offset Y:** Shifts drop shadow position horizontally and vertically.

  * **Background:** Controls container-level and item-level surface backgrounds.
    * **Background:** Sets the fill color, gradient, or image resource for the entire list container.
    * **Margins:** Defines outer border spacing (left, top, right, bottom).
    * **Item background:** Resting background visual for each individual list item row.
    * **Item background (pressed):** Background appearance displayed while an item is being tapped.
    * **Item background (focused):** Visual state displayed when an item is selected via hardware keys or focus controls.

<WRAP noprint>{{page>site:site-footer-comment_feedback_block}}</WRAP>

<wrap hide>
===== Hidden Index Anchors =====
[[:ui:ui-layout-list-options-general]]
[[:ui:ui-layout-list-options-sound]]
[[:ui:ui-layout-list-options-icon]]
[[:ui:ui-layout-list-options-label]]
[[:ui:ui-layout-list-options-background]]
</wrap>

<wrap hide>
===== Hidden Index Anchors =====
  * [[:ui:target_page_1]]
  * [[:ui:target_page_2]]
</wrap>
<WRAP noprint>{{page>site:site-footer-comment_feedback_block}}</WRAP>