Chromium Code Reviews
chromiumcodereview-hr@appspot.gserviceaccount.com (chromiumcodereview-hr) | Please choose your nickname with Settings | Help | Chromium Project | Gerrit Changes | Sign out
(762)

Side by Side Diff: chrome/common/extensions/docs/server2/templates/private/experimental_fontSettings_intro.html

Issue 10750017: Extensions Docs Server: Intro data source (Closed) Base URL: svn://svn.chromium.org/chrome/trunk/src
Patch Set: nits Created 8 years, 5 months ago
Use n/p to move between diff chunks; N/P to move between comments. Draft comments are only viewable by you.
Jump to:
View unified diff | Download patch | Annotate | Revision Log
OLDNEW
(Empty)
1 <!-- BEGIN AUTHORED CONTENT -->
2 <p>The Font Settings API allows you to manage Chrome's font settings.</p>
3 <h2 id="manifest">Manifest</h2>
4 <p>The Font Settings API is currently experimental, so you must declare the
5 "experimental" permission to use it. For example:</p>
6 <pre>{
7 "name": "My Font Settings Extension",
8 "description": "Customize your fonts",
9 "version": "0.2",
10 "permissions": ["experimental"]
11 }</pre>
12 <h2 id="scripts">Generic Font Families and Scripts</h2>
13 <p>Chrome allows for some font settings to depend on certain generic font
14 families and language scripts. For example, the font used for sans-serif
15 Simplified Chinese may be different than the font used for serif Japanese.</p>
16 <p>The generic font families supported by Chrome are based on
17 <a href="http://www.w3.org/TR/CSS21/fonts.html#generic-font-families">CSS generi c font families</a>
18 and are listed in the API reference below. When a webpage specifies a generic
19 font family, Chrome selects the font based on the corresponding setting. If no
20 generic font family is specified, Chrome uses the setting for the "standard"
21 generic font family.</p>
22 <p>When a webpage specifies a language, Chrome selects the font based on the
23 setting for the corresponding language script. If no language is specified,
24 Chrome uses the setting for the default, or global, script.</p>
25 <p>The supported language scripts are specified by ISO 15924 script code and
26 listed in the API reference below. Technically, Chrome settings are not strictly
27 per-script but also depend on language. For example, Chrome chooses the font for
28 Cyrillic (ISO 15924 script code "Cyrl") when a webpage specifies the Russian
29 language, and uses this font not just for Cyrillic script but for everything the
30 font covers, such as Latin.</p>
31 <h2 id="examples">Examples</h2>
32 <p>The following code gets the standard font for Arabic.</p>
33 <pre>
34 chrome.experimental.fontSettings.getFont(
35 { genericFamily: 'standard', script: 'Arab' },
36 function(details) { console.log(details.fontName); }
37 );
38 </pre>
39 <p>The next snippet sets the sans-serif font for Japanese.</p>
40 <pre>
41 chrome.experimental.fontSettings.setFont(
42 { genericFamily: 'sansserif', script: 'Jpan', fontName: 'MS PGothic' }
43 );
44 </pre>
45 <p>You can find a sample extension using the Font Settings API in the
46 <a href="http://src.chromium.org/viewvc/chrome/trunk/src/chrome/common/extension s/docs/examples/api/fontSettings/">examples/api/fontSettings</a>
47 directory. For other examples and for help in viewing the source code, see
48 <a href="samples.html">Samples</a>.</p>
49 <!-- END AUTHORED CONTENT -->
OLDNEW

Powered by Google App Engine
This is Rietveld 408576698