Salesforce Docs Portal

iOS Component Documentation Overview

The Agentforce iOS SDK provides specialized SwiftUI components for building rich, interactive conversational AI interfaces. These components are designed to handle specific aspects of conversation UI, from image display to user input, providing a comprehensive toolkit for creating engaging chat experiences.

Component Categories

  • Image Components - Async image loading, display, and caching components for visual content in conversations

Component Architecture

The component system is built on SwiftUI and follows modern iOS design patterns, providing:

Core Design Principles

  • SwiftUI Native: Built entirely with SwiftUI for optimal performance and integration
  • Accessibility First: Comprehensive accessibility support for all components
  • Theme Integration: Seamless integration with the Agentforce theming system
  • Responsive Design: Adaptive layouts that work across different screen sizes

Component Features

  • Async Loading: Non-blocking image and content loading
  • Error Handling: Graceful fallbacks for failed content loads
  • Performance Optimization: Efficient rendering and memory management
  • Customization: Extensive theming and styling options

Image Components

The image component system provides comprehensive image handling capabilities:

SalesforceAsyncImage

A specialized async image component that provides:

  • Automatic Loading: Seamless image loading with progress indicators
  • Fallback Support: Graceful handling of loading failures
  • Caching: Intelligent image caching for performance
  • Accessibility: Full accessibility support with proper labels

AgentforceImageProvider

A protocol-based image provider system that enables:

  • Custom Image Sources: Integration with any image service
  • Caching Strategies: Flexible caching implementation
  • Error Handling: Custom error handling and fallbacks
  • Performance Tuning: Optimized image loading and processing

Integration Patterns

Basic Image Display

Use the SalesforceAsyncImage component for seamless image loading with built-in fallback support.

Custom Image Provider

Implement custom image providers that integrate with your existing image services and caching strategies.

Component Benefits

  • Consistent UI: Standardized components ensure consistent user experience
  • Performance: Optimized for smooth scrolling and fast loading
  • Accessibility: Built-in accessibility features for inclusive design
  • Theming: Seamless integration with Agentforce theme system
  • Error Resilience: Robust error handling and fallback mechanisms

Best Practices

  • Use Async Components: Leverage async loading for better performance
  • Implement Fallbacks: Always provide fallback content for failed loads
  • Test Accessibility: Verify accessibility features work with screen readers
  • Optimize Images: Use appropriate image sizes and formats
  • Handle Errors: Implement comprehensive error handling for network issues

Next Steps