UISelectionList Theming Parameters¶
UISelectionList
theming block id is 'selection_list'.
Colours¶

A diagram of which part of the element is themed by which colour parameter.
UISelectionList
makes use of the following these colour parameters in
a 'colours' block. All of these colours can also be a colour gradient:
- "dark_bg" - The background colour/gradient of the selection list element. Often you won't see this unless your list buttons are semi-transparent.
- "normal_border" - The colour/gradient of the border around the selection list (if it has one).
Misc¶
UISelectionList
accepts the following miscellaneous parameters in a 'misc' block:
- "shape" - Can be one of 'rectangle' or 'rounded_rectangle'. Different shapes for this UI element.
- "shape_corner_radius" - Only used if our shape is 'rounded_rectangle'. It sets the radius used for the rounded corners. Defaults to "2".
- "border_width" - The width of the border around the element in pixels. Defaults to "1".
- "shadow_width" - The width of the shadow around the element in pixels. Defaults to "2".
- "list_item_height" - The pixel height of a the items in the list. Defaults to "20".
- "tool_tip_delay" - time in seconds before the button's tool tip (if it has one) will appear. Default is "1.0".
Sub-elements¶
The selection list may also contain a UIVerticalScrollBar
which you
can reference with the block id 'window.vertical_scroll_bar'. You can also reference all of the buttons that are sub
elements of the scroll bar with a theming block id of 'window.vertical_scroll_bar.button', or pick out the list item
buttons specifically with a class_id of '@selection_list_item'.
You can further reference the individual buttons of the scroll bar by adding their object IDs:
- 'window.vertical_scroll_bar.#top_button'
- 'window.vertical_scroll_bar.#bottom_button'
- 'window.vertical_scroll_bar.#sliding_button'
There is more information on theming the vertical scroll bar at UIVerticalScrollBar Theming Parameters.
Example¶
Here is an example of a panel block in a JSON theme file, using the parameters described above.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 | { "selection_list": { "colours": { "dark_bg":"#21282D", "normal_border": "#999999" }, "background_image": { "path": "data/images/splat.png", "sub_surface_rect": "0,0,32,32" }, "misc": { "shape": "rounded_rectangle", "shape_corner_radius": "10", "border_width": "1", "shadow_width": "15", "list_item_height": "30" } }, "selection_list.@selection_list_item": { "misc": { "border_width": "2" } } } |