Skip to content

docs(datetime): add header section for parts styling #4395

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
thetaPC merged 3 commits into from
Feb 6, 2026
Merged

docs(datetime): add header section for parts styling #4395

Show file tree
Hide file tree
Changes from 1 commit
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
2cfcfe3
docs(datetime): add header section for parts styling
thetaPC Feb 4, 2026
1044281
Merge branch 'datetime-header-styles' of github.com:ionic-team/ionic-…
thetaPC Feb 4, 2026
6f5f419
docs(datetime): update to calendar header
thetaPC Feb 6, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Prev Previous commit
docs(datetime): update to calendar header
  • Loading branch information
@thetaPC
thetaPC committed Feb 6, 2026
commit 6f5f41962a18dced0799df4cbb27a589f83fc081
10 changes: 6 additions & 4 deletions docs/api/datetime.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -41,7 +41,7 @@ import ShowAdjacentDays from '@site/static/usage/v8/datetime/show-adjacent-days/
import MultipleDateSelection from '@site/static/usage/v8/datetime/multiple/index.md';

import GlobalTheming from '@site/static/usage/v8/datetime/styling/global-theming/index.md';
import HeaderStyling from '@site/static/usage/v8/datetime/styling/header/index.md';
import CalendarHeaderStyling from '@site/static/usage/v8/datetime/styling/calendar-header/index.md';
import CalendarDaysStyling from '@site/static/usage/v8/datetime/styling/calendar-days/index.md';
import WheelStyling from '@site/static/usage/v8/datetime/styling/wheel-styling/index.md';

Expand Down Expand Up @@ -353,11 +353,13 @@ The benefit of this approach is that every component, not just `ion-datetime`, c

<GlobalTheming />

### Header
### Calender Header

The header in a grid-style `ion-datetime` can be styled using CSS shadow parts.
The calendar header manages the date navigation controls (month/year picker and prev/next buttons) and the days of the week when using a grid style layout.

<HeaderStyling />
The header can be styled using CSS shadow parts.

<CalendarHeaderStyling />

### Calendar Days

