Set a component's {@code enforceMaterialTheme} attribute to true to ensure that
- * the Context's theme inherits from {@code Theme.MaterialComponents}. For example, you'll want to
- * do this if the component uses a new attribute defined in
- * Theme.MaterialComponents like {@code colorSecondary}.
- *
- *
If the {@code enforceTextAppearance} attribute is set to true and
- * textAppearanceResIndices parameter is specified and has non-negative values, this will also
- * check that a valid TextAppearance is set on this component for the text appearance resources
- * passed in.
- */
- @NonNull
- public static TypedArray obtainStyledAttributes(
- @NonNull Context context,
- AttributeSet set,
- @NonNull @StyleableRes int[] attrs,
- @AttrRes int defStyleAttr,
- @StyleRes int defStyleRes,
- @StyleableRes int... textAppearanceResIndices) {
-
- // First, check for a compatible theme.
- checkCompatibleTheme(context, set, defStyleAttr, defStyleRes);
-
- // Then, check that a textAppearance is set if enforceTextAppearance attribute is true
- checkTextAppearance(context, set, attrs, defStyleAttr, defStyleRes, textAppearanceResIndices);
-
- // Then, safely retrieve the styled attribute information.
- return context.obtainStyledAttributes(set, attrs, defStyleAttr, defStyleRes);
- }
-
- /**
- * Safely retrieve styled attribute information in this Context's theme using {@link
- * androidx.appcompat.widget.TintTypedArray}, after checking whether the theme is compatible with
- * the component's given style.
- *
- *
Set a component's {@code enforceMaterialTheme} attribute to true to ensure that
- * the Context's theme inherits from {@code Theme.MaterialComponents}. For example, you'll want to
- * do this if the component uses a new attribute defined in Theme.MaterialComponents
- * like {@code colorSecondary}.
- *
- *
New components should prefer to use {@link #obtainStyledAttributes(Context, AttributeSet, - * int[], int, int, int...)}, and use {@link - * com.google.android.material.resources.MaterialResources} as a replacement for the functionality - * in {@link androidx.appcompat.widget.TintTypedArray}. - * - *
If the {@code enforceTextAppearance} attribute is set to true and
- * textAppearanceResIndices parameter is specified and has non-negative values, this will also
- * check that a valid TextAppearance is set on this component for the text appearance resources
- * passed in.
- */
- public static TintTypedArray obtainTintedStyledAttributes(
- @NonNull Context context,
- AttributeSet set,
- @NonNull @StyleableRes int[] attrs,
- @AttrRes int defStyleAttr,
- @StyleRes int defStyleRes,
- @StyleableRes int... textAppearanceResIndices) {
-
- // First, check for a compatible theme.
- checkCompatibleTheme(context, set, defStyleAttr, defStyleRes);
-
- // Then, check that a textAppearance is set if enforceTextAppearance attribute is true
- checkTextAppearance(context, set, attrs, defStyleAttr, defStyleRes, textAppearanceResIndices);
-
- // Then, safely retrieve the styled attribute information.
- return TintTypedArray.obtainStyledAttributes(context, set, attrs, defStyleAttr, defStyleRes);
- }
-
- private static void checkCompatibleTheme(
- @NonNull Context context,
- AttributeSet set,
- @AttrRes int defStyleAttr,
- @StyleRes int defStyleRes) {
- TypedArray a =
- context.obtainStyledAttributes(
- set, R.styleable.ThemeEnforcement, defStyleAttr, defStyleRes);
- boolean enforceMaterialTheme =
- a.getBoolean(R.styleable.ThemeEnforcement_enforceMaterialTheme, false);
- a.recycle();
-
- if (enforceMaterialTheme) {
- TypedValue isMaterialTheme = new TypedValue();
- boolean resolvedValue =
- context.getTheme().resolveAttribute(R.attr.isMaterialTheme, isMaterialTheme, true);
-
- if (!resolvedValue
- || (isMaterialTheme.type == TypedValue.TYPE_INT_BOOLEAN && isMaterialTheme.data == 0)) {
- // If we were unable to resolve isMaterialTheme boolean attribute, or isMaterialTheme is
- // false, check for Material Theme color attributes
- checkMaterialTheme(context);
- }
- }
- checkAppCompatTheme(context);
- }
-
- private static void checkTextAppearance(
- @NonNull Context context,
- AttributeSet set,
- @NonNull @StyleableRes int[] attrs,
- @AttrRes int defStyleAttr,
- @StyleRes int defStyleRes,
- @Nullable @StyleableRes int... textAppearanceResIndices) {
- TypedArray themeEnforcementAttrs =
- context.obtainStyledAttributes(
- set, R.styleable.ThemeEnforcement, defStyleAttr, defStyleRes);
- boolean enforceTextAppearance =
- themeEnforcementAttrs.getBoolean(R.styleable.ThemeEnforcement_enforceTextAppearance, false);
-
- if (!enforceTextAppearance) {
- themeEnforcementAttrs.recycle();
- return;
- }
-
- boolean validTextAppearance;
-
- if (textAppearanceResIndices == null || textAppearanceResIndices.length == 0) {
- // No custom TextAppearance attributes passed in, check android:textAppearance
- validTextAppearance =
- themeEnforcementAttrs.getResourceId(
- R.styleable.ThemeEnforcement_android_textAppearance, -1)
- != -1;
- } else {
- // Check custom TextAppearances are valid
- validTextAppearance =
- isCustomTextAppearanceValid(
- context, set, attrs, defStyleAttr, defStyleRes, textAppearanceResIndices);
- }
-
- themeEnforcementAttrs.recycle();
-
- if (!validTextAppearance) {
- throw new IllegalArgumentException(
- "This component requires that you specify a valid TextAppearance attribute. Update your "
- + "app theme to inherit from Theme.MaterialComponents (or a descendant).");
- }
- }
-
- private static boolean isCustomTextAppearanceValid(
- @NonNull Context context,
- AttributeSet set,
- @NonNull @StyleableRes int[] attrs,
- @AttrRes int defStyleAttr,
- @StyleRes int defStyleRes,
- @NonNull @StyleableRes int... textAppearanceResIndices) {
- TypedArray componentAttrs =
- context.obtainStyledAttributes(set, attrs, defStyleAttr, defStyleRes);
- for (int customTextAppearanceIndex : textAppearanceResIndices) {
- if (componentAttrs.getResourceId(customTextAppearanceIndex, -1) == -1) {
- componentAttrs.recycle();
- return false;
- }
- }
- componentAttrs.recycle();
- return true;
- }
-
- public static void checkAppCompatTheme(@NonNull Context context) {
- checkTheme(context, APPCOMPAT_CHECK_ATTRS, APPCOMPAT_THEME_NAME);
- }
-
- public static void checkMaterialTheme(@NonNull Context context) {
- checkTheme(context, MATERIAL_CHECK_ATTRS, MATERIAL_THEME_NAME);
- }
-
- public static boolean isAppCompatTheme(@NonNull Context context) {
- return isTheme(context, APPCOMPAT_CHECK_ATTRS);
- }
-
- public static boolean isMaterialTheme(@NonNull Context context) {
- return isTheme(context, MATERIAL_CHECK_ATTRS);
- }
-
- private static boolean isTheme(@NonNull Context context, @NonNull int[] themeAttributes) {
- TypedArray a = context.obtainStyledAttributes(themeAttributes);
- for (int i = 0; i < themeAttributes.length; i++) {
- if (!a.hasValue(i)) {
- a.recycle();
- return false;
- }
- }
- a.recycle();
- return true;
- }
-
- private static void checkTheme(
- @NonNull Context context, @NonNull int[] themeAttributes, String themeName) {
- if (!isTheme(context, themeAttributes)) {
- throw new IllegalArgumentException(
- "The style on this component requires your app theme to be "
- + themeName
- + " (or a descendant).");
- }
- }
-}
\ No newline at end of file