if ( ! defined( 'ABSPATH' ) ) {
exit; // Exit if accessed directly.
use Elementor\Core\Kits\Documents\Tabs\Global_Colors;
use Elementor\Core\Kits\Documents\Tabs\Global_Typography;
* Elementor counter widget.
* Elementor widget that displays stats and numbers in an escalating manner.
class Widget_Counter extends Widget_Base {
* Retrieve counter widget name.
* @return string Widget name.
public function get_name() {
* Retrieve counter widget title.
* @return string Widget title.
public function get_title() {
return esc_html__( 'Counter', 'elementor' );
* Retrieve counter widget icon.
* @return string Widget icon.
public function get_icon() {
* Retrieve the list of scripts the counter widget depended on.
* Used to set scripts dependencies required to run the widget.
* @return array Widget scripts dependencies.
public function get_script_depends() {
return [ 'jquery-numerator' ];
* Retrieve the list of keywords the widget belongs to.
* @return array Widget keywords.
public function get_keywords() {
protected function is_dynamic_content(): bool {
* Get style dependencies.
* Retrieve the list of style dependencies the widget requires.
* @return array Widget style dependencies.
public function get_style_depends(): array {
return [ 'widget-counter' ];
public function has_widget_inner_wrapper(): bool {
return ! Plugin::$instance->experiments->is_feature_active( 'e_optimized_markup' );
* Register counter widget controls.
* Adds different input fields to allow the user to change and customize the widget settings.
protected function register_controls() {
$this->start_controls_section(
'label' => esc_html__( 'Counter', 'elementor' ),
'label' => esc_html__( 'Starting Number', 'elementor' ),
'type' => Controls_Manager::NUMBER,
'label' => esc_html__( 'Ending Number', 'elementor' ),
'type' => Controls_Manager::NUMBER,
'label' => esc_html__( 'Number Prefix', 'elementor' ),
'type' => Controls_Manager::TEXT,
'label' => esc_html__( 'Number Suffix', 'elementor' ),
'type' => Controls_Manager::TEXT,
'label' => esc_html__( 'Animation Duration', 'elementor' ) . ' (ms)',
'type' => Controls_Manager::NUMBER,
'label' => esc_html__( 'Thousand Separator', 'elementor' ),
'type' => Controls_Manager::SWITCHER,
'label_on' => esc_html__( 'Show', 'elementor' ),
'label_off' => esc_html__( 'Hide', 'elementor' ),
'thousand_separator_char',
'label' => esc_html__( 'Separator', 'elementor' ),
'type' => Controls_Manager::SELECT,
'thousand_separator' => 'yes',
'label' => esc_html__( 'Title', 'elementor' ),
'type' => Controls_Manager::TEXT,
'default' => esc_html__( 'Cool Number', 'elementor' ),
'label' => esc_html__( 'Title HTML Tag', 'elementor' ),
'type' => Controls_Manager::SELECT,
$this->end_controls_section();
$this->start_controls_section(
'label' => esc_html__( 'Counter', 'elementor' ),
'tab' => Controls_Manager::TAB_STYLE,
$this->add_responsive_control(
'label' => esc_html__( 'Title Position', 'elementor' ),
'type' => Controls_Manager::CHOOSE,
'title' => esc_html__( 'Before', 'elementor' ),
'icon' => 'eicon-v-align-top',
'title' => esc_html__( 'After', 'elementor' ),
'icon' => 'eicon-v-align-bottom',
'title' => esc_html__( 'Start', 'elementor' ),
'icon' => 'eicon-h-align-left',
'title' => esc_html__( 'End', 'elementor' ),
'icon' => 'eicon-h-align-right',
'selectors_dictionary' => [
'before' => 'flex-direction: column;',
'after' => 'flex-direction: column-reverse;',
'start' => 'flex-direction: row;',
'end' => 'flex-direction: row-reverse;',
'{{WRAPPER}} .elementor-counter' => '{{VALUE}}',
'classes' => 'elementor-control-start-end',
$this->add_responsive_control(
'title_horizontal_alignment',
'label' => esc_html__( 'Title Horizontal Alignment', 'elementor' ),
'type' => Controls_Manager::CHOOSE,
'title' => esc_html__( 'Start', 'elementor' ),
'icon' => 'eicon-h-align-left',
'title' => esc_html__( 'Center', 'elementor' ),
'icon' => 'eicon-h-align-center',
'title' => esc_html__( 'End', 'elementor' ),
'icon' => 'eicon-h-align-right',
'classes' => 'elementor-control-start-end',
'{{WRAPPER}} .elementor-counter-title' => 'justify-content: {{VALUE}};',
$this->add_responsive_control(
'title_vertical_alignment',
'label' => esc_html__( 'Title Vertical Alignment', 'elementor' ),
'type' => Controls_Manager::CHOOSE,
'title' => esc_html__( 'Top', 'elementor' ),
'icon' => 'eicon-v-align-top',
'title' => esc_html__( 'Middle', 'elementor' ),
'icon' => 'eicon-v-align-middle',
'title' => esc_html__( 'Bottom', 'elementor' ),
'icon' => 'eicon-v-align-bottom',
'{{WRAPPER}} .elementor-counter-title' => 'align-items: {{VALUE}};',
'title_position' => [ 'start', 'end' ],
$this->add_responsive_control(
'label' => esc_html__( 'Title Gap', 'elementor' ),
'type' => Controls_Manager::SLIDER,
'size_units' => [ 'px', 'em', 'rem', 'custom' ],
'{{WRAPPER}} .elementor-counter' => 'gap: {{SIZE}}{{UNIT}};',
'title_position' => [ '', 'before', 'after' ],
$this->add_responsive_control(
'label' => esc_html__( 'Number Position', 'elementor' ),
'type' => Controls_Manager::CHOOSE,
'title' => esc_html__( 'Start', 'elementor' ),
'icon' => 'eicon-h-align-left',
'title' => esc_html__( 'Center', 'elementor' ),
'icon' => 'eicon-h-align-center',
'title' => esc_html__( 'End', 'elementor' ),
'icon' => 'eicon-h-align-right',
'title' => esc_html__( 'Stretch', 'elementor' ),
'classes' => 'elementor-control-start-end',
'selectors_dictionary' => [
'start' => 'text-align: {{VALUE}}; --counter-prefix-grow: 0; --counter-suffix-grow: 1; --counter-number-grow: 0;',
'center' => 'text-align: {{VALUE}}; --counter-prefix-grow: 1; --counter-suffix-grow: 1; --counter-number-grow: 0;',
'end' => 'text-align: {{VALUE}}; --counter-prefix-grow: 1; --counter-suffix-grow: 0; --counter-number-grow: 0;',
'stretch' => '--counter-prefix-grow: 0; --counter-suffix-grow: 0; --counter-number-grow: 1;',
'{{WRAPPER}} .elementor-counter-number-wrapper' => '{{VALUE}}',
$this->add_responsive_control(
'label' => esc_html__( 'Number Alignment', 'elementor' ),
'type' => Controls_Manager::CHOOSE,
'title' => esc_html__( 'Start', 'elementor' ),
'icon' => 'eicon-text-align-left',
'title' => esc_html__( 'Center', 'elementor' ),
'icon' => 'eicon-text-align-center',
'title' => esc_html__( 'End', 'elementor' ),
'icon' => 'eicon-text-align-right',
'classes' => 'elementor-control-start-end',
'{{WRAPPER}} .elementor-counter-number' => 'text-align: {{VALUE}};',
'number_position' => 'stretch',
$this->add_responsive_control(
'label' => esc_html__( 'Number Gap', 'elementor' ),
'type' => Controls_Manager::SLIDER,
'size_units' => [ 'px', 'em', 'rem', 'custom' ],
'{{WRAPPER}} .elementor-counter-number-wrapper' => 'gap: {{SIZE}}{{UNIT}};',
'name' => 'number_position',
$this->end_controls_section();
$this->start_controls_section(
'label' => esc_html__( 'Number', 'elementor' ),
'tab' => Controls_Manager::TAB_STYLE,
'label' => esc_html__( 'Text Color', 'elementor' ),
'type' => Controls_Manager::COLOR,