orrery-compose/me.kozakov.orrery.compose/DefaultDay

DefaultDay

fun DefaultDay(day: CalendarDay, modifier: Modifier = Modifier, selectionState: CalendarSelectionState? = null, today: LocalDate = currentDate(), colors: CalendarDayColors = CalendarDefaults.dayColors(), shapes: CalendarDayShapes = CalendarDefaults.dayShapes(), info: DayInfo? = null, enabled: Boolean = true, showOutDates: Boolean = true, animateSelection: Boolean = true, selectedElevation: Dp = 0.dp, hapticsEnabled: Boolean = true, decorators: List<DayDecorator> = emptyList(), strings: CalendarDayStrings = CalendarDefaults.dayStrings(), onClick: (CalendarDay) -> Unit? = null)

Batteries-included day cell: selection fill, in-range band, today indicator, optional secondary label, and stackable decorators for custom drawing (event dots, progress, markers, heatmaps).

Dates disabled via the selection state's DisabledDates render with the unavailable colors and are not clickable; enabled = false forces the same treatment. Shapes come from shapes.

A non-rectangular CalendarDayShapes.inRangeShape switches the range band to per-day segmented fills. Each half of the connector band fades in and out on its own (when animateSelection is true), so range endpoints and in-range days transition smoothly as a range grows, shrinks or is cleared.

The secondary DayInfo.label stays on one centered line and is ellipsized when it does not fit the cell, so long holiday names never wrap or shift the day number. A positive selectedElevation draws a shadow under the selected day's fill.

The container fill, selection fill, today FilledCircle and Behind decorators are clipped to CalendarDayShapes.dayShape; the range connector band, the today Ring/Underline and Over decorators (e.g. badges) draw outside that clip so they are never cropped by the cell shape.

While the cell has keyboard / D-pad focus, a ring of CalendarDayShapes.focusedBorderWidth in CalendarDayColors.focusedBorderColor outlines CalendarDayShapes.dayShape in the unclipped overlay. While a pointer hovers an available, unselected day, CalendarDayColors.hoverContainerColor fills the day shape.

Besides the date as content description, the cell reports range start / end / in range, today and unavailable as its accessibility state description, using strings.

@Composable

fun DefaultDay(day: CalendarDay, style: CalendarStyle, modifier: Modifier = Modifier, selectionState: CalendarSelectionState? = null, today: LocalDate = currentDate(), info: DayInfo? = null, enabled: Boolean = true, showOutDates: Boolean = true, animateSelection: Boolean = true, hapticsEnabled: Boolean = true, decorators: List<DayDecorator> = emptyList(), strings: CalendarDayStrings = CalendarDefaults.dayStrings(), onClick: (CalendarDay) -> Unit? = null)

DefaultDay rendered with a CalendarStyle: CalendarStyle.colors, CalendarStyle.shapes and CalendarStyle.selectedElevation replace the separate parameters of the other overload.

The cell is at least CalendarDensity.minCellHeight of CalendarStyle.density tall, and the secondary DayInfo.label is hidden when CalendarDensity.showSecondaryLabel is false. A positive CalendarStyle.cellBorderWidth outlines CalendarDayShapes.dayShape in CalendarStyle.cellBorderColor, drawn unclipped under the today marker, Over decorators and focus ring.