openproject/spec/support/shared/forms_html.rb

#-- encoding: UTF-8
#-- copyright
# OpenProject is an open source project management software.
# Copyright (C) 2012-2021 the OpenProject GmbH
#
# This program is free software; you can redistribute it and/or
# modify it under the terms of the GNU General Public License version 3.
#
# OpenProject is a fork of ChiliProject, which is a fork of Redmine. The copyright follows:
# Copyright (C) 2006-2013 Jean-Philippe Lang
# Copyright (C) 2010-2013 the ChiliProject Team
#
# This program is free software; you can redistribute it and/or
# modify it under the terms of the GNU General Public License
# as published by the Free Software Foundation; either version 2
# of the License, or (at your option) any later version.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
#
# See docs/COPYRIGHT.rdoc for more details.
#++

shared_examples_for 'labelled' do
  it 'has a label with title' do
    is_expected.to have_selector 'label.form--label[title]'
  end
end

shared_examples_for 'not labelled' do
  it 'does not have a label with title' do
    is_expected.not_to have_selector 'label.form--label[title]'
  end
end

shared_examples_for 'labelled by default' do
  context 'by default' do
    it_behaves_like 'labelled'
  end

  context 'with no_label option' do
    let(:options) { { no_label: true, label: false } }

    it_behaves_like 'not labelled'
  end
end

shared_examples_for 'wrapped in container' do |container = 'field-container'|
  it { is_expected.to have_selector "span.form--#{container}", count: 1 }

  context 'with additional class provided' do
    let(:css_class) { 'my-additional-class' }
    let(:expected_container_count) { defined?(container_count) ? container_count : 1 }

    before do
      options[:container_class] = css_class
    end

    it 'has the class' do
      is_expected.to have_selector "span.#{css_class}", count: expected_container_count
    end
  end
end

shared_examples_for 'not wrapped in container' do |container = 'field-container'|
  it { is_expected.not_to have_selector "span.form--#{container}" }
end

shared_examples_for 'wrapped in field-container by default' do
  context 'by default' do
    it_behaves_like 'wrapped in container'
  end

  context 'with no_label option' do
    let(:options) { { no_label: true, label: false } }

    it_behaves_like 'not wrapped in container'
  end
end