ILIAS\UI\Implementation\Component\Table Namespace Reference

Namespaces
namespace	Action
namespace	Column

Data Structures
class	AbstractTable
class	Data
class	DataRow
class	DataRowBuilder
class	Factory
class	Ordering
class	OrderingRow
class	OrderingRowBuilder
class	Presentation
class	PresentationRow
class	Renderer
class	RowBuilder
class	Table

Functions
	initViewControlFieldSelection (array $columns)
	getViewControlFieldSelection ()
	filterVisibleColumnIds (array $columns)
	withSelectedOptionalColumns (?array $selected_optional_column_ids)
	getSelectedOptionalColumns ()
	getOptionalColumns ()
	getInitiallyVisibleColumns ()
	getVisibleColumns ()
	initViewControlOrdering ()
	initialOrder ()
	getViewControlOrdering (int|null $total_count)
	withOrder (?Order $order)
	getOrder ()
	initViewControlpagination ()
	getViewControlPagination (?int $total_count=null)
	withRange (?Range $range)
	getRange ()

Variables
trait	TableViewControlFieldSelection
trait	TableViewControlOrdering
trait	TableViewControlPagination
Range	$range = null

Function Documentation

filterVisibleColumnIds()

ILIAS\UI\Implementation\Component\Table\filterVisibleColumnIds ( array  $columns )

protected

Parameters

array<string,Column>

$columns

Returns

array<string>

Definition at line 60 of file TableViewControlFieldSelection.php.

                                                             : array
    {
        return array_keys(
            array_filter(
                $columns,
                static fn($c): bool => $c->isInitiallyVisible()
            )
        );
    }

References $c.

Referenced by ILIAS\UI\Implementation\Component\Table\initViewControlFieldSelection().

Here is the caller graph for this function:

getInitiallyVisibleColumns()

ILIAS\UI\Implementation\Component\Table\getInitiallyVisibleColumns ( )

protected

Returns

array<int, Column>

Definition at line 105 of file TableViewControlFieldSelection.php.

                                                   : array
    {
        return array_filter(
            $this->getOptionalColumns(),
            static fn($c): bool => $c->isInitiallyVisible()
        );
    }

References $c, and ILIAS\UI\Implementation\Component\Table\getOptionalColumns().

Referenced by ILIAS\UI\Implementation\Component\Table\getSelectedOptionalColumns().

Here is the call graph for this function:

Here is the caller graph for this function:

getOptionalColumns()

ILIAS\UI\Implementation\Component\Table\getOptionalColumns ( )

protected

Returns

array<int, Column>

Definition at line 94 of file TableViewControlFieldSelection.php.

                                           : array
    {
        return array_filter(
            $this->getColumns(),
            static fn($c): bool => $c->isOptional()
        );
    }

References $c.

Referenced by ILIAS\UI\Implementation\Component\Table\getInitiallyVisibleColumns(), and ILIAS\UI\Implementation\Component\Table\getViewControlFieldSelection().

Here is the caller graph for this function:

getOrder()

ILIAS\UI\Implementation\Component\Table\getOrder

(

)

Definition at line 89 of file TableViewControlOrdering.php.

                              : Order
    {
        return $this->order ?? $this->data_factory->order($this->initialOrder(), Order::ASC);
    }

References ILIAS\Data\Order\ASC, and ILIAS\UI\Implementation\Component\Table\initialOrder().

Referenced by assMultipleChoice\deleteAnswer(), assTextQuestion\deleteAnswer(), assTextSubset\deleteAnswer(), assSingleChoice\deleteAnswer(), ILIAS\UI\Implementation\Component\Table\getViewControlOrdering(), and ILIAS\UI\Implementation\Component\Table\initViewControlOrdering().

Here is the call graph for this function:

Here is the caller graph for this function:

getRange()

ILIAS\UI\Implementation\Component\Table\getRange

(

)

Definition at line 63 of file TableViewControlPagination.php.

                              : Range
    {
        return $this->range ?? $this->data_factory->range(0, $this->number_of_rows);
    }

Referenced by ILIAS\UI\Implementation\Component\Table\getViewControlPagination(), and ILIAS\UI\Implementation\Component\Table\initViewControlpagination().

Here is the caller graph for this function:

getSelectedOptionalColumns()

ILIAS\UI\Implementation\Component\Table\getSelectedOptionalColumns

(

)

Returns

string[]

