Skip to content

Latest commit

 

History

History
97 lines (69 loc) · 3.37 KB

APPEARANCE.md

File metadata and controls

97 lines (69 loc) · 3.37 KB

Appearance

There are extensive options available in Tabman to customise the component to your liking. These are divided into appropriate functional structures:

Indicator

Customise how the indicator looks and behaves.

bar.appearance.indicator
Property Type Description Default
preferredStyle TabmanIndicator.Style The preferred style to use for the indicator (optionally conformed to by the bar). nil
color UIColor The color of the bar indicator. tintColor
lineWeight TabmanIndicator.LineWeight The weight (thickness) of the bar indicator if using a line indicator. .normal
isProgressive Bool Whether the indicator transiton is progressive. false
bounces Bool Whether the indicator bounces at the end of page ranges. false
compresses Bool Whether the indicator compresses at the end of page ranges (Unavailable if bounces enabled). false
useRoundedCorners Bool Whether to use rounded corners on line indicators. false

Interaction

Customise how the bar can be interacted with.

bar.appearance.interaction
Property Type Description Default
isScrollEnabled Bool Whether user scroll is enabled on a scrolling button bar. true

Layout

Customise how the bar lays itself and its items out.

bar.appearance.layout
Property Type Description Default
interItemSpacing CGFloat The spacing between items in the bar. 20.0
edgeInset CGFloat The spacing at the edge of the items in the bar. 16.0
height TabmanBar.Height The height for the bar. .auto
itemVerticalPadding CGFloat The vertical padding between the item and the bar bounds. 12.0
itemDistribution ItemDistribution How items in the bar should be distributed. .leftAligned

State

Customise how the bar should react to state changes.

bar.appearance.state
Property Type Description Default
selectedColor UIColor The color to use for selected items in the bar (text/images etc.). .black
color UIColor The text color to use for unselected items in the bar (text/images etc.). .black.withAlphaComponent(0.5)

Style

Customise any stylistic appearance properties of the bar.

bar.appearance.style
Property Type Description Default
background TabmanBarBackgroundView.BackgroundStyle The background style for the bar. .blur(style: .extraLight)
showEdgeFade Bool Whether to show a fade on the items at the bounds edge of a scrolling button bar. false
bottomSeparatorColor UIColor Color of the separator at the bottom of the bar. .clear

Text

Customise any text displayed in a bar.

bar.appearance.text
Property Type Description Default
font UIFont The font to use for text labels in the bar. .systemFont(ofSize: 16.0)