Discussion

Example:

cellActions.accessoryButtonTapped = ^(SCTableViewCell *cell, NSIndexPath *indexPath)
{
    NSLog(@"Cell at indexPath:%@ accessory button has been tapped.", indexPath);
};

Discussion

This action is typically used to easily provide a custom behavior for the cell’s custom button(s).

Example:

cellActions.customButtonTapped = ^(SCTableViewCell *cell, NSIndexPath *indexPath, UIButton *button)
{
    NSLog(@"Custom button with tag:%i has been tapped for cell at indexPath:%@.", button.tag, indexPath);
};

Discussion

This action is typically used to add additional custom sections, or modify the already existing automatically generated ones.

Example:

cellActions.detailModelConfigured = ^(SCTableViewCell *cell, NSIndexPath *indexPath, SCTableViewModel *detailModel)
{
    SCTableViewSection *customSection = [SCTableViewSection section];
    SCCustomCell *customCell = [SCCustomCell cellWithText:@"Custom Cell"];
    [customSection addCell:customCell];

    [detailModel addSection:customSection];
};

Discussion

This action is typically used to initially configure the detail model (like set a custom tag for example). Most of the model’s settings can also be configure in the detailModelConfigured action.

Example:

cellActions.detailModelCreated = ^(SCTableViewCell *cell, NSIndexPath *indexPath, SCTableViewModel *detailModel)
{
    detailModel.tag = 100;
};

Discussion

Example:

cellActions.detailModelDidDismiss = ^(SCTableViewCell *cell, NSIndexPath *indexPath, SCTableViewModel *detailModel)
{
    NSLog(@"Detail model has been dismissed.");
};

Discussion

Example:

cellActions.detailModelDidPresent = ^(SCTableViewCell *cell, NSIndexPath *indexPath, SCTableViewModel *detailModel)
{
    NSLog(@"Detail model has been presented.");
};

Discussion

Example:

cellActions.detailModelWillDismiss = ^(SCTableViewCell *cell, NSIndexPath *indexPath, SCTableViewModel *detailModel)
{
    NSLog(@"Detail model will be dismissed.");
};

Discussion

This action is typically used to further customize the detail model’s view controller.

Example:

cellActions.detailModelWillPresent = ^(SCTableViewCell *cell, NSIndexPath *indexPath, SCTableViewModel *detailModel)
{
    detailModel.viewController.title = @"My custom title";
};

Discussion

This action is typically used to provide your own custom detail model, instead of the one automatically generated by the cell. This might be needed in cases where the cell generates a detail SCArrayOfObjectsSection for example, and you need an SCArrayOfObjectsModel instead (to automatically generate sections for instance).

Discussion

This action is typically used to provide your own custom detail view controller, instead of the one automatically generated by the cell.

Discussion

Example:

cellActions.didDeselect = ^(SCTableViewCell *cell, NSIndexPath *indexPath)
{
    NSLog(@"Cell at indexPath:%@ has been selected.", indexPath);
};

Discussion

This action is typically used to change the subviews' layout.

Example:

cellActions.didLayoutSubviews = ^(SCTableViewCell *cell, NSIndexPath *indexPath)
{
    cell.textLabel.frame = CGRect(40, 20, 100, 40);
};

Discussion

This action is typically used to do any customization to the loaded bound value.

Example:

cellActions.didLoadBoundValue = ^NSObject*(SCTableViewCell *cell, NSIndexPath *indexPath, NSObject *value)
{
    // Make sure all string spaces are trimmed before displaying string.

    NSString *stringValue = (NSStirng *)value;
    NSString *trimmedString = [stringValue stringByTrimmingCharactersInSet:[NSCharacterSet whitespaceAndNewlineCharacterSet]];

    return trimmedString;
};

Discussion

Example:

cellActions.didSelect = ^(SCTableViewCell *cell, NSIndexPath *indexPath)
{
    NSLog(@"Cell at indexPath:%@ has been selected.", indexPath);
};

Discussion

This action is typically used to load any cell content that is too expensive to load in willDisplay, such as retrieving data from a web service. This guarantees smooth and uninterrupted scrolling of the table view.

Example:

cellActions.lazyLoad = ^(SCTableViewCell *cell, NSIndexPath *indexPath)
{
    cell.imageView.image = [self retrieveImageForRowAtIndexPath:indexPath];
};

Discussion

This action is typically used to override STV’s behavior when the return button is tapped, and define a custom one.

Example:

cellActions.returnButtonTapped = ^(SCTableViewCell *cell, NSIndexPath *indexPath)
{
    [self doMyCustomAction];
    [cell.ownerTableViewModel moveToNextCellControl:YES];
};

Discussion

This action is typically used to provide a custom behavior when the cell’s value changes.

Example:

cellActions.valueChanged = ^(SCTableViewCell *cell, NSIndexPath *indexPath)
{
    NSLog(@"Cell at indexPath:%@ value has changed to: %@.", indexPath, cell.boundValue);
};

Discussion

This action is typically used to provide a custom cell value validation.

Discussion

This action is typically used to do any customization to the bound value before being committed.

Example:

cellActions.willCommitBoundValue = ^NSObject*(SCTableViewCell *cell, NSIndexPath *indexPath, NSObject *value)
{
    // Make sure all string spaces are trimmed before committing the string.

    NSString *stringValue = (NSStirng *)value;
    NSString *trimmedString = [stringValue stringByTrimmingCharactersInSet:[NSCharacterSet whitespaceAndNewlineCharacterSet]];

    return trimmedString;
};

Discussion

This action is typically used to set the height of the cell, or any other attribute that will affect the cell’s configuration and layout.

Example:

cellActions.willConfigure = ^(SCTableViewCell *cell, NSIndexPath *indexPath)
{
    cell.height = 60;
};

Discussion

Example:

cellActions.willDeselect = ^(SCTableViewCell *cell, NSIndexPath *indexPath)
{
    NSLog(@"Cell at indexPath:%@ is about to be deselected.", indexPath);
};

Discussion

This action is typically used to set any attributes that will affect how the cell is displayed.

Example:

cellActions.willDisplay = ^(SCTableViewCell *cell, NSIndexPath *indexPath)
{
    cell.backgroundColor = [UIColor yellowColor];
};

Discussion

Example:

cellActions.willSelect = ^(SCTableViewCell *cell, NSIndexPath *indexPath)
{
    NSLog(@"Cell at indexPath:%@ is about to be selected.", indexPath);
};

Discussion

This action is typically used to set a custom themeStyle for the cell that is defined in the model’s theme file.

Example:

cellActions.willStyle = ^(SCTableViewCell *cell, NSIndexPath *indexPath)
{
    cell.themeStyle = @"MyCustomStyle";
};