Definition at line 83 of file TableViewControlFieldSelection.php.

                                                : array
    {
        if (is_null($this->selected_optional_column_ids)) {
            return array_keys($this->getInitiallyVisibleColumns());
        }
        return $this->selected_optional_column_ids;
    }

References ILIAS\UI\Implementation\Component\Table\getInitiallyVisibleColumns().

Referenced by ILIAS\UI\Implementation\Component\Table\getViewControlFieldSelection(), and ILIAS\UI\Implementation\Component\Table\getVisibleColumns().

Here is the call graph for this function:

Here is the caller graph for this function:

getViewControlFieldSelection()

ILIAS\UI\Implementation\Component\Table\getViewControlFieldSelection ( )

protected

Definition at line 41 of file TableViewControlFieldSelection.php.

                                                     : ?FieldSelection
    {
        $optional_cols = $this->getOptionalColumns();
        if ($optional_cols === []) {
            return null;
        }
 
        return $this->view_control_factory
            ->fieldSelection(array_map(
                static fn($c): string => $c->getTitle(),
                $optional_cols
            ))
            ->withValue($this->getSelectedOptionalColumns());
    }

References $c, ILIAS\UI\Implementation\Component\Table\getOptionalColumns(), and ILIAS\UI\Implementation\Component\Table\getSelectedOptionalColumns().

Referenced by ILIAS\UI\Implementation\Component\Table\Ordering\getViewControls(), and ILIAS\UI\Implementation\Component\Table\Data\getViewControls().

Here is the call graph for this function:

Here is the caller graph for this function:

getViewControlOrdering()

ILIAS\UI\Implementation\Component\Table\getViewControlOrdering ( int|null  $total_count )

protected

Definition at line 50 of file TableViewControlOrdering.php.

                                                                    : Sortation|ViewControl\Group
    {
        $sortable_visible_cols = array_filter(
            $this->getVisibleColumns(),
            static fn($c): bool => $c->isSortable()
        );
 
        if ($sortable_visible_cols === [] ||
            ($total_count !== null && $total_count < 2)
        ) {
            return $this->view_control_factory->group([
                $this->view_control_factory->nullControl(),
                $this->view_control_factory->nullControl()
            ]);
        }
 
        $sort_options = [];
        foreach ($sortable_visible_cols as $col_id => $col) {
 
            $order_asc = $this->data_factory->order($col_id, Order::ASC);
            $order_desc = $this->data_factory->order($col_id, Order::DESC);
 
            $labels = $col->getOrderingLabels();
            $sort_options[$labels[0]] = $order_asc;
            $sort_options[$labels[1]] = $order_desc;
        }
 
        $value = $this->getOrder()->join('', fn($ret, $key, $value) => [$key, $value]);
        return $this->view_control_factory->sortation($sort_options)
            ->withValue($value);
    }

References $c, ILIAS\Data\Order\ASC, ILIAS\Data\Order\DESC, ILIAS\UI\Implementation\Component\Table\getOrder(), and ILIAS\UI\Implementation\Component\Table\getVisibleColumns().

Referenced by ILIAS\UI\Implementation\Component\Table\Data\getViewControls().

Here is the call graph for this function:

Here is the caller graph for this function:

getViewControlPagination()

ILIAS\UI\Implementation\Component\Table\getViewControlPagination ( ?int  $total_count = null )

protected

Definition at line 37 of file TableViewControlPagination.php.

                                                                         : ViewControl\Pagination|ViewControl\Group
    {
        $smallest_option = current(Pagination::DEFAULT_LIMITS);
        if (is_null($total_count) || $total_count >= $smallest_option) {
            $range = $this->getRange();
            return
                $this->view_control_factory->pagination()
                    ->withTotalCount($total_count)
                    ->withValue([
                        Pagination::FNAME_OFFSET => $range->getStart(),
                        Pagination::FNAME_LIMIT => $range->getLength()
                    ]);
        }
        return $this->view_control_factory->group([
            $this->view_control_factory->nullControl(),
            $this->view_control_factory->nullControl()
        ]);
    }

References ILIAS\UI\Implementation\Component\Table\$range, ILIAS\Data\Range\getLength(), ILIAS\UI\Implementation\Component\Table\getRange(), and ILIAS\Data\Range\getStart().

Referenced by ILIAS\UI\Implementation\Component\Table\Data\getViewControls().

Here is the call graph for this function:

Here is the caller graph for this function:

