Init JS Components

init-js-components

Read @.ai/Component/Javascript/CONTEXT.md for the full component list and initialization pattern.

How initComponents works

window.prestashop.component.initComponents([
  'TranslatableInput',
  'TinyMCEEditor',
]);

• Components are registered on window.prestashop.component
• initComponents creates instances and stores them in window.prestashop.instance
• Components activate automatically by scanning the DOM for matching data-* attributes
• Only initialize components the page actually uses

Common form components

TranslatableInput / TranslatableField

For multilingual fields. The Symfony TranslatableType renders the DOM with proper data-* attributes; this component adds the language tab switching UI.

TinyMCEEditor

For rich text fields (FormattedTextareaType). Initializes the WYSIWYG editor on matching textareas.

ChoiceTree

For hierarchical selectors (categories, groups). Call .enableAutoCheckChildren() if parent selection should auto-select children.

new window.prestashop.component.ChoiceTree('#category-tree-selector').enableAutoCheckChildren();

TaggableField

For tag inputs with autocomplete. Used with TaggableType form type.

EntitySearchInput

For autocomplete search fields that reference other entities (e.g. search for a product by name).

GeneratableInput

For fields auto-generated from another (e.g. URL slug from name). Uses TextToLinkRewriteCopier pattern.

MultistoreConfigField / ModifyAllShopsCheckbox

For multistore-scoped configuration fields. Shows per-shop override controls.

FormFieldToggler / DisablingSwitch

For conditional field visibility — shows/hides fields based on another field's value.

Full component catalogue

Pass only the names the page actually needs to initComponents([...]) — don't load the whole catalogue.

Using components directly (without initComponents)

Some components can be instantiated directly for more control:

const choiceTree = new window.prestashop.component.ChoiceTree(selector);
choiceTree.enableAutoCheckChildren();

Custom components

Modules can register custom components:

EventEmitter.on('PSComponentsInitiated', () => {
  window.prestashop.component.MyCustomComponent = MyCustomComponent;
});

Rules

Conventions (jQuery ready pattern, direct instantiation, EventEmitter module registration) are in Javascript/CONTEXT.md. Skill-specific reminders:

• Only initialize components the page needs — don't load everything
• Components rely on DOM data-* attributes rendered by Symfony form types — they are not standalone
• initComponents is called once at page load — no need to call it again after DOM changes