Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/zefoy/ngx-font-picker
Google fonts font picker widget for Angular (version 2 and newer)
https://github.com/zefoy/ngx-font-picker
Last synced: 24 days ago
JSON representation
Google fonts font picker widget for Angular (version 2 and newer)
- Host: GitHub
- URL: https://github.com/zefoy/ngx-font-picker
- Owner: zefoy
- License: mit
- Created: 2016-08-30T10:57:23.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2024-10-19T16:24:47.000Z (about 2 months ago)
- Last Synced: 2024-11-05T14:52:38.796Z (about 1 month ago)
- Language: TypeScript
- Homepage:
- Size: 9.35 MB
- Stars: 20
- Watchers: 12
- Forks: 10
- Open Issues: 10
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.md
Awesome Lists containing this project
- awesome-angular - ngx-font-picker - Google fonts font picker widget for Angular. (Table of contents / Third Party Components)
- fucking-awesome-angular - ngx-font-picker - Google fonts font picker widget for Angular. (Table of contents / Third Party Components)
README
# Angular Font Picker
This is a simple font picker loosely based on the cool angular2-color-picker by Alberplz.
This documentation is for the latest 5/6.x.x version which requires Angular 5 or newer. For Angular 4 you need to use the latest 4.x.x version. Documentation for the 4.x.x can be found from here.
### Quick links
[Example application](https://zefoy.github.io/ngx-font-picker/)
|
[StackBlitz example](https://stackblitz.com/github/zefoy/ngx-font-picker/tree/master)
### Building the library
```bash
npm install
npm run build
```
### Running the example
```bash
npm install
npm run start
```
### Installing and usage
```bash
npm install ngx-font-picker --save
```
##### Load the module for your app (with global configuration):
Global configuration should be provided only once (this is usually done in the root module).
```javascript
import { FontPickerModule } from 'ngx-font-picker';
import { FONT_PICKER_CONFIG } from 'ngx-font-picker';
import { FontPickerConfigInterface } from 'ngx-font-picker';
const DEFAULT_FONT_PICKER_CONFIG: FontPickerConfigInterface = {
// Change this to your Google API key
apiKey: 'AIzaSyA9S7DY0khhn9JYcfyRWb1F6Rd2rwtF_mA'
};
@NgModule({
...
imports: [
...
FontPickerModule
],
providers: [
{
provide: FONT_PICKER_CONFIG,
useValue: DEFAULT_FONT_PICKER_CONFIG
}
]
})
```
##### Use it in your HTML template (for example in div element):
```html
Click to open the font picker
```
```javascript
[(fontPicker)] // Selected font ({family, size, style, styles, files}).
[fpWidth] // Width of the font picker (Default: '280px').
[fpHeight] // Height of the font picker (Default: '320px').
[fpPosition] // Position of the font picker (Default: 'bottom').
[fpAutoLoad] // Auto loads font on change (fontPicker input change).
[fpSearchText] // Search hint text (Default: 'Search fonts...').
[fpLoadingText] // Fonts loading text (Default: 'Loading fonts...').
[fpPopularLabel] // Popular fonts label (Default: 'Popular fonts').
[fpResultsLabel] // Search results label (Default: 'Search results').
[fpSizeSelect] // Show size selector in the font picker (Default: false).
[fpStyleSelect] // Show style selector in the font picker (Default: false).
[fpPresetLabel] // Label for the preset fonts list (Default: undefined).
[fpPresetFonts] // Listing of preset fonts to show (Default: undefined).
[fpPresetNotice] // Notice to show for custom fonts (Default: undefined).
[fpFallbackFont] // Fallback font (Default: {family: 'Roboto', size: 14}).
[fpCancelButton] // Show cancel button in the font picker (Default: false).
[fpCancelButtonText] // Text label for the cancel button (Default: 'Cancel').
[fpCancelButtonClass] // Class name for the cancel button (Replaces default).
[fpUploadButton] // Show upload button in the font picker (Default: false).
[fbUploadButtonText] // Text label for the upload button (Default: 'Upload').
[fpUploadButtonClass] // Class name for the upload button (Replaces default).
[fpDialogDisplay] // Dialog positioning mode: 'popup', 'inline' ('popup').
// popup: dialog is shown as popup (fixed positioning).
// inline: dialog is shown permanently (static positioning).
[fpUseRootViewContainer] // Create dialog component in the root view container (false).
// Note: The root component needs to have public viewContainerRef.
[fpFilterByFamilies] // Provides a list of font families that are allowed to be used (Default: [])
[fpSortByFamilies] // Sort fonts by family (Default: false)
(fontPickerChange) // Event handler for the font / size / style change.
(fontPickerUpload) // Event handler for the font upload button click event.
```
##### Available configuration options (for the global configuration):
```javascript
apiKey // Your Google API key for the Google Web Fonts API.
```
##### Available control / helper functions (provided by the service):
```javascript
loadFont(font) // Loads the given font (family:style) from Web Fonts.
getAllFonts(sort) // Returns list of Google Fonts with given sort option:
// 'alpha' | 'date' | 'popularity' | 'style' | 'trending'
```
##### Available control / helper functions (provided by the directive):
```javascript
loadFont(font) // Loads the (font.family:font.style) form Web Fonts.
openDialog() // Opens the font picker dialog if not already open.
closeDialog() // Closes the font picker dialog if not already closed.
toggleDialog() // Toggles the open state of the font picker dialog.
```
##### Accessing the Font Picker directive by using a ViewChild reference:
```javascript
@ViewChild('fontPickerElement', {static: true})
fontPicker: FontPickerDirective;
closeFontPicker(field: string): void {
this.fontPicker.closeDialog();
}
```