# DrawableToolbox **Repository Path**: duanhong169/DrawableToolbox ## Basic Information - **Project Name**: DrawableToolbox - **Description**: 功能完备的Drawable工具箱，通过代码构建种类多样的Drawable，摆脱枯燥重复的drawable.xml文件。 - **Primary Language**: Unknown - **License**: Apache-2.0 - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2018-08-09 - **Last Updated**: 2020-12-19 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # DrawableToolbox [![gitHub release](https://img.shields.io/github/release/duanhong169/DrawableToolbox.svg?style=social)](https://github.com/duanhong169/DrawableToolbox/releases) [![platform](https://img.shields.io/badge/platform-android-brightgreen.svg)](https://developer.android.com/index.html) [![license](https://img.shields.io/badge/license-Apache%202-green.svg)](https://github.com/duanhong169/DrawableToolbox/blob/master/LICENSE) [English](README.md) | 中文 功能完备的Drawable工具箱，通过代码构建种类多样的Drawable，摆脱枯燥重复的`drawable.xml`文件。
## 功能 * 通过代码构建Drawable * 支持``, ``, ``, ``等类型的drawable * 支持镜面翻转 ## 即将支持 * `LayerDrawable `(``) * 如果你有需要的功能，请提[Issue](https://github.com/duanhong169/DrawableToolbox/issues)或[Pull request](https://github.com/duanhong169/DrawableToolbox/pulls) ## Gradle ``` dependencies { implementation 'com.github.duanhong169:drawabletoolbox:${latestVersion}' ... } ``` > 将上方的`${latestVersion}`替换为当前最新的版本号，最新版本号参见[releases](https://github.com/duanhong169/DrawableToolbox/releases)。 ## 使用说明 通过`DrawableBuilder`来配置`Drawable`， 然后使用`build()`构建得到`Drawable`对象。 > 完整支持的API请参见[DrawableBuilder.kt](https://github.com/duanhong169/DrawableToolbox/blob/master/drawabletoolbox/src/main/java/top/defaults/drawabletoolbox/DrawableBuilder.kt)。 如下是一些示例代码和对应得到的`Drawable`： 代码： ```java DrawableBuilder() .rectangle() .hairlineBordered() .strokeColor(COLOR_DEFAULT) .strokeColorPressed(COLOR_PRESSED) .ripple() .build() ``` 结果： ![Bordered with Ripple](art/sample-1.png) 代码： ```java DrawableBuilder() .rectangle() .hairlineBordered() .mediumDashed() .strokeColor(COLOR_DEFAULT) .strokeColorPressed(COLOR_PRESSED) .ripple() .build() ``` 结果： ![Medium-dashed, Bordered with Ripple](art/sample-2.png) 代码： ```java DrawableBuilder() .rectangle() .rounded() .solidColor(COLOR_DEFAULT) .solidColorPressed(COLOR_PRESSED) .build() ``` 结果： ![Rounded, Filled with States](art/sample-4.png) 代码： ```java DrawableBuilder() .rectangle() .hairlineBordered() .longDashed() .rounded() .strokeColor(COLOR_DEFAULT) .strokeColorPressed(COLOR_PRESSED) .ripple() .build() ``` 结果： ![Rounded, Long-dashed, Bordered with Ripple](art/sample-6.png) 代码： ```java DrawableBuilder() .rectangle() .rounded() .gradient() .linearGradient() .angle(90) .startColor(COLOR_DEFAULT) .endColor(ContextCompat.getColor(context, R.color.colorPrimaryDark)) .ripple() .rippleColor(COLOR_PRESSED) .build() ``` 结果： ![Rounded, Gradient with Ripple](art/sample-8.png) 代码： ```java val baseBuilder = DrawableBuilder() .rectangle() .rounded() .gradient() .gradientType(GradientDrawable.LINEAR_GRADIENT) .angle(90) val normalState = baseBuilder .startColor(COLOR_DEFAULT) .endColor(ContextCompat.getColor(context, R.color.colorPrimaryDark)) .build() val pressedState = baseBuilder .startColor(COLOR_PRESSED) .endColor(ContextCompat.getColor(context, R.color.colorAccentDark)) .build() StateListDrawableBuilder() .normal(normalState) .pressed(pressedState) .build() ``` 结果： ![Rounded, Gradient with States](art/sample-9.png) 代码： ```java val baseBuilder = DrawableBuilder() .rectangle() .rounded() .hairlineBordered() .strokeColor(COLOR_DEFAULT) .solidColorSelected(COLOR_DEFAULT) .ripple() return when(type) { SegmentedControlDrawableSpec.TYPE_LEFT_MOST -> { baseBuilder.topRightRadius(0) .bottomRightRadius(0) .build() } SegmentedControlDrawableSpec.TYPE_RIGHT_MOST -> { baseBuilder.topLeftRadius(0) .bottomLeftRadius(0) .build() } else -> { baseBuilder.cornerRadius(0).build() } } ``` 结果： ![Segmented Control](art/sample-10.png) 代码： ```java // Rotate & Leveled the Ring DrawableBuilder() .size(200) .ring() .useLevelForRing() .solidColor(COLOR_DEFAULT) .innerRadiusRatio(3f) .thicknessRatio(10f) .rotate(0f, 720f) .build() ``` 结果： ![Rotate & Leveled the Ring](art/sample-11.png) 代码： ```java // Rotate, Sweep & Flip the Ring DrawableBuilder() .size(200) .ring() .innerRadiusRatio(3f) .thicknessRatio(10f) .gradient() .sweepGradient() .rotate(0f, 360f) .flip() .build() ``` 结果： ![Rotate, Sweep & Flip the Ring](art/sample-12.png) 代码： ```java // Rotate, Sweep & Scale the Oval with States val baseBuilder = DrawableBuilder() .size(400) .oval() .gradient() .sweepGradient() .rotate(0f, 360f) .scale(0.5f) .scaleGravity(Gravity.START or Gravity.TOP) val normalState = baseBuilder.build() val pressedState = baseBuilder .startColor(COLOR_PRESSED) .endColor(0x7FFFFFFF) .build() StateListDrawableBuilder() .normal(normalState) .pressed(pressedState) .build() ``` 结果： ![Rotate, Sweep & Scale the Oval with States](art/sample-13.png) 更多的代码示例请查看[SampleCodeSnippets.kt](https://github.com/duanhong169/DrawableToolbox/blob/master/app/src/main/java/top/defaults/drawabletoolboxapp/SampleCodeSnippets.kt)。 ## License Copyright 2018 Hong Duan Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.