Expand Down
2 changes: 1 addition & 1 deletion ...g/header/angular/example_component_css.md → ...r-header/angular/example_component_css.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
```css
/*
* Custom Datetime Header Part
* Custom Datetime Calendar Header Part
* -------------------------------------------
*/
ion-datetime::part(month-year-button) {
Expand Down
0 .../header/angular/example_component_html.md → ...-header/angular/example_component_html.md
View file
Open in desktop
File renamed without changes.
0 ...ng/header/angular/example_component_ts.md → ...ar-header/angular/example_component_ts.md
View file
Open in desktop
File renamed without changes.
2 changes: 1 addition & 1 deletion ...sage/v7/datetime/styling/header/demo.html → ...atetime/styling/calendar-header/demo.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@

<style>
/*
* Custom Datetime Header Parts
* Custom Datetime Calendar Header Parts
* -------------------------------------------
*/

Expand Down
2 changes: 1 addition & 1 deletion ...usage/v7/datetime/styling/header/index.md → ...datetime/styling/calendar-header/index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -30,6 +30,6 @@ import angular_example_component_ts from './angular/example_component_ts.md';
},
},
}}
src="usage/v7/datetime/styling/header/demo.html"
src="usage/v7/datetime/styling/calendar-header/demo.html"
size="medium"
/>
2 changes: 1 addition & 1 deletion .../v8/datetime/styling/header/javascript.md → ...ime/styling/calendar-header/javascript.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@

<style>
/*
* Custom Datetime Header Part
* Custom Datetime Calendar Header Part
* -------------------------------------------
*/
ion-datetime::part(month-year-button) {
Expand Down
2 changes: 1 addition & 1 deletion ...datetime/styling/header/react/main_css.md → ...styling/calendar-header/react/main_css.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
```css
/*
* Custom Datetime Header Part
* Custom Datetime Calendar Header Part
* -------------------------------------------
*/
ion-datetime::part(month-year-button) {
Expand Down
0 ...datetime/styling/header/react/main_tsx.md → ...styling/calendar-header/react/main_tsx.md
View file
Open in desktop
File renamed without changes.
2 changes: 1 addition & 1 deletion ...c/usage/v7/datetime/styling/header/vue.md → ...7/datetime/styling/calendar-header/vue.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@

<style scoped>
/*
* Custom Datetime Header Part
* Custom Datetime Calendar Header Part
* -------------------------------------------
*/
ion-datetime::part(month-year-button) {
Expand Down
2 changes: 1 addition & 1 deletion ...g/header/angular/example_component_css.md → ...r-header/angular/example_component_css.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
```css
/*
* Custom Datetime Header Part
* Custom Datetime Calendar Header Part
* -------------------------------------------
*/
ion-datetime::part(month-year-button) {
Expand Down
0 .../header/angular/example_component_html.md → ...-header/angular/example_component_html.md
View file
Open in desktop
File renamed without changes.
0 ...ng/header/angular/example_component_ts.md → ...ar-header/angular/example_component_ts.md
View file
Open in desktop
File renamed without changes.
2 changes: 1 addition & 1 deletion ...sage/v8/datetime/styling/header/demo.html → ...atetime/styling/calendar-header/demo.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@

<style>
/*
* Custom Datetime Header Parts
* Custom Datetime Calendar Header Parts
* -------------------------------------------
*/

Expand Down
2 changes: 1 addition & 1 deletion ...usage/v8/datetime/styling/header/index.md → ...datetime/styling/calendar-header/index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -30,6 +30,6 @@ import angular_example_component_ts from './angular/example_component_ts.md';
},
},
}}
src="usage/v8/datetime/styling/header/demo.html"
src="usage/v8/datetime/styling/calendar-header/demo.html"
size="medium"
/>
2 changes: 1 addition & 1 deletion .../v7/datetime/styling/header/javascript.md → ...ime/styling/calendar-header/javascript.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@

<style>
/*
* Custom Datetime Header Part
* Custom Datetime Calendar Header Part
* -------------------------------------------
*/
ion-datetime::part(month-year-button) {
Expand Down
2 changes: 1 addition & 1 deletion ...datetime/styling/header/react/main_css.md → ...styling/calendar-header/react/main_css.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
```css
/*
* Custom Datetime Header Part
* Custom Datetime Calendar Header Part
* -------------------------------------------
*/
ion-datetime::part(month-year-button) {
Expand Down
0 ...datetime/styling/header/react/main_tsx.md → ...styling/calendar-header/react/main_tsx.md
View file
Open in desktop
File renamed without changes.
2 changes: 1 addition & 1 deletion ...c/usage/v8/datetime/styling/header/vue.md → ...8/datetime/styling/calendar-header/vue.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@

<style scoped>
/*
* Custom Datetime Header Part
* Custom Datetime Calendar Header Part
* -------------------------------------------
*/
ion-datetime::part(month-year-button) {
Expand Down
8 changes: 4 additions & 4 deletions versioned_docs/version-v7/api/datetime.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -40,7 +40,7 @@ import HighlightedDatesCallback from '@site/static/usage/v7/datetime/highlighted
import MultipleDateSelection from '@site/static/usage/v7/datetime/multiple/index.md';

import GlobalTheming from '@site/static/usage/v7/datetime/styling/global-theming/index.md';
import HeaderStyling from '@site/static/usage/v7/datetime/styling/header/index.md';
import CalendarHeaderStyling from '@site/static/usage/v7/datetime/styling/calendar-header/index.md';
import CalendarDaysStyling from '@site/static/usage/v7/datetime/styling/calendar-days/index.md';
import WheelStyling from '@site/static/usage/v7/datetime/styling/wheel-styling/index.md';

Expand Down Expand Up @@ -342,11 +342,11 @@ The benefit of this approach is that every component, not just `ion-datetime`, c

<GlobalTheming />

### Header
### Calender Header

The header in a grid-style `ion-datetime` can be styled using CSS shadow parts.
The calendar header manages the date navigation controls (month/year picker and prev/next buttons) and the days of the week when using a grid style layout.

<HeaderStyling />
<CalendarHeaderStyling />

### Calendar Days

Expand Down