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 all commits
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
9 changes: 9 additions & 0 deletions docs/api/datetime.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -41,6 +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 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 @@ -352,6 +353,14 @@ The benefit of this approach is that every component, not just `ion-datetime`, c

<GlobalTheming />

### Calender Header

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.

The header can be styled using CSS shadow parts.

<CalendarHeaderStyling />

### Calendar Days

The calendar days in a grid-style `ion-datetime` can be styled using CSS shadow parts.
Expand Down
9 changes: 9 additions & 0 deletions static/usage/v7/datetime/styling/calendar-header/angular/example_component_css.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
```css
/*
* Custom Datetime Calendar Header Part
* -------------------------------------------
*/
ion-datetime::part(month-year-button) {
background-color: lightblue;
}
```
3 changes: 3 additions & 0 deletions static/usage/v7/datetime/styling/calendar-header/angular/example_component_html.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
```html
<ion-datetime presentation="date"></ion-datetime>
```
12 changes: 12 additions & 0 deletions static/usage/v7/datetime/styling/calendar-header/angular/example_component_ts.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,12 @@
```ts
import { Component } from '@angular/core';
import { IonDatetime } from '@ionic/angular/standalone';

@Component({
selector: 'app-example',
templateUrl: 'example.component.html',
styleUrls: ['./example.component.css'],
imports: [IonDatetime],
})
export class ExampleComponent {}
```
33 changes: 33 additions & 0 deletions static/usage/v7/datetime/styling/calendar-header/demo.html
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,33 @@
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>Datetime</title>
<link rel="stylesheet" href="../../../common.css" />
<script src="../../../common.js"></script>
<script type="module" src="https://cdn.jsdelivr.net/npm/@ionic/core@7/dist/ionic/ionic.esm.js"></script>
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@ionic/core@7/css/ionic.bundle.css" />

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

ion-datetime::part(month-year-button) {
background-color: lightblue;
}
</style>
</head>

<body>
<ion-app>
<ion-content>
<div class="container">
<ion-datetime presentation="date"></ion-datetime>
</div>
</ion-content>
</ion-app>
</body>
</html>
35 changes: 35 additions & 0 deletions static/usage/v7/datetime/styling/calendar-header/index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,35 @@
import Playground from '@site/src/components/global/Playground';

import javascript from './javascript.md';

import react_main_tsx from './react/main_tsx.md';
import react_main_css from './react/main_css.md';

import vue from './vue.md';

import angular_example_component_html from './angular/example_component_html.md';
import angular_example_component_css from './angular/example_component_css.md';
import angular_example_component_ts from './angular/example_component_ts.md';

<Playground
version="7"
code={{
javascript,
react: {
files: {
'src/main.tsx': react_main_tsx,
'src/main.css': react_main_css,
},
},
vue,
angular: {
files: {
'src/app/example.component.html': angular_example_component_html,
'src/app/example.component.css': angular_example_component_css,
'src/app/example.component.ts': angular_example_component_ts,
},
},
}}
src="usage/v7/datetime/styling/calendar-header/demo.html"
size="medium"
/>
13 changes: 13 additions & 0 deletions static/usage/v7/datetime/styling/calendar-header/javascript.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,13 @@
```html
<ion-datetime presentation="date"></ion-datetime>

<style>
/*
* Custom Datetime Calendar Header Part
* -------------------------------------------
*/
ion-datetime::part(month-year-button) {
background-color: lightblue;
}
</style>
```
9 changes: 9 additions & 0 deletions static/usage/v7/datetime/styling/calendar-header/react/main_css.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
```css
/*
* Custom Datetime Calendar Header Part
* -------------------------------------------
*/
ion-datetime::part(month-year-button) {
background-color: lightblue;
}
```
15 changes: 15 additions & 0 deletions static/usage/v7/datetime/styling/calendar-header/react/main_tsx.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,15 @@
```tsx
import React from 'react';
import { IonDatetime } from '@ionic/react';

import './main.css';

function Example() {
return (
<>
<IonDatetime presentation="date"></IonDatetime>
</>
);
}
export default Example;
```
19 changes: 19 additions & 0 deletions static/usage/v7/datetime/styling/calendar-header/vue.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,19 @@
```html
<template>
<ion-datetime presentation="date"></ion-datetime>
</template>

<script setup lang="ts">
import { IonDatetime } from '@ionic/vue';
</script>

<style scoped>
/*
* Custom Datetime Calendar Header Part
* -------------------------------------------
*/
ion-datetime::part(month-year-button) {
background-color: lightblue;
}
</style>
```
9 changes: 9 additions & 0 deletions static/usage/v8/datetime/styling/calendar-header/angular/example_component_css.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
```css
/*
* Custom Datetime Calendar Header Part
* -------------------------------------------
*/
ion-datetime::part(month-year-button) {
background-color: lightblue;
}
```
3 changes: 3 additions & 0 deletions static/usage/v8/datetime/styling/calendar-header/angular/example_component_html.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
```html
<ion-datetime presentation="date"></ion-datetime>
```
12 changes: 12 additions & 0 deletions static/usage/v8/datetime/styling/calendar-header/angular/example_component_ts.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,12 @@
```ts
import { Component } from '@angular/core';
import { IonDatetime } from '@ionic/angular/standalone';

@Component({
selector: 'app-example',
templateUrl: 'example.component.html',
styleUrls: ['./example.component.css'],
imports: [IonDatetime],
})
export class ExampleComponent {}
```
33 changes: 33 additions & 0 deletions static/usage/v8/datetime/styling/calendar-header/demo.html
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,33 @@
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>Datetime</title>
<link rel="stylesheet" href="../../../common.css" />
<script src="../../../common.js"></script>
<script type="module" src="https://cdn.jsdelivr.net/npm/@ionic/core@8/dist/ionic/ionic.esm.js"></script>
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@ionic/core@8/css/ionic.bundle.css" />

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

