@aventii/angular-time-picker (0.1.0)
Installation
@aventii:registry=npm install @aventii/angular-time-picker@0.1.0"@aventii/angular-time-picker": "0.1.0"About this package
@aventii/angular-time-picker
Composant Angular standalone de sélection d'heure au format 24 heures.
Il propose deux rouleaux circulaires indépendants pour les heures et les minutes, avec navigation par défilement, clic ou boutons.
Installation
npm install @aventii/angular-time-picker
Utilisation
Importer le composant dans une application Angular standalone :
import { TimePicker } from '@aventii/angular-time-picker';
@Component({
imports: [TimePicker],
// ...
})
export class App {
hour = signal(12);
minute = signal(30);
}
Dans le template :
<aventii-time-picker
[(hour)]="hour"
[(minute)]="minute"
[minuteStep]="5"
/>
Configuration
| Propriété | Type | Défaut | Description |
|---|---|---|---|
hour |
model<number> |
Obligatoire | Heure sélectionnée (0–23) |
minute |
model<number> |
Obligatoire | Minute sélectionnée (0–59) |
minuteStep |
number |
5 |
Intervalle entre les minutes proposées |
arrowStep |
number |
3 |
Nombre d'éléments parcourus par clic sur une flèche |
itemHeight |
number |
30 |
Hauteur des éléments en pixels |
maxElementsY |
number |
8 |
Nombre d'éléments visibles par rouleau |
labels |
TimePickerLabels |
Français | Textes de l'interface |
minuteStep doit être un diviseur positif de 60 (1, 2, 3, 5, 10, 15, etc.).
Comportement
- Les rouleaux permettent une navigation circulaire.
- Les heures et les minutes sont modifiables indépendamment.
- Les modifications sont immédiatement transmises au composant parent.
- Annuler restaure les valeurs présentes à l'ouverture.
- Valider conserve les valeurs et ferme le panneau.
- La fermeture par la croix, un clic extérieur ou la touche Échap conserve les valeurs courantes.
Internationalisation
Les libellés peuvent être personnalisés via l'input labels.
import { TimePickerLabels } from '@aventii/angular-time-picker';
labels: TimePickerLabels = {
title: 'Select time',
hours: 'Hours',
minutes: 'Minutes',
cancel: 'Cancel',
confirm: 'Confirm',
close: 'Close'
};
<aventii-time-picker
[(hour)]="hour"
[(minute)]="minute"
[labels]="labels"
/>
Personnalisation visuelle
Le composant expose des variables CSS personnalisables depuis l'application consommatrice.
aventii-time-picker {
--atp-primary: #059669;
--atp-primary-hover: #047857;
--atp-selected-background: #d1fae5;
--atp-selected-text: #065f46;
--atp-radius: 8px;
}
Les principales variables disponibles sont :
| Variable | Description |
|---|---|
--atp-background |
Fond du composant |
--atp-text |
Couleur principale du texte |
--atp-text-muted |
Couleur des textes secondaires |
--atp-border |
Couleur des bordures |
--atp-primary |
Couleur principale des boutons |
--atp-primary-hover |
Couleur principale au survol |
--atp-selected-background |
Fond des valeurs sélectionnées |
--atp-selected-text |
Texte des valeurs sélectionnées |
--atp-hover-background |
Fond des éléments survolés |
--atp-radius |
Arrondi des bordures |
--atp-wheel-width |
Largeur des rouleaux |
--atp-panel-width |
Largeur du panneau |
Développement
Depuis la racine du workspace Angular :
ng build time-picker --watch
Dans un second terminal :
ng serve demo
Licence
Copyright © 2026 Aventii. Tous droits réservés.
Ce logiciel est propriétaire. Toute utilisation, reproduction, modification, distribution ou intégration dans un autre logiciel sans autorisation préalable et écrite du titulaire des droits est interdite.
Aucune licence d'utilisation n'est accordée implicitement.
Dependencies
Dependencies
| ID | Version |
|---|---|
| tslib | ^2.3.0 |
Peer Dependencies
| ID | Version |
|---|---|
| @angular/common | ^22.2.0 |
| @angular/core | ^22.2.0 |