Clara Bayarri | 543fd29 | 2017-03-24 11:29:49 +0000 | [diff] [blame] | 1 | <?xml version="1.0" encoding="utf-8"?> |
| 2 | <!-- |
| 3 | ~ Copyright (C) 2017 The Android Open Source Project |
| 4 | ~ |
| 5 | ~ Licensed under the Apache License, Version 2.0 (the "License"); |
| 6 | ~ you may not use this file except in compliance with the License. |
| 7 | ~ You may obtain a copy of the License at |
| 8 | ~ |
| 9 | ~ http://www.apache.org/licenses/LICENSE-2.0 |
| 10 | ~ |
| 11 | ~ Unless required by applicable law or agreed to in writing, software |
| 12 | ~ distributed under the License is distributed on an "AS IS" BASIS, |
| 13 | ~ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
| 14 | ~ See the License for the specific language governing permissions and |
| 15 | ~ limitations under the License. |
| 16 | --> |
| 17 | <resources> |
| 18 | <!-- Attributes that are read when parsing a <fontfamily> tag. --> |
| 19 | <declare-styleable name="FontFamily"> |
| 20 | <!-- The authority of the Font Provider to be used for the request. --> |
| 21 | <attr name="fontProviderAuthority" format="string" /> |
| 22 | <!-- The package for the Font Provider to be used for the request. This is used to verify |
| 23 | the identity of the provider. --> |
| 24 | <attr name="fontProviderPackage" format="string" /> |
| 25 | <!-- The query to be sent over to the provider. Refer to your font provider's documentation |
| 26 | on the format of this string. --> |
| 27 | <attr name="fontProviderQuery" format="string" /> |
| 28 | <!-- The sets of hashes for the certificates the provider should be signed with. This is |
| 29 | used to verify the identity of the provider, and is only required if the provider is not |
| 30 | part of the system image. This value may point to one list or a list of lists, where each |
| 31 | individual list represents one collection of signature hashes. Refer to your font provider's |
| 32 | documentation for these values. --> |
| 33 | <attr name="fontProviderCerts" format="reference" /> |
Seigo Nonaka | 2afabd0 | 2017-05-16 17:30:29 -0700 | [diff] [blame] | 34 | <!-- The strategy to be used when fetching font data from a font provider in XML layouts. |
Clara Bayarri | 758621d | 2017-09-01 14:06:46 +0100 | [diff] [blame] | 35 | This attribute is ignored when the resource is loaded from code, as it is equivalent to the |
| 36 | choice of API between {@link |
| 37 | android.support.v4.content.res.ResourcesCompat#getFont(Context, int)} (blocking) and |
| 38 | {@link |
| 39 | android.support.v4.content.res.ResourcesCompat#getFont(Context, int, FontCallback, Handler)} |
| 40 | (async). --> |
Seigo Nonaka | 2afabd0 | 2017-05-16 17:30:29 -0700 | [diff] [blame] | 41 | <attr name="fontProviderFetchStrategy"> |
| 42 | <!-- The blocking font fetch works as follows. |
| 43 | First, check the local cache, then if the requested font is not cached, request the |
| 44 | font from the provider and wait until it is finished. You can change the length of |
| 45 | the timeout by modifying fontProviderFetchTimeout. If the timeout happens, the |
| 46 | default typeface will be used instead. --> |
| 47 | <enum name="blocking" value="0" /> |
| 48 | <!-- The async font fetch works as follows. |
| 49 | First, check the local cache, then if the requeted font is not cached, trigger a |
| 50 | request the font and continue with layout inflation. Once the font fetch succeeds, the |
| 51 | target text view will be refreshed with the downloaded font data. The |
| 52 | fontProviderFetchTimeout will be ignored if async loading is specified. --> |
| 53 | <enum name="async" value="1" /> |
| 54 | </attr> |
| 55 | <!-- The length of the timeout during fetching. --> |
| 56 | <attr name="fontProviderFetchTimeout" format="integer"> |
| 57 | <!-- A special value for the timeout. In this case, the blocking font fetching will not |
| 58 | timeout and wait until a reply is received from the font provider. --> |
| 59 | <enum name="forever" value="-1" /> |
| 60 | </attr> |
Clara Bayarri | 543fd29 | 2017-03-24 11:29:49 +0000 | [diff] [blame] | 61 | </declare-styleable> |
| 62 | |
| 63 | <!-- Attributes that are read when parsing a <font> tag, which is a child of |
| 64 | <font-family>. This represents an actual font file and its attributes. --> |
| 65 | <declare-styleable name="FontFamilyFont"> |
| 66 | <!-- The style of the given font file. This will be used when the font is being loaded into |
| 67 | the font stack and will override any style information in the font's header tables. If |
| 68 | unspecified, the value in the font's header tables will be used. --> |
| 69 | <attr name="fontStyle"> |
| 70 | <enum name="normal" value="0" /> |
| 71 | <enum name="italic" value="1" /> |
| 72 | </attr> |
| 73 | <!-- The reference to the font file to be used. This should be a file in the res/font folder |
| 74 | and should therefore have an R reference value. E.g. @font/myfont --> |
| 75 | <attr name="font" format="reference" /> |
| 76 | <!-- The weight of the given font file. This will be used when the font is being loaded into |
| 77 | the font stack and will override any weight information in the font's header tables. Must |
| 78 | be a positive number, a multiple of 100, and between 100 and 900, inclusive. The most |
| 79 | common values are 400 for regular weight and 700 for bold weight. If unspecified, the value |
| 80 | in the font's header tables will be used. --> |
| 81 | <attr name="fontWeight" format="integer" /> |
Clara Bayarri | d96eeb4 | 2017-10-04 16:11:15 +0100 | [diff] [blame] | 82 | |
| 83 | <!-- References to the framework attrs --> |
| 84 | <attr name="android:fontStyle" /> |
| 85 | <attr name="android:font" /> |
| 86 | <attr name="android:fontWeight" /> |
Clara Bayarri | 543fd29 | 2017-03-24 11:29:49 +0000 | [diff] [blame] | 87 | </declare-styleable> |
Seigo Nonaka | 2afabd0 | 2017-05-16 17:30:29 -0700 | [diff] [blame] | 88 | </resources> |