{"id":15019439,"url":"https://github.com/raphaelm-sudo/ngx-simple-spinner","last_synced_at":"2025-04-04T07:10:35.824Z","repository":{"id":43420617,"uuid":"273358256","full_name":"raphaelM-sudo/ngx-simple-spinner","owner":"raphaelM-sudo","description":"Simple and lightweight, yet customizable spinner/number input module for Angular","archived":false,"fork":false,"pushed_at":"2023-07-14T00:13:58.000Z","size":1552,"stargazers_count":1,"open_issues_count":7,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-03-10T22:16:38.280Z","etag":null,"topics":["angular","input","ngx","number","number-input","spinner"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/raphaelM-sudo.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-06-18T23:14:13.000Z","updated_at":"2022-09-19T17:10:27.000Z","dependencies_parsed_at":"2024-09-22T03:40:56.302Z","dependency_job_id":null,"html_url":"https://github.com/raphaelM-sudo/ngx-simple-spinner","commit_stats":{"total_commits":20,"total_committers":2,"mean_commits":10.0,"dds":0.09999999999999998,"last_synced_commit":"a14c1b4daf623eb190d8e9f9d40712ad72cd9bc6"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/raphaelM-sudo%2Fngx-simple-spinner","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/raphaelM-sudo%2Fngx-simple-spinner/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/raphaelM-sudo%2Fngx-simple-spinner/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/raphaelM-sudo%2Fngx-simple-spinner/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/raphaelM-sudo","download_url":"https://codeload.github.com/raphaelM-sudo/ngx-simple-spinner/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247135147,"owners_count":20889421,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["angular","input","ngx","number","number-input","spinner"],"created_at":"2024-09-24T19:53:29.131Z","updated_at":"2025-04-04T07:10:35.806Z","avatar_url":"https://github.com/raphaelM-sudo.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Ngx Simple Spinner\n\nSimple and lightweight, yet customizable spinner/number input module for Angular.\n\n[Demo](https://ngx-simple-spinner.netlify.app/)  \n[![Netlify Status](https://api.netlify.com/api/v1/badges/abae043e-6027-4493-bb44-aa1f4de436b0/deploy-status)](https://app.netlify.com/sites/ngx-simple-spinner/deploys)\n\nThis is a number input component for Angular, fully supporting template driven forms and form validation. It is completely customizable using SCSS/CSS.\nAdditionally it features: displaying most common fractions (1/2, 1/3, 1/4, ...), setting decimal places, i18n and RTL (right-to-left).\nIt replicates Google Chrome's behaviour regarding its base functionality.\n\n## Installation\n\nNgx Simple Spinner requires Angular 9 or above.\n\n```sh\nnpm install @nutrify/ngx-simple-spinner --save\n```\n\nYou might also need to install @angular/cdk:\n\n```sh\nnpm install @angular/cdk --save\n```\n\nFor styling import @nutrify/ngx-simple-spinner/scss/styles.scss or @nutrify/ngx-simple-spinner/css/styles.css\n\n## Usage\n\n**app.module.ts:**\n\n```typescript\nimport { NgModule } from '@angular/core';\nimport { BrowserModule } from '@angular/platform-browser';\n\nimport { AppComponent } from './app.component';\nimport { SimpleSpinnerModule } from '@nutrify/ngx-simple-spinner';\n\n@NgModule({\n  declarations: [\n    AppComponent\n  ],\n  imports: [\n    BrowserModule,\n    SimpleSpinnerModule\n  ],\n  providers: [],\n  bootstrap: [AppComponent]\n})\nexport class AppModule { }\n\n```\n\n**component.ts:**\n\n```typescript\n// ...\n\nexport class Component {\n  value = 12.5;\n}\n```\n\n**component.html:**\n\n```html\n\u003c!-- ... --\u003e\n\n\u003csimple-spinner [(ngModel)]=\"value\" min=\"1\" max=\"100\" smallStep=\"0.25\" maxDecimalPlaces=\"2\" fractions=\"true\"\u003e\u003c/simple-spinner\u003e\n\n\u003c!-- ... --\u003e\n```\n\nCheck out the [source code](https://github.com/raphaelM-sudo/ngx-simple-spinner/tree/master/src/app) for an example.\n\n#### Spinner\n\n##### Inputs\n\n| Property         | Default                   | Description                                                                                                      |\n| ---------------- | ------------------------- | ---------------------------------------------------------------------------------------------------------------- |\n| placeholder      |                           | Optional placeholder string, which gets displayed when value == null                                             |\n| value            |                           | Value of the number input                                                                                        |\n| min              | `Number.MIN_SAFE_INTEGER` | Minimum value (can be a float value)                                                                             |\n| max              | `Number.MAX_SAFE_INTEGER` | Maximum value (can be a float value)                                                                             |\n| bigStep          | 1                         | Number by which the current value should be in-/decremented using the nav/keyboard (can be a float value)        |\n| smallStep        | 0.25                      | Number by which the current value should be in-/decremented if 'bigStep' can't be applied (can be a float value) |\n| maxDecimalPlaces | 0                         | Maximum amount of decimal places that should be allowed to enter (exceeding decimal places get trimmed)          |\n| fractions        | `false`                   | Boolean describing whether or not fractions should be rendered                                                   |\n| i18nNumbers      | `true `                   | E.g. converts 0-9 to arabic digits, if arabic is the browser's default language                                  |\n| hoverBorder      | `false`                   | Boolean describing whether or not the border should only render on hover                                         |\n| hoverNav         | `true`                    | Boolean describing whether or not the navigation should only render on hover                                     |\n| dir              |                           | Optional direction property describing the content's orientation. Can be:  `'ltr' \\| 'rtl' \\| 'auto'`            |\n\n##### Directives\n\n| Property | Description                 |\n| -------- | --------------------------- |\n| disabled | Sets the disabled attribute |\n| required | Sets the required attribute |\n\n## Styling\n\nYou can use SCSS or CSS  for styling.\n\nJust import the stylesheet and apply changes to it.\n\nThe SCSS stylesheet is recommended since it exports more variables.\n\nIf you are not using SCSS for your Angular projects already, you really should.\n\n[The migration is very easy.](https://medium.com/@ngubanethabo.ambrose/migrate-from-css-to-scss-stylesheets-for-existing-angular-application-d61f8061f5b7)\n\n### CSS / SASS\n\n```scss\n@import '~@nutrify/ngx-simple-spinner/scss/styles';\n```\n\n### Angular\n\n**angular-cli.json:**\n\n```json\n\"styles\": [\n  \"styles.css\",\n\n  \"../node_modules/@nutrify/ngx-simple-spinner/css/styles.css\"\n]\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fraphaelm-sudo%2Fngx-simple-spinner","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fraphaelm-sudo%2Fngx-simple-spinner","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fraphaelm-sudo%2Fngx-simple-spinner/lists"}