tubi_tv_drawable_chromecast_off_selector.xml

Overview

`tubi_tv_drawable_chromecast_off_selector.xml` is an Android drawable selector resource file used to define different drawable (image) states for a Chromecast "off" button in the Tubi TV app. This file manages the visual representation of the Chromecast off button depending on its interaction state — specifically, whether the button is pressed or not.

By leveraging Android's selector mechanism, the app dynamically switches between different drawable assets to provide visual feedback to the user, improving usability and responsiveness of the UI component.

Detailed Explanation

Purpose

To provide different drawable images for the Chromecast off button depending on the button's pressed state.
To enhance user experience by visually indicating button press events via drawable changes.

Structure and Elements

The root element is ``, which is a state list drawable container. It contains multiple `` elements, each specifying a drawable resource and the state conditions under which it should be used.

<selector xmlns:android="http://schemas.android.com/apk/res/android">
    <item android:drawable="@drawable/tubi_tv_chromecast_off" android:state_pressed="false"></item>
    <item android:drawable="@drawable/tubi_tv_chromecast_off_pressed" android:state_pressed="true"></item>
    <item android:drawable="@drawable/tubi_tv_chromecast_off" />
</selector>

`<selector>`

Namespace: xmlns:android="http://schemas.android.com/apk/res/android"
Role: Container for state-dependent drawable items.
Usage: Android UI components reference this selector as their background or image source to switch images based on state.

`<item>`

Each `` defines a drawable resource and an optional set of state attributes that dictate when this item is selected.

Items in this file:

Index	Drawable Resource	State Condition	Description
1	`@drawable/tubi_tv_chromecast_off`	`android:state_pressed="false"`	Drawable shown when the button is not pressed.
2	`@drawable/tubi_tv_chromecast_off_pressed`	`android:state_pressed="true"`	Drawable shown when the button is pressed.
3	`@drawable/tubi_tv_chromecast_off`	(default)	Fallback drawable if no state matches.

Parameters and Attributes

Attribute	Description
`android:drawable`	Reference to the drawable resource (an image or XML drawable).
`android:state_pressed`	Boolean indicating whether the item applies when the button is pressed (`true`) or not (`false`).

Usage Example

To use this selector in an Android layout XML or programmatically, assign it as the `android:background` or `android:src` of a view, such as an `ImageView` or `Button`.

**In layout XML:**

<ImageView
    android:id="@+id/chromecast_off_button"
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    android:src="@drawable/tubi_tv_drawable_chromecast_off_selector" />

This will automatically switch the image displayed in the `ImageView` between the pressed and unpressed state drawables based on user interaction.

**Programmatically (in Kotlin):**

val chromecastButton: ImageView = findViewById(R.id.chromecast_off_button)
chromecastButton.setImageResource(R.drawable.tubi_tv_drawable_chromecast_off_selector)

Implementation Details

The selector relies on the Android framework's state list drawable mechanism.
The order of <item> elements is important; Android selects the first matching state.
The fallback drawable (last <item> without any state) ensures there is always a drawable shown, preventing UI glitches.
The drawables referenced (tubi_tv_chromecast_off and tubi_tv_chromecast_off_pressed) must be present in the res/drawable directory and typically represent normal and pressed button visuals respectively.

Interaction with Other Parts of the System

This selector XML is part of the UI resource layer.
It is used by UI components that represent the Chromecast "off" button in the Tubi TV app.
It interacts with the app's input system by responding visually to touch events (press/release).
The drawable resources (tubi_tv_chromecast_off, tubi_tv_chromecast_off_pressed) are separate image assets that this selector manages.
The component using this selector (likely a button or image view) will notify the business logic layer when clicked or pressed, but this selector itself only manages visual states.
Ensures consistent UI feedback across different screens or fragments where the Chromecast off button appears.

Visual Diagram

flowchart TD
    A[Chromecast Off Button View] -->|uses drawable| B[tubi_tv_drawable_chromecast_off_selector.xml]
    B -->|state_pressed=false| C[tubi_tv_chromecast_off (drawable)]
    B -->|state_pressed=true| D[tubi_tv_chromecast_off_pressed (drawable)]
    B -->|default fallback| C

**Diagram explanation:**

The Chromecast off button view references the selector XML.
The selector chooses which drawable to display based on the state_pressed boolean.
If pressed, it uses the "pressed" drawable.
If not pressed or no state matches, it uses the default drawable.

Summary

File Type: Android State List Drawable XML
Purpose: Provide visual feedback for Chromecast off button press states.
Key Features: State-dependent drawable switching.
Usage: Assign as android:src or android:background to UI elements.
Effect: Enhances user experience with responsive visual cues.

This file is a small but crucial part of the Tubi TV app's UI resource management, enabling dynamic and interactive button visuals without additional code.