ngx-tempusdominus-bootstrap
v1.0.2
Published
Angular2+ directive for tempus dominus bootstrap library.
Downloads
512
Maintainers
Readme
Angular Tempus Dominus Bootstrap
About
This is an angular wrapper for the Bootstrap datetimepicker: "Tempus Dominus" v5. This wrapper will works with bootstrap 3 and or/with bootstrap 4.
This version depends on the current version of tempus dominus bootstrap.
Installation
Install the directive via npm
npm install ngx-tempusdominus-bootstrap --save
Install required plugin if you didn't installed them yet
- jquery.js,
- bootstrap (.js & .css),
- tempusdominus core,
- tempusdominus bootstrap 3 or 4(.js & .css),
- moment.
For bootstrap 4
npm install jquery bootstrap moment tempusdominus-core tempusdominus-bootstrap-4 --save
"styles": [
"styles.css",
"../node_modules/bootstrap/dist/css/bootstrap.min.css",
"../node_modules/tempusdominus-bootstrap-4/build/css/tempusdominus-bootstrap-4.css",
],
"scripts": [
"../node_modules/jquery/dist/jquery.min.js",
"../node_modules/bootstrap/dist/js/bootstrap.min.js",
"../node_modules/moment/min/moment.min.js",
"../node_modules/tempusdominus-bootstrap-4/build/js/tempusdominus-bootstrap-4.js"
],
For bootstrap 3
npm install jquery bootstrap@^3.0.0 moment tempusdominus-core tempusdominus-bootstrap-3 --save
"styles": [
"styles.css",
"../node_modules/bootstrap/dist/css/bootstrap.min.css",
"../node_modules/tempusdominus-bootstrap-3/build/css/tempusdominus-bootstrap-3.css",
],
"scripts": [
"../node_modules/jquery/dist/jquery.min.js",
"../node_modules/bootstrap/dist/js/bootstrap.min.js",
"../node_modules/moment/min/moment.min.js",
"../node_modules/tempusdominus-bootstrap-3/build/js/tempusdominus-bootstrap-3.js"
],
Usage
Import the NgTempusdominusBootstrapModule
module in your module. You need FormsModule
or ReactiveModule
like all other form:
import { NgTempusdominusBootstrapModule } from 'ngx-tempusdominus-bootstrap';
import { FormsModule } from '@angular/forms';
@NgModule({
imports: [
...
FormsModule,
NgTempusdominusBootstrapModule,
...
]
})
export class SomeModule {}
In your component html:
- Input group: (there are 3 directive you shoud use:
NgTempusdominusBootstrap
,NgTempusdominusBootstrapInput
, andNgTempusdominusBootstrapToggle
)
<div class="form-group">
<div class="input-group date" data-target-input="nearest" NgTempusdominusBootstrap>
<input
[(ngModel)]="startDate"
(ngModelChange)="update()"
[options]="startOptions"
NgTempusdominusBootstrapInput
type="text" class="form-control"
/>
<div class="input-group-append" NgTempusdominusBootstrapToggle>
<div class="input-group-text"><i class="fa fa-calendar"></i></div>
</div>
</div>
</div>
- Input Only: (use:
NgTempusdominusBootstrapInput
only)
<input
[(ngModel)]="date"
[options]="options"
NgTempusdominusBootstrapInput
type="text" class="form-control"
/>
Parameters with NgTempusdominusBootstrapInput
options
With options
attribute you can pass an object containing all the required configuration for the tempus dominus v5.
All the options available in the original library are supported. Check the list of options on official website: https://tempusdominus.github.io/bootstrap-4/Options/
options = {
format: "DD.MM.YYYY",
maxDate: moment(),
minDate: date,
// ...
};
Examples
- Our demo here
- browse our example code with bootstrap 4
- Check the branch
bootstrap-3
for bootstrap 3 examples