class Weight

Same name in other branches
  1. 9 core/lib/Drupal/Core/Render/Element/Weight.php \Drupal\Core\Render\Element\Weight
  2. 8.9.x core/lib/Drupal/Core/Render/Element/Weight.php \Drupal\Core\Render\Element\Weight
  3. 10 core/lib/Drupal/Core/Render/Element/Weight.php \Drupal\Core\Render\Element\Weight

Provides a form element for input of a weight.

Weights are integers used to indicate ordering, with larger numbers later in the order.

Properties:

  • #delta: The range of possible weight values used. A delta of 10 would indicate possible weight values between -10 and 10.

Usage example:

$form['weight'] = [
    '#type' => 'weight',
    '#title' => $this->t('Weight'),
    '#default_value' => $edit['weight'],
    '#delta' => 10,
];

Hierarchy

Expanded class hierarchy of Weight

1 file declares its use of Weight
WeightTest.php in core/tests/Drupal/KernelTests/Core/Render/Element/WeightTest.php
177 string references to 'Weight'
block.schema.yml in core/modules/block/config/schema/block.schema.yml
core/modules/block/config/schema/block.schema.yml
block.schema.yml in core/modules/block/config/schema/block.schema.yml
core/modules/block/config/schema/block.schema.yml
BlockCreationTrait::placeBlock in core/modules/block/tests/src/Traits/BlockCreationTrait.php
Creates a block instance based on default settings.
BlockDependenciesTest::createBlock in core/modules/views/tests/src/Kernel/Plugin/BlockDependenciesTest.php
Creates a block instance based on default settings.
BlockForm::form in core/modules/block/src/BlockForm.php
Gets the actual form array to be built.

... See full list

File

core/lib/Drupal/Core/Render/Element/Weight.php, line 28

Namespace

Drupal\Core\Render\Element
View source 
class Weight extends FormElementBase {
    
    /**
     * {@inheritdoc}
     */
    public function getInfo() {
        $class = static::class;
        return [
            '#input' => TRUE,
            '#delta' => 10,
            '#default_value' => 0,
            '#process' => [
                [
                    $class,
                    'processWeight',
                ],
                [
                    $class,
                    'processAjaxForm',
                ],
            ],
        ];
    }
    
    /**
     * Expands a weight element into a select/number element.
     */
    public static function processWeight(&$element, FormStateInterface $form_state, &$complete_form) {
        // If the number of options is small enough, use a select field. Otherwise,
        // use a number field.
        $type = $element['#delta'] <= \Drupal::config('system.site')->get('weight_select_max') ? 'select' : 'number';
        $element = array_merge($element, \Drupal::service('element_info')->getInfo($type));
        $element['#is_weight'] = TRUE;
        if ($type === 'select') {
            $weights = [];
            for ($n = -1 * $element['#delta']; $n <= $element['#delta']; $n++) {
                $weights[$n] = $n;
            }
            $default_value = (int) $element['#default_value'];
            if (!isset($weights[$default_value])) {
                $weights[$default_value] = $default_value;
                ksort($weights);
            }
            $element['#options'] = $weights;
        }
        else {
            // Use a field big enough to fit most weights.
            $element['#size'] = 10;
        }
        return $element;
    }

}

Members

Title Modifiers Object type Summary Overriden Title Overrides
FormElementBase::processAutocomplete public static function Adds autocomplete functionality to elements. 1
FormElementBase::processPattern public static function #process callback for #pattern form element property. 1
FormElementBase::validatePattern public static function #element_validate callback for #pattern form element property. 1
FormElementBase::valueCallback public static function Determines how user input is mapped to an element&#039;s #value property. Overrides FormElementInterface::valueCallback 17
PluginInspectionInterface::getPluginDefinition public function Gets the definition of the plugin implementation. 7
PluginInspectionInterface::getPluginId public function Gets the plugin ID of the plugin instance. 3
RenderElementBase::preRenderAjaxForm public static function Adds Ajax information about an element to communicate with JavaScript. 2
RenderElementBase::preRenderGroup public static function Adds members of this group as actual elements for rendering. 2
RenderElementBase::processAjaxForm public static function Form element processing handler for the #ajax form property. 3
RenderElementBase::processGroup public static function Arranges elements into groups. 2
RenderElementBase::setAttributes public static function Sets a form element&#039;s class attribute. Overrides ElementInterface::setAttributes 2
Weight::getInfo public function Returns the element properties for this element. Overrides ElementInterface::getInfo
Weight::processWeight public static function Expands a weight element into a select/number element.

Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.