Skip to content

Опечатка в описании поля COMPLEX массива $arComponentDescription: "контроллер" вместо "комплексный компонент" #71

@Trionikl

Description

@Trionikl

Описание проблемы

На странице документации по описанию файла компонента component.php (.description.php) содержится неточность в описании ключа COMPLEX массива $arComponentDescription.

Местоположение

URL: https://docs.1c-bitrix.ru/pages/framework/components.html

Секция: Описание массива $arComponentDescription → ключ COMPLEX

Текущий текст

COMPLEX — Y для контроллера, для обычного компонента ключ значения не имеет.

Ожидаемый текст

COMPLEX — Y для комплексного компонента, для обычного компонента ключ значения не имеет.

Обоснование

В терминологии 1С-Битрикс существует различие между:

  1. Комплексный компонент — компонент, объединяющий несколько режимов работы (список/детально) с поддержкой ЧПУ (SEF). Примеры: catalog, news, gallery. Именно для этого типа компонентов используется флаг 'COMPLEX' => 'Y'.

  2. Контроллер — класс нового ядра D7 (Bitrix\Main\Engine\Controller), работающий по паттерну MVC и наследующийся от системного контроллера. Это совершенно другая сущность, не связанная с компонентной архитектурой напрямую.

Текущая формулировка может сбивать с толку разработчиков, путая понятия компонентной архитектуры и нового ядра D7.

Рекомендация по исправлению

Заменить слово "контроллера" на "комплексного компонента" в описании поля.

Metadata

Metadata

Assignees

Labels

No labels
No labels

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions