docs(ui5-table): add first blog draft #11232
Conversation
|
|
||
| # The Table Web Component is Now Stable - Here's What's New | ||
|
|
||
| After its half year tenure as experimental component since the relase of UI5 Web Components 2.0, allowing us to gather feedback |
There was a problem hiding this comment.
relase => release
I usually use this tool https://www.grammarly.com/ or something similar to detect all kinds of typos and grammar mistakes before publishing
There was a problem hiding this comment.
this should not be the way how virtualizer work
There was a problem hiding this comment.
I suppose you want a sample with extra rows? Maybe we should adjust the playground sample as well then (as the gif is taken from there)
|
|
||
| ### Keyboard Handling | ||
|
|
||
| Apart from moving the ARIA roles from the Shadow DOM to the "light" DOM, allowing you to directly reference other components via `aria-labelledby`, accessibility |
There was a problem hiding this comment.
Maybe mention that the root is the exception?
|
|
||
| While these new features and functionalities are already quite a lot, we already have additional features planned for the future. | ||
|
|
||
| Here is a quick sneak peek on what is about to come: |
There was a problem hiding this comment.
I'm not sure about this section. All these points are currently on the requirements list. But when and in which way they might be available in future depends on many factors. This list could create expectations what's coming next.
There was a problem hiding this comment.
We need a similar list for the ui5con or we should from that section from the ui5con session
There was a problem hiding this comment.
I'm fine with omitting this part from the blog. I'll think about replacing this maybe with a short migration sample
| Back in UI5 Web Components 1.x, the library already offered a Table component, which provided developers with capabilities to display | ||
| data in a tabular structure. | ||
|
|
||
| As we've decided to upgrade the component library to 2.0, the Table component was reevaluated and we've identified pain points, the biggest |
There was a problem hiding this comment.
We should try to formulate it positive and do so much finger pointing to the old table.
Maybe something like
With UI5 2.0 we decided to reevaluate our Table component by taking accessibility principles and the harmonization with the existing table types in OpenUI5 as fundaments.
Katja has maybe some suggestion as well :)
There was a problem hiding this comment.
I agree this type of text can and should be positive but I also believe that restrictions should be made transparent if they exist. Here, I think the text describes the process rather than the result and I would leave that part out and start the second sentence in this section with the three points that have been changed/improved.
|
|
||
| # The Table Web Component is Now Stable - Here's What's New | ||
|
|
||
| After its half year tenure as experimental component since the relase of UI5 Web Components 2.0, allowing us to gather feedback |
There was a problem hiding this comment.
| After its half year tenure as experimental component since the relase of UI5 Web Components 2.0, allowing us to gather feedback | |
| After its half-year tenure as an experimental component since the release of UI5 Web Components 2.0, allowing us to gather feedback |
| and improve upon the API, the Table component will finally leave its experimental state! | ||
|
|
||
| This blog will update you on why we've decided to take this path, the improvements and new features of the `ui5-table` | ||
| and will give you a rough idea of migration. |
There was a problem hiding this comment.
| and will give you a rough idea of migration. | |
| , and it will give you a rough idea of the migration. |
|
|
||
| Upgrading to a new version gave us the chance to reassess and reimagine the component, allowing us to focus on three core points: | ||
| 1. Improve Accessibility | ||
| 2. Harmonize Web Component Table and UI5 Tables |
There was a problem hiding this comment.
| 2. Harmonize Web Component Table and UI5 Tables | |
| 2. Harmonize the Table component and the equivalent UI5 tables |
| and often times differing from its counterpart. | ||
|
|
||
| Upgrading to a new version gave us the chance to reassess and reimagine the component, allowing us to focus on three core points: | ||
| 1. Improve Accessibility |
There was a problem hiding this comment.
| 1. Improve Accessibility | |
| 1. Improve accessibility |
There was a problem hiding this comment.
Idea: It might be better to stress what has been done : Improved accessibility ... and so on
| date: 2025-03-26T10:00 | ||
| --- | ||
|
|
||
| # The Table Web Component is Now Stable - Here's What's New |
There was a problem hiding this comment.
I would probably say "productive" or "no longer experimental" or something. As a reader, I would take it as a given that it is also stable. Downside is this is a bit long. 🤔
| in the overflow behavior of your table. | ||
|
|
||
| Furthermore, the "popin configuration" has changed. Instead of defining a `minWidth` representing the "minimum table width", you can define `width` or `minWidth` for the | ||
| column itself. Once the table overflows, the columns overflowing, e.g. not fitting into the table anymore, will be moved into the "popin area". This is a more natural |
There was a problem hiding this comment.
| column itself. Once the table overflows, the columns overflowing, e.g. not fitting into the table anymore, will be moved into the "popin area". This is a more natural | |
| column itself. If the table overflows, the columns that overflow, for example, if they don't fit into the table anymore, will be moved into the "popin area". This is a more natural |
|
|
||
| Furthermore, the "popin configuration" has changed. Instead of defining a `minWidth` representing the "minimum table width", you can define `width` or `minWidth` for the | ||
| column itself. Once the table overflows, the columns overflowing, e.g. not fitting into the table anymore, will be moved into the "popin area". This is a more natural | ||
| overflow behavior, allowing you to just define the widths of your columns without worrying about the general table width. |
There was a problem hiding this comment.
| overflow behavior, allowing you to just define the widths of your columns without worrying about the general table width. | |
| overflow behavior allowing you to just define the widths of your columns without worrying about the general table width. |
| The `ui5-table` and its related components (except for `TableVirtualizer`) are finally graduating from their experimental state and will move into a stable state. | ||
| The new table offers new and improved features, accessibility and user experience. | ||
|
|
||
| For compatibility reasons, the old table is still available in the `compat` package, but please migrate to the new Table implementation to leverage the newest |
There was a problem hiding this comment.
| For compatibility reasons, the old table is still available in the `compat` package, but please migrate to the new Table implementation to leverage the newest | |
| For compatibility reasons, the old table is still available in the `compat` package, but please migrate to the new table implementation to leverage the newest |
| For compatibility reasons, the old table is still available in the `compat` package, but please migrate to the new Table implementation to leverage the newest | ||
| features and functionalities. | ||
|
|
||
| If you are interested in learning more about the `ui5-table`, check the [documentation](https://sap.github.io/ui5-webcomponents/components/Table/) or join |
There was a problem hiding this comment.
To stress this more, you could say: check out the documentation
| For compatibility reasons, the old table is still available in the `compat` package, but please migrate to the new Table implementation to leverage the newest | ||
| features and functionalities. | ||
|
|
||
| If you are interested in learning more about the `ui5-table`, check the [documentation](https://sap.github.io/ui5-webcomponents/components/Table/) or join |
There was a problem hiding this comment.
| If you are interested in learning more about the `ui5-table`, check the [documentation](https://sap.github.io/ui5-webcomponents/components/Table/) or join | |
| If you are interested in learning more about the `ui5-table`, check the [documentation](https://sap.github.io/ui5-webcomponents/components/Table/), or join |
DO NOT MERGE YET!
This is a first draft for the blog post announcing the stable release of the
ui5-table.The following points are mentioned in the blog post: