AO3Boxicons

Reusable library that initialized the boxicons css and serves functions to turn stats and menus into icons

Verze ze dne 19. 06. 2024. Zobrazit nejnovější verzi.

Tento skript by neměl být instalován přímo. Jedná se o knihovnu, kterou by měly jiné skripty využívat pomocí meta příkazu // @require https://update.greasyfork.org/scripts/497064/1397191/AO3Boxicons.js

Autor
genusslicht
Verze
1.1
Vytvořeno
04. 06. 2024
Aktualizováno
19. 06. 2024
Size
15,5 KB
Licence
MIT

Basic Usage

  • Create a new User Script
  • add @required Tag with the newest version of this lib
  • Add to body:
(function () {
  const settings = {
    iconifyStats: true,
    iconifyUserNav: true
  };
  IconifyAO3(settings);
})();

Will turn the Stat names and the user navigation links into icons.

Settings

All described properties have to be in the settings object that is given to IconifyAO3.

  • boxiconsVersion: String - used version of boxicons. (current is "2.1.4", check boxicons.com for updates)
  • webFontsUri: String - Uri to a webfont that will be imported via CSS if set. See google web fonts for guidance. (!!! NO GOOGLE TRACKING IS ADDED IF LEFT UNSET !!!)
  • webFonts: Array<Object> - One or multiple objects that define an external font face (only latin)
  • iconifyStats: Boolean - if set to true, stat titles will be turned into icons.
  • statsSettings: Object - sets individual options for stat icons. See below.
  • iconifyUserNav: Boolean - if set to true, user navigation texts will be turned into icons.
  • userNavSettings: Object - sets individual options for user nav icons. See below.

External Web Font

Possible font source: https://fontsource.org/

Properties for each defined font

  • name: String - Name to address the loaded font face in local CSS. MANDATORY!
  • url: String - url to the external font file. MANDATORY!
  • format: String - format of the external font file. MANDATORY!
  • weight: String - The weight parameter of the font. Default: "400"
  • style: String - Font style. Default: "normal"
  • display: String - Display option of the font. Default: "swap"
  • width: String - Defines the font's stretch. Will not be set if not defined.

Example

[
  {
    "name: "Open Sans",
    "url": "https://cdn.jsdelivr.net/fontsource/fonts/open-sans:vf@latest/latin-wdth-normal.woff2",
    "format": "woff2-variations",
    "weight": "300 800",
    "width": "75% 100%"
  }
]

Individual Stat Icons

Define individual icons and tooltips, using the statsSettings object.

Properties

  • iconClass: String - name of boxicon icon (see https://boxicons.com)
  • solid: Boolean - sets the icon as solid or not. See selected icon properties on https://boxicons.com
  • tooltip: String - description that shows on mouse hover. Default is stats titles.

Example

{
  statsSettings: {
    kudosOptions: { solid: false }
  }
}

Will turn the solid heart for kudos into an unsolid heart. Note that the default settings will stay intact if not overwritten here.

List of possible Options

wordCountOptions, chaptersOptions, collectionsOptions, commentsOptions, kudosOptions, bookmarksOptions, hitsOptions, workSubsOptions, authorSubsOptions, commentThreadsOptions, fandomsOptions, workCountOptions, seriesCompleteOptions, kudos2HitsOptions,timeToReadOptions,dateWorkPublishedOptions, dateWorkUpdateOptions, dateWorkCompleteOptions

Individual User Navigation Icons

Define individual icons and tooltips, using the userNavSettings object.

Properties

  • iconClass: String - name of boxicon icon (see https://boxicons.com)
  • solid: Boolean - sets the icon as solid or not. See selected icon properties on https://boxicons.com
  • tooltip: String - description that shows on mouse hover.

Example

{
  userNavSettings: {
    accountOptions: { iconClass: "user-rectangle" }
  }
}

Will turn the round user icon into a rectangular one. Note that the default settings will stay intact if not overwritten here.

List of possible Options

accountOptions, postNewOptions, logoutOptions