ElementInterface.php

<?php

namespace Drupal\config_translation\FormElement;

use Drupal\Core\Config\Config;
use Drupal\Core\Language\LanguageInterface;
use Drupal\Core\TypedData\TypedDataInterface;
use Drupal\language\Config\LanguageConfigOverride;

/**
 * Provides an interface for configuration translation form elements.
 */
interface ElementInterface {
    
    /**
     * Creates a form element instance from a schema definition.
     *
     * @param \Drupal\Core\TypedData\TypedDataInterface $schema
     *   The configuration schema.
     *
     * @return static
     */
    public static function create(TypedDataInterface $schema);
    
    /**
     * Builds a render array containing the source and translation form elements.
     *
     * @param \Drupal\Core\Language\LanguageInterface $source_language
     *   The source language of the configuration object.
     * @param \Drupal\Core\Language\LanguageInterface $translation_language
     *   The language to display the translation form for.
     * @param mixed $source_config
     *   The configuration value of the element in the source language.
     * @param mixed $translation_config
     *   The configuration value of the element in the language to translate to.
     * @param array $parents
     *   Parents array for the element in the form.
     * @param string|null $base_key
     *   (optional) Base key to be used for the elements in the form. NULL for
     *   top-level form elements.
     *
     * @return array
     *   A render array consisting of the source and translation elements for the
     *   source value.
     */
    public function getTranslationBuild(LanguageInterface $source_language, LanguageInterface $translation_language, $source_config, $translation_config, array $parents, $base_key = NULL);
    
    /**
     * Sets configuration based on a nested form value array.
     *
     * If the configuration values are the same as the source configuration, the
     * override should be removed from the translation configuration.
     *
     * @param \Drupal\Core\Config\Config $base_config
     *   Base configuration values, in the source language.
     * @param \Drupal\language\Config\LanguageConfigOverride $config_translation
     *   Translation configuration override data.
     * @param mixed $config_values
     *   The configuration value of the element taken from the form values.
     * @param string|null $base_key
     *   (optional) The base key that the schema and the configuration values
     *   belong to. This should be NULL for the top-level configuration object and
     *   be populated consecutively when recursing into the configuration
     *   structure.
     */
    public function setConfig(Config $base_config, LanguageConfigOverride $config_translation, $config_values, $base_key = NULL);

}