jQuery UI API - Datepicker-Widget

Kategorie

小部件

Nutzung

Beschreibung:Wählen Sie ein Datum aus einem Popup- oder Inline-Kalender aus.

添加版本:1.0

Der jQuery UI Datepicker ist ein hochgradig konfigurierbares Plugin, das Datepicker-Funktionalität zu Ihren Seiten hinzufügt. Sie können das Datumsformat und die Sprache anpassen, den auswählbaren Datumsbereich einschränken und Schaltflächen sowie weitere Navigationsoptionen hinzufügen.

Standardmäßig öffnet sich der Datepicker in einem kleinen Overlay, wenn das zugehörige Textfeld den Fokus erhält. Für einen Inline-Kalender hängen Sie den Datepicker einfach an ein div oder span an.

Tastaturinteraktion

Wenn der Datepicker geöffnet ist, sind die folgenden Tastaturbefehle verfügbar:

  • BILD AUF: Zum vorherigen Monat wechseln.
  • BILD AB: Zum nächsten Monat wechseln.
  • STRG+BILD AUF: Zum vorherigen Jahr wechseln.
  • STRG+BILD AB: Zum nächsten Jahr wechseln.
  • STRG+POS1: Zum aktuellen Monat wechseln. Wenn der Datepicker geschlossen ist, öffnen Sie ihn.
  • STRG+LINKS: Zum vorherigen Tag wechseln
  • STRG+RECHTS: Zum nächsten Tag wechseln.
  • STRG+OBEN: Zur vorherigen Woche wechseln.
  • STRG+UNTEN: Zur nächsten Woche wechseln.
  • EINGABE: Das fokussierte Datum auswählen.
  • STRG+ENDE: Den Datepicker schließen und das Datum löschen.
  • ESC: Den Datepicker schließen, ohne eine Auswahl zu treffen.

Hilfsfunktionen

$.datepicker.setDefaults( settings )

Die Standardeinstellungen für alle Datepicker ändern.

Verwenden Sie dieoption()Methode für die Einstellungen einzelner Instanzen.

Codebeispiele:

Alle Datepicker so einstellen, dass sie sich öffnen, wenn sie den Fokus erhalten oder wenn ein Symbol angeklickt wird.

$.datepicker.setDefaults({
  showOn: "both",
  buttonImageOnly: true,
  buttonImage: "calendar.gif",
  buttonText: "Calendar"
});

Alle Datepicker auf französischen Text einstellen.

$.datepicker.setDefaults( $.datepicker.regional[ "fr" ] );

$.datepicker.format( format, date, settings )

Formatiert ein Datum mit einem angegebenen Format in einen String-Wert.

Das Format kann eine Kombination der folgenden Elemente sein:

  • d - Tag des Monats (ohne führende Null)
  • dd - Tag des Monats (zwei Ziffern)
  • o - Tag des Jahres (ohne führende Null)
  • oo - Tag des Jahres (drei Ziffern)
  • D - Kurzname des Tages
  • DD - langer Name des Tages
  • m - Monat des Jahres (ohne führende Null)
  • mm - Monat des Jahres (zwei Ziffern)
  • M - Kurzname des Monats
  • MM - Langname des Monats
  • y - Jahr (zweistellig)
  • yy - Jahr (vierstellig)
  • @ - Unix-Zeitstempel (ms seit 01/01/1970)
  • ! - Windows-Uhr (100ns seit 01/01/0001)
  • '...' - Literaltext
  • '' - einfaches Anführungszeichen
  • Alles andere - Literaltext

Es gibt auch einige$.datepickervordefinierte Standard-Datumsformate:

  • ATOM - 'yy-mm-dd' (entspricht RFC 3339/ISO 8601)
  • COOKIE - 'D, dd M yy'
  • ISO_8601 - 'yy-mm-dd'
  • RFC_822 - 'D, d M y' (siehe RFC 822)
  • RFC_850 - 'DD, dd-M-y' (siehe RFC 850)
  • RFC_1036 - 'D, d M y' (siehe RFC 1036)
  • RFC_1123 - 'D, d M yy' (siehe RFC 1123)
  • RFC_2822 - 'D, d M yy' (siehe RFC 2822)
  • RSS - 'D, d M y' (identisch mit RFC 822)
  • TICKS - '!'
  • TIMESTAMP - '@'
  • W3C - 'yy-mm-dd' (identisch mit ISO 8601)
Codebeispiele:

Ein Datum im ISO-Format anzeigen. Erzeugt "2007-01-26".

$.datepicker.formatDate( "yy-mm-dd", new Date( 2007, 1 - 1, 26 ) );

Zeigt ein Datum im erweiterten französischen Format an. Erzeugt "Samedi, Juillet 14, 2007".

