xml 属性名大改

新增支持部分属性修改全局样式方法命名
getActivity · Sep 5, 2021 · 021f15e · 021f15e
1 parent f7a97ca
commit 021f15e
Show file tree

Hide file tree

Showing 24 changed files with 1,226 additions and 417 deletions.
diff --git a/Adaptive.md b/Adaptive.md
@@ -1,8 +1,121 @@
 # 关于属性适配的问题
 
-* 你好，如果你是刚使用这个库的人可以不必理会，如果你之前使用了 `TitleBar` 这个库，也就是 5.0 版本以下的，在升级到 `5.0` 版本后需要进行适配，否则 `Android Studio` 会报错`编译不通过`，对于这个问题我表示十分抱歉，低版本的 `xml` 属性命名得并不是很规范，现在在 `5.0` 版本给予了纠正，尽管这次的代价比较大，但是我会义无反顾去做，如果你使用了 `TitleBar` 但是不想进行适配，请不要`升级`依赖版本。
+* 你好，如果你是刚使用这个库的人可以不必理会，如果你之前使用了 `TitleBar` 这个库，也就是 `9.0` 版本以下的，在升级到 `9.0` 版本后需要进行适配，否则 `Android Studio` 会报错`编译不通过`，对于这个问题我表示十分抱歉，低版本的 `xml` 属性命名得并不是很规范，现在在 `5.0` 和 `9.0` 版本进行优化，尽管这次的代价比较大，但是我会义无反顾去做，如果你使用了 `TitleBar` 但是不想进行适配，请不要`升级`依赖库版本。
 
-#### 3.5 版本属性命名
+#### 从 5.0 以上的版本升级到 9.0 版本适配方案
+
+* 删除 `app:backButton` 属性，请使用 `app:leftIcon` 代替，全局替换如下：
+
+```text
+// 旧版本的用法
+app:backButton="false"
+// 新版本的用法
+app:leftIcon="@null"
+```
+
+* 拆分 `android:drawablePadding` 属性，将原有属性拆分为以下几个属性：
+
+```text
+app:titleIconPadding
+
+app:leftIconPadding
+
+app:rightIconPadding
+```
+
+* 拆分 `android:drawableSize` 属性，将原有属性拆分为以下几个属性：
+
+```text
+app:titleIconWidth
+app:titleIconHeight
+
+app:leftIconWidth
+app:leftIconHeight
+
+app:rightIconWidth
+app:rightIconHeight
+```
+
+* 属性改名一览，只是简单改名，没有做太多修改：
+
+|       5.0 版本     |       9.0 版本     |
+| :------------: | :-------------: |
+|    `app:leftSize`   |    `app:leftTitleSize`   |
+|    `app:rightSize`   |    `app:rightTitleSize`   |
+|    `app:leftColor`   |    `app:leftTitleColor`   |
+|    `app:rightColor`   |    `app:rightTitleColor`   |
+|    `app:leftTint`   |    `app:leftIconTint`   |
+|    `app:rightTint`   |    `app:rightIconTint`   |
+|    `app:lineColor`   |    `app:lineDrawable`   |
+|    `android:paddingVertical`   |    `app:childPaddingVertical`   |
+|    `android:paddingHorizontal`   |    `app:childPaddingHorizontal`   |
+
+* 新增左标提和右标题的文本样式设置（之前的版本只有中间标题的）：
+
+```text
+app:leftTitleStyle
+app:rightTitleStyle
+```
+
+* 新增中间标题图标设置（之前的版本只有左标题和右标题才有）：
+
+```text
+app:titleIcon
+app:titleIconPadding
+app:titleIconTint
+```
+
+* 新增图标的显示重心设置（图标在文字的哪个位置上面绘制）：
+
+```text
+app:titleIconGravity
+app:leftIconGravity
+app:rightIconGravity
+```
+
+#### 从 1.5 以上的版本升级到 5.0 版本适配方案
+
+* 常规适配：单词反向，不再采用下划线形式，而用单词开头大写的方式代替
+
+| 3.5 版本   |  5.0 版本   |
+| :------------: | :-------------: |
+| title_left | leftTitle |
+| title_right | rightTitle |
+| icon_left   | leftIcon |
+| icon_right | rightIcon |
+| color_title | titleColor |
+| color_right | rightColor |
+| color_left | leftColor |
+| size_title | titleSize |
+| size_right | rightSize |
+| size_left | leftSize |
+| background_left | leftBackground |
+| background_right| rightBackground |
+
+* 特殊适配：去除下划线，并且用单词开头大写的方式代替
+
+|   3.5 版本   |    5.0 版本  |
+|  :-------:  |  :---------:  |
+| bar_style    |   barStyle    |
+| line_visible |   lineVisible |
+| line_color   |   lineColor |
+| line_size    |   lineSize |
+
+* 极端适配：命名和之前完全不同
+
+|   3.5 版本   |    5.0 版本  |
+|  :-------:   |  :-------:  |
+|  icon_back    |   backButton |
+
+* 无需适配：这个属性没有任何改动
+
+| 3.5 版本 |    5.0 版本  |
+| :-----:  |  :-------:  | 
+|  title   |    title   |
+
+#### 不同版本的 XML 属性命名预览
+
+* 3.5 版本 XML 属性命名
 
 ```xml
 <declare-styleable name="TitleBar">
@@ -39,10 +152,10 @@
 </declare-styleable>
 ```
 
-#### 5.0 版本属性命名
+* 5.0 版本 XML 属性命名
 
 ```xml
-<declare-styleable name="TitleBar"  tools:ignore="ResourceName">
+<declare-styleable name="TitleBar">
     <!-- 整体样式 -->
     <attr name="barStyle">
         <enum name="light" value="0x10" />
@@ -73,43 +186,113 @@
 </declare-styleable>
 ```
 
-#### 适配方案
+* 9.0 版本 XML 属性命名
 
-* 常规适配：单词反向，不再采用下划线形式，而用单词开头大写的方式代替
+```xml
+<declare-styleable name="TitleBar">
 
-| 3.5 版本   |  5.0 版本
-| :------------: | :-------------: |
-| title_left | leftTitle |
-| title_right | rightTitle |
-| icon_left   | leftIcon |
-| icon_right | rightIcon |
-| color_title | titleColor |
-| color_right | rightColor |
-| color_left | leftColor |
-| size_title | titleSize |
-| size_right | rightSize |
-| size_left | leftSize |
-| background_left | leftBackground |
-| background_right| rightBackground |
+    <!-- 标题栏背景 -->
+    <attr name="android:background" />
 
-* 特殊适配：去除下划线，并且用单词开头大写的方式代替
+    <!-- 标题栏样式 -->
+    <attr name="barStyle">
+        <enum name="light" value="0x10" />
+        <enum name="night" value="0x20" />
+        <enum name="transparent" value="0x30" />
+        <enum name="ripple" value="0x40" />
+    </attr>
 
-|   3.5 版本   |    5.0 版本  |
-|  :-------:  |  :---------:  |
-| bar_style    |   barStyle    |
-| line_visible |   lineVisible |
-| line_color   |   lineColor |
-| line_size    |   lineSize |
+    <!-- 控件水平内间距 -->
+    <attr name="childPaddingHorizontal" format="dimension" />
+    <!-- 控件垂直内间距（可用于调整标题栏自适应的高度） -->
+    <attr name="childPaddingVertical" format="dimension" />
 
-* 极端适配：命名和之前完全不同
+    <!-- 中间标题 -->
+    <attr name="title" format="string" />
+    <attr name="titleColor" format="color" />
+    <attr name="titleSize" format="dimension" />
+    <attr name="titleGravity">
+        <flag name="left" value="0x03" />
+        <flag name="right" value="0x05" />
+        <flag name="center" value="0x11" />
+        <flag name="start" value="0x00800003" />
+        <flag name="end" value="0x00800005" />
+    </attr>
+    <attr name="titleStyle">
+        <flag name="normal" value="0" />
+        <flag name="bold" value="1" />
+        <flag name="italic" value="2" />
+    </attr>
+    <attr name="titleIcon" format="reference" />
+    <attr name="titleIconWidth" format="dimension" />
+    <attr name="titleIconHeight" format="dimension" />
+    <attr name="titleIconPadding" format="dimension" />
+    <attr name="titleIconTint" format="color" />
+    <attr name="titleIconGravity">
+        <flag name="top" value="0x30" />
+        <flag name="bottom" value="0x50" />
+        <flag name="left" value="0x03" />
+        <flag name="right" value="0x05" />
+        <flag name="start" value="0x00800003" />
+        <flag name="end" value="0x00800005" />
+    </attr>
 
-|   3.5 版本   |    5.0 版本  |
-|  :-------:   |  :-------:  |
-|  icon_back    |   backButton |
+    <!-- 左边标题 -->
+    <attr name="leftTitle" format="string"/>
+    <attr name="leftTitleColor" format="color" />
+    <attr name="leftTitleSize" format="dimension" />
+    <attr name="leftTitleStyle">
+        <flag name="normal" value="0" />
+        <flag name="bold" value="1" />
+        <flag name="italic" value="2" />
+    </attr>
+    <!-- leftIcon 优先于 backButton -->
+    <attr name="leftIcon" format="reference" />
+    <attr name="leftIconWidth" format="dimension" />
+    <attr name="leftIconHeight" format="dimension" />
+    <attr name="leftIconPadding" format="dimension" />
+    <attr name="leftIconTint" format="color" />
+    <attr name="leftIconGravity">
+        <flag name="top" value="0x30" />
+        <flag name="bottom" value="0x50" />
+        <flag name="left" value="0x03" />
+        <flag name="right" value="0x05" />
+        <flag name="start" value="0x00800003" />
+        <flag name="end" value="0x00800005" />
+    </attr>
+    <attr name="leftBackground" format="reference|color" />
+
+    <!-- 右边标题 -->
+    <attr name="rightTitle" format="string" />
+    <attr name="rightTitleColor" format="color" />
+    <attr name="rightTitleSize" format="dimension" />
+    <attr name="rightTitleStyle">
+        <flag name="normal" value="0" />
+        <flag name="bold" value="1" />
+        <flag name="italic" value="2" />
+    </attr>
+    <attr name="rightIcon" format="reference" />
+    <attr name="rightIconWidth" format="dimension" />
+    <attr name="rightIconHeight" format="dimension" />
+    <attr name="rightIconPadding" format="dimension" />
+    <attr name="rightIconTint" format="color" />
+    <attr name="rightIconGravity">
+        <flag name="top" value="0x30" />
+        <flag name="bottom" value="0x50" />
+        <flag name="left" value="0x03" />
+        <flag name="right" value="0x05" />
+        <flag name="start" value="0x00800003" />
+        <flag name="end" value="0x00800005" />
+    </attr>
+    <attr name="rightBackground" format="reference|color" />
+
+    <!-- 分割线 -->
+    <attr name="lineVisible" format="boolean" />
+    <attr name="lineDrawable" format="reference|color" />
+    <attr name="lineSize" format="dimension" />
+
+</declare-styleable>
+```
 
-* 无需适配：这个属性没有任何改动
 
-| 3.5 版本 |    5.0 版本  |
-| :-----:  |  :-------:  | 
-|  title   |    title   |
 
diff --git a/LICENSE b/LICENSE
@@ -1,6 +1,6 @@
 
                                  Apache License
-                           Version 2.0, January 2004
+                           Version 2.0, August 2018
                         http://www.apache.org/licenses/
 
    TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
@@ -187,7 +187,7 @@
       same "printed page" as the copyright notice for easier
       identification within third-party archives.
 
-   Copyright [yyyy] [name of copyright owner]
+   Copyright 2018 Huang JinQun
 
    Licensed under the Apache License, Version 2.0 (the "License");
    you may not use this file except in compliance with the License.