Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

Support for italic and bold fonts using attribute textStyle #179

Open
wants to merge 7 commits into
base: master
Choose a base branch
from
Open

Support for italic and bold fonts using attribute textStyle #179

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
7 commits
Select commit Hold shift + click to select a range
19c9747
Adding bold and italic support
gfranks May 27, 2015
3a30fe1
removed unnecessary if statement in methods set{...}FontAttrId()
Jun 3, 2015
ab326d9
CalligraphyConfig: refactored redundant code + added log message inst…
Jun 3, 2015
23913cb
bugfix: if TextView.getTypeface() returns null there will not be a Nu…
Jun 5, 2015
d0aa60e
removed non-public method without usages
Jun 5, 2015
efc44f8
refactored redundant code
Jun 5, 2015
11de0e6
Merge branch 'textstyle_attribute'
Jun 5, 2015
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
67 changes: 65 additions & 2 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -39,11 +39,25 @@ Define your default font using `CalligraphyConfig`, in your `Application` class
@Override
public void onCreate() {
super.onCreate();

// Customize each text style font separately
CalligraphyConfig.initDefault(new CalligraphyConfig.Builder()
.setDefaultFontPath("fonts/Roboto-RobotoRegular.ttf")
.setDefaultBoldFontPath("fonts/Roboto-RobotoBold.ttf")
.setDefaultItalicFontPath("fonts/Roboto-RobotoItalic.ttf")
.setDefaultBoldItalicFontPath("fonts/Roboto-RobotoBoldItalic.ttf")
.setFontAttrId(R.attr.fontPath)
.build()
);

// Set the inherent default font path to look up Regular, Bold, Italic, and Bold-Italic fonts stored in your assets folder
// NOTE: This string will be formatted to lookup each font style. If one of the styles is not found, the default (Regular) will be used
CalligraphyConfig.initDefault(new CalligraphyConfig.Builder()
.setInherentDefaultFontPaths("fonts/Roboto-%s.ttf")
.setFontAttrId(R.attr.fontPath)
.build()
);

//....
}
```
Expand All @@ -70,11 +84,22 @@ _You're good to go!_
### Custom font per TextView

```xml
<!-- Specify the font path type for regular, bold, italic, and bold-italic, one will be used based on the textStyle applied -->
<TextView
android:text="@string/hello_world"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
fontPath="fonts/Roboto-Bold.ttf"/>
fontPath="fonts/Roboto-Regular.ttf"
boldFontPath="fonts/Roboto-Bold.ttf"
italicFontPath="fonts/Roboto-Italic.ttf"
boldItalicFontPath="fonts/Roboto-Bold-Italic.ttf"/>

<!-- If you specify an inherent font path, just using the fontPath attr will suffice -->
<TextView
android:text="@string/hello_world"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
fontPath="fonts/Roboto-%s.ttf"/>
```

_Note: Popular IDE's (Android Studio, IntelliJ) will likely mark this as an error despite being correct. You may want to add `tools:ignore="MissingPrefix"` to either the View itself or its parent ViewGroup to avoid this. You'll need to add the tools namespace to have access to this "ignore" attribute. `xmlns:tools="
Expand All @@ -84,9 +109,19 @@ http://schemas.android.com/tools"`. See https://code.google.com/p/android/issues


```xml
<!-- Specify the font path type for regular, bold, italic, and bold-italic, these will be applied based on the textStyle -->
<style name="TextAppearance.FontPath" parent="android:TextAppearance">
<!-- Custom Attr-->
<item name="fontPath">fonts/RobotoCondensed-Regular.ttf</item>
<item name="boldFontPath">fonts/RobotoCondensed-Bold.ttf</item>
<item name="italicFontPath">fonts/RobotoCondensed-Italic.ttf</item>
<item name="boldItalicFontPath">fonts/RobotoCondensed-Bold-Italic.ttf</item>
</style>

<!-- If you specify an inherent font path, just using the fontPath attr will suffice -->
<style name="TextAppearance.FontPath" parent="android:TextAppearance">
<!-- Custom Attr-->
<item name="fontPath">fonts/RobotoCondensed-%s.ttf</item>
</style>
```

Expand All @@ -103,8 +138,17 @@ http://schemas.android.com/tools"`. See https://code.google.com/p/android/issues


```xml
<!-- Specify the font path type for regular, bold, italic, and bold-italic, these will be applied based on the textStyle -->
<style name="TextViewCustomFont">
<item name="fontPath">fonts/RobotoCondensed-Regular.ttf</item>
<item name="boldFontPath">fonts/RobotoCondensed-Bold.ttf</item>
<item name="italicFontPath">fonts/RobotoCondensed-Italic.ttf</item>
<item name="boldItalicFontPath">fonts/RobotoCondensed-Bold-Italic.ttf</item>
</style>

<!-- If you specify an inherent font path, just using the fontPath attr will suffice -->
<style name="TextViewCustomFont">
<item name="fontPath">fonts/RobotoCondensed-%s.ttf</item>
</style>
```

Expand All @@ -117,8 +161,17 @@ http://schemas.android.com/tools"`. See https://code.google.com/p/android/issues

<style name="AppTheme.Widget"/>

<!-- Specify the font path type for regular, bold, italic, and bold-italic, these will be applied based on the textStyle -->
<style name="AppTheme.Widget.TextView" parent="android:Widget.Holo.Light.TextView">
<item name="fontPath">fonts/Roboto-ThinItalic.ttf</item>
<item name="boldFontPath">fonts/Roboto-Bold.ttf</item>
<item name="italicFontPath">fonts/Roboto-Italic.ttf</item>
<item name="boldItalicFontPath">fonts/Roboto-Bold-Italic.ttf</item>
</style>

<!-- If you specify an inherent font path, just using the fontPath attr will suffice -->
<style name="TextViewCustomFont">
<item name="fontPath">fonts/Roboto-%s.ttf</item>
</style>
```

Expand All @@ -136,7 +189,17 @@ The `CalligraphyFactory` looks for the font in a pretty specific order, for the
defined in the `Style` and a `TextAttribute` defined in the `View` the `Style` attribute is picked first!
4. `Theme` - if defined this is used.
5. `Default` - if defined in the `CalligraphyConfig` this is used of none of the above are found
**OR** if one of the above returns an invalid font.
**OR** if one of the above returns an invalid font.

When specifying an inherent font path, we lookup each font based on these values
```java
// If we fail to find one of the fonts, we will either default to the Regular font supplied (i.e. "fonts/font-Regular.ttf")
// or the default system font if there is no Regular
String.format("fonts/font-%s.ttf", "Regular");
String.format("fonts/font-%s.ttf", "Bold");
String.format("fonts/font-%s.ttf", "Italic");
String.format("fonts/font-%s.ttf", "Bold-Italic");
```

### Why *not* piggyback off of fontFamily attribute?

Expand Down
Loading