typekit/webfontloader
Webfontloader
Webfontloader 是一个 JavaScript 库和标准化 API，用于从多个外部提供商和自定义样式表中获取和管理 Web 字体。它充当字体加载状态管理器，通过统一接口协调排版资产的检索。
该项目特别专注于通过管理加载状态和超时来防止不可见文本的闪烁。它的独特之处在于提供了一种在不同浏览上下文中同步排版的机制，包括将字体加载逻辑注入子窗口框架和 iframe 的能力。
该库跟踪字体加载生命周期以触发 JavaScript 回调并将 CSS 类应用于文档根目录。这些功能允许精确控制视觉过渡，包括在字体渲染超过定义持续时间时使用回退样式。
Features
- Font Loading Libraries - Provides a comprehensive JavaScript interface for orchestrating web font loading with standardized event tracking and state management.
- Web Font Loaders - Provides a unified library for fetching and integrating web fonts from multiple external providers.
- Loading Timeouts - Implements configurable durations for font requests to trigger fallback styles if rendering is delayed.
- FOIT Prevention - Provides a specialized system to prevent the flash of invisible text using loading states and timeouts.
- Font Loading Transitions - Manages loading states and timeouts to eliminate the flash of invisible text before fonts render.
- Lifecycle Event Hooks - Triggers asynchronous callbacks at specific stages of the font loading process to respond to state changes.
- Loading Timeout Controllers - Implements programmatic timers to define maximum wait times for font rendering before switching to fallback styles.
- Cross-Provider Font Loaders - Unifies the fetching of fonts from multiple distinct providers into a single standardized API.
- Loading State Tracking - Monitors the progress of font loading to trigger UI changes or callbacks when fonts are requested, rendered, or fail.
- Loading Event Coordination - Triggers JavaScript callbacks and document style updates during the loading lifecycle to manage visual transitions.
- Loading State Managers - Orchestrates UI updates and CSS class application based on the current loading status of fonts.
- Provider Abstractions - Provides a unified interface to normalize font requests across various third-party typography providers.
- Font Glyph Validation - Verifies the correct rendering of specific font subsets and private glyphs using character strings.
- Font Glyph Verification - Verifies the presence of required glyphs in custom font sources using configurable test strings.
- Cross-Context Font Loading - Directs font loading requests from a parent window into same-origin iframe child contexts.
- Font Loading Behavior Controls - Allows modification of loading parameters and target windows to optimize typography rendering.
- Font Renderers - Tracks when fonts are requested or rendered to provide precise control over the visual presentation.
- Render Detection - Measures character dimensions to verify that a font has successfully rendered in the browser viewport.
- Font Synchronizers - Provides mechanisms to propagate font loading states and styles from a parent window into embedded iframe contexts.
- DOM-Driven State Management - Applies CSS classes to the document root to manage state and visual transitions during font retrieval.
- Asset Loading Injection - Injects font loading logic into child window frames to ensure typography consistency across embedded documents.
- Font Management - Control font loading behavior and events.
- Typography Libraries - Library for controlling web font loading.
- Web Typography Utilities - Control over font loading via @font-face.
