| calendar-dialog-acceptance.mjs |
Calendar Dialog Acceptance Widget
Template ID: #calendarDialogAcceptanceTemplate (from calendarDialogAcceptance.inc.xhtml)
@tagname calendar-dialog-acceptance
@attribute {string} status - The user's response status from the event.
|
2198 |
- |
| calendar-dialog-attachment.mjs |
Single row containing the details for an attachment.
Template ID: #calendarDialogAttachmentTemplate
@tagname calendar-dialog-attachment
@attribute {string} label - The displayed label for the attachment.
@attribute {string} url - The full URI pointing to the attachment.
@attribute {string} [icon] - The icon URL to display for the attachment.
|
2786 |
- |
| calendar-dialog-attachments-list.mjs |
@typedef {object} AttachmentStub
@property {string} uri - The URI of the attachment.
@property {string} [icon] - An optional string pointing to an icon to
represent the attached file.
|
1867 |
- |
| calendar-dialog-attendee.mjs |
Template ID: #calendarAttendeeTemplate
@tagname calendar-dialog-attendee
|
3065 |
- |
| calendar-dialog-attendees-row.mjs |
Template ID: #calendarAttendeesRowTemplate
@tagname calendar-dialog-attendees-row
@attribute {string} [type] - If type is full, attendees is expanded with
a browser, otherwise it is truncated.
|
6771 |
- |
| calendar-dialog-categories.mjs |
Calendar Dialog Categories
Template ID: #calendarDialogCategoriesTemplate
@tagname calendar-dialog-categories
|
2768 |
- |
| calendar-dialog-create-reminder-form.mjs |
Template ID: #calendarDialogCreateReminderFormTemplate
@tagname calendar-dialog-create-reminder-form
@fires CustomEvent - Event "new-reminder" emitted when a new reminder should
be added to the event. The detail is an object with the property
`minutesBefore` specifying how many minutes before the event the reminder
should trigger. When the reminder is created, `setReminders` should be
called with the updated list of reminders, though the new reminder should
explicitly be at the bottom of the list. TODO maybe handle adding the new
reminder in a closed loop here? That means we might show incorrect data
though.
|
4385 |
- |
| calendar-dialog-date-row.mjs |
Template ID: #calendarDialogDateRowTemplate
@tagname calendar-dialog-date-row
@attribute {string} start-date - ISO timestamp when the event starts.
@attribute {string} end-date - ISO timestamp when the event ends.
@attribute {string} [repeats] - Human readable description of the repeat
pattern. If omitted, the repeats icon is hidden.
|
1949 |
- |
| calendar-dialog-description-row.mjs |
globals launchBrowser |
4310 |
- |
| calendar-dialog-navigation-row.mjs |
A row with an action button that triggers subview navigation.
Template ID: #calendarDialogNavigationRowTemplate
@tagname calendar-dialog-navigation-row
@attribute {string} subview-id - The ID of the subview to show.
@slot icon - The row icon.
@slot label - The row label.
@slot action - The action button icon.
@slot content - The row content.
@fires CustomEvent - Event "calendar-dialog-open-subview" requests that the
parent shows the subview identified by this row's `subview-id`.
|
2118 |
- |
| calendar-dialog-reminders-row.mjs |
Template ID: #calendarDialogRemindersRowTemplate
@tagname calendar-dialog-reminders-row
|
2327 |
- |
| calendar-dialog-row.mjs |
Calendar Dialog Row Template
Template ID: #calendarDialogRow (from calendarDialogRowTemplate.inc.xhtml)
@tagname calendar-dialog-row
@attribute {boolean} [expanding] - Determines whether content can be expanded.
@attribute {boolean} [expanded] - Determines whether content is expanded.
@slot icon - The icon image for the row
@slot label - The label for the row.
@slot content - Body content for the row.
|
1354 |
- |
| calendar-dialog-subview-manager.mjs |
The subview manager should contain multiple subview containers, each with
their own ID. The subviews should have the hidden attribute by default. It
will be toggled by this manager.
The size of the default subview dictates the viewport size of any other
subview.
@tagname calendar-dialog-subview-manager
@attribute {string} default-subview - ID of the subview that should be shown by
default.
@fires subviewchanged Emitted whenever the subview changed. Contains the ID
of the now visible subview as detail.
|
3149 |
- |
| calendar-dialog-subview.mjs |
A calendar dialog subview with a Back button.
Template ID: #calendarDialogSubviewTemplate
@fires CustomEvent - Event "calendar-dialog-close-subview" requests that the
parent returns to its default subview.
@slot main - The main subview content.
@slot footer - Additional footer content.
@attribute initial-focus-id - The ID of the initial focus element.
@tagname calendar-dialog-subview
|
2229 |
- |
| calendar-dialog-toggleable-row.mjs |
A toggleable row that shows/hides row content.
Template ID: #calendarDialogToggleableRowTemplate
@tagname calendar-dialog-toggleable-row
@slot icon - The icon image for the row
@slot label - The label for the row.
@slot content - Body content for the row. Displayed when `checked` is set.
@attribute {boolean} [checked] - Observed state for the checkbox.
|
2017 |
- |
| calendar-dialog.mjs |
Read-only calendar event dialog. Expects to find an element to anchor to at
a selector of the pattern
`#view-box > :not([hidden]) [data-event-id="${event-id}"][data-recurrence-id="${recurrence-id}"]`.
If there is no recurrence ID, that part of the selector is omitted. If no
element is found we attempt to fall back to the target of the opening event
if possible.
Template ID: #calendarDialogTemplate
@tagname calendar-dialog
@attribute {string} event-id - ID of the event to display.
@attribute {string} calendar-id - ID of the calendar the event to display is
in.
@attribute {string} [recurrence-id] - Recurrence ID as the nativeTime
representation of a CalDateTime. icalString is not appropriately portable.
|
24555 |
- |
| calendar-event-calendar-options.mjs |
A copy of the calendar values used by the calendar control.
The Redux store holds these plain values. Calendar operations use the
original `calICalendar` object outside the store.
@typedef {object} CalendarEventCalendarData
@property {string} id - The calendar ID.
@property {string} name - The calendar name.
|
7104 |
- |
| calendar-event-category-options.mjs |
A category name and colors stored as plain values in Redux.
@typedef {object} CalendarEventCategoryOption
@property {string} name - The category name.
@property {string} color - A background color in `#RRGGBB` form, or an empty
string to use the neutral CSS color.
@property {string} textColor - A text color for the background, or an empty
string to use the neutral CSS color.
|
2860 |
- |
| calendar-event-category-row.mjs |
Shows selected categories as chips, each with a Remove button.
The summary shows up to three chips; More opens a list of the rest.
Add category opens checkboxes for available and selected names.
The row observes and updates the draft for the session bound by the dialog.
Open lists, focus, and chip widths stay in the row, outside Redux.
Template ID: #calendarDialogRowTemplate (inherited)
@tagname calendar-event-category-row
@slot icon - The row icon.
@slot label - The row label.
@slot content - The category controls.
|
22390 |
- |
| calendar-event-create-edit-dialog.mjs |
Displays editable event values, calendar choices, and category controls.
Keeps unsaved values (the draft) in the document's Redux store under a fixed
session key. Public getters return copies so callers cannot change the draft.
The route attributes select a saved event or one occurrence in a repeating
series. An empty route starts a new event.
`CalendarEventDialogSourceMixin` loads the event. The category row loads its
own options and observes and updates the draft for this dialog's session.
The dialog waits for translated category controls before opening.
Save uses `saveFields` to copy draft values to an event, then calls the
top-level window's `doTransaction` to write the event with Undo and meeting
message support. A failed Save keeps the draft for retry. A successful Save
closes the dialog only if the draft is still current.
These Calendar transactions are separate from Redux actions.
Closing clears the draft. While Save is pending, the dialog blocks closing
and duplicate Save requests. In edit mode, it also blocks route changes.
Other components add size and field rows.
Template ID: #calendarEventCreateEditDialogTemplate
@tagname calendar-event-create-edit-dialog
@attribute {string} calendar-id - The source calendar ID. Observed by the
source mixin. Set with `event-id` to edit an event.
@attribute {string} event-id - The saved event ID. Observed by the source mixin.
@attribute {string} recurrence-id - The optional occurrence start time in
microseconds, as a string. Observed by the source mixin.
|
45841 |
- |
| calendar-event-create-save.mjs |
Runs the supplied validators for enabled fields and stores their results.
A validator checks input and returns an object with a `valid` flag.
Returns null if the request or draft changes during validation.
@param {object} options - The fields and current request.
@param {{
getState: () => object,
dispatch: (action: object) => void
}} options.store - The dialog's Redux store.
@param {string} options.sessionKey - The fixed dialog key.
@param {Record<string, CalendarEventSaveField>} options.fields
- Field helpers.
@param {Record<string, {
enabled: boolean,
values: CalendarEventDraft
}>} options.preparedSections - Copied field values and enabled states.
@param {() => boolean} options.isCurrent - Checks the request and draft.
@returns {?Record<string, CalendarEventDraftSectionValidity>} Field results,
or null if the request or draft has changed.
|
10184 |
- |
| calendar-event-dialog-route-controller.mjs |
A route request that a dialog uses while it loads an event.
@typedef {object} CalendarEventDialogRouteRequest
@property {number} generation - The ID of this route request.
@property {() => boolean} isCurrent - True while this route is current.
@property {AbortSignal} signal - Aborted when this route is replaced.
|
6074 |
- |
| calendar-event-dialog-source-mixin.mjs |
The attributes that select an event source.
@type {string[]}
|
17447 |
- |
| calendar-event-edit-save.mjs |
Returns whether Edit Save needs to write categories.
Compares sorted names so order alone leaves the saved categories intact.
@param {CalendarEventDraft} draft - The values captured for Save.
@param {CalendarEventDraft} baseline - The starting values of the draft.
@returns {boolean} Whether the enabled state or enabled selection changed.
|
11570 |
- |
| calendar-event-save-fields.mjs |
Defines how Save checks and copies one section of unsaved values.
A section groups related fields, such as the start and end times.
`keys` lists the draft properties passed to `apply` and `validate`.
For example, a location helper copies `location` to the event's LOCATION
property. The event is a Calendar object; the draft contains plain data.
For enabled fields, create Save calls `validate` when supplied. After
validation succeeds, create Save calls `apply` for those fields.
Disabled fields add no properties to a new event.
Edit Save skips unchanged categories. For each field it saves, edit Save
calls `apply` for an enabled row or `remove` for a disabled row.
Both paths keep disabled fields' input in the draft for retry.
Field code supplies defaults and checks permissions for its own values.
@typedef {object} CalendarEventSaveField
@property {string[]} keys - Draft properties owned by this field.
@property {(event: calIEvent, values: CalendarEventDraft) => void} apply
- Copies enabled values to an event whose properties can still change.
@property {(event: calIEvent) => void} [remove] - Removes this field's old
properties from the mutable event copy. Required for optional rows used by
edit Save.
@property {(values: CalendarEventDraft) => CalendarEventDraftSectionValidity}
[validate] - Checks enabled values and displays errors during create Save.
Returns the result for Save to store. Edit Save uses stored results instead.
|
6037 |
- |
| calendar-event-session-row.mjs |
@import {CalendarDialogRow} from "./calendar-dialog-row.mjs" |
3327 |
- |
| calendar-event-source-loader.mjs |
The route attributes that identify one calendar event.
@typedef {object} CalendarEventSourceIdentity
@property {string} calendarId - The calendar ID.
@property {string} eventId - The event ID.
@property {?string} recurrenceId - The optional occurrence ID.
|
9488 |
- |
| calendar.inc.xhtml |
|
6407 |
- |
| calendarDialogAcceptanceTemplate.inc.xhtml |
|
1195 |
- |
| calendarDialogAttachmentsListTemplate.inc.xhtml |
|
725 |
- |
| calendarDialogAttachmentTemplate.inc.xhtml |
|
477 |
- |
| calendarDialogAttendeesRowTemplate.inc.xhtml |
|
755 |
- |
| calendarDialogAttendeeTemplate.inc.xhtml |
|
460 |
- |
| calendarDialogCategoriesTemplate.inc.xhtml |
|
399 |
- |
| calendarDialogCreateReminderFormTemplate.inc.xhtml |
|
2362 |
- |
| calendarDialogDateRowTemplate.inc.xhtml |
|
716 |
- |
| calendarDialogDescriptionRowTemplate.inc.xhtml |
|
1039 |
- |
| calendarDialogNavigationRowTemplate.inc.xhtml |
|
594 |
- |
| calendarDialogRemindersRowTemplate.inc.xhtml |
|
772 |
- |
| calendarDialogRowTemplate.inc.xhtml |
|
424 |
- |
| calendarDialogSubviewTemplate.inc.xhtml |
|
698 |
- |
| calendarDialogToggleableRowTemplate.inc.xhtml |
|
543 |
- |
| calendarEventCategoryRowTemplate.inc.xhtml |
|
1954 |
- |
| calendarEventCreateEditDescriptionSubviewTemplate.inc.xhtml |
|
522 |
- |
| calendarEventCreateEditDialogTemplate.inc.xhtml |
|
4147 |
- |
| dialog-position.mjs |
@typedef {object} dialogProperties
@property {number} height - The height of the dialog.
@property {number} width - The width of the dialog.
@property {number} margin - The margin to maintain around the dialog.
@property {"ltr"|"rtl"} [direction="ltr"] - The container's text direction.
@property {number} [triggerTopOffset=0] - The amount to place the dialog
above a target when it is displayed alongside it.
|
6661 |
- |
| dialogs |
|
|
- |
| eventDescription.html |
|
393 |
- |
| positioned-dialog.mjs |
Base class for a dialog positioned relative to a trigger and restrained by a
container. The position is determined by the logic in dialog-position.mjs.
The position and height of the dialog are constrained by the container
element.
@tagname positioned-dialog
@attribute {number} margin - See margin property.
@attribute {string} trigger-selector - See triggerSelector property.
|
6056 |
- |
| state |
|
|
- |