DslTabLayout Documentation

DslTabLayout is a highly versatile, self-drawn TabLayout replacement that inherits from ViewGroup (not a composite control). It can be used as a horizontal or vertical LinearLayout without special requirements.

Key Features:

• Custom Views: Supports any type of child view and any type of Drawable for indicators.
• Layout Modes: Supports horizontal scrolling, smart item width splitting, and vertical layouts (since v2.0.0).
• Visual Effects:
  • High-protrusion mode (allows a child to extend beyond the container).
  • Highlight/irregular shape effects on selection (since v2.2.0).
  • Indicator color sliding gradients (since v3.0.1).
  • Indicator flash effects (since v3.1.0).
• Interaction: Supports sliding selection mode (smartly selects previous/next item) and badge configurations.
• Compatibility: Supports ViewPager, ViewPager2, and RTL (since v3.0.0, minSdk >= 17).

SDK Requirements:

• Before v3.5.5: compileSdk=33, minSdk >= 17
• v3.5.5 and later: compileSdk=34, minSdk >= 21

To install the library using JitPack, follow the steps based on your Android Gradle Plugin (AGP) version.

For AGP 8.0+

Add the JitPack repository to your root settings.gradle file:

dependencyResolutionManagement {
    ...
    repositories {
        ...
        maven { url 'https://jitpack.io' }
    }
}

For AGP 8.0-

Add the JitPack repository to your root build.gradle file:

allprojects {
    repositories {
        ...
        maven { url 'https://jitpack.io' }
    }
}

Add Dependencies

In your app-level build.gradle, add the core library and optional delegates for ViewPager support:

dependencies {
    implementation 'com.github.angcyo.DslTablayout:TabLayout:3.7.2'

    // Optional: For ViewPager1 support
    implementation 'com.github.angcyo.DslTablayout:ViewPager1Delegate:3.7.2'
    
    // Optional: For ViewPager2 support
    implementation 'com.github.angcyo.DslTablayout:ViewPager2Delegate:3.7.2'
}

Note: If JitPack fails to fetch the library, try using the group com.github.angcyo.DslTabLayout:xxx.

The DslGravity class is a helper for calculating precise coordinates for UI elements based on Android's Gravity system. It allows you to define a bounding box and then compute where a target of a specific size should be placed.

Key Properties (Calculated after applyGravity):

• _gravityLeft, _gravityTop, _gravityRight, _gravityBottom: The calculated edge coordinates of the target.
• _gravityOffsetX, _gravityOffsetY: The adjusted offsets after accounting for gravity direction.
• _horizontalGravity, _verticalGravity: The extracted horizontal and vertical gravity components.
• _isCenterGravity: Boolean indicating if the gravity is both CENTER_HORIZONTAL and CENTER_VERTICAL.

Manual Configuration: You can instantiate DslGravity and configure it manually using:

• setGravityBounds(rect: RectF) or setGravityBounds(left, top, right, bottom)
• gravity: Set the android.view.Gravity integer.
• gravityRelativeCenter: Toggle between center-based or edge-based positioning.
• applyGravity(width, height, callback): Triggers the calculation.

Use the dslGravity helper function to calculate the position of a target element within a bounding rectangle (Rect or RectF) based on Android Gravity constants.

This function handles offset calculations and provides a callback with the calculated center coordinates and the DslGravity instance for further property access.

Parameters:

• rect: The bounding area (Rect or RectF) where the target will be placed.
• gravity: An Android Gravity integer (e.g., Gravity.CENTER, Gravity.LEFT or Gravity.TOP).
• width: The width of the target element.
• height: The height of the target element.
• offsetX: Horizontal offset. Note that this value is automatically negated if the gravity is RIGHT or END to maintain consistent directionality.
• offsetY: Vertical offset. Note that this value is automatically negated if the gravity is BOTTOM.
• gravityRelativeCenter: If true, the target's center point is placed at the gravity position. If false, the target's edges are aligned with the gravity position.
• callback: A lambda receiving (dslGravity: DslGravity, centerX: Float, centerY: Float).