Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
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
41 changes: 10 additions & 31 deletions core/api.txt
Original file line number Diff line number Diff line change
Expand Up @@ -1244,37 +1244,16 @@ ion-item-divider,shadow
ion-item-divider,prop,color,"danger" | "dark" | "light" | "medium" | "primary" | "secondary" | "success" | "tertiary" | "warning" | string & Record<never, never> | undefined,undefined,false,true
ion-item-divider,prop,mode,"ios" | "md",undefined,false,false
ion-item-divider,prop,sticky,boolean,false,false,false
ion-item-divider,prop,theme,"ios" | "md" | "ionic",undefined,false,false
ion-item-divider,css-prop,--background,ionic
ion-item-divider,css-prop,--background,ios
ion-item-divider,css-prop,--background,md
ion-item-divider,css-prop,--color,ionic
ion-item-divider,css-prop,--color,ios
ion-item-divider,css-prop,--color,md
ion-item-divider,css-prop,--inner-padding-bottom,ionic
ion-item-divider,css-prop,--inner-padding-bottom,ios
ion-item-divider,css-prop,--inner-padding-bottom,md
ion-item-divider,css-prop,--inner-padding-end,ionic
ion-item-divider,css-prop,--inner-padding-end,ios
ion-item-divider,css-prop,--inner-padding-end,md
ion-item-divider,css-prop,--inner-padding-start,ionic
ion-item-divider,css-prop,--inner-padding-start,ios
ion-item-divider,css-prop,--inner-padding-start,md
ion-item-divider,css-prop,--inner-padding-top,ionic
ion-item-divider,css-prop,--inner-padding-top,ios
ion-item-divider,css-prop,--inner-padding-top,md
ion-item-divider,css-prop,--padding-bottom,ionic
ion-item-divider,css-prop,--padding-bottom,ios
ion-item-divider,css-prop,--padding-bottom,md
ion-item-divider,css-prop,--padding-end,ionic
ion-item-divider,css-prop,--padding-end,ios
ion-item-divider,css-prop,--padding-end,md
ion-item-divider,css-prop,--padding-start,ionic
ion-item-divider,css-prop,--padding-start,ios
ion-item-divider,css-prop,--padding-start,md
ion-item-divider,css-prop,--padding-top,ionic
ion-item-divider,css-prop,--padding-top,ios
ion-item-divider,css-prop,--padding-top,md
ion-item-divider,css-prop,--background
ion-item-divider,css-prop,--color
ion-item-divider,css-prop,--inner-padding-bottom
ion-item-divider,css-prop,--inner-padding-end
ion-item-divider,css-prop,--inner-padding-start
ion-item-divider,css-prop,--inner-padding-top
ion-item-divider,css-prop,--padding-bottom
ion-item-divider,css-prop,--padding-end
ion-item-divider,css-prop,--padding-start
ion-item-divider,css-prop,--padding-top

