Skip to content

Commit d88d6bb

Browse files
authored
Merge pull request #6 from ProAngular/ct/readme-updates
Add table of contents and anchor links
2 parents 3591b07 + 956a719 commit d88d6bb

File tree

3 files changed

+67
-17
lines changed

3 files changed

+67
-17
lines changed

README.md

Lines changed: 65 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -9,23 +9,51 @@
99
</h1>
1010
</p>
1111

12-
[![npm version](https://badge.fury.io/js/@proangular%2Fngx-scroll-top.svg)](https://badge.fury.io/js/@proangular%2Fngx-scroll-top)
13-
[![NPM Downloads](https://img.shields.io/amo/dw/@proangular%252Fngx-scroll-top.svg)](https://www.npmjs.com/@proangular/ngx-scroll-top)
14-
[![Join the chat at https://gitter.im/ProAngular/community](https://badges.gitter.im/ProAngular/lobby.svg)](https://gitter.im/ProAngular/community)
15-
[![Verify and Deploy to GitHub Packages](https://github.com/ProAngular/ngx-scroll-top/actions/workflows/on-merge-main-deploy-gpr.yml/badge.svg)](https://github.com/ProAngular/ngx-scroll-top/actions/workflows/on-merge-main-deploy-gpr.yml)
16-
[![Verify and Deploy to npmjs](https://github.com/ProAngular/ngx-scroll-top/actions/workflows/on-merge-main-deploy-npmjs.yml/badge.svg)](https://github.com/ProAngular/ngx-scroll-top/actions/workflows/on-merge-main-deploy-npmjs.yml)
17-
18-
# Description
12+
[![npm](https://badgen.net/badge/icon/npm?icon=npm&label)](https://www.npmjs.com/@proangular/ngx-scroll-top)
13+
[![GitHub](https://badgen.net/badge/icon/GitHub?icon=github&label)](https://github.com/ProAngular/ngx-scroll-top)
14+
[![TypeScript](https://badgen.net/badge/icon/TypeScript?icon=typescript&label)](https://github.com/ProAngular/ngx-scroll-top/search?l=typescript)
15+
[![npm Version](https://badge.fury.io/js/@proangular%2Fngx-scroll-top.svg)](https://www.npmjs.com/@proangular/ngx-scroll-top)
16+
[![Node Version](https://badgen.net/npm/node/@proangular/ngx-scroll-top)](https://www.npmjs.com/@proangular/ngx-scroll-top)
17+
[![Package Downloads](https://badgen.net/npm/dw/@proangular/ngx-scroll-top)](https://www.npmjs.com/@proangular/ngx-scroll-top)
18+
[![Size](https://img.shields.io/bundlephobia/minzip/@proangular/ngx-scroll-top.svg)](https://bundlephobia.com/result?p=ProAngular/ngx-scroll-top)
19+
[![Website Status](https://img.shields.io/website?down_color=lightgrey&down_message=Offline&label=Website&up_color=green&up_message=Online&url=https%3A%2F%2Fwww.proangular.com)](https://www.proangular.com)
20+
[![Gitter Chat](https://badges.gitter.im/ProAngular/lobby.svg)](https://gitter.im/ProAngular/community)
21+
[![Discord Chat](https://img.shields.io/discord/1003103094588055552?label=Discord)](https://discord.com/channels/1003103094588055552)
22+
[![Sponsors](https://img.shields.io/github/sponsors/proangular?label=Sponsors)](https://github.com/sponsors/ProAngular)
23+
[![License](https://img.shields.io/npm/l/express.svg?maxAge=2592000)](/LICENSE)
24+
[![GitHub Package Status](https://github.com/ProAngular/ngx-scroll-top/actions/workflows/on-merge-main-deploy-gpr.yml/badge.svg)](https://github.com/ProAngular/ngx-scroll-top/actions/workflows/on-merge-main-deploy-gpr.yml)
25+
[![npmjs Package Status](https://github.com/ProAngular/ngx-scroll-top/actions/workflows/on-merge-main-deploy-npmjs.yml/badge.svg)](https://github.com/ProAngular/ngx-scroll-top/actions/workflows/on-merge-main-deploy-npmjs.yml)
26+
27+
## Table of Contents
28+
29+
- [Description](#description)
30+
- [Demo](#demo)
31+
- [Installation](#installation)
32+
- [Dependencies](#dependencies)
33+
- [Usage](#usage)
34+
- [Component API](#api)
35+
- [Compatibility](#compatibility)
36+
- [Issues & Contribution](#development)
37+
- [Donations](#donations)
38+
- [License](#license)
39+
40+
<a name="description"/>
41+
42+
## Description
1943

2044
Configurable, lightweight back to top button for Angular projects.
2145

22-
# Demo
46+
<a name="demo"/>
47+
48+
## Demo
2349

2450
<p align="center">
2551
<img src="src/assets/images/demo-scroll-top.gif" />
2652
</p>
2753

28-
# Installation
54+
<a name="installation"/>
55+
56+
## Installation
2957

3058
```bash
3159
ng add @proangular/ngx-scroll-top@latest
@@ -51,7 +79,19 @@ Import `NgxScrollTopModule` where needed
5179
export class AppModule { }
5280
```
5381

54-
# Usage
82+
<a name="dependencies"/>
83+
84+
## Dependencies
85+
86+
### Styling UX - Angular Material
87+
88+
You should have an Angular Material theme set up prior to using this. It's also possible to use this without an angular theme and style it yourself entirely!
89+
90+
More information on theming Angular Material: https://material.angular.io/guide/theming
91+
92+
<a name="usage"/>
93+
94+
## Usage
5595

5696
Default (blue button with white icon)
5797
```html
@@ -73,7 +113,9 @@ Customization with optional inputs and icon
73113
>&#8686;</ngx-scroll-top>
74114
```
75115

76-
# Component API
116+
<a name="api"/>
117+
118+
## Component API
77119

78120
| Input | Value Typing | Default Value | Description |
79121
| ---------------------- | --------------------- | ----------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
@@ -87,15 +129,19 @@ Customization with optional inputs and icon
87129
| **width** | string | `'40px'` | Width of back to top button in string px format. |
88130
| **zIndex** | number | `999` | Style the `z-index` for the back to top button as needed for correct layer height adjustment. This can be useful when working with sticky headers. |
89131

90-
# Compatibility
132+
<a name="compatibility"/>
133+
134+
## Compatibility
91135

92136
| Angular version | @proangular/ngx-scroll-top | Install |
93137
| --------------- | -------------------------- | ------------------------------------------ |
94138
| v14 | v1.x.x | `ng add @proangular/ngx-scroll-top@latest` |
95139
| v13 | v1.x.x | `ng add @proangular/ngx-scroll-top@latest` |
96140
| v12 | v1.x.x | `ng add @proangular/ngx-scroll-top@latest` |
97141

98-
# Development
142+
<a name="development"/>
143+
144+
## Issues & Contribution
99145

100146
Please submit all issues, and feature requests here: [https://github.com/ProAngular/ngx-scroll-top/issues](https://github.com/ProAngular/ngx-scroll-top/issues)
101147

@@ -115,13 +161,17 @@ Contribution:
115161

116162
Thank you for any and all contributions!
117163

118-
# Donation
164+
<a name="donations"/>
165+
166+
## Donation
119167

120168
As a husband and father of four children, your donations mean the world to me! Any donations are greatly appreciated and keep me going!
121169
* [https://www.paypal.me/CodyTolene](https://www.paypal.me/CodyTolene)
122170
* [https://github.com/sponsors/ProAngular](https://github.com/sponsors/ProAngular)
123171

124-
# License
172+
<a name="license"/>
173+
174+
## License
125175

126176
Copyright &copy; 2022 [Cody Tolene](https://www.CodyTolene.com)
127177

package-lock.json

Lines changed: 1 addition & 1 deletion
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

package.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
{
22
"name": "@proangular/ngx-scroll-top",
3-
"version": "1.1.6",
3+
"version": "1.1.7",
44
"description": "Configurable, lightweight back to top button for Angular projects.",
55
"author": "Pro Angular <[email protected]>",
66
"homepage": "https://www.proangular.com",

0 commit comments

Comments
 (0)