You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

136 lines
2.8 KiB

<?php
namespace Elementor;
if ( ! defined( 'ABSPATH' ) ) {
exit; // Exit if accessed directly.
}
/**
* Elementor repeater element class.
*
* Elementor repeater handler class is responsible for initializing the repeater.
*
* @since 1.0.0
*/
class Repeater extends Element_Base {
/**
* Repeater counter.
*
* Holds the Repeater counter data. Default is `0`.
*
* @since 1.0.0
* @access private
* @static
*
* @var int Repeater counter.
*/
private static $counter = 0;
/**
* Repeater constructor.
*
* Initializing Elementor repeater element.
*
* @since 1.0.7
* @access public
*
* @param array $data Optional. Element data. Default is an empty array.
* @param array|null $args Optional. Element default arguments. Default is null.
*
*/
public function __construct( array $data = [], array $args = null ) {
self::$counter++;
parent::__construct( $data, $args );
}
/**
* Get repeater name.
*
* Retrieve the repeater name.
*
* @since 1.0.7
* @access public
*
* @return string Repeater name.
*/
public function get_name() {
return 'repeater-' . self::$counter;
}
/**
* Get repeater type.
*
* Retrieve the repeater type.
*
* @since 1.0.0
* @access public
* @static
*
* @return string Repeater type.
*/
public static function get_type() {
return 'repeater';
}
/**
* Add new repeater control to stack.
*
* Register a repeater control to allow the user to set/update data.
*
* This method should be used inside `_register_controls()`.
*
* @since 1.0.0
* @access public
*
* @param string $id Repeater control ID.
* @param array $args Repeater control arguments.
* @param array $options Optional. Repeater control options. Default is an
* empty array.
*
* @return bool True if repeater control added, False otherwise.
*/
public function add_control( $id, array $args, $options = [] ) {
$current_tab = $this->get_current_tab();
if ( null !== $current_tab ) {
$args = array_merge( $args, $current_tab );
}
return Plugin::$instance->controls_manager->add_control_to_stack( $this, $id, $args, $options );
}
/**
* Get repeater fields.
*
* Retrieve the fields from the current repeater control.
*
* @since 1.5.0
* @access public
*
* @return array Repeater fields.
*/
public function get_fields() {
return array_values( $this->get_controls() );
}
/**
* Get default child type.
*
* Retrieve the repeater child type based on element data.
*
* Note that repeater does not support children, therefore it returns false.
*
* @since 1.0.0
* @access protected
*
* @param array $element_data Element ID.
*
* @return false Repeater default child type or False if type not found.
*/
protected function _get_default_child_type( array $element_data ) {
return false;
}
}