ion-item-group,none
ion-item-group,prop,mode,"ios" | "md",undefined,false,false
Expand Down
8 changes: 0 additions & 8 deletions core/src/components.d.ts
Original file line number Diff line number Diff line change
Expand Up @@ -1920,10 +1920,6 @@ export namespace Components {
* @default false
*/
"sticky": boolean;
/**
* The theme determines the visual appearance of the component.
*/
"theme"?: "ios" | "md" | "ionic";
}
interface IonItemGroup {
/**
Expand Down Expand Up @@ -7918,10 +7914,6 @@ declare namespace LocalJSX {
* @default false
*/
"sticky"?: boolean;
/**
* The theme determines the visual appearance of the component.
*/
"theme"?: "ios" | "md" | "ionic";
}
interface IonItemGroup {
/**
Expand Down
201 changes: 201 additions & 0 deletions core/src/components/item-divider/item-divider.interfaces.ts
Original file line number Diff line number Diff line change
@@ -0,0 +1,201 @@
import type { IonPadding, IonMargin } from '../../themes/themes.interfaces';

export type IonItemDividerRecipe = {
background?: string;
color?: string;
minHeight?: string;

padding?: IonPadding;

inner?: {
padding?: IonPadding;
};

border?: {
bottom?: string;
};

font?: {
size?: string;
weight?: string;
};

leading?: {
// Targets `:host([slot="start"])`
anchor?: {
margin?: IonMargin;
};

// Targets `::slotted([slot="start"])`
edge?: {
margin?: IonMargin;
};
};

trailing?: {
// Targets `::slotted([slot="end"])`
edge?: {
margin?: IonMargin;
};
};
Comment on lines +23 to +40
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Naming Convention: Anchors & Edges

To maintain consistency with the Ionic Modular architecture established in ion-chip, this component adopts a shared spatial vocabulary. While chips use DOM order (:first-child), dividers use named slots (slot="start/end"). The following naming convention bridges that gap:

  • Anchors (:host): Refers to the component's own placement within a parent container.
    • leading-anchor: Targets :host([slot="start"]).
    • trailing-anchor: Targets :host([slot="end"]).
  • Edges (::slotted): Refers to content placed at the boundaries of the component itself.
    • leading-edge: Targets ::slotted([slot="start"]).
    • trailing-edge: Targets ::slotted([slot="end"]).

Why this matters:
This mirrors the leading (:first-child) and trailing (:last-child) pattern used in chips. By using leading/trailing instead of left/right or start/end, we create a less confusing structure that developers can use with ease.


label?: {
margin?: IonMargin;
};

icon?: {
font?: {
size?: string;
};

leading?: {
// Targets `::slotted([slot="start"])`
edge?: {
margin?: IonMargin;
};
};

trailing?: {
// Targets `::slotted([slot="end"])`
edge?: {
margin?: IonMargin;
};
};

// Default non-semantic states
default?: {
color?: string;
};

// Any of the semantic colors like primary, secondary, etc.
semantic?: {
default?: {
color?: string;
};
};
Comment on lines +66 to +75
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This follows the same structure established in chip when it came to default vs semantic colors.

};

note?: {
align?: {
self?: string;
};

font?: {
size?: string;
};

margin?: IonMargin;
padding?: IonPadding;
};

avatar?: {
height?: string;
width?: string;

margin?: IonMargin;

leading?: {
// Targets `::slotted([slot="start"])`
edge?: {
margin?: IonMargin;
};
};

trailing?: {
// Targets `::slotted([slot="end"])`
edge?: {
margin?: IonMargin;
};
};
};

thumbnail?: {
height?: string;
width?: string;

margin?: IonMargin;

leading?: {
// Targets `::slotted([slot="start"])`
edge?: {
margin?: IonMargin;
};
};

trailing?: {
// Targets `::slotted([slot="end"])`
edge?: {
margin?: IonMargin;
};
};
};

header1?: {
margin?: IonMargin;
};

header2?: {
margin?: IonMargin;

// Targets `:last-child`
trailing?: {
margin?: IonMargin;
};
};

header3?: {
margin?: IonMargin;

// Targets `:last-child`
trailing?: {
margin?: IonMargin;
};
};

header4?: {
margin?: IonMargin;

// Targets `:last-child`
trailing?: {
margin?: IonMargin;
};
};

header5?: {
margin?: IonMargin;

// Targets `:last-child`
trailing?: {
margin?: IonMargin;
};
};

header6?: {
margin?: IonMargin;

// Targets `:last-child`
trailing?: {
margin?: IonMargin;
};
};

paragraph?: {
color?: string;
overflow?: string;

margin?: IonMargin;

font?: {
size?: string;
};

text?: {
overflow?: string;
};

// Targets `:last-child`
trailing?: {
margin?: IonMargin;
};
};
};
98 changes: 0 additions & 98 deletions core/src/components/item-divider/item-divider.ios.scss

This file was deleted.

26 changes: 0 additions & 26 deletions core/src/components/item-divider/item-divider.ios.vars.scss

This file was deleted.

Loading
Loading