@natec/mef-dev-ui-kit 22.0.298 → 22.0.305

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/README.md CHANGED
@@ -336,3 +336,76 @@ Proprietary - Copyright © NATEC
336
336
  ## Support
337
337
 
338
338
  For issues, questions, or feature requests, please refer to the [MEF.DEV platform documentation](https://platform.mef.dev).
339
+
340
+ ## Dialog style overrides
341
+
342
+ Use `panelClass` to style an individual dialog. Put the class in the application's
343
+ **global stylesheet**, since the overlay pane is outside the opening component's
344
+ encapsulated view. No `::ng-deep`, internal MDC selectors, or `!important` is needed.
345
+ Use the existing dialog config for width, height, and their min/max constraints.
346
+
347
+ ```ts
348
+ this.dialog.open(DialogComponent, {
349
+ panelClass: 'compact-dialog',
350
+ width: '640px',
351
+ maxWidth: 'calc(100vw - 32px)',
352
+ });
353
+ ```
354
+
355
+ ```scss
356
+ .compact-dialog {
357
+ --md-dialog-radius: 0;
358
+ --md-dialog-title-padding: 12px 16px;
359
+ --md-dialog-title-font-size: 16px;
360
+ --md-dialog-title-line-height: 24px;
361
+ --md-dialog-title-spacer-height: 0;
362
+ --md-dialog-content-padding: 12px 16px;
363
+ --md-dialog-content-max-height: 75vh;
364
+ --md-dialog-actions-padding: 8px 16px;
365
+ --md-dialog-actions-min-height: 40px;
366
+ }
367
+ ```
368
+
369
+ The following CSS custom properties are the public dialog styling API. Defaults
370
+ are consumed as `var()` fallbacks, so values inherit from the pane or any DOM
371
+ ancestor without being reset on inner elements. For application-wide styling,
372
+ set them on `:root`, or on an ancestor that actually contains the overlay.
373
+
374
+ | Property | Default |
375
+ | --- | --- |
376
+ | `--md-dialog-radius` | `5px` |
377
+ | `--md-dialog-surface` | UI Kit `$White` |
378
+ | `--md-dialog-shadow` | `none` |
379
+ | `--md-dialog-border` | `none` |
380
+ | `--md-dialog-color` | `inherit` |
381
+ | `--md-dialog-title-color` | `#201a1b` |
382
+ | `--md-dialog-title-font-family` | `--md-font-heading`, then `Montserrat` |
383
+ | `--md-dialog-title-padding` | `6px 24px 13px` |
384
+ | `--md-dialog-title-font-size` | `1.5rem` |
385
+ | `--md-dialog-title-line-height` | `2rem` |
386
+ | `--md-dialog-title-font-weight` | `400` |
387
+ | `--md-dialog-title-letter-spacing` | `0.03125em` |
388
+ | `--md-dialog-title-spacer-height` | `37px` |
389
+ | `--md-dialog-content-padding` | `20px 24px 0` |
390
+ | `--md-dialog-content-padding-top-with-title` | `0` |
391
+ | `--md-dialog-content-max-height` | `65vh` (existing Sass default) |
392
+ | `--md-dialog-actions-padding` | `16px 24px` |
393
+ | `--md-dialog-actions-min-height` | `52px` |
394
+ | `--md-dialog-actions-button-spacing` | `8px` (existing Sass default) |
395
+
396
+ The title spacer controls the existing `::before` baseline spacer; set it to `0`
397
+ for compact headers. When content immediately follows a title, its top padding
398
+ uses `--md-dialog-content-padding-top-with-title` instead of the padding shorthand's
399
+ top value. Button spacing applies to adjacent `.button-base` / `.mdc-button-base`
400
+ buttons and retains RTL behavior; other button layouts can use their own `gap`.
401
+
402
+ The backdrop is a sibling of the pane, so it does **not** inherit variables from
403
+ `panelClass`. Use `backdropClass: 'compact-dialog-backdrop'` and a global rule:
404
+
405
+ ```scss
406
+ .compact-dialog-backdrop {
407
+ --md-color-backdrop: rgba(0, 0, 0, 0.3);
408
+ }
409
+ ```
410
+
411
+ The Modals demo includes both default and compact versions of the same dialog.