@servicemind.tis/tis-smart-table-viewer 2.4.17 → 2.4.19

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
@@ -14,6 +14,7 @@
14
14
  - Custom row background styling
15
15
  - Built-in pagination and sorting
16
16
  - Dynamic slot and template injection for full control
17
+ - Configurable CSS class prefix (`classPrefix`, default `tis-`)
17
18
 
18
19
  ---
19
20
 
@@ -248,6 +249,33 @@ Make sure to import `TisSmartTableViewerModule` and necessary Angular Material m
248
249
 
249
250
  ---
250
251
 
252
+ ## CSS class prefix (`classPrefix`)
253
+
254
+ The library emits design-system CSS classes with a configurable prefix.
255
+
256
+ | Input | Default | Example result |
257
+ |---|---|---|
258
+ | `classPrefix` | `'tis-'` | `cx('table')` → `tis-table` |
259
+
260
+ ```html
261
+ <!-- default: classes like tis-table, tis-page, tis-breadcrumb -->
262
+ <tis-smart-table-viewer ...></tis-smart-table-viewer>
263
+
264
+ <!-- custom namespace: classes like app-table, app-page -->
265
+ <tis-smart-table-viewer classPrefix="app-" ...></tis-smart-table-viewer>
266
+ ```
267
+
268
+ ### Host stylesheet contract
269
+
270
+ Most layout/visual styles (page shell, table chrome, breadcrumbs, utilities, dialogs) live in the **host application** stylesheet (e.g. your design-system `styles.scss`), not inside this library.
271
+
272
+ - With the default `tis-`, keep your existing `.tis-*` rules.
273
+ - If you change `classPrefix`, you must provide matching global rules for that prefix (e.g. rename/duplicate `.tis-table` → `.app-table`), or the UI will look unstyled.
274
+ - CSS custom properties such as `--tis-primary` are **not** renamed by `classPrefix`.
275
+ - Library-internal encapsulated styles use stable `stv-*` class names and do not depend on `classPrefix`.
276
+
277
+ ---
278
+
251
279
 
252
280
  ## 🤝 Contributing
253
281