{"id":15295840,"url":"https://github.com/cybertooth-io/ember-data-bootstrap3-forms","last_synced_at":"2026-01-20T02:18:54.067Z","repository":{"id":37225249,"uuid":"76327769","full_name":"cybertooth-io/ember-data-bootstrap3-forms","owner":"cybertooth-io","description":"Present Ember-Data model errors in Bootstrap3 alerts and help-blocks.","archived":false,"fork":false,"pushed_at":"2023-03-04T15:13:04.000Z","size":2471,"stargazers_count":1,"open_issues_count":32,"forks_count":0,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-03-17T17:54:11.325Z","etag":null,"topics":["bootstrap","bootstrap-form","bootstrap3","ember-data","html-forms"],"latest_commit_sha":null,"homepage":"http://ember-data-bootstrap3-forms.cybertooth.io/","language":"JavaScript","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/cybertooth-io.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.md","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":"2016-12-13T05:58:57.000Z","updated_at":"2023-01-31T16:46:46.000Z","dependencies_parsed_at":"2024-10-30T20:20:59.033Z","dependency_job_id":null,"html_url":"https://github.com/cybertooth-io/ember-data-bootstrap3-forms","commit_stats":{"total_commits":66,"total_committers":5,"mean_commits":13.2,"dds":"0.48484848484848486","last_synced_commit":"4a25f40fe348ed805b622cb09b0fd52234d403df"},"previous_names":["cybertoothca/ember-data-bootstrap3-forms"],"tags_count":24,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cybertooth-io%2Fember-data-bootstrap3-forms","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cybertooth-io%2Fember-data-bootstrap3-forms/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cybertooth-io%2Fember-data-bootstrap3-forms/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cybertooth-io%2Fember-data-bootstrap3-forms/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cybertooth-io","download_url":"https://codeload.github.com/cybertooth-io/ember-data-bootstrap3-forms/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247440247,"owners_count":20939213,"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":["bootstrap","bootstrap-form","bootstrap3","ember-data","html-forms"],"created_at":"2024-09-30T18:08:22.282Z","updated_at":"2026-01-20T02:18:54.043Z","avatar_url":"https://github.com/cybertooth-io.png","language":"JavaScript","readme":"# ember-data-bootstrap3-forms\n\n[![npm version](http://badge.fury.io/js/ember-data-bootstrap3-forms.svg)](http://badge.fury.io/js/ember-data-bootstrap3-forms) ![downloads](https://img.shields.io/npm/dy/ember-data-bootstrap3-forms.svg) [![Code Climate](http://codeclimate.com/github/cybertoothca/ember-data-bootstrap3-forms/badges/gpa.svg)](http://codeclimate.com/github/cybertoothca/ember-data-bootstrap3-forms)\n\n[![ember-observer-badge](http://emberobserver.com/badges/ember-data-bootstrap3-forms.svg)](http://emberobserver.com/addons/ember-data-bootstrap3-forms) [![License](http://img.shields.io/npm/l/ember-data-bootstrap3-forms.svg)](LICENSE.md)\n\nThis addon helps present your Ember-Data model errors in a consistent fashion using Bootstrap3 alerts and help-blocks.\n\n## Compatibility\n\n- Ember.js v2.18 or above\n- Ember CLI v2.13 or above\n- Node.js v8 or above\n\n* Ember Data - the `twbs-errors-alert` \u0026 `twbs-form-group` components depend on Ember Data's\n  modeling of errors.\n* You should have Bootstrap 3.x\n\n## Installation\n\n```\nember install ember-data-bootstrap3-forms\n```\n\n**As mentioned, you should install Bootstrap3 in order for the correct styling to be applied. Refer to the\nrequirements section above.**\n\n## Demo\n\nThe demonstration web application can be found here:\n[http://ember-data-bootstrap3-forms.cybertooth.io/](http://ember-data-bootstrap3-forms.cybertooth.io/).\n\n## What Does This Addon Do?\n\nThis addon supplies the following _components_:\n\n- [`{{twbs-errors-alert}}`](#twbs-errors-alert) - a component that listens to a single model's errors\n  and prepares a bootstrap alert box with the fields you want in a bulleted list.\n- [`{{twbs-form}}`](#twbs-form) - a component that creates a form element that you can easily bind\n  the submit and reset action to. Then all you need to do is add a submit and/or reset button to your\n  form.\n- [`{{twbs-form-group}}`](#twbs-form-group) - a component generating a Bootstrap\n  `\u003cdiv class=\"form-group\"\u003e...\u003c/div\u003e` that has intelligence built in to detect when it's\n  field enters the error-state; the `.has-error` class will be applied and error messages will be\n  appended to the bottom of the component's template.\n\n_Further information about these items can be found in the Usage section below._\n\n## Usage\n\nAs mentioned above there are several examples on the demonstration site:\n[http://ember-data-bootstrap3-forms.cybertooth.io/](http://ember-data-bootstrap3-forms.cybertooth.io/)\n\n### Components\n\n#### `{{twbs-form}}`\n\nA standard HTML form with the Bootstrap3 `.form` class assigned. Provide a block\nwith all the form-groups and inputs that you want inside the form container. The\n`twbs-form` component accepts a `submit` and `reset` property both of which\nshould take in a closure function.\n\n##### Arguments\n\n- `submit` (OPTIONAL) - the action that will be fired if the form happens to\n  be submitted by a basic submit button or by pressing enter while focused on\n  an input. Ideal for posting model changes.\n- `reset` (OPTIONAL) - the action the will be fired when the form is reset by\n  clicking on a basic reset button. Ideal for rolling back model changes.\n\n###### Examples\n\n[Check out the demo application](http://ember-data-bootstrap3-forms.cybertooth.io/)\n\n#### `{{twbs-errors-alert}}`\n\nA Bootstrap3 _alert_ box that contains a list of model errors. You provide a block to the component, it will be\nplaced in a paragraph element just above the unordered-list of errors. When the model does not have any errors,\nthe alert will not be visible.\n\n##### Arguments\n\n- `model` (**REQUIRED**) - the supplied model's `DS.Errors` collection is the source for the list of errors presented\n  in the alert.\n- `excludes` (OPTIONAL) - a comma-separated list of the camelCased attribute names from the model whose errors\n  will be ignored and not presented in the list. **If you specify both an `includes` and `excludes` argument, the\n  `excludes` argument always takes precedence.**\n- `includes` (OPTIONAL) - a comma-separated list of the camelCased attribute names from the model whose errors\n  should be included in the list.\n- `classNames` (OPTIONAL) - use the `classNames` argument to pass an alert style to the errors alert. For example,\n  `alert-danger` or `alert-warning`.\n\n##### Examples\n\n[Check out the demo application](http://ember-data-bootstrap3-forms.cybertooth.io/)\n\n#### `{{twbs-form-group}}`\n\nA Bootstrap 3 `.form-group` that accepts a model's errors for a given field\nand listens for field errors in order to apply the danger colour and produce\nthe list of error messages below the form itself.\n\nTo understand how this works, familiarize yourself with [Bootstrap 3's form validation\nstates](http://getbootstrap.com/css/#forms-control-validation). Also recognize\nthat Ember Data model errors can be viewed from a field's perspective and this\ncomponent is watching that particular view of the errors.\n\n##### Arguments\n\n- `fieldErrors` (**REQUIRED**) - the model's errors collection for a specific\n  field. For example, if your model has a field named `firstName` you would pass\n  the following: `model.errors.firstName`.\n\n##### Examples\n\n[Check out the demo application](http://ember-data-bootstrap3-forms.cybertooth.io/)\n\n### Troubleshooting And Tips\n\n1. Do you have Ember Data in your application and are using it for your data modeling?\n1. Is Bootstrap 3 installed? As the addon's name states, this isn't Bootstrap 4 ready.\n\n## Contributing\n\nSee the [Contributing](CONTRIBUTING.md) guide for details.\n\n## License\n\nThis project is licensed under the [MIT License](LICENSE.md).\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcybertooth-io%2Fember-data-bootstrap3-forms","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcybertooth-io%2Fember-data-bootstrap3-forms","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcybertooth-io%2Fember-data-bootstrap3-forms/lists"}