@aventii/angular-time-picker (0.1.0)

Published 2026-10-13 12:20:46 +00:00 by Valentin

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
Details
npm
2026-10-13 12:20:46 +00:00
26
UNLICENSED
latest
19 KiB
Assets (1)
Versions (1) View all
0.1.0 2026-10-13