1. Automate
2. Documentation
3. Attribute value types

Attribute value types

View elements use the following types of values for their attributes:

boolean

• true or false, see Android documentation.
• A reference to a system boolean resource, declared as @android:boolean/name.
• A reference to a Automate boolean resource, declared as @boolean/name.
• A dynamic system theme attribute for a boolean, declared as ?android:attr/name or ?android:name.
• A dynamic Automate theme attribute for a boolean, declared as ?attr/name or ?name.

color

• An # followed by 3, 4, 6 or 8 hexadecimal digits; #RGB, #ARGB, #AARRGGBB or #AARRGGBB, see Android documentation.
• A reference to a system color resource, declared as @android:color/name, see Android documentation
• A reference to a Automate color resource, declared as @color/name.
• A dynamic system theme attribute for a color, declared as ?android:attr/name or ?android:name, see Android documentation.
• A dynamic Automate theme attribute for a color, declared as ?attr/name or ?name.

dimension

• A decimal number followed by a unit of measure:

  • dp — Density-Independent pixels, an abstract unit that is based on the physical density of the screen.
  • sp — Scale-Independent Pixels, like the dp unit but also scaled by the user's font size preference.
  • pt — Points, 1/72 of an inch based on the physical size of the screen, assuming a 72 DPI density.
  • px — Pixels, corresponds to actual pixels on the screen.
  • mm — Millimeters, based on the physical size of the screen.
  • in — Inches, based on the physical size of the screen.
  See Android documentation.
• A reference to a system dimension resource, declared as @android:dimen/name, see Android documentation.
• A reference to a Automate dimension resource, declared as @dimen/name.
• A dynamic system theme attribute for a dimension, declared as ?android:attr/name or ?android:name, see Android documentation.
• A dynamic Automate theme attribute for a dimension, declared as ?attr/name or ?name.

drawable

• An URI of an image store on the device:

  • android.resource: an resource packaged in app, declared as android.resource://package-name/resource-id.

  • content: accessible image content provided by app, e.g:

    • An Automate icon, declared as content://com.llamalab.automate.provider/icons/id where id is an integer between 61441 and 61769 (see Icon pick block), optionally append ?size=dimension to specify a size.
    • An Automate text icon, declared as content://com.llamalab.automate.provider/text-icon/text where text is your text, optionally append ?size=dimension to specify a size.
    • An Automate file proxy, use the fileUri with flag "a", "d", or as a last-resort (Privacy warning!) "s" for widget layouts.
  • data: in-line image data, e.g. data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCAyNCAyNCI+PHBhdGggZD0iTTEyIDIxLjJjLTUuMDczIDAtOS4yLTQuMTI3LTkuMi05LjJhMS4zOCAxLjM4IDAgMSAxIDIuNzYgMGMwIDMuNTUgMi44ODkgNi40NCA2LjQ0IDYuNDQgMy41NSAwIDYuNDQtMi44OSA2LjQ0LTYuNDRhMS4zOCAxLjM4IDAgMCAxIDIuNzYgMGMwIDUuMDczLTQuMTI3IDkuMi05LjIgOS4yTTkuNyA2LjAyQTEuMzggMS4zOCAwIDAgMSA4LjMyIDcuNEg0LjE4QTEuMzggMS4zOCAwIDAgMSAyLjggNi4wMmEzLjQ1IDMuNDUgMCAwIDEgNi45IDBtMTEuNSAwYTEuMzggMS4zOCAwIDAgMS0xLjM4IDEuMzhoLTQuMTRhMS4zOCAxLjM4IDAgMCAxLTEuMzgtMS4zOCAzLjQ1IDMuNDUgMCAwIDEgNi45IDAiLz48L3N2Zz4
  • file: an external storage file, usually don’t work in a widget layout.

  See Android documentation.

  Note!Using an URI in an adapter item view layouts may cause sizing issues on Android 11 and lower.

• A reference to a system drawable resource, declared as @android:drawable/name, see Android documentation.
• A reference to an Automate drawable resource, declared as @drawable/name.
• A dynamic system theme attribute for a drawable, declared as ?android:attr/name or ?android:name, see Android documentation.
• A dynamic Automate theme attribute for a drawable, declared as ?attr/name or ?name.

See supported image formats, Scalable Vector Graphics (SVG) version 1.1 is also supported.

enum

Must be one of the listed values.

flags

Must be one or more of the listed values separated by |.

float

• An decimal number.
• A dynamic system theme attribute for a float, declared as ?android:attr/name.
• A dynamic Automate theme attribute for a float, declared as ?attr/name.

id

• A new id, declared as @+id/name, see Android documentation
• A reference to a system id resource, declared as @android:id/name, see Android documentation.
• A reference to a Automate id resource, declared as @id/name.

integer

• An integer number, see Android documentation
• A reference to a system integer resource, declared as @android:integer/name, see Android documentation.
• A reference to a Automate integer resource, declared as @integer/name.
• A dynamic system theme attribute for an integer, declared as ?android:attr/name.
• A dynamic Automate theme attribute for an integer, declared as ?attr/name or ?name.

string

• Text, see Android documentation
• A reference to a system string resource, declared as @android:string/name, see Android documentation
• A reference to a Automate string resource, declared as @string/name
• A dynamic system theme attribute for an string, declared as ?android:attr/name
• A dynamic Automate theme attribute for an string, declared as ?attr/name or ?name