$.datepicker.formatDate( "DD, MM d, yy", new Date( 2007, 7 - 1, 14 ), {
  dayNamesShort: $.datepicker.regional[ "fr" ].dayNamesShort,
  dayNames: $.datepicker.regional[ "fr" ].dayNames,
  monthNamesShort: $.datepicker.regional[ "fr" ].monthNamesShort,
  monthNames: $.datepicker.regional[ "fr" ].monthNames
});

$.datepicker.parseDate( format, value, settings )

Extrahiert ein Datum aus einem String-Wert mit einem angegebenen Format.

Das Format kann eine Kombination der folgenden Elemente sein:

  • d - Tag des Monats (ohne führende Null)
  • dd - Tag des Monats (zwei Ziffern)
  • o - Tag des Jahres (ohne führende Null)
  • oo - Tag des Jahres (drei Ziffern)
  • D - kurzer Name des Wochentags
  • DD - langer Name des Wochentags
  • m - Monat des Jahres (ohne führende Null)
  • mm - Monat des Jahres (zwei Ziffern)
  • M - Kurzname des Monats
  • MM - Langname des Monats
  • y - Jahr (zweistellig)
  • yy - Jahr (vierstellig)
  • @ - Unix-Zeitstempel (ms seit 01/01/1970)
  • ! - Windows-Uhr (100ns seit 01/01/0001)
  • '...' - Literaltext
  • '' - einfaches Anführungszeichen
  • Alles andere - Literaltext

Einige Ausnahmen, die ausgelöst werden können:

  • 'Invalid arguments' - wird ausgelöst, wenn das Format oder der Wert leer ist.
  • 'Missing number at position nn' - wird ausgelöst, wenn das Format eine Zahl angibt, die nicht gefunden wird.
  • 'Unknown name at position nn' - wird ausgelöst, wenn das Format einen Wochentags- oder Monatsnamen angibt, der nicht gefunden wird.
  • 'Unexpected literal at position nn' - wird ausgelöst, wenn das Format einen Literalwert angibt, der nicht gefunden wird.
  • 'Invalid date' - wird ausgelöst, wenn das Datum ungültig ist, wie z. B. '31/02/2007'.
Codebeispiele:

Extrahiert ein Datum im ISO-Format.

$.datepicker.parseDate( "yy-mm-dd", "2007-01-26" );

Extrahiert ein Datum im erweiterten französischen Format.

$.datepicker.parseDate( "DD, MM d, yy", "Samedi, Juillet 14, 2007", {
  shortYearCuroff: 20,
  dayNamesShort: $.datepicker.regional[ "fr" ].dayNamesShort,
  dayNames: $.datepicker.regional[ "fr" ].dayNames,
  monthNamesShort: $.datepicker.regional[ "fr" ].monthNamesShort,
  monthNames: $.datepicker.regional[ "fr" ].monthNames
});

$.datepicker.iso8601Week( date )

Ermittelt die Kalenderwoche für ein gegebenes Datum: 1 bis 53.

Diese Funktion verwendet die ISO-8601-Definition einer Woche: Eine Woche beginnt am Montag, und die erste Woche eines jeden Jahres enthält den 4. Januar. Das bedeutet, dass höchstens drei Tage aus dem Vorjahr in die erste Woche des aktuellen Jahres einbezogen werden können und höchstens drei Tage aus dem aktuellen Jahr in die letzte Woche des Vorjahres einbezogen werden können.

Diese Funktion ist diecalculateWeekStandardimplementierung der Option.

Codebeispiele:

Ermittelt die Kalenderwoche für ein Datum.

$.datepicker.iso8601Week( new Date( 2007, 1 - 1, 26 ) );

$.datepicker.noWeekends

Legt eine Funktion wie beforeShowDay fest, um die Auswahl von Wochenenden zu verhindern.

Wir könnenbeforeShowDayin der Option angebennoWeekends()eine Funktion zum Berechnen aller Arbeitstage, die eintrue/falseArray von Werten bereitstellt, um anzugeben, ob das Datum auswählbar ist.

Codebeispiele:

Stelle den Datepicker so ein, dass Wochenenden nicht auswählbar sind.

$( "#datepicker" ).datepicker({
  beforeShowDay: $.datepicker.noWeekends
});

Einschränkungen

Der Datepicker bietet Unterstützung für die Lokalisierung von Inhalten, um unterschiedliche Sprachen und Datumsformate zu ermöglichen. Jede Lokalisierung ist in einer Datei enthalten, wobei der Sprachcode an den Namen angehängt wird, zum Beispiel Französisch istjquery.ui.datepicker-fr.js. Die erforderliche Lokalisierungsdatei muss nach dem Haupt-Datepicker-Code eingebunden werden. Jede Lokalisierungsdatei fügt der verfügbaren Lokalisierungssammlung ihre eigenen Einstellungen hinzu, und alle Instanzen wenden diese Einstellungen automatisch als Standardwerte an.

