Widgets

ClockWidget

Widget orologio decorativo in tempo reale con supporto formato 12/24h, visualizzazione data, varianti stilistiche e localizzazione personalizzabile.

Import

import { ClockWidget } from '@pzeta/vue-components'

Esempio Base

Il widget si aggiorna automaticamente ogni secondo e mostra ora (HH:MM:SS) e data corrente.

Props

PropTipoDefaultDescrizione
showDatebooleantrueMostra la data sotto all'orario
showSecondsbooleantrueMostra i secondi nell'orario
use24HourbooleantrueUsa il formato 24 ore (false = 12h con AM/PM)
variant'default' | 'primary' | 'gradient' | 'signboard''default'Variante stilistica del widget
size'sm' | 'md' | 'lg''md'Dimensione del widget
localestring'it-IT'Locale per la formattazione
dayNamesstring[]undefinedArray personalizzato dei nomi dei giorni (sovrascrive i default i18n)
monthNamesstring[]undefinedArray personalizzato dei nomi dei mesi (sovrascrive i default i18n)

Emits

EventoPayloadDescrizione
tickDateEmesso ogni secondo con la data/ora corrente

Slot

Nessuno slot disponibile.

Esempi

Configurazioni Base

Varianti

La variante signboard mostra ore, minuti e secondi su card separate ispirate agli orologi da stazione.

Dimensioni

Localizzazione

Se dayNames e monthNames non sono forniti, il widget usa le traduzioni configurate nel plugin i18n.

Evento Tick

TypeScript

import type { ClockWidgetProps } from '@pzeta/vue-components'

// Tipo dell'emit
// ClockWidgetEmits = (e: 'tick', value: Date) => void

const config: ClockWidgetProps = {
  showDate: true,
  showSeconds: false,
  use24Hour: false,
  variant: 'primary',
  size: 'lg',
  locale: 'it-IT',
}