testcentricity_web 4.7.1 → 4.7.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: aa2b9b061985c6e04005e82feb7b44b9901e13e2f78624a6f8a0e5c2edd91fa7
-  data.tar.gz: 16eb4823d74ec97b771d50994485f60234ec5a44a1f13f7b51a26e9bd19f3b53
+  metadata.gz: 3103f915327a804e3c65fc944cd20cc319e6ff9ae8a512cb467a6a4467e4e389
+  data.tar.gz: 14c47d15e314bdf19d1151c526ef3f7a3b52ee29330613f3d51fd4a68aba8861
 SHA512:
-  metadata.gz: 1f04b179abf04da0fe20e8beb228f5fbd9bd8542cc239ed75a23332c67cea8a4b1c04546d67fd79e3aee029d665d0d14a691a2a8338b6685a6852fba23a57316
-  data.tar.gz: 31e95275639ac5691439c9f60440c3b9f4790dc68633b438478ff393e248c5ed8c91d12656a102be858f7a266fb67b4a245d3c4f4cc64972dbc8f7df7935ed43
+  metadata.gz: '08ad1d7a1b710ed1aa03bdb9c8bda7fe13e6d01327ba637b27ba70d81c3f06c1a5643d9fdeaa269a998e14a494bab4e8649704f308c52af00c392aebc26a58b5'
+  data.tar.gz: 447537cae7f7d30208d7fb9da8538ce6073f5ae1e1aab8fcdec86a19c0a4d06ea5f437b0c5ffff5a89d528e07bac7e4945c38e3d6720ae5909a6a2d4247640a2

data/CHANGELOG.md

@@ -2,6 +2,16 @@
 All notable changes to this project will be documented in this file.
 
 
+## [4.7.2] - 09-FEB-2026
+
+### Added
+* Added `UIElement.hasHorizontalOverflow?` and `UIElement.hasVerticalOverflow?` methods.
+* Updated `PageObject.verify_ui_states` and `PageSection.verify_ui_states` methods to support verification of the following
+`UIElement` properties:
+  * `horizontal_overflow`
+  * `vertical_overflow`
+
+
 ## [4.7.1] - 13-JAN-2026
 
 ### Fixed

data/README.md

@@ -720,6 +720,11 @@ The `verify_ui_states` method supports the following property/state pairs:
     :secure Boolean
     :title  String
 
+**Buttons and Text Field Caption Overflow:**
+
+    :horizontal_overflow or :h_overflow Boolean
+    :vertical_overflow   or :v_overflow Boolean
+
 **Text Fields:**
 
     :readonly    Boolean
@@ -1065,6 +1070,43 @@ Baseline translation strings are stored in `.yml` files in the `config/locales/`
         ├── 📄 Gemfile
         └── 📄 README.md
 
+#### Testing for Text Overflow
+
+The `verify_ui_states` method can be used to determine if text contained in fields or button captions is truncated due to
+text overflowing the horizontal or vertical bounds of the associated field or button. The problem of text overflow is especially
+concerning in web UIs that may be localized to support multiple languages and locales.
+
+An example of horizontal text overflow in a field and vertical overflow in a button caption is depicted below.
+
+![Localized UI](https://raw.githubusercontent.com/TestCentricity/testcentricity_web/main/.github/images/Text_Overflow.png "Localized UI")
+
+The example below depictsusing the `verify_ui_states` method to verify that text overflow is not occurring in the button
+captions for a localized popup Shopping Bag panel.
+```ruby
+    class BagViewPopup < TestCentricity::PageSection
+      trait(:section_locator) { 'aside.ac-gn-bagview' }
+      trait(:section_name)    { 'Shopping Bag Popup' }
+
+      # Shopping Bag Popup UI elements
+      label  :bag_message,     'p[class*="ac-gn-bagview-message"]'
+      lists  bag_items_list:   'ul[class*="ac-gn-bagview-bag"]',
+             bag_nav_list:     'ul.ac-gn-bagview-nav-list '
+      button :checkout_button, 'a[class*="ac-gn-bagview-button-checkout"]'
+
+      def verify_checkout_ui
+        ui = {
+          checkout_button => { 
+            visible: true,
+            enabled: true,
+            caption: { translate: 'BagViewPopup.checkout' },
+            h_overflow: false,
+            v_overflow: false
+          }
+        }
+        verify_ui_states(ui)
+      end
+    end
+````
 
 ### Working With Custom UIElements
 

data/lib/testcentricity_web/version.rb

@@ -1,3 +1,3 @@
 module TestCentricityWeb
-  VERSION = '4.7.1'
+  VERSION = '4.7.2'
 end

data/lib/testcentricity_web/web_core/page_objects_helper.rb

@@ -99,6 +99,10 @@ module TestCentricity
                      ui_object.get_column_count
                    when :placeholder
                      ui_object.get_placeholder
+                   when :horizontal_overflow, :h_overflow
+                     ui_object.hasHorizontalOverflow?
+                   when :vertical_overflow, :v_overflow
+                     ui_object.hasVerticalOverflow?
                    when :min
                      ui_object.get_min
                    when :max

data/lib/testcentricity_web/web_elements/ui_element.rb

@@ -574,6 +574,30 @@ module TestCentricity
         end
       end
 
+      # Is UI object's text content truncated horizontally?
+      #
+      # @return [Boolean]
+      # @example
+      #   help_message.hasHorizontalOverflow?
+      #
+      def hasHorizontalOverflow?
+        scroll_width = get_attribute(:scrollWidth)
+        client_width = get_attribute(:clientWidth)
+        scroll_width > client_width
+      end
+
+      # Is UI object's text content truncated vertically?
+      #
+      # @return [Boolean]
+      # @example
+      #   help_message.hasVerticalOverflow?
+      #
+      def hasVerticalOverflow?
+        scroll_height = get_attribute(:scrollHeight)
+        client_height = get_attribute(:clientHeight)
+        scroll_height > client_height
+      end
+
       def get_value(visible = true)
         obj, type = find_element(visible)
         object_not_found_exception(obj, type)

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: testcentricity_web
 version: !ruby/object:Gem::Version
-  version: 4.7.1
+  version: 4.7.2
 platform: ruby
 authors:
 - A.J. Mrozinski
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-01-13 00:00:00.000000000 Z
+date: 2026-02-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: axe-core-cucumber
@@ -44,14 +44,14 @@ dependencies:
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 10.2.0
+        version: 10.1.1
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 10.2.0
+        version: 10.1.1
 - !ruby/object:Gem::Dependency
   name: cuke_modeler
   requirement: !ruby/object:Gem::Requirement
@@ -434,7 +434,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements:
 - Capybara, Selenium-WebDriver
-rubygems_version: 3.4.10
+rubygems_version: 3.4.19
 signing_key:
 specification_version: 4
 summary: A Page Object Model Framework for desktop and mobile web testing