class GridFieldDeleteAction extends AbstractGridFieldComponent implements GridField_ColumnProvider, GridField_ActionProvider, GridField_ActionMenuItem (View source)

This class is a GridField component that adds a delete action for objects.

This component also supports unlinking a relation instead of deleting the object.

Use the $removeRelation property set in the constructor.

$action = GridFieldDeleteAction::create(); // delete objects permanently

// removes the relation to object instead of deleting
$action = GridFieldDeleteAction::create(true);

Traits

A class that can be instantiated or replaced via DI

Properties

protected bool $removeRelation

If this is set to true, this GridField_ActionProvider will remove the object from the list, instead of deleting.

Methods

public static 
create(mixed ...$args)

An implementation of the factory method, allows you to create an instance of a class

public static 
singleton(string $class = null)

Creates a class instance by the "singleton" design pattern.

public
__construct(bool $removeRelation = false)

No description

public
string
getTitle(GridField $gridField, ViewableData $record, $columnName)

No description

public
string|null
getGroup(GridField $gridField, ViewableData $record, $columnName)

No description

public
array
getExtraData(GridField $gridField, ViewableData $record, $columnName)

No description

public
augmentColumns(GridField $gridField, array $columns)

Add a column 'Delete'

public
array
getColumnAttributes(GridField $gridField, ViewableData $record, string $columnName)

Return any special attributes that will be used for FormField::create_tag()

public
array
getColumnMetadata(GridField $gridField, string $columnName)

Add the title

public
array
getColumnsHandled(GridField $gridField)

Which columns are handled by this component

public
array
getActions(GridField $gridField)

Which GridField actions are this component handling

public
string
getColumnContent(GridField $gridField, ViewableData $record, string $columnName)

No description

public
handleAction(GridField $gridField, string $actionName, array $arguments, array $data)

Handle the actions and apply any changes to the GridField

protected
getRemoveAction(GridField $gridField, ViewableData $record, string $columnName)

No description

public
bool
getRemoveRelation()

Get whether to remove or delete the relation

public
$this
setRemoveRelation(bool $removeRelation)

Set whether to remove or delete the relation

Details

static Injectable create(mixed ...$args)

An implementation of the factory method, allows you to create an instance of a class

This method will defer class substitution to the Injector API, which can be customised via the Config API to declare substitution classes.

This can be called in one of two ways - either calling via the class directly, or calling on Object and passing the class name as the first parameter. The following are equivalent: $list = DataList::create(SiteTree::class); $list = SiteTree::get();

Parameters

mixed ...$args

Return Value

Injectable

static Injectable singleton(string $class = null)

Creates a class instance by the "singleton" design pattern.

It will always return the same instance for this class, which can be used for performance reasons and as a simple way to access instance methods which don't rely on instance data (e.g. the custom SilverStripe static handling).

Parameters

string $class

Optional classname to create, if the called class should not be used

Return Value

Injectable

The singleton instance

__construct(bool $removeRelation = false)

No description

Parameters

bool $removeRelation
  • true if removing the item from the list, but not deleting it

string getTitle(GridField $gridField, ViewableData $record, $columnName)

No description

Parameters

GridField $gridField
ViewableData $record
$columnName

Return Value

string $title

string|null getGroup(GridField $gridField, ViewableData $record, $columnName)

No description

Parameters

GridField $gridField
ViewableData $record
$columnName

Return Value

string|null $group

array getExtraData(GridField $gridField, ViewableData $record, $columnName)

No description

Parameters

GridField $gridField
ViewableData $record
$columnName

Return Value

array $data

augmentColumns(GridField $gridField, array $columns)

Add a column 'Delete'

Parameters

GridField $gridField
array $columns

List reference of all column names.

array getColumnAttributes(GridField $gridField, ViewableData $record, string $columnName)

Return any special attributes that will be used for FormField::create_tag()

Parameters

GridField $gridField
ViewableData $record

displayed in this row

string $columnName

Return Value

array

array getColumnMetadata(GridField $gridField, string $columnName)

Add the title

Parameters

GridField $gridField
string $columnName

Return Value

array
  • Map of arbitrary metadata identifiers to their values.

array getColumnsHandled(GridField $gridField)

Which columns are handled by this component

Parameters

GridField $gridField

Return Value

array

array getActions(GridField $gridField)

Which GridField actions are this component handling

Parameters

GridField $gridField

Return Value

array

with action identifier strings.

string getColumnContent(GridField $gridField, ViewableData $record, string $columnName)

No description

Parameters

GridField $gridField
ViewableData $record
  • Record displayed in this row
string $columnName

Return Value

string
  • HTML for the column. Return NULL to skip.

handleAction(GridField $gridField, string $actionName, array $arguments, array $data)

Handle the actions and apply any changes to the GridField

Parameters

GridField $gridField
string $actionName

Action identifier, see getActions().

array $arguments

Arguments relevant for this

array $data

All form data

Exceptions

ValidationException

protected GridField_FormAction|null getRemoveAction(GridField $gridField, ViewableData $record, string $columnName)

No description

Parameters

GridField $gridField
ViewableData $record
string $columnName

Return Value

GridField_FormAction|null

bool getRemoveRelation()

Get whether to remove or delete the relation

Return Value

bool

$this setRemoveRelation(bool $removeRelation)

Set whether to remove or delete the relation

Parameters

bool $removeRelation

Return Value

$this