dasar-ui 1.5.0 → 1.9.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +53 -0
- package/README.md +40 -34
- package/docs/_config.yml +3 -0
- package/docs/getting-started.md +89 -0
- package/docs/index.md +9 -0
- package/docs/installation.md +46 -0
- package/package.json +7 -6
- package/projects/dasar-ui/package.json +1 -1
- package/projects/dasar-ui/src/lib/components/dasar-modal/dasar-modal.ts +2 -2
- package/projects/dasar-ui/src/lib/components/dasar-overlay/dasar-overlay.spec.ts +8 -0
- package/projects/dasar-ui/src/lib/components/dasar-overlay/dasar-overlay.ts +2 -2
- package/projects/dasar-ui/src/lib/components/dasar-theme-provider/dasar-theme-provider.spec.ts +89 -0
- package/projects/dasar-ui/src/lib/components/dasar-theme-provider/dasar-theme-provider.ts +23 -0
- package/projects/dasar-ui/src/lib/models/theme.model.ts +64 -0
- package/projects/dasar-ui/src/lib/services/theme.service.spec.ts +65 -0
- package/projects/dasar-ui/src/lib/services/theme.service.ts +70 -0
- package/projects/dasar-ui/src/public-api.ts +1 -0
- package/projects/documentation/src/app/app.html +33 -6
- package/projects/documentation/src/app/app.ts +36 -2
- package/projects/documentation/src/app/components/doc-customize-modal.component.ts +56 -2
- package/projects/documentation/src/app/components/doc-markdown.component.ts +154 -0
- package/projects/documentation/src/app/layouts/doc.layout.ts +23 -3
- package/projects/documentation/src/app/pages/button/button.page.html +1 -1
- package/projects/documentation/src/app/pages/chip/chip.page.html +1 -1
- package/projects/documentation/src/app/pages/getting-started/getting-started.page.ts +21 -0
- package/projects/documentation/src/app/pages/icon/icon.page.html +1 -1
- package/projects/documentation/src/app/pages/installation/installation.page.ts +18 -0
- package/projects/documentation/src/app/pages/introduction/introduction.page.ts +18 -0
- package/projects/documentation/src/app/pages/list/examples/advanced-dynamic/list-advanced-dynamic.example.html +29 -0
- package/projects/documentation/src/app/pages/list/examples/advanced-dynamic/list-advanced-dynamic.example.ts +33 -0
- package/projects/documentation/src/app/pages/list/examples/advanced-theme/list-advanced-theme.example.html +13 -0
- package/projects/documentation/src/app/pages/list/examples/advanced-theme/list-advanced-theme.example.ts +30 -0
- package/projects/documentation/src/app/pages/list/examples/basic/list-basic.example.html +5 -0
- package/projects/documentation/src/app/pages/list/examples/basic/list-basic.example.ts +12 -0
- package/projects/documentation/src/app/pages/list/examples/bordered-divider/list-bordered-divider.example.html +20 -0
- package/projects/documentation/src/app/pages/list/examples/bordered-divider/list-bordered-divider.example.ts +12 -0
- package/projects/documentation/src/app/pages/list/examples/custom-style/list-custom-style.example.html +11 -0
- package/projects/documentation/src/app/pages/list/examples/custom-style/list-custom-style.example.ts +19 -0
- package/projects/documentation/src/app/pages/list/examples/header-footer/list-header-footer.example.html +7 -0
- package/projects/documentation/src/app/pages/list/examples/header-footer/list-header-footer.example.ts +12 -0
- package/projects/documentation/src/app/pages/list/examples/interactive/list-interactive.example.html +20 -0
- package/projects/documentation/src/app/pages/list/examples/interactive/list-interactive.example.ts +22 -0
- package/projects/documentation/src/app/pages/list/examples/prefix-suffix/list-prefix-suffix.example.html +9 -0
- package/projects/documentation/src/app/pages/list/examples/prefix-suffix/list-prefix-suffix.example.ts +16 -0
- package/projects/documentation/src/app/pages/list/examples/size/list-size.example.html +20 -0
- package/projects/documentation/src/app/pages/list/examples/size/list-size.example.ts +12 -0
- package/projects/documentation/src/app/pages/list/list.page.html +95 -0
- package/projects/documentation/src/app/pages/list/list.page.ts +238 -0
- package/projects/documentation/src/app/pages/modal/modal.page.ts +15 -6
- package/projects/documentation/src/app/pages/table/table.page.html +1 -1
- package/projects/documentation/src/app/pages/tabs/tabs.page.ts +7 -0
- package/projects/documentation/src/app/pages/theming/examples/component-config/theming-component-config.example.html +13 -0
- package/projects/documentation/src/app/pages/theming/examples/component-config/theming-component-config.example.ts +20 -0
- package/projects/documentation/src/app/pages/theming/examples/css-override/theming-css-override.example.html +8 -0
- package/projects/documentation/src/app/pages/theming/examples/css-override/theming-css-override.example.scss +4 -0
- package/projects/documentation/src/app/pages/theming/examples/css-override/theming-css-override.example.ts +11 -0
- package/projects/documentation/src/app/pages/theming/examples/custom-tokens/theming-custom-tokens.example.html +13 -0
- package/projects/documentation/src/app/pages/theming/examples/custom-tokens/theming-custom-tokens.example.ts +33 -0
- package/projects/documentation/src/app/pages/theming/examples/global-theme/theming-global-theme.example.html +6 -0
- package/projects/documentation/src/app/pages/theming/examples/global-theme/theming-global-theme.example.ts +20 -0
- package/projects/documentation/src/app/pages/theming/examples/light-dark/theming-light-dark.example.html +15 -0
- package/projects/documentation/src/app/pages/theming/examples/light-dark/theming-light-dark.example.ts +31 -0
- package/projects/documentation/src/app/pages/theming/theming-component-config.page.ts +52 -0
- package/projects/documentation/src/app/pages/theming/theming-css-variables.page.ts +71 -0
- package/projects/documentation/src/app/pages/theming/theming-tokens.page.ts +56 -0
- package/projects/documentation/src/app/pages/theming/theming.data.ts +947 -0
- package/projects/documentation/src/app/pages/theming/theming.page.html +56 -0
- package/projects/documentation/src/app/pages/theming/theming.page.ts +144 -0
- package/projects/documentation/src/app/routes/app.routes.ts +63 -15
- package/projects/documentation/src/app/services/doc-customize.service.ts +12 -0
- package/projects/documentation/src/styles.scss +12 -0
|
@@ -0,0 +1,29 @@
|
|
|
1
|
+
<dasar-list clickable hoverable bordered show-divider>
|
|
2
|
+
@if (tasks().length > 0) {
|
|
3
|
+
@for (task of tasks(); track task.id) {
|
|
4
|
+
<dasar-list-item (click)="addTask()">
|
|
5
|
+
<dasar-icon prefix-slot name="list" size="sm" />
|
|
6
|
+
<div class="dasar-list-item-body">
|
|
7
|
+
<span>{{ task.title }}</span>
|
|
8
|
+
<span style="font-size: 12px; color: gray">{{ task.owner }}</span>
|
|
9
|
+
</div>
|
|
10
|
+
<dasar-button
|
|
11
|
+
suffix-slot
|
|
12
|
+
size="xs"
|
|
13
|
+
variant="ghost"
|
|
14
|
+
appearance="subtle"
|
|
15
|
+
(click)="removeTask(task.id, $event)"
|
|
16
|
+
aria-label="Remove task"
|
|
17
|
+
>
|
|
18
|
+
<dasar-icon name="trash" size="sm" />
|
|
19
|
+
</dasar-button>
|
|
20
|
+
</dasar-list-item>
|
|
21
|
+
}
|
|
22
|
+
} @else {
|
|
23
|
+
<dasar-list-item>No tasks yet. Click anywhere to add one.</dasar-list-item>
|
|
24
|
+
}
|
|
25
|
+
</dasar-list>
|
|
26
|
+
|
|
27
|
+
<p style="font-size: 12px; margin-top: 8px; color: gray">
|
|
28
|
+
Clicking a row adds a task. The remove button stops the event from bubbling to the row.
|
|
29
|
+
</p>
|
|
@@ -0,0 +1,33 @@
|
|
|
1
|
+
import { Component, signal } from '@angular/core';
|
|
2
|
+
import { DasarButtonComponent, DasarIconComponent, DasarListComponent } from 'dasar-ui';
|
|
3
|
+
|
|
4
|
+
interface DocTask {
|
|
5
|
+
id: number;
|
|
6
|
+
title: string;
|
|
7
|
+
owner: string;
|
|
8
|
+
}
|
|
9
|
+
|
|
10
|
+
@Component({
|
|
11
|
+
templateUrl: './list-advanced-dynamic.example.html',
|
|
12
|
+
selector: 'app-list-advanced-dynamic-example',
|
|
13
|
+
imports: [DasarIconComponent, DasarButtonComponent, DasarListComponent],
|
|
14
|
+
standalone: true,
|
|
15
|
+
})
|
|
16
|
+
export class ListAdvancedDynamicExample {
|
|
17
|
+
private nextId = 3;
|
|
18
|
+
|
|
19
|
+
protected tasks = signal<DocTask[]>([
|
|
20
|
+
{ id: 1, title: 'Draft the API contract', owner: 'Ada' },
|
|
21
|
+
{ id: 2, title: 'Review the token names', owner: 'Grace' },
|
|
22
|
+
]);
|
|
23
|
+
|
|
24
|
+
addTask() {
|
|
25
|
+
const id = this.nextId++;
|
|
26
|
+
this.tasks.update((current) => [...current, { id, title: `Task #${id}`, owner: 'Unassigned' }]);
|
|
27
|
+
}
|
|
28
|
+
|
|
29
|
+
removeTask(id: number, event: MouseEvent) {
|
|
30
|
+
event.stopPropagation();
|
|
31
|
+
this.tasks.update((current) => current.filter((task) => task.id !== id));
|
|
32
|
+
}
|
|
33
|
+
}
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
<dasar-theme-provider [componentConfig]="componentConfig" [tokenConfig]="tokenConfig">
|
|
2
|
+
<dasar-list>
|
|
3
|
+
<div header-slot>From the theme provider</div>
|
|
4
|
+
@for (item of items; track item) {
|
|
5
|
+
<dasar-list-item>{{ item }}</dasar-list-item>
|
|
6
|
+
}
|
|
7
|
+
</dasar-list>
|
|
8
|
+
</dasar-theme-provider>
|
|
9
|
+
|
|
10
|
+
<p style="font-size: 12px; margin-top: 8px; color: gray">
|
|
11
|
+
components.list sets size, bordered and show-divider. tokens.light.list sets the radius and the
|
|
12
|
+
header background.
|
|
13
|
+
</p>
|
|
@@ -0,0 +1,30 @@
|
|
|
1
|
+
import { Component } from '@angular/core';
|
|
2
|
+
import {
|
|
3
|
+
DasarComponentConfig,
|
|
4
|
+
DasarThemeProviderComponent,
|
|
5
|
+
DasarThemeConfig,
|
|
6
|
+
DasarListComponent,
|
|
7
|
+
} from 'dasar-ui';
|
|
8
|
+
|
|
9
|
+
@Component({
|
|
10
|
+
templateUrl: './list-advanced-theme.example.html',
|
|
11
|
+
selector: 'app-list-advanced-theme-example',
|
|
12
|
+
imports: [DasarThemeProviderComponent, DasarListComponent],
|
|
13
|
+
standalone: true,
|
|
14
|
+
})
|
|
15
|
+
export class ListAdvancedThemeExample {
|
|
16
|
+
protected items = ['Design', 'Engineering', 'Product'];
|
|
17
|
+
|
|
18
|
+
protected componentConfig: DasarComponentConfig = {
|
|
19
|
+
list: { size: 'sm', bordered: true, showDivider: true },
|
|
20
|
+
};
|
|
21
|
+
|
|
22
|
+
protected tokenConfig: DasarThemeConfig['tokens'] = {
|
|
23
|
+
light: {
|
|
24
|
+
list: {
|
|
25
|
+
radius: '12px',
|
|
26
|
+
headerBackground: 'var(--theme-primary-surface-color)',
|
|
27
|
+
},
|
|
28
|
+
},
|
|
29
|
+
};
|
|
30
|
+
}
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
import { Component } from '@angular/core';
|
|
2
|
+
import { DasarListComponent } from 'dasar-ui';
|
|
3
|
+
|
|
4
|
+
@Component({
|
|
5
|
+
templateUrl: './list-basic.example.html',
|
|
6
|
+
selector: 'app-list-basic-example',
|
|
7
|
+
imports: [DasarListComponent],
|
|
8
|
+
standalone: true,
|
|
9
|
+
})
|
|
10
|
+
export class ListBasicExample {
|
|
11
|
+
protected members = ['Ada Lovelace', 'Grace Hopper', 'Katherine Johnson'];
|
|
12
|
+
}
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
<p style="font-size: 12px; margin: 8px 0 4px; color: gray">bordered</p>
|
|
2
|
+
<dasar-list bordered>
|
|
3
|
+
@for (item of items; track item) {
|
|
4
|
+
<dasar-list-item>{{ item }}</dasar-list-item>
|
|
5
|
+
}
|
|
6
|
+
</dasar-list>
|
|
7
|
+
|
|
8
|
+
<p style="font-size: 12px; margin: 8px 0 4px; color: gray">show-divider</p>
|
|
9
|
+
<dasar-list show-divider>
|
|
10
|
+
@for (item of items; track item) {
|
|
11
|
+
<dasar-list-item>{{ item }}</dasar-list-item>
|
|
12
|
+
}
|
|
13
|
+
</dasar-list>
|
|
14
|
+
|
|
15
|
+
<p style="font-size: 12px; margin: 8px 0 4px; color: gray">bordered + show-divider</p>
|
|
16
|
+
<dasar-list bordered show-divider>
|
|
17
|
+
@for (item of items; track item) {
|
|
18
|
+
<dasar-list-item>{{ item }}</dasar-list-item>
|
|
19
|
+
}
|
|
20
|
+
</dasar-list>
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
import { Component } from '@angular/core';
|
|
2
|
+
import { DasarListComponent } from 'dasar-ui';
|
|
3
|
+
|
|
4
|
+
@Component({
|
|
5
|
+
templateUrl: './list-bordered-divider.example.html',
|
|
6
|
+
selector: 'app-list-bordered-divider-example',
|
|
7
|
+
imports: [DasarListComponent],
|
|
8
|
+
standalone: true,
|
|
9
|
+
})
|
|
10
|
+
export class ListBorderedDividerExample {
|
|
11
|
+
protected items = ['Design system', 'Component library', 'Documentation'];
|
|
12
|
+
}
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
<dasar-list bordered show-divider container-class="my-list" [container-style]="containerStyle">
|
|
2
|
+
@for (item of items; track item; let i = $index) {
|
|
3
|
+
<dasar-list-item [item-style]="i === 1 ? highlightStyle : null">
|
|
4
|
+
<span class="my-list-label">{{ item }}</span>
|
|
5
|
+
</dasar-list-item>
|
|
6
|
+
}
|
|
7
|
+
</dasar-list>
|
|
8
|
+
|
|
9
|
+
<p style="font-size: 12px; margin-top: 8px; color: gray">
|
|
10
|
+
container-style caps the width at 320px, and the second row uses item-style for a highlight.
|
|
11
|
+
</p>
|
package/projects/documentation/src/app/pages/list/examples/custom-style/list-custom-style.example.ts
ADDED
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
import { Component } from '@angular/core';
|
|
2
|
+
import { DasarListComponent } from 'dasar-ui';
|
|
3
|
+
|
|
4
|
+
@Component({
|
|
5
|
+
templateUrl: './list-custom-style.example.html',
|
|
6
|
+
selector: 'app-list-custom-style-example',
|
|
7
|
+
imports: [DasarListComponent],
|
|
8
|
+
standalone: true,
|
|
9
|
+
})
|
|
10
|
+
export class ListCustomStyleExample {
|
|
11
|
+
protected items = ['Overview', 'Activity', 'Settings'];
|
|
12
|
+
|
|
13
|
+
protected containerStyle = { 'max-width': '320px' };
|
|
14
|
+
|
|
15
|
+
protected highlightStyle = {
|
|
16
|
+
'background-color': 'var(--theme-primary-surface-color)',
|
|
17
|
+
'font-weight': '600',
|
|
18
|
+
};
|
|
19
|
+
}
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
import { Component } from '@angular/core';
|
|
2
|
+
import { DasarListComponent } from 'dasar-ui';
|
|
3
|
+
|
|
4
|
+
@Component({
|
|
5
|
+
templateUrl: './list-header-footer.example.html',
|
|
6
|
+
selector: 'app-list-header-footer-example',
|
|
7
|
+
imports: [DasarListComponent],
|
|
8
|
+
standalone: true,
|
|
9
|
+
})
|
|
10
|
+
export class ListHeaderFooterExample {
|
|
11
|
+
protected members = ['Ada Lovelace', 'Grace Hopper', 'Katherine Johnson'];
|
|
12
|
+
}
|
package/projects/documentation/src/app/pages/list/examples/interactive/list-interactive.example.html
ADDED
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
<dasar-list clickable hoverable bordered>
|
|
2
|
+
@for (item of items; track item.id) {
|
|
3
|
+
<dasar-list-item
|
|
4
|
+
(click)="select(item.id)"
|
|
5
|
+
[item-style]="{
|
|
6
|
+
'background-color': selected() === item.id ? 'var(--theme-primary-surface-color)' : '',
|
|
7
|
+
'font-weight': selected() === item.id ? '600' : '',
|
|
8
|
+
}"
|
|
9
|
+
>
|
|
10
|
+
<div class="dasar-list-item-body">
|
|
11
|
+
<span>{{ item.name }}</span>
|
|
12
|
+
<span style="font-size: 12px; color: gray">{{ item.role }}</span>
|
|
13
|
+
</div>
|
|
14
|
+
</dasar-list-item>
|
|
15
|
+
}
|
|
16
|
+
</dasar-list>
|
|
17
|
+
|
|
18
|
+
<p style="font-size: 12px; margin-top: 8px; color: gray">
|
|
19
|
+
Selected: {{ selected() ?? 'none' }}. Click the row again to clear it.
|
|
20
|
+
</p>
|
package/projects/documentation/src/app/pages/list/examples/interactive/list-interactive.example.ts
ADDED
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
import { Component, signal } from '@angular/core';
|
|
2
|
+
import { DasarListComponent } from 'dasar-ui';
|
|
3
|
+
|
|
4
|
+
@Component({
|
|
5
|
+
templateUrl: './list-interactive.example.html',
|
|
6
|
+
selector: 'app-list-interactive-example',
|
|
7
|
+
imports: [DasarListComponent],
|
|
8
|
+
standalone: true,
|
|
9
|
+
})
|
|
10
|
+
export class ListInteractiveExample {
|
|
11
|
+
protected items = [
|
|
12
|
+
{ id: 'ada', name: 'Ada Lovelace', role: 'Analyst' },
|
|
13
|
+
{ id: 'grace', name: 'Grace Hopper', role: 'Engineer' },
|
|
14
|
+
{ id: 'katherine', name: 'Katherine Johnson', role: 'Mathematician' },
|
|
15
|
+
];
|
|
16
|
+
|
|
17
|
+
protected selected = signal<string | null>(null);
|
|
18
|
+
|
|
19
|
+
protected select(id: string) {
|
|
20
|
+
this.selected.set(this.selected() === id ? null : id);
|
|
21
|
+
}
|
|
22
|
+
}
|
|
@@ -0,0 +1,9 @@
|
|
|
1
|
+
<dasar-list bordered show-divider hoverable>
|
|
2
|
+
@for (item of items; track item.name) {
|
|
3
|
+
<dasar-list-item>
|
|
4
|
+
<dasar-icon prefix-slot name="user" size="sm" />
|
|
5
|
+
{{ item.name }}
|
|
6
|
+
<dasar-chip suffix-slot size="xs" variant="secondary">{{ item.role }}</dasar-chip>
|
|
7
|
+
</dasar-list-item>
|
|
8
|
+
}
|
|
9
|
+
</dasar-list>
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
import { Component } from '@angular/core';
|
|
2
|
+
import { DasarChipComponent, DasarIconComponent, DasarListComponent } from 'dasar-ui';
|
|
3
|
+
|
|
4
|
+
@Component({
|
|
5
|
+
templateUrl: './list-prefix-suffix.example.html',
|
|
6
|
+
selector: 'app-list-prefix-suffix-example',
|
|
7
|
+
imports: [DasarIconComponent, DasarChipComponent, DasarListComponent],
|
|
8
|
+
standalone: true,
|
|
9
|
+
})
|
|
10
|
+
export class ListPrefixSuffixExample {
|
|
11
|
+
protected items = [
|
|
12
|
+
{ name: 'Ada Lovelace', role: 'Admin' },
|
|
13
|
+
{ name: 'Grace Hopper', role: 'Editor' },
|
|
14
|
+
{ name: 'Katherine Johnson', role: 'Viewer' },
|
|
15
|
+
];
|
|
16
|
+
}
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
<p style="font-size: 12px; margin: 8px 0 4px; color: gray">sm</p>
|
|
2
|
+
<dasar-list size="sm">
|
|
3
|
+
@for (item of items; track item) {
|
|
4
|
+
<dasar-list-item>{{ item }}</dasar-list-item>
|
|
5
|
+
}
|
|
6
|
+
</dasar-list>
|
|
7
|
+
|
|
8
|
+
<p style="font-size: 12px; margin: 8px 0 4px; color: gray">md</p>
|
|
9
|
+
<dasar-list size="md">
|
|
10
|
+
@for (item of items; track item) {
|
|
11
|
+
<dasar-list-item>{{ item }}</dasar-list-item>
|
|
12
|
+
}
|
|
13
|
+
</dasar-list>
|
|
14
|
+
|
|
15
|
+
<p style="font-size: 12px; margin: 8px 0 4px; color: gray">lg</p>
|
|
16
|
+
<dasar-list size="lg">
|
|
17
|
+
@for (item of items; track item) {
|
|
18
|
+
<dasar-list-item>{{ item }}</dasar-list-item>
|
|
19
|
+
}
|
|
20
|
+
</dasar-list>
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
import { Component } from '@angular/core';
|
|
2
|
+
import { DasarListComponent } from 'dasar-ui';
|
|
3
|
+
|
|
4
|
+
@Component({
|
|
5
|
+
templateUrl: './list-size.example.html',
|
|
6
|
+
selector: 'app-list-size-example',
|
|
7
|
+
imports: [DasarListComponent],
|
|
8
|
+
standalone: true,
|
|
9
|
+
})
|
|
10
|
+
export class ListSizeExample {
|
|
11
|
+
protected items = ['Inbox', 'Sent', 'Drafts'];
|
|
12
|
+
}
|
|
@@ -0,0 +1,95 @@
|
|
|
1
|
+
<docs-layout
|
|
2
|
+
title="List"
|
|
3
|
+
description="A vertical list of items with an optional header, footer, prefix and suffix, plus dividers, borders and hover or click states."
|
|
4
|
+
[apiData]="apiProps"
|
|
5
|
+
>
|
|
6
|
+
<doc-example-component
|
|
7
|
+
[codes]="[
|
|
8
|
+
{ label: 'HTML', lang: 'html', value: basicHtml },
|
|
9
|
+
{ label: 'TypeScript', lang: 'typescript', value: basicTs },
|
|
10
|
+
]"
|
|
11
|
+
title="Basic"
|
|
12
|
+
>
|
|
13
|
+
<app-list-basic-example />
|
|
14
|
+
</doc-example-component>
|
|
15
|
+
|
|
16
|
+
<doc-example-component
|
|
17
|
+
[codes]="[
|
|
18
|
+
{ label: 'HTML', lang: 'html', value: sizeHtml },
|
|
19
|
+
{ label: 'TypeScript', lang: 'typescript', value: sizeTs },
|
|
20
|
+
]"
|
|
21
|
+
title="Size"
|
|
22
|
+
>
|
|
23
|
+
<app-list-size-example />
|
|
24
|
+
</doc-example-component>
|
|
25
|
+
|
|
26
|
+
<doc-example-component
|
|
27
|
+
[codes]="[
|
|
28
|
+
{ label: 'HTML', lang: 'html', value: borderedDividerHtml },
|
|
29
|
+
{ label: 'TypeScript', lang: 'typescript', value: borderedDividerTs },
|
|
30
|
+
]"
|
|
31
|
+
title="Bordered & Divider"
|
|
32
|
+
>
|
|
33
|
+
<app-list-bordered-divider-example />
|
|
34
|
+
</doc-example-component>
|
|
35
|
+
|
|
36
|
+
<doc-example-component
|
|
37
|
+
[codes]="[
|
|
38
|
+
{ label: 'HTML', lang: 'html', value: interactiveHtml },
|
|
39
|
+
{ label: 'TypeScript', lang: 'typescript', value: interactiveTs },
|
|
40
|
+
]"
|
|
41
|
+
title="Interactive"
|
|
42
|
+
>
|
|
43
|
+
<app-list-interactive-example />
|
|
44
|
+
</doc-example-component>
|
|
45
|
+
|
|
46
|
+
<doc-example-component
|
|
47
|
+
[codes]="[
|
|
48
|
+
{ label: 'HTML', lang: 'html', value: headerFooterHtml },
|
|
49
|
+
{ label: 'TypeScript', lang: 'typescript', value: headerFooterTs },
|
|
50
|
+
]"
|
|
51
|
+
title="Header & Footer"
|
|
52
|
+
>
|
|
53
|
+
<app-list-header-footer-example />
|
|
54
|
+
</doc-example-component>
|
|
55
|
+
|
|
56
|
+
<doc-example-component
|
|
57
|
+
[codes]="[
|
|
58
|
+
{ label: 'HTML', lang: 'html', value: prefixSuffixHtml },
|
|
59
|
+
{ label: 'TypeScript', lang: 'typescript', value: prefixSuffixTs },
|
|
60
|
+
]"
|
|
61
|
+
title="Prefix & Suffix"
|
|
62
|
+
>
|
|
63
|
+
<app-list-prefix-suffix-example />
|
|
64
|
+
</doc-example-component>
|
|
65
|
+
|
|
66
|
+
<doc-example-component
|
|
67
|
+
[codes]="[
|
|
68
|
+
{ label: 'HTML', lang: 'html', value: customStyleHtml },
|
|
69
|
+
{ label: 'TypeScript', lang: 'typescript', value: customStyleTs },
|
|
70
|
+
]"
|
|
71
|
+
title="Custom Style"
|
|
72
|
+
>
|
|
73
|
+
<app-list-custom-style-example />
|
|
74
|
+
</doc-example-component>
|
|
75
|
+
|
|
76
|
+
<doc-example-component
|
|
77
|
+
[codes]="[
|
|
78
|
+
{ label: 'HTML', lang: 'html', value: advancedDynamicHtml },
|
|
79
|
+
{ label: 'TypeScript', lang: 'typescript', value: advancedDynamicTs },
|
|
80
|
+
]"
|
|
81
|
+
title="Advanced: Dynamic List"
|
|
82
|
+
>
|
|
83
|
+
<app-list-advanced-dynamic-example />
|
|
84
|
+
</doc-example-component>
|
|
85
|
+
|
|
86
|
+
<doc-example-component
|
|
87
|
+
[codes]="[
|
|
88
|
+
{ label: 'HTML', lang: 'html', value: advancedThemeHtml },
|
|
89
|
+
{ label: 'TypeScript', lang: 'typescript', value: advancedThemeTs },
|
|
90
|
+
]"
|
|
91
|
+
title="Advanced: Theme Defaults"
|
|
92
|
+
>
|
|
93
|
+
<app-list-advanced-theme-example />
|
|
94
|
+
</doc-example-component>
|
|
95
|
+
</docs-layout>
|
|
@@ -0,0 +1,238 @@
|
|
|
1
|
+
import { Component } from '@angular/core';
|
|
2
|
+
import { CommonModule } from '@angular/common';
|
|
3
|
+
import { DocsLayoutComponent, DocApiProperty } from '../../layouts/doc.layout';
|
|
4
|
+
import { DocExampleComponent } from '../../components/doc-example.component';
|
|
5
|
+
|
|
6
|
+
import { ListBasicExample } from './examples/basic/list-basic.example';
|
|
7
|
+
import { ListSizeExample } from './examples/size/list-size.example';
|
|
8
|
+
import { ListBorderedDividerExample } from './examples/bordered-divider/list-bordered-divider.example';
|
|
9
|
+
import { ListInteractiveExample } from './examples/interactive/list-interactive.example';
|
|
10
|
+
import { ListHeaderFooterExample } from './examples/header-footer/list-header-footer.example';
|
|
11
|
+
import { ListPrefixSuffixExample } from './examples/prefix-suffix/list-prefix-suffix.example';
|
|
12
|
+
import { ListCustomStyleExample } from './examples/custom-style/list-custom-style.example';
|
|
13
|
+
import { ListAdvancedDynamicExample } from './examples/advanced-dynamic/list-advanced-dynamic.example';
|
|
14
|
+
import { ListAdvancedThemeExample } from './examples/advanced-theme/list-advanced-theme.example';
|
|
15
|
+
|
|
16
|
+
// @ts-ignore
|
|
17
|
+
import basicHtml from './examples/basic/list-basic.example.html' with { loader: 'text' };
|
|
18
|
+
// @ts-ignore
|
|
19
|
+
import basicTs from './examples/basic/list-basic.example.ts' with { loader: 'text' };
|
|
20
|
+
|
|
21
|
+
// @ts-ignore
|
|
22
|
+
import sizeHtml from './examples/size/list-size.example.html' with { loader: 'text' };
|
|
23
|
+
// @ts-ignore
|
|
24
|
+
import sizeTs from './examples/size/list-size.example.ts' with { loader: 'text' };
|
|
25
|
+
|
|
26
|
+
// @ts-ignore
|
|
27
|
+
import borderedDividerHtml from './examples/bordered-divider/list-bordered-divider.example.html' with {
|
|
28
|
+
loader: 'text',
|
|
29
|
+
};
|
|
30
|
+
// @ts-ignore
|
|
31
|
+
import borderedDividerTs from './examples/bordered-divider/list-bordered-divider.example.ts' with {
|
|
32
|
+
loader: 'text',
|
|
33
|
+
};
|
|
34
|
+
|
|
35
|
+
// @ts-ignore
|
|
36
|
+
import interactiveHtml from './examples/interactive/list-interactive.example.html' with {
|
|
37
|
+
loader: 'text',
|
|
38
|
+
};
|
|
39
|
+
// @ts-ignore
|
|
40
|
+
import interactiveTs from './examples/interactive/list-interactive.example.ts' with {
|
|
41
|
+
loader: 'text',
|
|
42
|
+
};
|
|
43
|
+
|
|
44
|
+
// @ts-ignore
|
|
45
|
+
import headerFooterHtml from './examples/header-footer/list-header-footer.example.html' with {
|
|
46
|
+
loader: 'text',
|
|
47
|
+
};
|
|
48
|
+
// @ts-ignore
|
|
49
|
+
import headerFooterTs from './examples/header-footer/list-header-footer.example.ts' with {
|
|
50
|
+
loader: 'text',
|
|
51
|
+
};
|
|
52
|
+
|
|
53
|
+
// @ts-ignore
|
|
54
|
+
import prefixSuffixHtml from './examples/prefix-suffix/list-prefix-suffix.example.html' with {
|
|
55
|
+
loader: 'text',
|
|
56
|
+
};
|
|
57
|
+
// @ts-ignore
|
|
58
|
+
import prefixSuffixTs from './examples/prefix-suffix/list-prefix-suffix.example.ts' with {
|
|
59
|
+
loader: 'text',
|
|
60
|
+
};
|
|
61
|
+
|
|
62
|
+
// @ts-ignore
|
|
63
|
+
import customStyleHtml from './examples/custom-style/list-custom-style.example.html' with {
|
|
64
|
+
loader: 'text',
|
|
65
|
+
};
|
|
66
|
+
// @ts-ignore
|
|
67
|
+
import customStyleTs from './examples/custom-style/list-custom-style.example.ts' with {
|
|
68
|
+
loader: 'text',
|
|
69
|
+
};
|
|
70
|
+
|
|
71
|
+
// @ts-ignore
|
|
72
|
+
import advancedDynamicHtml from './examples/advanced-dynamic/list-advanced-dynamic.example.html' with {
|
|
73
|
+
loader: 'text',
|
|
74
|
+
};
|
|
75
|
+
// @ts-ignore
|
|
76
|
+
import advancedDynamicTs from './examples/advanced-dynamic/list-advanced-dynamic.example.ts' with {
|
|
77
|
+
loader: 'text',
|
|
78
|
+
};
|
|
79
|
+
|
|
80
|
+
// @ts-ignore
|
|
81
|
+
import advancedThemeHtml from './examples/advanced-theme/list-advanced-theme.example.html' with {
|
|
82
|
+
loader: 'text',
|
|
83
|
+
};
|
|
84
|
+
// @ts-ignore
|
|
85
|
+
import advancedThemeTs from './examples/advanced-theme/list-advanced-theme.example.ts' with {
|
|
86
|
+
loader: 'text',
|
|
87
|
+
};
|
|
88
|
+
|
|
89
|
+
@Component({
|
|
90
|
+
imports: [
|
|
91
|
+
CommonModule,
|
|
92
|
+
DocsLayoutComponent,
|
|
93
|
+
DocExampleComponent,
|
|
94
|
+
ListBasicExample,
|
|
95
|
+
ListSizeExample,
|
|
96
|
+
ListBorderedDividerExample,
|
|
97
|
+
ListInteractiveExample,
|
|
98
|
+
ListHeaderFooterExample,
|
|
99
|
+
ListPrefixSuffixExample,
|
|
100
|
+
ListCustomStyleExample,
|
|
101
|
+
ListAdvancedDynamicExample,
|
|
102
|
+
ListAdvancedThemeExample,
|
|
103
|
+
],
|
|
104
|
+
templateUrl: './list.page.html',
|
|
105
|
+
selector: 'app-list-page',
|
|
106
|
+
standalone: true,
|
|
107
|
+
})
|
|
108
|
+
export class ListDocPage {
|
|
109
|
+
protected basicHtml = basicHtml;
|
|
110
|
+
protected basicTs = basicTs;
|
|
111
|
+
|
|
112
|
+
protected sizeHtml = sizeHtml;
|
|
113
|
+
protected sizeTs = sizeTs;
|
|
114
|
+
|
|
115
|
+
protected borderedDividerHtml = borderedDividerHtml;
|
|
116
|
+
protected borderedDividerTs = borderedDividerTs;
|
|
117
|
+
|
|
118
|
+
protected interactiveHtml = interactiveHtml;
|
|
119
|
+
protected interactiveTs = interactiveTs;
|
|
120
|
+
|
|
121
|
+
protected headerFooterHtml = headerFooterHtml;
|
|
122
|
+
protected headerFooterTs = headerFooterTs;
|
|
123
|
+
|
|
124
|
+
protected prefixSuffixHtml = prefixSuffixHtml;
|
|
125
|
+
protected prefixSuffixTs = prefixSuffixTs;
|
|
126
|
+
|
|
127
|
+
protected customStyleHtml = customStyleHtml;
|
|
128
|
+
protected customStyleTs = customStyleTs;
|
|
129
|
+
|
|
130
|
+
protected advancedDynamicHtml = advancedDynamicHtml;
|
|
131
|
+
protected advancedDynamicTs = advancedDynamicTs;
|
|
132
|
+
|
|
133
|
+
protected advancedThemeHtml = advancedThemeHtml;
|
|
134
|
+
protected advancedThemeTs = advancedThemeTs;
|
|
135
|
+
|
|
136
|
+
protected readonly apiProps: DocApiProperty[] = [
|
|
137
|
+
{
|
|
138
|
+
name: 'size',
|
|
139
|
+
type: "'sm' | 'md' | 'lg'",
|
|
140
|
+
defaultValue: "'md'",
|
|
141
|
+
description:
|
|
142
|
+
'Sets the font size and the item padding. Uses --list-font-size-sm/md/lg and --list-item-padding.',
|
|
143
|
+
},
|
|
144
|
+
{
|
|
145
|
+
name: 'bordered',
|
|
146
|
+
type: 'boolean',
|
|
147
|
+
defaultValue: 'false',
|
|
148
|
+
description: 'Adds a 1px border around the container using --list-border.',
|
|
149
|
+
},
|
|
150
|
+
{
|
|
151
|
+
name: 'show-divider',
|
|
152
|
+
type: 'boolean',
|
|
153
|
+
defaultValue: 'false',
|
|
154
|
+
description: 'Separates items with a 1px line using --list-divider.',
|
|
155
|
+
},
|
|
156
|
+
{
|
|
157
|
+
name: 'hoverable',
|
|
158
|
+
type: 'boolean',
|
|
159
|
+
defaultValue: 'false',
|
|
160
|
+
description: 'Highlights an item on hover using --list-hover-background.',
|
|
161
|
+
},
|
|
162
|
+
{
|
|
163
|
+
name: 'clickable',
|
|
164
|
+
type: 'boolean',
|
|
165
|
+
defaultValue: 'false',
|
|
166
|
+
description:
|
|
167
|
+
'Shows a pointer cursor and an active background using --list-active-background. The click event stays on the item, the component does not emit anything.',
|
|
168
|
+
},
|
|
169
|
+
{
|
|
170
|
+
name: 'container-class',
|
|
171
|
+
type: 'string | object',
|
|
172
|
+
defaultValue: "''",
|
|
173
|
+
description: 'Class applied to the list container.',
|
|
174
|
+
},
|
|
175
|
+
{
|
|
176
|
+
name: 'container-style',
|
|
177
|
+
type: 'object',
|
|
178
|
+
defaultValue: 'null',
|
|
179
|
+
description: 'Inline style for the list container.',
|
|
180
|
+
},
|
|
181
|
+
{
|
|
182
|
+
name: 'item-class',
|
|
183
|
+
type: 'string | object',
|
|
184
|
+
defaultValue: "''",
|
|
185
|
+
description: 'On dasar-list-item. Class applied to the item.',
|
|
186
|
+
},
|
|
187
|
+
{
|
|
188
|
+
name: 'item-style',
|
|
189
|
+
type: 'object',
|
|
190
|
+
defaultValue: 'null',
|
|
191
|
+
description: 'On dasar-list-item. Inline style for the item.',
|
|
192
|
+
},
|
|
193
|
+
{
|
|
194
|
+
name: '[header-slot]',
|
|
195
|
+
type: 'Content Slot',
|
|
196
|
+
defaultValue: '-',
|
|
197
|
+
description:
|
|
198
|
+
'On dasar-list. Renders a sticky-style header above the content. The header and footer wrapper is only rendered when the slot is provided.',
|
|
199
|
+
},
|
|
200
|
+
{
|
|
201
|
+
name: '[footer-slot]',
|
|
202
|
+
type: 'Content Slot',
|
|
203
|
+
defaultValue: '-',
|
|
204
|
+
description: 'On dasar-list. Renders a footer below the content.',
|
|
205
|
+
},
|
|
206
|
+
{
|
|
207
|
+
name: '[prefix-slot]',
|
|
208
|
+
type: 'Content Slot',
|
|
209
|
+
defaultValue: '-',
|
|
210
|
+
description: 'On dasar-list-item. Renders before the item body, for example an icon.',
|
|
211
|
+
},
|
|
212
|
+
{
|
|
213
|
+
name: '[suffix-slot]',
|
|
214
|
+
type: 'Content Slot',
|
|
215
|
+
defaultValue: '-',
|
|
216
|
+
description: 'On dasar-list-item. Renders after the item body, for example a chip.',
|
|
217
|
+
},
|
|
218
|
+
{
|
|
219
|
+
name: 'default slot',
|
|
220
|
+
type: 'Content Slot',
|
|
221
|
+
defaultValue: '-',
|
|
222
|
+
description: 'The list content. dasar-list-item elements are the usual children.',
|
|
223
|
+
},
|
|
224
|
+
{
|
|
225
|
+
name: 'theme tokens',
|
|
226
|
+
type: 'DasarThemeList',
|
|
227
|
+
defaultValue: '-',
|
|
228
|
+
description:
|
|
229
|
+
'Set through tokens.light.list (or tokens.dark.list) in DasarThemeService.setGlobalTheme, or [tokenConfig] on dasar-theme-provider. Example: hoverBackground -> --list-hover-background.',
|
|
230
|
+
},
|
|
231
|
+
{
|
|
232
|
+
name: 'component config',
|
|
233
|
+
type: 'DasarListConfig / DasarListItemConfig',
|
|
234
|
+
defaultValue: '-',
|
|
235
|
+
description: 'Defaults via components.list and components.listItem in DasarComponentConfig.',
|
|
236
|
+
},
|
|
237
|
+
];
|
|
238
|
+
}
|