$.datepicker.regionalDie Eigenschaft enthält ein Array von Lokalisierungen, mit dem Sprachcode als Schlüssel, wobei der Standardschlüssel"", der Englisch repräsentiert. Jeder Eintrag ist ein Objekt mit den folgenden Eigenschaften:closeText、prevText、nextText、currentText、monthNames、monthNamesShort、dayNames、dayNamesShort、dayNamesMin、weekHeader、dateFormat、firstDay、isRTL、showMonthAfterYearundyearSuffix。

Sie können die Standardlokalisierung mit dem folgenden Code wiederherstellen:

$.datepicker.setDefaults( $.datepicker.regional[ "" ] );

Sie können den Datepicker für ein bestimmtes Gebietsschema mit dem folgenden Code überschreiben:

$( selector ).datepicker( $.datepicker.regional[ "fr" ] );

主题

Das Datepicker-Widget verwendet dasjQuery UI CSS Framework, um sein Erscheinungsbild und Verhalten zu definieren. Wenn Sie datepicker-spezifische Stile verwenden müssen, können Sie die folgenden CSS-Klassennamen verwenden:

  • ui-datepicker: Der äußere Container des Datepickers. Wenn der Datepicker inline ist, hat dieses Element zusätzlich eineui-datepicker-inlineKlasse. Wenn dieisRTLOption gesetzt ist, hat dieses Element zusätzlich eineui-datepicker-rtl -Klasse.
    • ui-datepicker-header: Der Header-Container des Datepickers.
      • ui-datepicker-prev: Das Steuerelement zur Auswahl des vorherigen Monats.
      • ui-datepicker-next: Das Steuerelement zur Auswahl des nächsten Monats.
      • ui-datepicker-title: Der Titelcontainer des Datepickers, der Monat und Jahr enthält.
        • ui-datepicker-month: Die Textanzeige des Monats. Wenn diechangeMonthoption gesetzt ist, zeigt es ein<select>Element.
        • ui-datepicker-year: Die Textanzeige des Jahres. Wenn diechangeYearoption gesetzt ist, zeigt es ein<select>Element.
    • ui-datepicker-calendar: Die Tabelle, die den Kalender enthält.
      • ui-datepicker-week-end: Zellen, die Wochenendtage enthalten.
      • ui-datepicker-other-month: Zellen für Tage, die in einem Monat vorkommen, aber nicht zum aktuellen Monat gehören.
      • ui-datepicker-unselectable: Zellen, die vom Benutzer nicht ausgewählt werden können.
      • ui-datepicker-current-day: Zellen für das ausgewählte Datum.
      • ui-datepicker-today: Zellen für das aktuelle Datum.
    • ui-datepicker-buttonpane: Wenn dieshowButtonPanelOption verwendet wird, wird ein Schaltflächenbereich verwendet.
      • ui-datepicker-current: Die Schaltfläche zum Auswählen des aktuellen Datums.

Wenn dienumberOfMonthsOption verwendet wird, um mehrere Monate anzuzeigen, werden einige zusätzliche Klassen verwendet:

  • ui-datepicker-multi: Der äußerste Container eines Multi-Monats-Datepickers. Dieses Element hat zusätzlich einenui-datepicker-multi-2、ui-datepicker-multi-3oderui-datepicker-multi-4Klassenname basierend auf der Anzahl der angezeigten Monate.
    • ui-datepicker-group: Der einzelne Picker innerhalb der Gruppe. Dieses Element hat zusätzlich einenui-datepicker-group-first、ui-datepicker-group-middleoderui-datepicker-group-lastKlassenname basierend auf seiner Position in der Gruppe.

Abhängigkeiten

Zusätzliche Hinweise

  • Dieses Widget benötigt etwas funktionales CSS, andernfalls funktioniert es nicht. Wenn Sie ein benutzerdefiniertes Theme erstellen, verwenden Sie die widgetspezifische CSS-Datei als Ausgangspunkt.
  • Dieses Widget manipuliert den Wert eines Elements programmatisch, sodass das nativechangeEreignis wird nicht ausgelöst, wenn sich der Wert ändert.
  • : Nicht unterstützt auf<input type="date">: Erstellen eines Datepickers, da dies zu UI-Konflikten mit dem nativen Picker führt.

Beispiele

Ein einfacher jQuery UI Datepicker.

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>日期选择器部件(Datepicker Widget)演示</title>
  <link rel="stylesheet" href="//code.jquery.com/ui/1.10.4/themes/smoothness/jquery-ui.css">
  <script src="//code.jquery.com/jquery-1.10.2.js"></script>
  <script src="//code.jquery.com/ui/1.10.4/jquery-ui.js"></script>
</head>
<body>
 
<div id="datepicker"></div>
 
<script>
$( "#datepicker" ).datepicker();
</script>
 
</body>
</html>

Weitere Erweiterungen