Skip to main content

​
Accordions & Expandables Demo

Accordions are perfect for organizing detailed information that users can explore on demand, reducing visual clutter while keeping content accessible.

​
📚 Basic Accordions

An accordion is a UI component that allows users to expand and collapse content sections. It’s ideal for:
  • FAQ sections
  • Detailed documentation
  • Method overloads
  • Complex property descriptions
Use accordions when you have:
  • Large amounts of related content
  • Optional detailed information
  • Step-by-step instructions
  • Multiple examples or variations

​
🔍 Method Overloads

public void Process()
Processes data using default settings.Parameters: None
Returns: void
Exceptions: None
public void Process(string data)
Processes the specified data string.Parameters:
  • data (string) - The data to process
Returns: void
Exceptions:
  • ArgumentNullException - When data is null
public void Process(string data, ProcessOptions options)
Processes data with custom options.Parameters:
  • data (string) - The data to process
  • options (ProcessOptions) - Processing configuration
Returns: void
Exceptions:
  • ArgumentNullException - When data or options is null
  • InvalidOperationException - When options are invalid
public async Task ProcessAsync(string data, CancellationToken cancellationToken = default)
Asynchronously processes data with cancellation support.Parameters:
  • data (string) - The data to process
  • cancellationToken (CancellationToken) - Cancellation token
Returns: Task
Exceptions:
  • ArgumentNullException - When data is null
  • OperationCanceledException - When operation is cancelled

​
📋 Exception Documentation

When Thrown: When a required parameter is nullCommon Causes:
  • Forgetting to initialize an object
  • Passing null from another method
  • Database returning null values
How to Handle:
try
{
    service.Process(data);
}
catch (ArgumentNullException ex)
{
    logger.LogError(ex, "Required parameter was null");
    // Handle appropriately
}
When Thrown: When the operation is not valid for the current stateCommon Causes:
  • Calling methods in wrong order
  • Object not properly initialized
  • State machine in invalid state
Prevention:
if (service.CanProcess)
{
    service.Process(data);
}
When Thrown: When an operation is not supportedCommon Scenarios:
  • Read-only collections
  • Abstract methods
  • Platform-specific features
Example:
public virtual void AdvancedFeature()
{
    throw new NotSupportedException(
        "This feature is not supported in the base implementation");
}

​
🛠️ Configuration Examples

{
  "logging": {
    "level": "Information"
  },
  "database": {
    "connectionString": "Server=localhost;Database=MyApp"
  }
}

{
  "logging": {
    "level": "Debug",
    "providers": ["Console", "File"],
    "file": {
      "path": "logs/app.log",
      "rollingInterval": "Day"
    }
  },
  "database": {
    "connectionString": "Server=localhost;Database=MyApp",
    "commandTimeout": 30,
    "retryCount": 3,
    "enableSensitiveDataLogging": false
  },
  "caching": {
    "enabled": true,
    "duration": "00:05:00"
  }
}

{
  "logging": {
    "level": "Warning",
    "providers": ["ApplicationInsights"],
    "applicationInsights": {
      "instrumentationKey": "your-key-here",
      "enableAdaptiveSampling": true
    }
  },
  "database": {
    "connectionString": "Server=prod-server;Database=MyApp;Encrypt=true",
    "commandTimeout": 60,
    "retryCount": 5,
    "maxPoolSize": 100
  },
  "security": {
    "requireHttps": true,
    "enableHsts": true,
    "corsOrigins": ["https://app.example.com"]
  }
}
Accordions can be nested and combined with other components for rich, interactive documentation.
Use accordions to keep your documentation scannable while still providing comprehensive information for those who need it.