getVisibleColumns()

ILIAS\UI\Implementation\Component\Table\getVisibleColumns

(

)

Returns

array<string, Column>

Definition at line 116 of file TableViewControlFieldSelection.php.

                                       : array
    {
        $visible_optional_columns = $this->getSelectedOptionalColumns();
        return array_filter(
            $this->getColumns(),
            fn(Column $col, string $col_id): bool => !$col->isOptional() || in_array($col_id, $visible_optional_columns, true),
            ARRAY_FILTER_USE_BOTH
        );
    }

References ILIAS\UI\Implementation\Component\Table\getSelectedOptionalColumns(), and ILIAS\UI\Component\Table\Column\Column\isOptional().

Referenced by ILIAS\UI\Implementation\Component\Table\Data\getRowBuilder(), ILIAS\UI\Implementation\Component\Table\Ordering\getRowBuilder(), ILIAS\UI\Implementation\Component\Table\getViewControlOrdering(), and ILIAS\UI\Implementation\Component\Table\initialOrder().

Here is the call graph for this function:

Here is the caller graph for this function:

initialOrder()

ILIAS\UI\Implementation\Component\Table\initialOrder ( )

private

Definition at line 37 of file TableViewControlOrdering.php.

                                   : string
    {
        $visible_cols = $this->getVisibleColumns();
        $sortable_visible_cols = array_filter(
            $visible_cols,
            static fn($c): bool => $c->isSortable()
        );
        if ($sortable_visible_cols === []) {
            return array_key_first($visible_cols);
        }
        return array_key_first($sortable_visible_cols);
    }

References $c, and ILIAS\UI\Implementation\Component\Table\getVisibleColumns().

Referenced by ILIAS\UI\Implementation\Component\Table\getOrder().

Here is the call graph for this function:

Here is the caller graph for this function:

initViewControlFieldSelection()

ILIAS\UI\Implementation\Component\Table\initViewControlFieldSelection ( array  $columns )

protected

Parameters

array<string,Column>

$columns

Definition at line 36 of file TableViewControlFieldSelection.php.

                                                                    : void
    {
        $this->selected_optional_column_ids = $this->filterVisibleColumnIds($columns);
    }

References ILIAS\UI\Implementation\Component\Table\filterVisibleColumnIds().

Referenced by ILIAS\UI\Implementation\Component\Table\Data\__construct(), and ILIAS\UI\Implementation\Component\Table\Ordering\__construct().

Here is the call graph for this function:

Here is the caller graph for this function:

initViewControlOrdering()

ILIAS\UI\Implementation\Component\Table\initViewControlOrdering ( )

protected

Definition at line 32 of file TableViewControlOrdering.php.

                                                : void
    {
        $this->order = $this->getOrder();
    }

References ILIAS\UI\Implementation\Component\Table\getOrder().

Referenced by ILIAS\UI\Implementation\Component\Table\Data\__construct().

Here is the call graph for this function:

Here is the caller graph for this function:

initViewControlpagination()

ILIAS\UI\Implementation\Component\Table\initViewControlpagination ( )

protected

Definition at line 32 of file TableViewControlPagination.php.

                                                  : void
    {
        $this->range = $this->getRange();
    }

References ILIAS\UI\Implementation\Component\Table\getRange().

Referenced by ILIAS\UI\Implementation\Component\Table\Data\__construct().

Here is the call graph for this function:

Here is the caller graph for this function:

withOrder()

ILIAS\UI\Implementation\Component\Table\withOrder

(

?Order

$order

)

Definition at line 82 of file TableViewControlOrdering.php.

                                            : self
    {
        $clone = clone $this;
        $clone->order = $order;
        return $clone;
    }

withRange()

ILIAS\UI\Implementation\Component\Table\withRange

(

?Range

$range

)

Definition at line 56 of file TableViewControlPagination.php.

                                            : self
    {
        $clone = clone $this;
        $clone->range = $range;
        return $clone;
    }

References ILIAS\UI\Implementation\Component\Table\$range.

withSelectedOptionalColumns()

ILIAS\UI\Implementation\Component\Table\withSelectedOptionalColumns

(

?array

$selected_optional_column_ids

)

Parameters

string[]

$selected_optional_column_ids

Definition at line 73 of file TableViewControlFieldSelection.php.

                                                                                     : static
    {
        $clone = clone $this;
        $clone->selected_optional_column_ids = $selected_optional_column_ids;
        return $clone;
    }