ion-datetime::part(month-year-button) {
background-color: lightblue;
}
</style>
</head>

<body>
<ion-app>
<ion-content>
<div class="container">
<ion-datetime presentation="date"></ion-datetime>
</div>
</ion-content>
</ion-app>
</body>
</html>
35 changes: 35 additions & 0 deletions static/usage/v8/datetime/styling/calendar-header/index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,35 @@
import Playground from '@site/src/components/global/Playground';

import javascript from './javascript.md';

import react_main_tsx from './react/main_tsx.md';
import react_main_css from './react/main_css.md';

import vue from './vue.md';

import angular_example_component_html from './angular/example_component_html.md';
import angular_example_component_css from './angular/example_component_css.md';
import angular_example_component_ts from './angular/example_component_ts.md';

<Playground
version="8"
code={{
javascript,
react: {
files: {
'src/main.tsx': react_main_tsx,
'src/main.css': react_main_css,
},
},
vue,
angular: {
files: {
'src/app/example.component.html': angular_example_component_html,
'src/app/example.component.css': angular_example_component_css,
'src/app/example.component.ts': angular_example_component_ts,
},
},
}}
src="usage/v8/datetime/styling/calendar-header/demo.html"
size="medium"
/>
13 changes: 13 additions & 0 deletions static/usage/v8/datetime/styling/calendar-header/javascript.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,13 @@
```html
<ion-datetime presentation="date"></ion-datetime>

<style>
/*
* Custom Datetime Calendar Header Part
* -------------------------------------------
*/
ion-datetime::part(month-year-button) {
background-color: lightblue;
}
</style>
```
9 changes: 9 additions & 0 deletions static/usage/v8/datetime/styling/calendar-header/react/main_css.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
```css
/*
* Custom Datetime Calendar Header Part
* -------------------------------------------
*/
ion-datetime::part(month-year-button) {
background-color: lightblue;
}
```
15 changes: 15 additions & 0 deletions static/usage/v8/datetime/styling/calendar-header/react/main_tsx.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,15 @@
```tsx
import React from 'react';
import { IonDatetime } from '@ionic/react';

import './main.css';

function Example() {
return (
<>
<IonDatetime presentation="date"></IonDatetime>
</>
);
}
export default Example;
```
19 changes: 19 additions & 0 deletions static/usage/v8/datetime/styling/calendar-header/vue.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,19 @@
```html
<template>
<ion-datetime presentation="date"></ion-datetime>
</template>

<script setup lang="ts">
import { IonDatetime } from '@ionic/vue';
</script>

<style scoped>
/*
* Custom Datetime Calendar Header Part
* -------------------------------------------
*/
ion-datetime::part(month-year-button) {
background-color: lightblue;
}
</style>
```
7 changes: 7 additions & 0 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,6 +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 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 @@ -341,6 +342,12 @@ The benefit of this approach is that every component, not just `ion-datetime`, c

<GlobalTheming />

### Calender Header

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.

<CalendarHeaderStyling />

### Calendar Days

The calendar days in a grid-style `ion-datetime` can be styled using CSS shadow parts.
Expand Down