NatAvatar
public final class NatAvatar : UIView
NatAvatar is a class that represents a component from the Design System. The avatar colors change according to the current brand configured in the Design System.
It has 3 styles:
- Icon
- Label
- Image
And 5 sizes:
- standard
- semi
- semiX
- medium
- largeXXX
The default size is standard and the default type is Icon.
The component’s size is not changeable.
It’s type can change according to the configuration methods called after its initialization.
Example of usage:
// using default configuration:
let avatar = NatAvatar()
// or:
let avatar = NatAvatar(size: .medium, style: .image)
Requires
It’s necessary to configure the Design System with a theme or fatalError will be raised.
DesignSystem().configure(with: AvailableTheme)
-
Undocumented
Declaration
Swift
public init(size: Size = .medium, type: Types = .icon, theme: AvailableTheme = .none)
-
Undocumented
Declaration
Swift
public override func layoutSubviews() -
Size is a enum that represents size values for NatAvatar component.
These are all sizes allowed for a NatAvatar:
- standard
- semi
- semiX
- medium
largeXXX
See moreRequires
It’s necessary to configure the Design System with a theme or fatalError will be raised.
DesignSystem().configure(with: AvailableTheme)
Declaration
Swift
public enum Size : CaseIterable -
Style is a enum that represents style values for NatAvatar component.
These are the allowed styles for a NatAvatar:
- icon
- label
image
Requires
It’s necessary to configure the Design System with a theme or fatalError will be raised.
DesignSystem().configure(with: AvailableTheme)
Declaration
Swift
public enum Types : CaseIterable
-
Sets the label text for NatAvatar with
labeltypeDeclaration
Swift
public func configure(name: String)Parameters
namea string with the full name for the avatar or the initials with 2 characters. If the name has more than 2 words, the initials will be the first letter from the first and last names
-
Sets an image for NatAvatar with
imagetypeDeclaration
Swift
public func configure(image: UIImage?)Parameters
imagean UIImage with the image to be displayed. If image is
nil, the component will show the default icon -
Sets a remote image for NatAvatar with
imagetypeDeclaration
Swift
public func configure(imageURL: URL?)Parameters
imageURLa URL containing an image
-
Configures an icon as a fallback. It will appear if the configuration with the remote image fails.
Declaration
Swift
public func configure(setFallbackIcon: String?)Parameters
setFallbackIconAn icon from NatDSIcons, which is sent as a string. Example:
getIcon(.outlinedDefaultMockup) -
Sets an icon for NatAvatar with
icontypeDeclaration
Swift
public func configure(icon: String?)Parameters
iconAn icon from NatDSIcons, which is sent as a string. Example:
getIcon(.outlinedDefaultMockup) -
Sets the default icon
outlinedDefaultMockfor NatAvatar.Declaration
Swift
public func configureWithDefaultIcon()