Variable Documentation

$range

Range ILIAS::UI::Implementation::Component::Table\$range = null

protected

Definition at line 30 of file TableViewControlPagination.php.

Referenced by ILIAS\Blog\Contributor\ContributorRetrieval\applyRange(), ILIAS\UI\Examples\Listing\Entity\Standard\base(), ILIAS\UI\examples\Table\Column\Boolean\base(), ILIAS\UI\examples\Table\Column\Breadcrumb\base(), ILIAS\UI\examples\Table\Column\Date\base(), ILIAS\UI\examples\Table\Column\EMail\base(), ILIAS\UI\examples\Table\Column\Link\base(), ILIAS\UI\examples\Table\Column\LinkListing\base(), ILIAS\UI\examples\Table\Column\Number\base(), ILIAS\UI\examples\Table\Column\Status\base(), ILIAS\UI\examples\Table\Column\StatusIcon\base(), ILIAS\UI\examples\Table\Column\Text\base(), ILIAS\UI\examples\Table\Column\TimeSpan\base(), ILIAS\UI\examples\Table\Data\base(), ILIAS\FileDelivery\FileDeliveryTypes\PHPChunked\deliver(), ILIAS\UI\examples\Table\Column\Breadcrumb\disabled(), ILIAS\UI\examples\Table\Data\DataTableDemoRepo\doSelect(), ilUserCertificateRepository\fetchCertificatesForOverviewCount(), ILIAS\UI\Implementation\Component\Input\ViewControl\Renderer\findCurrentPage(), ILIAS\TestQuestionPool\Questions\Presentation\QuestionTable\getData(), ILIAS\Test\Questions\Presentation\QuestionsOfAttemptTable\getData(), ILIAS\Test\Questions\RandomQuestionSetNonAvailablePoolsTable\getData(), ILIAS\components\ILIAS\Glossary\Table\GlossaryAutoLinkTable\getDataRetrieval(), ILIAS\components\ILIAS\Glossary\Table\GlossaryForeignTermTable\getDataRetrieval(), ILIAS\components\ILIAS\Glossary\Table\TermDefinitionBulkCreationTable\getDataRetrieval(), ILIAS\components\ILIAS\Glossary\Table\TermListTable\getDataRetrieval(), ILIAS\components\ILIAS\Glossary\Table\TermUsagesTable\getDataRetrieval(), ILIAS\Skill\Table\AssignedObjectsTable\getDataRetrieval(), ILIAS\Skill\Table\AssignMaterialsTable\getDataRetrieval(), ILIAS\Skill\Table\LevelResourcesTable\getDataRetrieval(), ILIAS\Skill\Table\ProfileTable\getDataRetrieval(), ILIAS\Skill\Table\ProfileUserAssignmentTable\getDataRetrieval(), DataTest\getDataRetrieval(), DataViewControlsTest\getDataRetrieval(), ilTestArchiver\getDataRetrievalForAttemptOverviewTable(), ILIAS\UI\examples\Table\Action\Multi\getExampleTable(), ILIAS\UI\examples\Table\Action\Single\getExampleTable(), ILIAS\UI\examples\Table\Action\Standard\getExampleTable(), ILIAS\Test\Settings\Templates\PersonalSettingsDatabaseRepository\getForUser(), ilLanguageFolderTable\getItems(), ilLanguageStatisticsTable\getItems(), ILIAS\Test\Logging\TestLoggingDatabaseRepository\getLogs(), ilBiblLibraryTableGUI\getRecords(), ILIAS\Cron\Job\Manager\UI\JobTable\getRecords(), ILIAS\LDAP\Server\UI\ServerTable\getRecords(), ILIAS\Mail\Attachments\MailAttachmentTableGUI\getRecords(), ilSamlIdpTableGUI\getRecords(), ILIAS\components\Authentication\Pages\AuthPageLanguagesOverviewTable\getRecords(), ILIAS\Chatroom\Bans\BannedUsersTable\getRecords(), ILIAS\Contact\MailingLists\MailingListsMembersTable\getRecords(), ILIAS\Contact\MailingLists\MailingListsTable\getRecords(), ILIAS\Contact\MemberSearch\MailMemberSearchTable\getRecords(), ILIAS\Forum\Moderation\ForumModeratorsTable\getRecords(), ilDidacticTemplateSettingsTableDataRetrieval\getRecords(), ILIAS\TestQuestionPool\Skills\SkillUsagesTable\getRecords(), ILIAS\Forum\Drafts\ForumDraftsTable\getRecords(), ILIAS\Forum\Statistics\ForumStatisticsTable\getRecords(), LDAPRoleAssignmentTable\getRecords(), LDAPRoleMappingTable\getRecords(), ilMailTemplateTable\getRecords(), ILIAS\Forum\Notification\ForumNotificationTable\getRecords(), ILIAS\Registration\RegistrationCodesTable\getRecords(), ilMediaCastManageTableGUI\getRows(), ilOrgUnitTypeGUI\getTableDataRetrieval(), ilOrgUnitUserAssignmentDBRepository\getUserDataByOrgUnitsAndPosition(), ILIAS\Test\Participants\ParticipantTable\getViewControlledRecords(), ILIAS\UI\Implementation\Component\Table\getViewControlPagination(), ILIAS\MetaData\Settings\Vocabularies\DataRetrieval\getVocabs(), ILIAS\components\ResourceStorage\Collections\View\RequestToDataTable\initSortingAndOrdering(), ILIAS\components\ResourceStorage\Container\View\RequestToDataTable\initSortingAndOrdering(), ILIAS\Calendar\ConsultationHours\BookingDataProvider\limitData(), ILIAS\Conditions\Configuration\ConditionTriggerProvider\limitData(), ILIAS\components\Authentication\Pages\AuthPageLanguagesOverviewTable\limitRecords(), ILIAS\Chatroom\Bans\BannedUsersTable\limitRecords(), ILIAS\Contact\MailingLists\MailingListsMembersTable\limitRecords(), ILIAS\Contact\MailingLists\MailingListsTable\limitRecords(), ILIAS\Contact\MemberSearch\MailMemberSearchTable\limitRecords(), ILIAS\Forum\Drafts\ForumDraftsTable\limitRecords(), ILIAS\Forum\Notification\ForumNotificationTable\limitRecords(), ILIAS\Forum\Statistics\ForumStatisticsTable\limitRecords(), LDAPRoleAssignmentTable\limitRecords(), LDAPRoleMappingTable\limitRecords(), ilMailTemplateTable\limitRecords(), ILIAS\Test\Participants\ParticipantTable\limitRecords(), ILIAS\TestQuestionPool\Skills\SkillUsagesTable\limitRecords(), ILIAS\Test\Questions\Presentation\QuestionsBrowserTable\loadRecords(), ILIAS\UI\examples\Table\Column\Breadcrumb\long_path(), ILIAS\UI\Implementation\Component\Input\ViewControl\Renderer\renderPagination(), ILIAS\Contact\BuddySystem\Tables\RelationsTable\rows(), RangeTest\testConstructionWrongLength(), RangeTest\testConstructionWrongStart(), RangeTest\testCroppedTo(), DataRendererTest\testDataTableRenderHeaderWithActions(), DataRendererTest\testDataTableRenderHeaderWithoutSortableColums(), DataRendererTest\testDataTableRenderTableHeader(), DataTest\testDataTableWithRange(), RangeTest\testEndCalculation(), EntityListingTest\testEntityListingYieldingEntities(), RangeTest\testFactory(), PaginationTest\testGetRangeOnNull(), RangeTest\testNegativeLength(), RangeTest\testNegativeStart(), DataRendererTest\testRenderEmptyDataCell(), RangeTest\testUnpack(), RangeTest\testValues(), RangeTest\testWithLength(), RangeTest\testWithStart(), ILIAS\UI\examples\Table\Data\with_additional_viewcontrols(), ILIAS\UI\examples\Table\Data\without_data(), and ILIAS\UI\Implementation\Component\Table\withRange().

TableViewControlFieldSelection

trait ILIAS::UI::Implementation::Component::Table\TableViewControlFieldSelection

Initial value:

{
    
    protected ?array $selected_optional_column_ids = null

Definition at line 26 of file TableViewControlFieldSelection.php.

TableViewControlOrdering

trait ILIAS::UI::Implementation::Component::Table\TableViewControlOrdering

Initial value:

{
    protected ?Order $order = null

Definition at line 28 of file TableViewControlOrdering.php.

TableViewControlPagination

trait ILIAS::UI::Implementation::Component::Table\TableViewControlPagination

Initial value:

{
    protected int $number_of_rows = 800

Definition at line 27 of file TableViewControlPagination.php.