This is page 89 of 143. Use http://codebase.md/xmlui-org/xmlui/xmlui/tools/vscode/resources/xmlui-markup-syntax-highlighting.png?lines=false&page={x} to view the full context.
# Directory Structure
```
├── .changeset
│ ├── config.json
│ └── cyan-tools-design.md
├── .eslintrc.cjs
├── .github
│ ├── build-checklist.png
│ ├── ISSUE_TEMPLATE
│ │ ├── bug_report.md
│ │ └── feature_request.md
│ └── workflows
│ ├── deploy-blog-optimized.yml
│ ├── deploy-blog-swa.yml
│ ├── deploy-blog.yml
│ ├── deploy-docs-optimized.yml
│ ├── deploy-docs-swa.yml
│ ├── deploy-docs.yml
│ ├── prepare-versions.yml
│ ├── release-packages.yml
│ ├── run-all-tests.yml
│ └── run-smoke-tests.yml
├── .gitignore
├── .prettierrc.js
├── .vscode
│ ├── launch.json
│ └── settings.json
├── blog
│ ├── .gitignore
│ ├── .gitkeep
│ ├── CHANGELOG.md
│ ├── extensions.ts
│ ├── index.html
│ ├── index.ts
│ ├── package.json
│ ├── public
│ │ ├── blog
│ │ │ ├── images
│ │ │ │ ├── an-advanced-codefence.gif
│ │ │ │ ├── an-advanced-codefence.mp4
│ │ │ │ ├── blog-page-component.png
│ │ │ │ ├── blog-scrabble.png
│ │ │ │ ├── codefence-runner.png
│ │ │ │ ├── integrated-blog-search.png
│ │ │ │ ├── lorem-ipsum.png
│ │ │ │ ├── playground-checkbox-source.png
│ │ │ │ ├── playground.png
│ │ │ │ ├── use-xmlui-mcp-to-find-a-howto.png
│ │ │ │ └── xmlui-demo-gallery.png
│ │ │ ├── introducing-xmlui.md
│ │ │ ├── lorem-ipsum.md
│ │ │ ├── newest-post.md
│ │ │ ├── older-post.md
│ │ │ ├── xmlui-playground.md
│ │ │ └── xmlui-powered-blog.md
│ │ ├── mockServiceWorker.js
│ │ ├── resources
│ │ │ ├── favicon.ico
│ │ │ ├── files
│ │ │ │ └── for-download
│ │ │ │ └── xmlui
│ │ │ │ └── xmlui-standalone.umd.js
│ │ │ ├── github.svg
│ │ │ ├── llms.txt
│ │ │ ├── logo-dark.svg
│ │ │ ├── logo.svg
│ │ │ ├── pg-popout.svg
│ │ │ ├── rss.svg
│ │ │ └── xmlui-logo.svg
│ │ ├── serve.json
│ │ ├── staticwebapp.config.json
│ │ └── web.config
│ ├── scripts
│ │ ├── download-latest-xmlui.js
│ │ ├── generate-rss.js
│ │ ├── get-releases.js
│ │ └── utils.js
│ ├── src
│ │ ├── components
│ │ │ ├── BlogOverview.xmlui
│ │ │ ├── BlogPage.xmlui
│ │ │ └── PageNotFound.xmlui
│ │ ├── config.ts
│ │ ├── Main.xmlui
│ │ └── themes
│ │ └── blog-theme.ts
│ └── tsconfig.json
├── CONTRIBUTING.md
├── docs
│ ├── .gitignore
│ ├── CHANGELOG.md
│ ├── ComponentRefLinks.txt
│ ├── content
│ │ ├── _meta.json
│ │ ├── components
│ │ │ ├── _meta.json
│ │ │ ├── _overview.md
│ │ │ ├── APICall.md
│ │ │ ├── App.md
│ │ │ ├── AppHeader.md
│ │ │ ├── AppState.md
│ │ │ ├── AutoComplete.md
│ │ │ ├── Avatar.md
│ │ │ ├── Backdrop.md
│ │ │ ├── Badge.md
│ │ │ ├── BarChart.md
│ │ │ ├── Bookmark.md
│ │ │ ├── Breakout.md
│ │ │ ├── Button.md
│ │ │ ├── Card.md
│ │ │ ├── Carousel.md
│ │ │ ├── ChangeListener.md
│ │ │ ├── Checkbox.md
│ │ │ ├── CHStack.md
│ │ │ ├── ColorPicker.md
│ │ │ ├── Column.md
│ │ │ ├── ContentSeparator.md
│ │ │ ├── CVStack.md
│ │ │ ├── DataSource.md
│ │ │ ├── DateInput.md
│ │ │ ├── DatePicker.md
│ │ │ ├── DonutChart.md
│ │ │ ├── DropdownMenu.md
│ │ │ ├── EmojiSelector.md
│ │ │ ├── ExpandableItem.md
│ │ │ ├── FileInput.md
│ │ │ ├── FileUploadDropZone.md
│ │ │ ├── FlowLayout.md
│ │ │ ├── Footer.md
│ │ │ ├── Form.md
│ │ │ ├── FormItem.md
│ │ │ ├── FormSection.md
│ │ │ ├── Fragment.md
│ │ │ ├── H1.md
│ │ │ ├── H2.md
│ │ │ ├── H3.md
│ │ │ ├── H4.md
│ │ │ ├── H5.md
│ │ │ ├── H6.md
│ │ │ ├── Heading.md
│ │ │ ├── HSplitter.md
│ │ │ ├── HStack.md
│ │ │ ├── Icon.md
│ │ │ ├── IFrame.md
│ │ │ ├── Image.md
│ │ │ ├── Items.md
│ │ │ ├── LabelList.md
│ │ │ ├── Legend.md
│ │ │ ├── LineChart.md
│ │ │ ├── Link.md
│ │ │ ├── List.md
│ │ │ ├── Logo.md
│ │ │ ├── Markdown.md
│ │ │ ├── MenuItem.md
│ │ │ ├── MenuSeparator.md
│ │ │ ├── ModalDialog.md
│ │ │ ├── NavGroup.md
│ │ │ ├── NavLink.md
│ │ │ ├── NavPanel.md
│ │ │ ├── NoResult.md
│ │ │ ├── NumberBox.md
│ │ │ ├── Option.md
│ │ │ ├── Page.md
│ │ │ ├── PageMetaTitle.md
│ │ │ ├── Pages.md
│ │ │ ├── Pagination.md
│ │ │ ├── PasswordInput.md
│ │ │ ├── PieChart.md
│ │ │ ├── ProgressBar.md
│ │ │ ├── Queue.md
│ │ │ ├── RadioGroup.md
│ │ │ ├── RealTimeAdapter.md
│ │ │ ├── Redirect.md
│ │ │ ├── Select.md
│ │ │ ├── Slider.md
│ │ │ ├── Slot.md
│ │ │ ├── SpaceFiller.md
│ │ │ ├── Spinner.md
│ │ │ ├── Splitter.md
│ │ │ ├── Stack.md
│ │ │ ├── StickyBox.md
│ │ │ ├── SubMenuItem.md
│ │ │ ├── Switch.md
│ │ │ ├── TabItem.md
│ │ │ ├── Table.md
│ │ │ ├── TableOfContents.md
│ │ │ ├── Tabs.md
│ │ │ ├── Text.md
│ │ │ ├── TextArea.md
│ │ │ ├── TextBox.md
│ │ │ ├── Theme.md
│ │ │ ├── TimeInput.md
│ │ │ ├── Timer.md
│ │ │ ├── ToneChangerButton.md
│ │ │ ├── ToneSwitch.md
│ │ │ ├── Tooltip.md
│ │ │ ├── Tree.md
│ │ │ ├── VSplitter.md
│ │ │ ├── VStack.md
│ │ │ ├── xmlui-animations
│ │ │ │ ├── _meta.json
│ │ │ │ ├── _overview.md
│ │ │ │ ├── Animation.md
│ │ │ │ ├── FadeAnimation.md
│ │ │ │ ├── FadeInAnimation.md
│ │ │ │ ├── FadeOutAnimation.md
│ │ │ │ ├── ScaleAnimation.md
│ │ │ │ └── SlideInAnimation.md
│ │ │ ├── xmlui-pdf
│ │ │ │ ├── _meta.json
│ │ │ │ ├── _overview.md
│ │ │ │ └── Pdf.md
│ │ │ ├── xmlui-spreadsheet
│ │ │ │ ├── _meta.json
│ │ │ │ ├── _overview.md
│ │ │ │ └── Spreadsheet.md
│ │ │ └── xmlui-website-blocks
│ │ │ ├── _meta.json
│ │ │ ├── _overview.md
│ │ │ ├── Carousel.md
│ │ │ ├── HelloMd.md
│ │ │ ├── HeroSection.md
│ │ │ └── ScrollToTop.md
│ │ └── extensions
│ │ ├── _meta.json
│ │ ├── xmlui-animations
│ │ │ ├── _meta.json
│ │ │ ├── _overview.md
│ │ │ ├── Animation.md
│ │ │ ├── FadeAnimation.md
│ │ │ ├── FadeInAnimation.md
│ │ │ ├── FadeOutAnimation.md
│ │ │ ├── ScaleAnimation.md
│ │ │ └── SlideInAnimation.md
│ │ └── xmlui-website-blocks
│ │ ├── _meta.json
│ │ ├── _overview.md
│ │ ├── Carousel.md
│ │ ├── FancyButton.md
│ │ ├── HeroSection.md
│ │ └── ScrollToTop.md
│ ├── extensions.ts
│ ├── index.html
│ ├── index.ts
│ ├── package.json
│ ├── public
│ │ ├── feed.rss
│ │ ├── mockServiceWorker.js
│ │ ├── pages
│ │ │ ├── _meta.json
│ │ │ ├── app-structure.md
│ │ │ ├── build-editor-component.md
│ │ │ ├── build-hello-world-component.md
│ │ │ ├── components-intro.md
│ │ │ ├── context-variables.md
│ │ │ ├── forms.md
│ │ │ ├── globals.md
│ │ │ ├── glossary.md
│ │ │ ├── helper-tags.md
│ │ │ ├── hosted-deployment.md
│ │ │ ├── howto
│ │ │ │ ├── assign-a-complex-json-literal-to-a-component-variable.md
│ │ │ │ ├── chain-a-refetch.md
│ │ │ │ ├── control-cache-invalidation.md
│ │ │ │ ├── debounce-user-input-for-api-calls.md
│ │ │ │ ├── debounce-with-changelistener.md
│ │ │ │ ├── debug-a-component.md
│ │ │ │ ├── delay-a-datasource-until-another-datasource-is-ready.md
│ │ │ │ ├── delegate-a-method.md
│ │ │ │ ├── do-custom-form-validation.md
│ │ │ │ ├── expose-a-method-from-a-component.md
│ │ │ │ ├── filter-and-transform-data-from-an-api.md
│ │ │ │ ├── group-items-in-list-by-a-property.md
│ │ │ │ ├── handle-background-operations.md
│ │ │ │ ├── hide-an-element-until-its-datasource-is-ready.md
│ │ │ │ ├── make-a-set-of-equal-width-cards.md
│ │ │ │ ├── make-a-table-responsive.md
│ │ │ │ ├── make-navpanel-width-responsive.md
│ │ │ │ ├── modify-a-value-reported-in-a-column.md
│ │ │ │ ├── paginate-a-list.md
│ │ │ │ ├── pass-data-to-a-modal-dialog.md
│ │ │ │ ├── react-to-button-click-not-keystrokes.md
│ │ │ │ ├── set-the-initial-value-of-a-select-from-fetched-data.md
│ │ │ │ ├── share-a-modaldialog-across-components.md
│ │ │ │ ├── sync-selections-between-table-and-list-views.md
│ │ │ │ ├── update-ui-optimistically.md
│ │ │ │ ├── use-built-in-form-validation.md
│ │ │ │ └── use-the-same-modaldialog-to-add-or-edit.md
│ │ │ ├── howto.md
│ │ │ ├── intro.md
│ │ │ ├── layout.md
│ │ │ ├── markup.md
│ │ │ ├── mcp.md
│ │ │ ├── modal-dialogs.md
│ │ │ ├── news-and-reviews.md
│ │ │ ├── reactive-intro.md
│ │ │ ├── refactoring.md
│ │ │ ├── routing-and-links.md
│ │ │ ├── samples
│ │ │ │ ├── color-palette.xmlui
│ │ │ │ ├── color-values.xmlui
│ │ │ │ ├── shadow-sizes.xmlui
│ │ │ │ ├── spacing-sizes.xmlui
│ │ │ │ ├── swatch.xmlui
│ │ │ │ ├── theme-gallery-brief.xmlui
│ │ │ │ └── theme-gallery.xmlui
│ │ │ ├── scoping.md
│ │ │ ├── scripting.md
│ │ │ ├── styles-and-themes
│ │ │ │ ├── common-units.md
│ │ │ │ ├── layout-props.md
│ │ │ │ ├── theme-variable-defaults.md
│ │ │ │ ├── theme-variables.md
│ │ │ │ └── themes.md
│ │ │ ├── template-properties.md
│ │ │ ├── test.md
│ │ │ ├── tutorial-01.md
│ │ │ ├── tutorial-02.md
│ │ │ ├── tutorial-03.md
│ │ │ ├── tutorial-04.md
│ │ │ ├── tutorial-05.md
│ │ │ ├── tutorial-06.md
│ │ │ ├── tutorial-07.md
│ │ │ ├── tutorial-08.md
│ │ │ ├── tutorial-09.md
│ │ │ ├── tutorial-10.md
│ │ │ ├── tutorial-11.md
│ │ │ ├── tutorial-12.md
│ │ │ ├── universal-properties.md
│ │ │ ├── user-defined-components.md
│ │ │ ├── vscode.md
│ │ │ ├── working-with-markdown.md
│ │ │ ├── working-with-text.md
│ │ │ ├── xmlui-animations
│ │ │ │ ├── _meta.json
│ │ │ │ ├── _overview.md
│ │ │ │ ├── Animation.md
│ │ │ │ ├── FadeAnimation.md
│ │ │ │ ├── FadeInAnimation.md
│ │ │ │ ├── FadeOutAnimation.md
│ │ │ │ ├── ScaleAnimation.md
│ │ │ │ └── SlideInAnimation.md
│ │ │ ├── xmlui-charts
│ │ │ │ ├── _meta.json
│ │ │ │ ├── _overview.md
│ │ │ │ ├── BarChart.md
│ │ │ │ ├── DonutChart.md
│ │ │ │ ├── LabelList.md
│ │ │ │ ├── Legend.md
│ │ │ │ ├── LineChart.md
│ │ │ │ └── PieChart.md
│ │ │ ├── xmlui-pdf
│ │ │ │ ├── _meta.json
│ │ │ │ ├── _overview.md
│ │ │ │ └── Pdf.md
│ │ │ └── xmlui-spreadsheet
│ │ │ ├── _meta.json
│ │ │ ├── _overview.md
│ │ │ └── Spreadsheet.md
│ │ ├── resources
│ │ │ ├── devdocs
│ │ │ │ ├── debug-proxy-object-2.png
│ │ │ │ ├── debug-proxy-object.png
│ │ │ │ ├── table_editor_01.png
│ │ │ │ ├── table_editor_02.png
│ │ │ │ ├── table_editor_03.png
│ │ │ │ ├── table_editor_04.png
│ │ │ │ ├── table_editor_05.png
│ │ │ │ ├── table_editor_06.png
│ │ │ │ ├── table_editor_07.png
│ │ │ │ ├── table_editor_08.png
│ │ │ │ ├── table_editor_09.png
│ │ │ │ ├── table_editor_10.png
│ │ │ │ ├── table_editor_11.png
│ │ │ │ ├── table-editor-01.png
│ │ │ │ ├── table-editor-02.png
│ │ │ │ ├── table-editor-03.png
│ │ │ │ ├── table-editor-04.png
│ │ │ │ ├── table-editor-06.png
│ │ │ │ ├── table-editor-07.png
│ │ │ │ ├── table-editor-08.png
│ │ │ │ ├── table-editor-09.png
│ │ │ │ └── xmlui-rendering-of-tiptap-markdown.png
│ │ │ ├── favicon.ico
│ │ │ ├── files
│ │ │ │ ├── clients.json
│ │ │ │ ├── daily-revenue.json
│ │ │ │ ├── dashboard-stats.json
│ │ │ │ ├── demo.xmlui
│ │ │ │ ├── demo.xmlui.xs
│ │ │ │ ├── downloads
│ │ │ │ │ └── downloads.json
│ │ │ │ ├── for-download
│ │ │ │ │ ├── index-with-api.html
│ │ │ │ │ ├── index.html
│ │ │ │ │ ├── mockApi.js
│ │ │ │ │ ├── start-darwin.sh
│ │ │ │ │ ├── start-linux.sh
│ │ │ │ │ ├── start.bat
│ │ │ │ │ └── xmlui
│ │ │ │ │ └── xmlui-standalone.umd.js
│ │ │ │ ├── getting-started
│ │ │ │ │ ├── cl-tutorial-final.zip
│ │ │ │ │ ├── cl-tutorial.zip
│ │ │ │ │ ├── cl-tutorial2.zip
│ │ │ │ │ ├── cl-tutorial3.zip
│ │ │ │ │ ├── cl-tutorial4.zip
│ │ │ │ │ ├── cl-tutorial5.zip
│ │ │ │ │ ├── cl-tutorial6.zip
│ │ │ │ │ ├── getting-started.zip
│ │ │ │ │ ├── hello-xmlui.zip
│ │ │ │ │ ├── xmlui-empty.zip
│ │ │ │ │ └── xmlui-starter.zip
│ │ │ │ ├── howto
│ │ │ │ │ └── component-icons
│ │ │ │ │ └── up-arrow.svg
│ │ │ │ ├── invoices.json
│ │ │ │ ├── monthly-status.json
│ │ │ │ ├── news-and-reviews.json
│ │ │ │ ├── products.json
│ │ │ │ ├── releases.json
│ │ │ │ ├── tutorials
│ │ │ │ │ ├── datasource
│ │ │ │ │ │ └── api.ts
│ │ │ │ │ └── p2do
│ │ │ │ │ ├── api.ts
│ │ │ │ │ └── todo-logo.svg
│ │ │ │ └── xmlui.json
│ │ │ ├── github.svg
│ │ │ ├── images
│ │ │ │ ├── apiaction-tutorial
│ │ │ │ │ ├── add-success.png
│ │ │ │ │ ├── apiaction-param.png
│ │ │ │ │ ├── change-completed.png
│ │ │ │ │ ├── change-in-progress.png
│ │ │ │ │ ├── confirm-delete.png
│ │ │ │ │ ├── data-error.png
│ │ │ │ │ ├── data-progress.png
│ │ │ │ │ ├── data-success.png
│ │ │ │ │ ├── display-1.png
│ │ │ │ │ ├── item-deleted.png
│ │ │ │ │ ├── item-updated.png
│ │ │ │ │ ├── missing-api-key.png
│ │ │ │ │ ├── new-item-added.png
│ │ │ │ │ └── test-message.png
│ │ │ │ ├── chat-api
│ │ │ │ │ └── domain-model.svg
│ │ │ │ ├── components
│ │ │ │ │ ├── image
│ │ │ │ │ │ └── breakfast.jpg
│ │ │ │ │ ├── markdown
│ │ │ │ │ │ └── colors.png
│ │ │ │ │ └── modal
│ │ │ │ │ ├── deep_link_dialog_1.jpg
│ │ │ │ │ └── deep_link_dialog_2.jpg
│ │ │ │ ├── create-apps
│ │ │ │ │ ├── collapsed-vertical.png
│ │ │ │ │ ├── using-forms-warning-dialog.png
│ │ │ │ │ └── using-forms.png
│ │ │ │ ├── datasource-tutorial
│ │ │ │ │ ├── data-with-header.png
│ │ │ │ │ ├── filtered-data.png
│ │ │ │ │ ├── filtered-items.png
│ │ │ │ │ ├── initial-page-items.png
│ │ │ │ │ ├── list-items.png
│ │ │ │ │ ├── next-page-items.png
│ │ │ │ │ ├── no-data.png
│ │ │ │ │ ├── pagination-1.jpg
│ │ │ │ │ ├── pagination-1.png
│ │ │ │ │ ├── polling-1.png
│ │ │ │ │ ├── refetch-data.png
│ │ │ │ │ ├── slow-loading.png
│ │ │ │ │ ├── test-message.png
│ │ │ │ │ ├── Thumbs.db
│ │ │ │ │ ├── unconventional-data.png
│ │ │ │ │ └── unfiltered-items.png
│ │ │ │ ├── flower.jpg
│ │ │ │ ├── get-started
│ │ │ │ │ ├── add-new-contact.png
│ │ │ │ │ ├── app-modified.png
│ │ │ │ │ ├── app-start.png
│ │ │ │ │ ├── app-with-boxes.png
│ │ │ │ │ ├── app-with-toast.png
│ │ │ │ │ ├── boilerplate-structure.png
│ │ │ │ │ ├── cl-initial.png
│ │ │ │ │ ├── cl-start.png
│ │ │ │ │ ├── contact-counts.png
│ │ │ │ │ ├── contact-dialog-title.png
│ │ │ │ │ ├── contact-dialog.png
│ │ │ │ │ ├── contact-menus.png
│ │ │ │ │ ├── contact-predicates.png
│ │ │ │ │ ├── context-menu.png
│ │ │ │ │ ├── dashboard-numbers.png
│ │ │ │ │ ├── default-contact-list.png
│ │ │ │ │ ├── delete-contact.png
│ │ │ │ │ ├── delete-task.png
│ │ │ │ │ ├── detailed-template.png
│ │ │ │ │ ├── edit-contact-details.png
│ │ │ │ │ ├── edited-contact-saved.png
│ │ │ │ │ ├── empty-sections.png
│ │ │ │ │ ├── filter-completed.png
│ │ │ │ │ ├── fullwidth-desktop.png
│ │ │ │ │ ├── fullwidth-mobile.png
│ │ │ │ │ ├── initial-table.png
│ │ │ │ │ ├── items-and-badges.png
│ │ │ │ │ ├── loading-message.png
│ │ │ │ │ ├── new-contact-button.png
│ │ │ │ │ ├── new-contact-saved.png
│ │ │ │ │ ├── no-empty-sections.png
│ │ │ │ │ ├── personal-todo-initial.png
│ │ │ │ │ ├── piechart.png
│ │ │ │ │ ├── review-today.png
│ │ │ │ │ ├── rudimentary-dashboard.png
│ │ │ │ │ ├── section-collapsed.png
│ │ │ │ │ ├── sectioned-items.png
│ │ │ │ │ ├── sections-ordered.png
│ │ │ │ │ ├── spacex-list-with-links.png
│ │ │ │ │ ├── spacex-list.png
│ │ │ │ │ ├── start-personal-todo-1.png
│ │ │ │ │ ├── submit-new-contact.png
│ │ │ │ │ ├── submit-new-task.png
│ │ │ │ │ ├── syntax-highlighting.png
│ │ │ │ │ ├── table-with-badge.png
│ │ │ │ │ ├── template-with-card.png
│ │ │ │ │ ├── test-emulated-api.png
│ │ │ │ │ ├── Thumbs.db
│ │ │ │ │ ├── todo-logo.png
│ │ │ │ │ └── xmlui-tools.png
│ │ │ │ ├── HelloApp.png
│ │ │ │ ├── HelloApp2.png
│ │ │ │ ├── logos
│ │ │ │ │ ├── xmlui1.svg
│ │ │ │ │ ├── xmlui2.svg
│ │ │ │ │ ├── xmlui3.svg
│ │ │ │ │ ├── xmlui4.svg
│ │ │ │ │ ├── xmlui5.svg
│ │ │ │ │ ├── xmlui6.svg
│ │ │ │ │ └── xmlui7.svg
│ │ │ │ ├── pdf
│ │ │ │ │ └── dummy-pdf.jpg
│ │ │ │ ├── rendering-engine
│ │ │ │ │ ├── AppEngine-flow.svg
│ │ │ │ │ ├── Component.svg
│ │ │ │ │ ├── CompoundComponent.svg
│ │ │ │ │ ├── RootComponent.svg
│ │ │ │ │ └── tree-with-containers.svg
│ │ │ │ ├── reviewers-guide
│ │ │ │ │ ├── AppEngine-flow.svg
│ │ │ │ │ └── incbutton-in-action.png
│ │ │ │ ├── tools
│ │ │ │ │ └── boilerplate-structure.png
│ │ │ │ ├── try.svg
│ │ │ │ ├── tutorial
│ │ │ │ │ ├── app-chat-history.png
│ │ │ │ │ ├── app-content-placeholder.png
│ │ │ │ │ ├── app-header-and-content.png
│ │ │ │ │ ├── app-links-channel-selected.png
│ │ │ │ │ ├── app-links-click.png
│ │ │ │ │ ├── app-navigation.png
│ │ │ │ │ ├── finished-ex01.png
│ │ │ │ │ ├── finished-ex02.png
│ │ │ │ │ ├── hello.png
│ │ │ │ │ ├── splash-screen-advanced.png
│ │ │ │ │ ├── splash-screen-after-click.png
│ │ │ │ │ ├── splash-screen-centered.png
│ │ │ │ │ ├── splash-screen-events.png
│ │ │ │ │ ├── splash-screen-expression.png
│ │ │ │ │ ├── splash-screen-reuse-after.png
│ │ │ │ │ ├── splash-screen-reuse-before.png
│ │ │ │ │ └── splash-screen.png
│ │ │ │ └── tutorial-01.png
│ │ │ ├── llms.txt
│ │ │ ├── logo-dark.svg
│ │ │ ├── logo.svg
│ │ │ ├── pg-popout.svg
│ │ │ └── xmlui-logo.svg
│ │ ├── serve.json
│ │ └── web.config
│ ├── scripts
│ │ ├── download-latest-xmlui.js
│ │ ├── generate-rss.js
│ │ ├── get-releases.js
│ │ └── utils.js
│ ├── src
│ │ ├── components
│ │ │ ├── BlogOverview.xmlui
│ │ │ ├── BlogPage.xmlui
│ │ │ ├── Boxes.xmlui
│ │ │ ├── Breadcrumb.xmlui
│ │ │ ├── ChangeLog.xmlui
│ │ │ ├── ColorPalette.xmlui
│ │ │ ├── DocumentLinks.xmlui
│ │ │ ├── DocumentPage.xmlui
│ │ │ ├── DocumentPageNoTOC.xmlui
│ │ │ ├── Icons.xmlui
│ │ │ ├── IncButton.xmlui
│ │ │ ├── IncButton2.xmlui
│ │ │ ├── NameValue.xmlui
│ │ │ ├── PageNotFound.xmlui
│ │ │ ├── PaletteItem.xmlui
│ │ │ ├── Palettes.xmlui
│ │ │ ├── SectionHeader.xmlui
│ │ │ ├── TBD.xmlui
│ │ │ ├── Test.xmlui
│ │ │ ├── ThemesIntro.xmlui
│ │ │ ├── ThousandThemes.xmlui
│ │ │ ├── TubeStops.xmlui
│ │ │ ├── TubeStops.xmlui.xs
│ │ │ └── TwoColumnCode.xmlui
│ │ ├── config.ts
│ │ ├── Main.xmlui
│ │ └── themes
│ │ ├── docs-theme.ts
│ │ ├── earthtone.ts
│ │ ├── xmlui-gray-on-default.ts
│ │ ├── xmlui-green-on-default.ts
│ │ └── xmlui-orange-on-default.ts
│ └── tsconfig.json
├── LICENSE
├── package-lock.json
├── package.json
├── packages
│ ├── tsconfig.json
│ ├── xmlui-animations
│ │ ├── .gitignore
│ │ ├── CHANGELOG.md
│ │ ├── demo
│ │ │ └── Main.xmlui
│ │ ├── index.html
│ │ ├── index.ts
│ │ ├── meta
│ │ │ └── componentsMetadata.ts
│ │ ├── package.json
│ │ └── src
│ │ ├── Animation.tsx
│ │ ├── AnimationNative.tsx
│ │ ├── FadeAnimation.tsx
│ │ ├── FadeInAnimation.tsx
│ │ ├── FadeOutAnimation.tsx
│ │ ├── index.tsx
│ │ ├── ScaleAnimation.tsx
│ │ └── SlideInAnimation.tsx
│ ├── xmlui-devtools
│ │ ├── .gitignore
│ │ ├── CHANGELOG.md
│ │ ├── demo
│ │ │ └── Main.xmlui
│ │ ├── index.html
│ │ ├── index.ts
│ │ ├── meta
│ │ │ └── componentsMetadata.ts
│ │ ├── package.json
│ │ ├── src
│ │ │ ├── devtools
│ │ │ │ ├── DevTools.tsx
│ │ │ │ ├── DevToolsNative.module.scss
│ │ │ │ ├── DevToolsNative.tsx
│ │ │ │ ├── ModalDialog.module.scss
│ │ │ │ ├── ModalDialog.tsx
│ │ │ │ ├── ModalVisibilityContext.tsx
│ │ │ │ ├── Tooltip.module.scss
│ │ │ │ ├── Tooltip.tsx
│ │ │ │ └── utils.ts
│ │ │ ├── editor
│ │ │ │ └── Editor.tsx
│ │ │ └── index.tsx
│ │ └── vite.config-overrides.ts
│ ├── xmlui-hello-world
│ │ ├── .gitignore
│ │ ├── index.ts
│ │ ├── meta
│ │ │ └── componentsMetadata.ts
│ │ ├── package.json
│ │ └── src
│ │ ├── HelloWorld.module.scss
│ │ ├── HelloWorld.tsx
│ │ ├── HelloWorldNative.tsx
│ │ └── index.tsx
│ ├── xmlui-os-frames
│ │ ├── .gitignore
│ │ ├── demo
│ │ │ └── Main.xmlui
│ │ ├── index.html
│ │ ├── index.ts
│ │ ├── meta
│ │ │ └── componentsMetadata.ts
│ │ ├── package.json
│ │ └── src
│ │ ├── index.tsx
│ │ ├── IPhoneFrame.module.scss
│ │ ├── IPhoneFrame.tsx
│ │ ├── MacOSAppFrame.module.scss
│ │ ├── MacOSAppFrame.tsx
│ │ ├── WindowsAppFrame.module.scss
│ │ └── WindowsAppFrame.tsx
│ ├── xmlui-pdf
│ │ ├── .gitignore
│ │ ├── CHANGELOG.md
│ │ ├── demo
│ │ │ ├── components
│ │ │ │ └── Pdf.xmlui
│ │ │ └── Main.xmlui
│ │ ├── index.html
│ │ ├── index.ts
│ │ ├── meta
│ │ │ └── componentsMetadata.ts
│ │ ├── package.json
│ │ └── src
│ │ ├── index.tsx
│ │ ├── LazyPdfNative.tsx
│ │ ├── Pdf.module.scss
│ │ └── Pdf.tsx
│ ├── xmlui-playground
│ │ ├── .gitignore
│ │ ├── CHANGELOG.md
│ │ ├── demo
│ │ │ └── Main.xmlui
│ │ ├── index.html
│ │ ├── index.ts
│ │ ├── meta
│ │ │ └── componentsMetadata.ts
│ │ ├── package.json
│ │ └── src
│ │ ├── hooks
│ │ │ ├── usePlayground.ts
│ │ │ └── useToast.ts
│ │ ├── index.tsx
│ │ ├── playground
│ │ │ ├── Box.module.scss
│ │ │ ├── Box.tsx
│ │ │ ├── CodeSelector.module.scss
│ │ │ ├── CodeSelector.tsx
│ │ │ ├── ConfirmationDialog.module.scss
│ │ │ ├── ConfirmationDialog.tsx
│ │ │ ├── Editor.tsx
│ │ │ ├── Header.module.scss
│ │ │ ├── Header.tsx
│ │ │ ├── Playground.tsx
│ │ │ ├── PlaygroundContent.module.scss
│ │ │ ├── PlaygroundContent.tsx
│ │ │ ├── PlaygroundNative.module.scss
│ │ │ ├── PlaygroundNative.tsx
│ │ │ ├── Preview.tsx
│ │ │ ├── StandalonePlayground.tsx
│ │ │ ├── StandalonePlaygroundNative.module.scss
│ │ │ ├── StandalonePlaygroundNative.tsx
│ │ │ ├── ThemeSwitcher.module.scss
│ │ │ ├── ThemeSwitcher.tsx
│ │ │ └── utils.ts
│ │ ├── providers
│ │ │ ├── Toast.module.scss
│ │ │ └── ToastProvider.tsx
│ │ ├── state
│ │ │ └── store.ts
│ │ ├── themes
│ │ │ └── theme.ts
│ │ └── utils
│ │ └── helpers.ts
│ ├── xmlui-search
│ │ ├── .gitignore
│ │ ├── CHANGELOG.md
│ │ ├── demo
│ │ │ └── Main.xmlui
│ │ ├── index.html
│ │ ├── index.ts
│ │ ├── meta
│ │ │ └── componentsMetadata.ts
│ │ ├── package.json
│ │ └── src
│ │ ├── index.tsx
│ │ ├── Search.module.scss
│ │ └── Search.tsx
│ ├── xmlui-spreadsheet
│ │ ├── .gitignore
│ │ ├── demo
│ │ │ └── Main.xmlui
│ │ ├── index.html
│ │ ├── index.ts
│ │ ├── meta
│ │ │ └── componentsMetadata.ts
│ │ ├── package.json
│ │ └── src
│ │ ├── index.tsx
│ │ ├── Spreadsheet.tsx
│ │ └── SpreadsheetNative.tsx
│ └── xmlui-website-blocks
│ ├── .gitignore
│ ├── CHANGELOG.md
│ ├── demo
│ │ ├── components
│ │ │ ├── HeroBackgroundBreakoutPage.xmlui
│ │ │ ├── HeroBackgroundsPage.xmlui
│ │ │ ├── HeroContentsPage.xmlui
│ │ │ ├── HeroTextAlignPage.xmlui
│ │ │ ├── HeroTextPage.xmlui
│ │ │ └── HeroTonesPage.xmlui
│ │ ├── Main.xmlui
│ │ └── themes
│ │ └── default.ts
│ ├── index.html
│ ├── index.ts
│ ├── meta
│ │ └── componentsMetadata.ts
│ ├── package.json
│ ├── public
│ │ └── resources
│ │ ├── building.jpg
│ │ └── xmlui-logo.svg
│ └── src
│ ├── Carousel
│ │ ├── Carousel.module.scss
│ │ ├── Carousel.tsx
│ │ ├── CarouselContext.tsx
│ │ └── CarouselNative.tsx
│ ├── FancyButton
│ │ ├── FancyButton.module.scss
│ │ ├── FancyButton.tsx
│ │ └── FancyButton.xmlui
│ ├── Hello
│ │ ├── Hello.tsx
│ │ ├── Hello.xmlui
│ │ └── Hello.xmlui.xs
│ ├── HeroSection
│ │ ├── HeroSection.module.scss
│ │ ├── HeroSection.spec.ts
│ │ ├── HeroSection.tsx
│ │ └── HeroSectionNative.tsx
│ ├── index.tsx
│ ├── ScrollToTop
│ │ ├── ScrollToTop.module.scss
│ │ ├── ScrollToTop.tsx
│ │ └── ScrollToTopNative.tsx
│ └── vite-env.d.ts
├── playwright.config.ts
├── README.md
├── tools
│ ├── codefence
│ │ └── xmlui-code-fence-docs.md
│ ├── create-app
│ │ ├── .gitignore
│ │ ├── CHANGELOG.md
│ │ ├── create-app.ts
│ │ ├── helpers
│ │ │ ├── copy.ts
│ │ │ ├── get-pkg-manager.ts
│ │ │ ├── git.ts
│ │ │ ├── install.ts
│ │ │ ├── is-folder-empty.ts
│ │ │ ├── is-writeable.ts
│ │ │ ├── make-dir.ts
│ │ │ └── validate-pkg.ts
│ │ ├── index.ts
│ │ ├── package.json
│ │ ├── templates
│ │ │ ├── default
│ │ │ │ └── ts
│ │ │ │ ├── gitignore
│ │ │ │ ├── index.html
│ │ │ │ ├── index.ts
│ │ │ │ ├── public
│ │ │ │ │ ├── mockServiceWorker.js
│ │ │ │ │ ├── resources
│ │ │ │ │ │ ├── favicon.ico
│ │ │ │ │ │ └── xmlui-logo.svg
│ │ │ │ │ └── serve.json
│ │ │ │ └── src
│ │ │ │ ├── components
│ │ │ │ │ ├── ApiAware.xmlui
│ │ │ │ │ ├── Home.xmlui
│ │ │ │ │ ├── IncButton.xmlui
│ │ │ │ │ └── PagePanel.xmlui
│ │ │ │ ├── config.ts
│ │ │ │ └── Main.xmlui
│ │ │ ├── index.ts
│ │ │ └── types.ts
│ │ └── tsconfig.json
│ ├── create-xmlui-hello-world
│ │ ├── index.js
│ │ └── package.json
│ └── vscode
│ ├── .gitignore
│ ├── .vscode
│ │ ├── launch.json
│ │ └── tasks.json
│ ├── .vscodeignore
│ ├── build.sh
│ ├── CHANGELOG.md
│ ├── esbuild.js
│ ├── eslint.config.mjs
│ ├── formatter-docs.md
│ ├── generate-test-sample.sh
│ ├── LICENSE.md
│ ├── package-lock.json
│ ├── package.json
│ ├── README.md
│ ├── resources
│ │ ├── xmlui-logo.png
│ │ └── xmlui-markup-syntax-highlighting.png
│ ├── src
│ │ ├── extension.ts
│ │ └── server.ts
│ ├── syntaxes
│ │ └── xmlui.tmLanguage.json
│ ├── test-samples
│ │ └── sample.xmlui
│ ├── tsconfig.json
│ └── tsconfig.tsbuildinfo
├── turbo.json
└── xmlui
├── .gitignore
├── bin
│ ├── bootstrap.cjs
│ ├── bootstrap.js
│ ├── build-lib.ts
│ ├── build.ts
│ ├── index.ts
│ ├── preview.ts
│ ├── start.ts
│ ├── vite-xmlui-plugin.ts
│ └── viteConfig.ts
├── CHANGELOG.md
├── conventions
│ ├── component-qa-checklist.md
│ ├── copilot-conventions.md
│ ├── create-xmlui-components.md
│ ├── mermaid.md
│ ├── testing-conventions.md
│ └── xmlui-in-a-nutshell.md
├── dev-docs
│ ├── accessibility.md
│ ├── build-system.md
│ ├── build-xmlui.md
│ ├── component-behaviors.md
│ ├── component-metadata.md
│ ├── components-with-options.md
│ ├── containers.md
│ ├── data-operations.md
│ ├── glossary.md
│ ├── index.md
│ ├── next
│ │ ├── component-dev-guide.md
│ │ ├── configuration-management-enhancement-summary.md
│ │ ├── documentation-scripts-refactoring-complete-summary.md
│ │ ├── documentation-scripts-refactoring-plan.md
│ │ ├── duplicate-pattern-extraction-summary.md
│ │ ├── error-handling-standardization-summary.md
│ │ ├── generating-component-reference.md
│ │ ├── index.md
│ │ ├── logging-consistency-implementation-summary.md
│ │ ├── project-build.md
│ │ ├── project-structure.md
│ │ ├── theme-context.md
│ │ ├── tiptap-design-considerations.md
│ │ ├── working-with-code.md
│ │ ├── xmlui-runtime-architecture
│ │ └── xmlui-wcag-accessibility-report.md
│ ├── react-fundamentals.md
│ ├── release-method.md
│ ├── standalone-app.md
│ ├── theme-variables-refactoring.md
│ ├── ud-components.md
│ └── xmlui-repo.md
├── package.json
├── scripts
│ ├── coverage-only.js
│ ├── e2e-test-summary.js
│ ├── extract-component-metadata.js
│ ├── generate-docs
│ │ ├── build-downloads-map.mjs
│ │ ├── build-pages-map.mjs
│ │ ├── components-config.json
│ │ ├── configuration-management.mjs
│ │ ├── constants.mjs
│ │ ├── create-theme-files.mjs
│ │ ├── DocsGenerator.mjs
│ │ ├── error-handling.mjs
│ │ ├── extensions-config.json
│ │ ├── folders.mjs
│ │ ├── generate-summary-files.mjs
│ │ ├── get-docs.mjs
│ │ ├── input-handler.mjs
│ │ ├── logger.mjs
│ │ ├── logging-standards.mjs
│ │ ├── MetadataProcessor.mjs
│ │ ├── pattern-utilities.mjs
│ │ └── utils.mjs
│ ├── generate-metadata-markdown.js
│ ├── get-langserver-metadata.js
│ ├── inline-links.mjs
│ └── README-e2e-summary.md
├── src
│ ├── abstractions
│ │ ├── _conventions.md
│ │ ├── ActionDefs.ts
│ │ ├── AppContextDefs.ts
│ │ ├── ComponentDefs.ts
│ │ ├── ContainerDefs.ts
│ │ ├── ExtensionDefs.ts
│ │ ├── FunctionDefs.ts
│ │ ├── RendererDefs.ts
│ │ ├── scripting
│ │ │ ├── BlockScope.ts
│ │ │ ├── Compilation.ts
│ │ │ ├── LogicalThread.ts
│ │ │ ├── LoopScope.ts
│ │ │ ├── modules.ts
│ │ │ ├── ScriptParserError.ts
│ │ │ ├── Token.ts
│ │ │ ├── TryScope.ts
│ │ │ └── TryScopeExp.ts
│ │ └── ThemingDefs.ts
│ ├── components
│ │ ├── _conventions.md
│ │ ├── abstractions.ts
│ │ ├── Accordion
│ │ │ ├── Accordion.md
│ │ │ ├── Accordion.module.scss
│ │ │ ├── Accordion.spec.ts
│ │ │ ├── Accordion.tsx
│ │ │ ├── AccordionContext.tsx
│ │ │ ├── AccordionItem.tsx
│ │ │ ├── AccordionItemNative.tsx
│ │ │ └── AccordionNative.tsx
│ │ ├── Animation
│ │ │ └── AnimationNative.tsx
│ │ ├── APICall
│ │ │ ├── APICall.md
│ │ │ ├── APICall.spec.ts
│ │ │ ├── APICall.tsx
│ │ │ └── APICallNative.tsx
│ │ ├── App
│ │ │ ├── App.md
│ │ │ ├── App.module.scss
│ │ │ ├── App.spec.ts
│ │ │ ├── App.tsx
│ │ │ ├── AppLayoutContext.ts
│ │ │ ├── AppNative.tsx
│ │ │ ├── AppStateContext.ts
│ │ │ ├── doc-resources
│ │ │ │ ├── condensed-sticky.xmlui
│ │ │ │ ├── condensed.xmlui
│ │ │ │ ├── horizontal-sticky.xmlui
│ │ │ │ ├── horizontal.xmlui
│ │ │ │ ├── vertical-full-header.xmlui
│ │ │ │ ├── vertical-sticky.xmlui
│ │ │ │ └── vertical.xmlui
│ │ │ ├── IndexerContext.ts
│ │ │ ├── LinkInfoContext.ts
│ │ │ ├── SearchContext.tsx
│ │ │ ├── Sheet.module.scss
│ │ │ └── Sheet.tsx
│ │ ├── AppHeader
│ │ │ ├── AppHeader.md
│ │ │ ├── AppHeader.module.scss
│ │ │ ├── AppHeader.spec.ts
│ │ │ ├── AppHeader.tsx
│ │ │ └── AppHeaderNative.tsx
│ │ ├── AppState
│ │ │ ├── AppState.md
│ │ │ ├── AppState.spec.ts
│ │ │ ├── AppState.tsx
│ │ │ └── AppStateNative.tsx
│ │ ├── AutoComplete
│ │ │ ├── AutoComplete.md
│ │ │ ├── AutoComplete.module.scss
│ │ │ ├── AutoComplete.spec.ts
│ │ │ ├── AutoComplete.tsx
│ │ │ ├── AutoCompleteContext.tsx
│ │ │ └── AutoCompleteNative.tsx
│ │ ├── Avatar
│ │ │ ├── Avatar.md
│ │ │ ├── Avatar.module.scss
│ │ │ ├── Avatar.spec.ts
│ │ │ ├── Avatar.tsx
│ │ │ └── AvatarNative.tsx
│ │ ├── Backdrop
│ │ │ ├── Backdrop.md
│ │ │ ├── Backdrop.module.scss
│ │ │ ├── Backdrop.spec.ts
│ │ │ ├── Backdrop.tsx
│ │ │ └── BackdropNative.tsx
│ │ ├── Badge
│ │ │ ├── Badge.md
│ │ │ ├── Badge.module.scss
│ │ │ ├── Badge.spec.ts
│ │ │ ├── Badge.tsx
│ │ │ └── BadgeNative.tsx
│ │ ├── Bookmark
│ │ │ ├── Bookmark.md
│ │ │ ├── Bookmark.module.scss
│ │ │ ├── Bookmark.spec.ts
│ │ │ ├── Bookmark.tsx
│ │ │ └── BookmarkNative.tsx
│ │ ├── Breakout
│ │ │ ├── Breakout.module.scss
│ │ │ ├── Breakout.spec.ts
│ │ │ ├── Breakout.tsx
│ │ │ └── BreakoutNative.tsx
│ │ ├── Button
│ │ │ ├── Button-style.spec.ts
│ │ │ ├── Button.md
│ │ │ ├── Button.module.scss
│ │ │ ├── Button.spec.ts
│ │ │ ├── Button.tsx
│ │ │ └── ButtonNative.tsx
│ │ ├── Card
│ │ │ ├── Card.md
│ │ │ ├── Card.module.scss
│ │ │ ├── Card.spec.ts
│ │ │ ├── Card.tsx
│ │ │ └── CardNative.tsx
│ │ ├── Carousel
│ │ │ ├── Carousel.md
│ │ │ ├── Carousel.module.scss
│ │ │ ├── Carousel.spec.ts
│ │ │ ├── Carousel.tsx
│ │ │ ├── CarouselContext.tsx
│ │ │ ├── CarouselItem.tsx
│ │ │ ├── CarouselItemNative.tsx
│ │ │ └── CarouselNative.tsx
│ │ ├── ChangeListener
│ │ │ ├── ChangeListener.md
│ │ │ ├── ChangeListener.spec.ts
│ │ │ ├── ChangeListener.tsx
│ │ │ └── ChangeListenerNative.tsx
│ │ ├── chart-color-schemes.ts
│ │ ├── Charts
│ │ │ ├── AreaChart
│ │ │ │ ├── AreaChart.md
│ │ │ │ ├── AreaChart.spec.ts
│ │ │ │ ├── AreaChart.tsx
│ │ │ │ └── AreaChartNative.tsx
│ │ │ ├── BarChart
│ │ │ │ ├── BarChart.md
│ │ │ │ ├── BarChart.module.scss
│ │ │ │ ├── BarChart.spec.ts
│ │ │ │ ├── BarChart.tsx
│ │ │ │ └── BarChartNative.tsx
│ │ │ ├── DonutChart
│ │ │ │ ├── DonutChart.spec.ts
│ │ │ │ └── DonutChart.tsx
│ │ │ ├── LabelList
│ │ │ │ ├── LabelList.module.scss
│ │ │ │ ├── LabelList.spec.ts
│ │ │ │ ├── LabelList.tsx
│ │ │ │ └── LabelListNative.tsx
│ │ │ ├── Legend
│ │ │ │ ├── Legend.spec.ts
│ │ │ │ ├── Legend.tsx
│ │ │ │ └── LegendNative.tsx
│ │ │ ├── LineChart
│ │ │ │ ├── LineChart.md
│ │ │ │ ├── LineChart.module.scss
│ │ │ │ ├── LineChart.spec.ts
│ │ │ │ ├── LineChart.tsx
│ │ │ │ └── LineChartNative.tsx
│ │ │ ├── PieChart
│ │ │ │ ├── PieChart.md
│ │ │ │ ├── PieChart.spec.ts
│ │ │ │ ├── PieChart.tsx
│ │ │ │ ├── PieChartNative.module.scss
│ │ │ │ └── PieChartNative.tsx
│ │ │ ├── RadarChart
│ │ │ │ ├── RadarChart.md
│ │ │ │ ├── RadarChart.spec.ts
│ │ │ │ ├── RadarChart.tsx
│ │ │ │ └── RadarChartNative.tsx
│ │ │ ├── Tooltip
│ │ │ │ ├── TooltipContent.module.scss
│ │ │ │ ├── TooltipContent.spec.ts
│ │ │ │ └── TooltipContent.tsx
│ │ │ └── utils
│ │ │ ├── abstractions.ts
│ │ │ └── ChartProvider.tsx
│ │ ├── Checkbox
│ │ │ ├── Checkbox.md
│ │ │ ├── Checkbox.spec.ts
│ │ │ └── Checkbox.tsx
│ │ ├── CodeBlock
│ │ │ ├── CodeBlock.module.scss
│ │ │ ├── CodeBlock.spec.ts
│ │ │ ├── CodeBlock.tsx
│ │ │ ├── CodeBlockNative.tsx
│ │ │ └── highlight-code.ts
│ │ ├── collectedComponentMetadata.ts
│ │ ├── ColorPicker
│ │ │ ├── ColorPicker.md
│ │ │ ├── ColorPicker.module.scss
│ │ │ ├── ColorPicker.spec.ts
│ │ │ ├── ColorPicker.tsx
│ │ │ └── ColorPickerNative.tsx
│ │ ├── Column
│ │ │ ├── Column.md
│ │ │ ├── Column.tsx
│ │ │ ├── ColumnNative.tsx
│ │ │ ├── doc-resources
│ │ │ │ └── list-component-data.js
│ │ │ └── TableContext.tsx
│ │ ├── component-utils.ts
│ │ ├── ComponentProvider.tsx
│ │ ├── ComponentRegistryContext.tsx
│ │ ├── container-helpers.tsx
│ │ ├── ContentSeparator
│ │ │ ├── ContentSeparator.md
│ │ │ ├── ContentSeparator.module.scss
│ │ │ ├── ContentSeparator.spec.ts
│ │ │ ├── ContentSeparator.tsx
│ │ │ └── ContentSeparatorNative.tsx
│ │ ├── DataSource
│ │ │ ├── DataSource.md
│ │ │ └── DataSource.tsx
│ │ ├── DateInput
│ │ │ ├── DateInput.md
│ │ │ ├── DateInput.module.scss
│ │ │ ├── DateInput.spec.ts
│ │ │ ├── DateInput.tsx
│ │ │ └── DateInputNative.tsx
│ │ ├── DatePicker
│ │ │ ├── DatePicker.md
│ │ │ ├── DatePicker.module.scss
│ │ │ ├── DatePicker.spec.ts
│ │ │ ├── DatePicker.tsx
│ │ │ └── DatePickerNative.tsx
│ │ ├── DropdownMenu
│ │ │ ├── DropdownMenu.md
│ │ │ ├── DropdownMenu.module.scss
│ │ │ ├── DropdownMenu.spec.ts
│ │ │ ├── DropdownMenu.tsx
│ │ │ ├── DropdownMenuNative.tsx
│ │ │ ├── MenuItem.md
│ │ │ └── SubMenuItem.md
│ │ ├── EmojiSelector
│ │ │ ├── EmojiSelector.md
│ │ │ ├── EmojiSelector.spec.ts
│ │ │ ├── EmojiSelector.tsx
│ │ │ └── EmojiSelectorNative.tsx
│ │ ├── ExpandableItem
│ │ │ ├── ExpandableItem.module.scss
│ │ │ ├── ExpandableItem.spec.ts
│ │ │ ├── ExpandableItem.tsx
│ │ │ └── ExpandableItemNative.tsx
│ │ ├── FileInput
│ │ │ ├── FileInput.md
│ │ │ ├── FileInput.module.scss
│ │ │ ├── FileInput.spec.ts
│ │ │ ├── FileInput.tsx
│ │ │ └── FileInputNative.tsx
│ │ ├── FileUploadDropZone
│ │ │ ├── FileUploadDropZone.md
│ │ │ ├── FileUploadDropZone.module.scss
│ │ │ ├── FileUploadDropZone.spec.ts
│ │ │ ├── FileUploadDropZone.tsx
│ │ │ └── FileUploadDropZoneNative.tsx
│ │ ├── FlowLayout
│ │ │ ├── FlowLayout.md
│ │ │ ├── FlowLayout.module.scss
│ │ │ ├── FlowLayout.spec.ts
│ │ │ ├── FlowLayout.spec.ts-snapshots
│ │ │ │ └── Edge-cases-boxShadow-is-not-clipped-1-non-smoke-darwin.png
│ │ │ ├── FlowLayout.tsx
│ │ │ └── FlowLayoutNative.tsx
│ │ ├── Footer
│ │ │ ├── Footer.md
│ │ │ ├── Footer.module.scss
│ │ │ ├── Footer.spec.ts
│ │ │ ├── Footer.tsx
│ │ │ └── FooterNative.tsx
│ │ ├── Form
│ │ │ ├── Form.md
│ │ │ ├── Form.module.scss
│ │ │ ├── Form.spec.ts
│ │ │ ├── Form.tsx
│ │ │ ├── formActions.ts
│ │ │ ├── FormContext.ts
│ │ │ └── FormNative.tsx
│ │ ├── FormItem
│ │ │ ├── FormItem.md
│ │ │ ├── FormItem.module.scss
│ │ │ ├── FormItem.spec.ts
│ │ │ ├── FormItem.tsx
│ │ │ ├── FormItemNative.tsx
│ │ │ ├── HelperText.module.scss
│ │ │ ├── HelperText.tsx
│ │ │ ├── ItemWithLabel.tsx
│ │ │ └── Validations.ts
│ │ ├── FormSection
│ │ │ ├── FormSection.md
│ │ │ ├── FormSection.ts
│ │ │ └── FormSection.xmlui
│ │ ├── Fragment
│ │ │ ├── Fragment.spec.ts
│ │ │ └── Fragment.tsx
│ │ ├── Heading
│ │ │ ├── abstractions.ts
│ │ │ ├── H1.md
│ │ │ ├── H1.spec.ts
│ │ │ ├── H2.md
│ │ │ ├── H2.spec.ts
│ │ │ ├── H3.md
│ │ │ ├── H3.spec.ts
│ │ │ ├── H4.md
│ │ │ ├── H4.spec.ts
│ │ │ ├── H5.md
│ │ │ ├── H5.spec.ts
│ │ │ ├── H6.md
│ │ │ ├── H6.spec.ts
│ │ │ ├── Heading.md
│ │ │ ├── Heading.module.scss
│ │ │ ├── Heading.spec.ts
│ │ │ ├── Heading.tsx
│ │ │ └── HeadingNative.tsx
│ │ ├── HoverCard
│ │ │ ├── HoverCard.tsx
│ │ │ └── HovercardNative.tsx
│ │ ├── HtmlTags
│ │ │ ├── HtmlTags.module.scss
│ │ │ ├── HtmlTags.spec.ts
│ │ │ └── HtmlTags.tsx
│ │ ├── Icon
│ │ │ ├── AdmonitionDanger.tsx
│ │ │ ├── AdmonitionInfo.tsx
│ │ │ ├── AdmonitionNote.tsx
│ │ │ ├── AdmonitionTip.tsx
│ │ │ ├── AdmonitionWarning.tsx
│ │ │ ├── ApiIcon.tsx
│ │ │ ├── ArrowDropDown.module.scss
│ │ │ ├── ArrowDropDown.tsx
│ │ │ ├── ArrowDropUp.module.scss
│ │ │ ├── ArrowDropUp.tsx
│ │ │ ├── ArrowLeft.module.scss
│ │ │ ├── ArrowLeft.tsx
│ │ │ ├── ArrowRight.module.scss
│ │ │ ├── ArrowRight.tsx
│ │ │ ├── Attach.tsx
│ │ │ ├── Binding.module.scss
│ │ │ ├── Binding.tsx
│ │ │ ├── BoardIcon.tsx
│ │ │ ├── BoxIcon.tsx
│ │ │ ├── CheckIcon.tsx
│ │ │ ├── ChevronDownIcon.tsx
│ │ │ ├── ChevronLeft.tsx
│ │ │ ├── ChevronRight.tsx
│ │ │ ├── ChevronUpIcon.tsx
│ │ │ ├── CodeFileIcon.tsx
│ │ │ ├── CodeSandbox.tsx
│ │ │ ├── CompactListIcon.tsx
│ │ │ ├── ContentCopyIcon.tsx
│ │ │ ├── DarkToLightIcon.tsx
│ │ │ ├── DatabaseIcon.module.scss
│ │ │ ├── DatabaseIcon.tsx
│ │ │ ├── DocFileIcon.tsx
│ │ │ ├── DocIcon.tsx
│ │ │ ├── DotMenuHorizontalIcon.tsx
│ │ │ ├── DotMenuIcon.tsx
│ │ │ ├── EmailIcon.tsx
│ │ │ ├── EmptyFolderIcon.tsx
│ │ │ ├── ErrorIcon.tsx
│ │ │ ├── ExpressionIcon.tsx
│ │ │ ├── FillPlusCricleIcon.tsx
│ │ │ ├── FilterIcon.tsx
│ │ │ ├── FolderIcon.tsx
│ │ │ ├── GlobeIcon.tsx
│ │ │ ├── HomeIcon.tsx
│ │ │ ├── HyperLinkIcon.tsx
│ │ │ ├── Icon.md
│ │ │ ├── Icon.module.scss
│ │ │ ├── Icon.spec.ts
│ │ │ ├── Icon.tsx
│ │ │ ├── IconNative.tsx
│ │ │ ├── ImageFileIcon.tsx
│ │ │ ├── Inspect.tsx
│ │ │ ├── LightToDark.tsx
│ │ │ ├── LinkIcon.tsx
│ │ │ ├── ListIcon.tsx
│ │ │ ├── LooseListIcon.tsx
│ │ │ ├── MoonIcon.tsx
│ │ │ ├── MoreOptionsIcon.tsx
│ │ │ ├── NoSortIcon.tsx
│ │ │ ├── PDFIcon.tsx
│ │ │ ├── PenIcon.tsx
│ │ │ ├── PhoneIcon.tsx
│ │ │ ├── PhotoIcon.tsx
│ │ │ ├── PlusIcon.tsx
│ │ │ ├── SearchIcon.tsx
│ │ │ ├── ShareIcon.tsx
│ │ │ ├── SortAscendingIcon.tsx
│ │ │ ├── SortDescendingIcon.tsx
│ │ │ ├── StarsIcon.tsx
│ │ │ ├── SunIcon.tsx
│ │ │ ├── svg
│ │ │ │ ├── admonition_danger.svg
│ │ │ │ ├── admonition_info.svg
│ │ │ │ ├── admonition_note.svg
│ │ │ │ ├── admonition_tip.svg
│ │ │ │ ├── admonition_warning.svg
│ │ │ │ ├── api.svg
│ │ │ │ ├── arrow-dropdown.svg
│ │ │ │ ├── arrow-left.svg
│ │ │ │ ├── arrow-right.svg
│ │ │ │ ├── arrow-up.svg
│ │ │ │ ├── attach.svg
│ │ │ │ ├── binding.svg
│ │ │ │ ├── box.svg
│ │ │ │ ├── bulb.svg
│ │ │ │ ├── code-file.svg
│ │ │ │ ├── code-sandbox.svg
│ │ │ │ ├── dark_to_light.svg
│ │ │ │ ├── database.svg
│ │ │ │ ├── doc.svg
│ │ │ │ ├── empty-folder.svg
│ │ │ │ ├── expression.svg
│ │ │ │ ├── eye-closed.svg
│ │ │ │ ├── eye-dark.svg
│ │ │ │ ├── eye.svg
│ │ │ │ ├── file-text.svg
│ │ │ │ ├── filter.svg
│ │ │ │ ├── folder.svg
│ │ │ │ ├── img.svg
│ │ │ │ ├── inspect.svg
│ │ │ │ ├── light_to_dark.svg
│ │ │ │ ├── moon.svg
│ │ │ │ ├── pdf.svg
│ │ │ │ ├── photo.svg
│ │ │ │ ├── share.svg
│ │ │ │ ├── stars.svg
│ │ │ │ ├── sun.svg
│ │ │ │ ├── trending-down.svg
│ │ │ │ ├── trending-level.svg
│ │ │ │ ├── trending-up.svg
│ │ │ │ ├── txt.svg
│ │ │ │ ├── unknown-file.svg
│ │ │ │ ├── unlink.svg
│ │ │ │ └── xls.svg
│ │ │ ├── TableDeleteColumnIcon.tsx
│ │ │ ├── TableDeleteRowIcon.tsx
│ │ │ ├── TableInsertColumnIcon.tsx
│ │ │ ├── TableInsertRowIcon.tsx
│ │ │ ├── TrashIcon.tsx
│ │ │ ├── TrendingDownIcon.tsx
│ │ │ ├── TrendingLevelIcon.tsx
│ │ │ ├── TrendingUpIcon.tsx
│ │ │ ├── TxtIcon.tsx
│ │ │ ├── UnknownFileIcon.tsx
│ │ │ ├── UnlinkIcon.tsx
│ │ │ ├── UserIcon.tsx
│ │ │ ├── WarningIcon.tsx
│ │ │ └── XlsIcon.tsx
│ │ ├── IconProvider.tsx
│ │ ├── IconRegistryContext.tsx
│ │ ├── IFrame
│ │ │ ├── IFrame.md
│ │ │ ├── IFrame.module.scss
│ │ │ ├── IFrame.spec.ts
│ │ │ ├── IFrame.tsx
│ │ │ └── IFrameNative.tsx
│ │ ├── Image
│ │ │ ├── Image.md
│ │ │ ├── Image.module.scss
│ │ │ ├── Image.spec.ts
│ │ │ ├── Image.tsx
│ │ │ └── ImageNative.tsx
│ │ ├── Input
│ │ │ ├── index.ts
│ │ │ ├── InputAdornment.module.scss
│ │ │ ├── InputAdornment.tsx
│ │ │ ├── InputDivider.module.scss
│ │ │ ├── InputDivider.tsx
│ │ │ ├── InputLabel.module.scss
│ │ │ ├── InputLabel.tsx
│ │ │ ├── PartialInput.module.scss
│ │ │ └── PartialInput.tsx
│ │ ├── InspectButton
│ │ │ ├── InspectButton.module.scss
│ │ │ └── InspectButton.tsx
│ │ ├── Items
│ │ │ ├── Items.md
│ │ │ ├── Items.spec.ts
│ │ │ ├── Items.tsx
│ │ │ └── ItemsNative.tsx
│ │ ├── Link
│ │ │ ├── Link.md
│ │ │ ├── Link.module.scss
│ │ │ ├── Link.spec.ts
│ │ │ ├── Link.tsx
│ │ │ └── LinkNative.tsx
│ │ ├── List
│ │ │ ├── doc-resources
│ │ │ │ └── list-component-data.js
│ │ │ ├── List.md
│ │ │ ├── List.module.scss
│ │ │ ├── List.spec.ts
│ │ │ ├── List.tsx
│ │ │ └── ListNative.tsx
│ │ ├── Logo
│ │ │ ├── doc-resources
│ │ │ │ └── xmlui-logo.svg
│ │ │ ├── Logo.md
│ │ │ ├── Logo.tsx
│ │ │ └── LogoNative.tsx
│ │ ├── Markdown
│ │ │ ├── CodeText.module.scss
│ │ │ ├── CodeText.tsx
│ │ │ ├── Markdown.md
│ │ │ ├── Markdown.module.scss
│ │ │ ├── Markdown.spec.ts
│ │ │ ├── Markdown.tsx
│ │ │ ├── MarkdownNative.tsx
│ │ │ ├── parse-binding-expr.ts
│ │ │ └── utils.ts
│ │ ├── metadata-helpers.ts
│ │ ├── ModalDialog
│ │ │ ├── ConfirmationModalContextProvider.tsx
│ │ │ ├── Dialog.module.scss
│ │ │ ├── Dialog.tsx
│ │ │ ├── ModalDialog.md
│ │ │ ├── ModalDialog.module.scss
│ │ │ ├── ModalDialog.spec.ts
│ │ │ ├── ModalDialog.tsx
│ │ │ ├── ModalDialogNative.tsx
│ │ │ └── ModalVisibilityContext.tsx
│ │ ├── NavGroup
│ │ │ ├── NavGroup.md
│ │ │ ├── NavGroup.module.scss
│ │ │ ├── NavGroup.spec.ts
│ │ │ ├── NavGroup.tsx
│ │ │ ├── NavGroupContext.ts
│ │ │ └── NavGroupNative.tsx
│ │ ├── NavLink
│ │ │ ├── NavLink.md
│ │ │ ├── NavLink.module.scss
│ │ │ ├── NavLink.spec.ts
│ │ │ ├── NavLink.tsx
│ │ │ └── NavLinkNative.tsx
│ │ ├── NavPanel
│ │ │ ├── NavPanel.md
│ │ │ ├── NavPanel.module.scss
│ │ │ ├── NavPanel.spec.ts
│ │ │ ├── NavPanel.tsx
│ │ │ └── NavPanelNative.tsx
│ │ ├── NestedApp
│ │ │ ├── AppWithCodeView.module.scss
│ │ │ ├── AppWithCodeView.tsx
│ │ │ ├── AppWithCodeViewNative.tsx
│ │ │ ├── defaultProps.tsx
│ │ │ ├── logo.svg
│ │ │ ├── NestedApp.module.scss
│ │ │ ├── NestedApp.tsx
│ │ │ ├── NestedAppNative.tsx
│ │ │ ├── Tooltip.module.scss
│ │ │ ├── Tooltip.tsx
│ │ │ └── utils.ts
│ │ ├── NoResult
│ │ │ ├── NoResult.md
│ │ │ ├── NoResult.module.scss
│ │ │ ├── NoResult.spec.ts
│ │ │ ├── NoResult.tsx
│ │ │ └── NoResultNative.tsx
│ │ ├── NumberBox
│ │ │ ├── numberbox-abstractions.ts
│ │ │ ├── NumberBox.md
│ │ │ ├── NumberBox.module.scss
│ │ │ ├── NumberBox.spec.ts
│ │ │ ├── NumberBox.tsx
│ │ │ └── NumberBoxNative.tsx
│ │ ├── Option
│ │ │ ├── Option.md
│ │ │ ├── Option.spec.ts
│ │ │ ├── Option.tsx
│ │ │ ├── OptionNative.tsx
│ │ │ └── OptionTypeProvider.tsx
│ │ ├── PageMetaTitle
│ │ │ ├── PageMetaTilteNative.tsx
│ │ │ ├── PageMetaTitle.md
│ │ │ ├── PageMetaTitle.spec.ts
│ │ │ └── PageMetaTitle.tsx
│ │ ├── Pages
│ │ │ ├── Page.md
│ │ │ ├── Pages.md
│ │ │ ├── Pages.module.scss
│ │ │ ├── Pages.tsx
│ │ │ └── PagesNative.tsx
│ │ ├── Pagination
│ │ │ ├── Pagination.md
│ │ │ ├── Pagination.module.scss
│ │ │ ├── Pagination.spec.ts
│ │ │ ├── Pagination.tsx
│ │ │ └── PaginationNative.tsx
│ │ ├── PositionedContainer
│ │ │ ├── PositionedContainer.module.scss
│ │ │ ├── PositionedContainer.tsx
│ │ │ └── PositionedContainerNative.tsx
│ │ ├── ProfileMenu
│ │ │ ├── ProfileMenu.module.scss
│ │ │ └── ProfileMenu.tsx
│ │ ├── ProgressBar
│ │ │ ├── ProgressBar.md
│ │ │ ├── ProgressBar.module.scss
│ │ │ ├── ProgressBar.spec.ts
│ │ │ ├── ProgressBar.tsx
│ │ │ └── ProgressBarNative.tsx
│ │ ├── Queue
│ │ │ ├── Queue.md
│ │ │ ├── Queue.spec.ts
│ │ │ ├── Queue.tsx
│ │ │ ├── queueActions.ts
│ │ │ └── QueueNative.tsx
│ │ ├── RadioGroup
│ │ │ ├── RadioGroup.md
│ │ │ ├── RadioGroup.module.scss
│ │ │ ├── RadioGroup.spec.ts
│ │ │ ├── RadioGroup.tsx
│ │ │ ├── RadioGroupNative.tsx
│ │ │ ├── RadioItem.tsx
│ │ │ └── RadioItemNative.tsx
│ │ ├── RealTimeAdapter
│ │ │ ├── RealTimeAdapter.tsx
│ │ │ └── RealTimeAdapterNative.tsx
│ │ ├── Redirect
│ │ │ ├── Redirect.md
│ │ │ ├── Redirect.spec.ts
│ │ │ └── Redirect.tsx
│ │ ├── ResponsiveBar
│ │ │ ├── README.md
│ │ │ ├── ResponsiveBar.md
│ │ │ ├── ResponsiveBar.module.scss
│ │ │ ├── ResponsiveBar.spec.ts
│ │ │ ├── ResponsiveBar.tsx
│ │ │ └── ResponsiveBarNative.tsx
│ │ ├── Select
│ │ │ ├── HiddenOption.tsx
│ │ │ ├── OptionContext.ts
│ │ │ ├── Select.md
│ │ │ ├── Select.module.scss
│ │ │ ├── Select.spec.ts
│ │ │ ├── Select.tsx
│ │ │ ├── SelectContext.tsx
│ │ │ └── SelectNative.tsx
│ │ ├── SelectionStore
│ │ │ ├── SelectionStore.md
│ │ │ ├── SelectionStore.tsx
│ │ │ └── SelectionStoreNative.tsx
│ │ ├── Slider
│ │ │ ├── Slider.md
│ │ │ ├── Slider.module.scss
│ │ │ ├── Slider.spec.ts
│ │ │ ├── Slider.tsx
│ │ │ └── SliderNative.tsx
│ │ ├── Slot
│ │ │ ├── Slot.md
│ │ │ ├── Slot.spec.ts
│ │ │ └── Slot.ts
│ │ ├── SlotItem.tsx
│ │ ├── SpaceFiller
│ │ │ ├── SpaceFiller.md
│ │ │ ├── SpaceFiller.module.scss
│ │ │ ├── SpaceFiller.spec.ts
│ │ │ ├── SpaceFiller.tsx
│ │ │ └── SpaceFillerNative.tsx
│ │ ├── Spinner
│ │ │ ├── Spinner.md
│ │ │ ├── Spinner.module.scss
│ │ │ ├── Spinner.spec.ts
│ │ │ ├── Spinner.tsx
│ │ │ └── SpinnerNative.tsx
│ │ ├── Splitter
│ │ │ ├── HSplitter.md
│ │ │ ├── HSplitter.spec.ts
│ │ │ ├── Splitter.md
│ │ │ ├── Splitter.module.scss
│ │ │ ├── Splitter.spec.ts
│ │ │ ├── Splitter.tsx
│ │ │ ├── SplitterNative.tsx
│ │ │ ├── utils.ts
│ │ │ ├── VSplitter.md
│ │ │ └── VSplitter.spec.ts
│ │ ├── Stack
│ │ │ ├── CHStack.md
│ │ │ ├── CHStack.spec.ts
│ │ │ ├── CVStack.md
│ │ │ ├── CVStack.spec.ts
│ │ │ ├── HStack.md
│ │ │ ├── HStack.spec.ts
│ │ │ ├── Stack.md
│ │ │ ├── Stack.module.scss
│ │ │ ├── Stack.spec.ts
│ │ │ ├── Stack.tsx
│ │ │ ├── StackNative.tsx
│ │ │ ├── VStack.md
│ │ │ └── VStack.spec.ts
│ │ ├── StickyBox
│ │ │ ├── StickyBox.md
│ │ │ ├── StickyBox.module.scss
│ │ │ ├── StickyBox.tsx
│ │ │ └── StickyBoxNative.tsx
│ │ ├── Switch
│ │ │ ├── Switch.md
│ │ │ ├── Switch.spec.ts
│ │ │ └── Switch.tsx
│ │ ├── Table
│ │ │ ├── doc-resources
│ │ │ │ └── list-component-data.js
│ │ │ ├── react-table-config.d.ts
│ │ │ ├── Table.md
│ │ │ ├── Table.module.scss
│ │ │ ├── Table.spec.ts
│ │ │ ├── Table.tsx
│ │ │ ├── TableNative.tsx
│ │ │ └── useRowSelection.tsx
│ │ ├── TableOfContents
│ │ │ ├── TableOfContents.module.scss
│ │ │ ├── TableOfContents.spec.ts
│ │ │ ├── TableOfContents.tsx
│ │ │ └── TableOfContentsNative.tsx
│ │ ├── Tabs
│ │ │ ├── TabContext.tsx
│ │ │ ├── TabItem.md
│ │ │ ├── TabItem.tsx
│ │ │ ├── TabItemNative.tsx
│ │ │ ├── Tabs.md
│ │ │ ├── Tabs.module.scss
│ │ │ ├── Tabs.spec.ts
│ │ │ ├── Tabs.tsx
│ │ │ └── TabsNative.tsx
│ │ ├── Text
│ │ │ ├── Text.md
│ │ │ ├── Text.module.scss
│ │ │ ├── Text.spec.ts
│ │ │ ├── Text.tsx
│ │ │ └── TextNative.tsx
│ │ ├── TextArea
│ │ │ ├── TextArea.md
│ │ │ ├── TextArea.module.scss
│ │ │ ├── TextArea.spec.ts
│ │ │ ├── TextArea.tsx
│ │ │ ├── TextAreaNative.tsx
│ │ │ ├── TextAreaResizable.tsx
│ │ │ └── useComposedRef.ts
│ │ ├── TextBox
│ │ │ ├── TextBox.md
│ │ │ ├── TextBox.module.scss
│ │ │ ├── TextBox.spec.ts
│ │ │ ├── TextBox.tsx
│ │ │ └── TextBoxNative.tsx
│ │ ├── Theme
│ │ │ ├── NotificationToast.tsx
│ │ │ ├── Theme.md
│ │ │ ├── Theme.module.scss
│ │ │ ├── Theme.spec.ts
│ │ │ ├── Theme.tsx
│ │ │ └── ThemeNative.tsx
│ │ ├── TimeInput
│ │ │ ├── TimeInput.md
│ │ │ ├── TimeInput.module.scss
│ │ │ ├── TimeInput.spec.ts
│ │ │ ├── TimeInput.tsx
│ │ │ ├── TimeInputNative.tsx
│ │ │ └── utils.ts
│ │ ├── Timer
│ │ │ ├── Timer.md
│ │ │ ├── Timer.spec.ts
│ │ │ ├── Timer.tsx
│ │ │ └── TimerNative.tsx
│ │ ├── Toggle
│ │ │ ├── Toggle.module.scss
│ │ │ └── Toggle.tsx
│ │ ├── ToneChangerButton
│ │ │ ├── ToneChangerButton.md
│ │ │ ├── ToneChangerButton.spec.ts
│ │ │ └── ToneChangerButton.tsx
│ │ ├── ToneSwitch
│ │ │ ├── ToneSwitch.md
│ │ │ ├── ToneSwitch.module.scss
│ │ │ ├── ToneSwitch.spec.ts
│ │ │ ├── ToneSwitch.tsx
│ │ │ └── ToneSwitchNative.tsx
│ │ ├── Tooltip
│ │ │ ├── Tooltip.md
│ │ │ ├── Tooltip.module.scss
│ │ │ ├── Tooltip.spec.ts
│ │ │ ├── Tooltip.tsx
│ │ │ └── TooltipNative.tsx
│ │ ├── Tree
│ │ │ ├── testData.ts
│ │ │ ├── Tree-dynamic.spec.ts
│ │ │ ├── Tree-icons.spec.ts
│ │ │ ├── Tree.md
│ │ │ ├── Tree.spec.ts
│ │ │ ├── TreeComponent.module.scss
│ │ │ ├── TreeComponent.tsx
│ │ │ └── TreeNative.tsx
│ │ ├── TreeDisplay
│ │ │ ├── TreeDisplay.md
│ │ │ ├── TreeDisplay.module.scss
│ │ │ ├── TreeDisplay.tsx
│ │ │ └── TreeDisplayNative.tsx
│ │ ├── ValidationSummary
│ │ │ ├── ValidationSummary.module.scss
│ │ │ └── ValidationSummary.tsx
│ │ └── VisuallyHidden.tsx
│ ├── components-core
│ │ ├── abstractions
│ │ │ ├── ComponentRenderer.ts
│ │ │ ├── LoaderRenderer.ts
│ │ │ ├── standalone.ts
│ │ │ └── treeAbstractions.ts
│ │ ├── action
│ │ │ ├── actions.ts
│ │ │ ├── APICall.tsx
│ │ │ ├── FileDownloadAction.tsx
│ │ │ ├── FileUploadAction.tsx
│ │ │ ├── NavigateAction.tsx
│ │ │ └── TimedAction.tsx
│ │ ├── ApiBoundComponent.tsx
│ │ ├── appContext
│ │ │ ├── date-functions.ts
│ │ │ ├── math-function.ts
│ │ │ └── misc-utils.ts
│ │ ├── AppContext.tsx
│ │ ├── behaviors
│ │ │ ├── Behavior.tsx
│ │ │ └── CoreBehaviors.tsx
│ │ ├── component-hooks.ts
│ │ ├── ComponentDecorator.tsx
│ │ ├── ComponentViewer.tsx
│ │ ├── CompoundComponent.tsx
│ │ ├── constants.ts
│ │ ├── DebugViewProvider.tsx
│ │ ├── descriptorHelper.ts
│ │ ├── devtools
│ │ │ ├── InspectorDialog.module.scss
│ │ │ ├── InspectorDialog.tsx
│ │ │ └── InspectorDialogVisibilityContext.tsx
│ │ ├── EngineError.ts
│ │ ├── event-handlers.ts
│ │ ├── InspectorButton.module.scss
│ │ ├── InspectorContext.tsx
│ │ ├── interception
│ │ │ ├── abstractions.ts
│ │ │ ├── ApiInterceptor.ts
│ │ │ ├── ApiInterceptorProvider.tsx
│ │ │ ├── apiInterceptorWorker.ts
│ │ │ ├── Backend.ts
│ │ │ ├── Errors.ts
│ │ │ ├── IndexedDb.ts
│ │ │ ├── initMock.ts
│ │ │ ├── InMemoryDb.ts
│ │ │ ├── ReadonlyCollection.ts
│ │ │ └── useApiInterceptorContext.tsx
│ │ ├── loader
│ │ │ ├── ApiLoader.tsx
│ │ │ ├── DataLoader.tsx
│ │ │ ├── ExternalDataLoader.tsx
│ │ │ ├── Loader.tsx
│ │ │ ├── MockLoaderRenderer.tsx
│ │ │ └── PageableLoader.tsx
│ │ ├── LoaderComponent.tsx
│ │ ├── markup-check.ts
│ │ ├── parts.ts
│ │ ├── renderers.ts
│ │ ├── rendering
│ │ │ ├── AppContent.tsx
│ │ │ ├── AppRoot.tsx
│ │ │ ├── AppWrapper.tsx
│ │ │ ├── buildProxy.ts
│ │ │ ├── collectFnVarDeps.ts
│ │ │ ├── ComponentAdapter.tsx
│ │ │ ├── ComponentWrapper.tsx
│ │ │ ├── Container.tsx
│ │ │ ├── containers.ts
│ │ │ ├── ContainerWrapper.tsx
│ │ │ ├── ErrorBoundary.module.scss
│ │ │ ├── ErrorBoundary.tsx
│ │ │ ├── InvalidComponent.module.scss
│ │ │ ├── InvalidComponent.tsx
│ │ │ ├── nodeUtils.ts
│ │ │ ├── reducer.ts
│ │ │ ├── renderChild.tsx
│ │ │ ├── StandaloneComponent.tsx
│ │ │ ├── StateContainer.tsx
│ │ │ ├── UnknownComponent.module.scss
│ │ │ ├── UnknownComponent.tsx
│ │ │ └── valueExtractor.ts
│ │ ├── reportEngineError.ts
│ │ ├── RestApiProxy.ts
│ │ ├── script-runner
│ │ │ ├── asyncProxy.ts
│ │ │ ├── AttributeValueParser.ts
│ │ │ ├── bannedFunctions.ts
│ │ │ ├── BindingTreeEvaluationContext.ts
│ │ │ ├── eval-tree-async.ts
│ │ │ ├── eval-tree-common.ts
│ │ │ ├── eval-tree-sync.ts
│ │ │ ├── ParameterParser.ts
│ │ │ ├── process-statement-async.ts
│ │ │ ├── process-statement-common.ts
│ │ │ ├── process-statement-sync.ts
│ │ │ ├── ScriptingSourceTree.ts
│ │ │ ├── simplify-expression.ts
│ │ │ ├── statement-queue.ts
│ │ │ └── visitors.ts
│ │ ├── StandaloneApp.tsx
│ │ ├── StandaloneExtensionManager.ts
│ │ ├── TableOfContentsContext.tsx
│ │ ├── theming
│ │ │ ├── _themes.scss
│ │ │ ├── component-layout-resolver.ts
│ │ │ ├── extendThemeUtils.ts
│ │ │ ├── hvar.ts
│ │ │ ├── layout-resolver.ts
│ │ │ ├── parse-layout-props.ts
│ │ │ ├── StyleContext.tsx
│ │ │ ├── StyleRegistry.ts
│ │ │ ├── ThemeContext.tsx
│ │ │ ├── ThemeProvider.tsx
│ │ │ ├── themes
│ │ │ │ ├── base-utils.ts
│ │ │ │ ├── palette.ts
│ │ │ │ ├── root.ts
│ │ │ │ ├── solid.ts
│ │ │ │ ├── theme-colors.ts
│ │ │ │ └── xmlui.ts
│ │ │ ├── themeVars.module.scss
│ │ │ ├── themeVars.ts
│ │ │ ├── transformThemeVars.ts
│ │ │ └── utils.ts
│ │ ├── utils
│ │ │ ├── actionUtils.ts
│ │ │ ├── audio-utils.ts
│ │ │ ├── base64-utils.ts
│ │ │ ├── compound-utils.ts
│ │ │ ├── css-utils.ts
│ │ │ ├── DataLoaderQueryKeyGenerator.ts
│ │ │ ├── date-utils.ts
│ │ │ ├── extractParam.ts
│ │ │ ├── hooks.tsx
│ │ │ ├── LruCache.ts
│ │ │ ├── mergeProps.ts
│ │ │ ├── misc.ts
│ │ │ ├── request-params.ts
│ │ │ ├── statementUtils.ts
│ │ │ └── treeUtils.ts
│ │ └── xmlui-parser.ts
│ ├── index-standalone.ts
│ ├── index.scss
│ ├── index.ts
│ ├── language-server
│ │ ├── server-common.ts
│ │ ├── server-web-worker.ts
│ │ ├── server.ts
│ │ ├── services
│ │ │ ├── common
│ │ │ │ ├── docs-generation.ts
│ │ │ │ ├── lsp-utils.ts
│ │ │ │ ├── metadata-utils.ts
│ │ │ │ └── syntax-node-utilities.ts
│ │ │ ├── completion.ts
│ │ │ ├── diagnostic.ts
│ │ │ ├── format.ts
│ │ │ └── hover.ts
│ │ └── xmlui-metadata-generated.js
│ ├── logging
│ │ ├── LoggerContext.tsx
│ │ ├── LoggerInitializer.tsx
│ │ ├── LoggerService.ts
│ │ └── xmlui.ts
│ ├── logo.svg
│ ├── parsers
│ │ ├── common
│ │ │ ├── GenericToken.ts
│ │ │ ├── InputStream.ts
│ │ │ └── utils.ts
│ │ ├── scripting
│ │ │ ├── code-behind-collect.ts
│ │ │ ├── Lexer.ts
│ │ │ ├── modules.ts
│ │ │ ├── Parser.ts
│ │ │ ├── ParserError.ts
│ │ │ ├── ScriptingNodeTypes.ts
│ │ │ ├── TokenTrait.ts
│ │ │ ├── TokenType.ts
│ │ │ └── tree-visitor.ts
│ │ ├── style-parser
│ │ │ ├── errors.ts
│ │ │ ├── source-tree.ts
│ │ │ ├── StyleInputStream.ts
│ │ │ ├── StyleLexer.ts
│ │ │ ├── StyleParser.ts
│ │ │ └── tokens.ts
│ │ └── xmlui-parser
│ │ ├── CharacterCodes.ts
│ │ ├── diagnostics.ts
│ │ ├── fileExtensions.ts
│ │ ├── index.ts
│ │ ├── lint.ts
│ │ ├── parser.ts
│ │ ├── ParserError.ts
│ │ ├── scanner.ts
│ │ ├── syntax-kind.ts
│ │ ├── syntax-node.ts
│ │ ├── transform.ts
│ │ ├── utils.ts
│ │ ├── xmlui-serializer.ts
│ │ └── xmlui-tree.ts
│ ├── react-app-env.d.ts
│ ├── syntax
│ │ ├── monaco
│ │ │ ├── grammar.monacoLanguage.ts
│ │ │ ├── index.ts
│ │ │ ├── xmlui-dark.ts
│ │ │ ├── xmlui-light.ts
│ │ │ └── xmluiscript.monacoLanguage.ts
│ │ └── textMate
│ │ ├── index.ts
│ │ ├── xmlui-dark.json
│ │ ├── xmlui-light.json
│ │ ├── xmlui.json
│ │ └── xmlui.tmLanguage.json
│ ├── testing
│ │ ├── assertions.ts
│ │ ├── component-test-helpers.ts
│ │ ├── ComponentDrivers.ts
│ │ ├── drivers
│ │ │ ├── DateInputDriver.ts
│ │ │ ├── index.ts
│ │ │ ├── ModalDialogDriver.ts
│ │ │ ├── NumberBoxDriver.ts
│ │ │ ├── TextBoxDriver.ts
│ │ │ ├── TimeInputDriver.ts
│ │ │ ├── TimerDriver.ts
│ │ │ └── TreeDriver.ts
│ │ ├── fixtures.ts
│ │ ├── index.ts
│ │ ├── infrastructure
│ │ │ ├── index.html
│ │ │ ├── main.tsx
│ │ │ ├── public
│ │ │ │ ├── mockServiceWorker.js
│ │ │ │ ├── resources
│ │ │ │ │ ├── bell.svg
│ │ │ │ │ ├── box.svg
│ │ │ │ │ ├── doc.svg
│ │ │ │ │ ├── eye.svg
│ │ │ │ │ ├── flower-640x480.jpg
│ │ │ │ │ ├── sun.svg
│ │ │ │ │ ├── test-image-100x100.jpg
│ │ │ │ │ └── txt.svg
│ │ │ │ └── serve.json
│ │ │ └── TestBed.tsx
│ │ └── themed-app-test-helpers.ts
│ └── vite-env.d.ts
├── tests
│ ├── components
│ │ ├── CodeBlock
│ │ │ └── hightlight-code.test.ts
│ │ ├── playground-pattern.test.ts
│ │ └── Tree
│ │ └── Tree-states.test.ts
│ ├── components-core
│ │ ├── abstractions
│ │ │ └── treeAbstractions.test.ts
│ │ ├── container
│ │ │ └── buildProxy.test.ts
│ │ ├── interception
│ │ │ ├── orderBy.test.ts
│ │ │ ├── ReadOnlyCollection.test.ts
│ │ │ └── request-param-converter.test.ts
│ │ ├── scripts-runner
│ │ │ ├── AttributeValueParser.test.ts
│ │ │ ├── eval-tree-arrow-async.test.ts
│ │ │ ├── eval-tree-arrow.test.ts
│ │ │ ├── eval-tree-func-decl-async.test.ts
│ │ │ ├── eval-tree-func-decl.test.ts
│ │ │ ├── eval-tree-pre-post.test.ts
│ │ │ ├── eval-tree-regression.test.ts
│ │ │ ├── eval-tree.test.ts
│ │ │ ├── function-proxy.test.ts
│ │ │ ├── parser-regression.test.ts
│ │ │ ├── process-event.test.ts
│ │ │ ├── process-function.test.ts
│ │ │ ├── process-implicit-context.test.ts
│ │ │ ├── process-statement-asgn.test.ts
│ │ │ ├── process-statement-destruct.test.ts
│ │ │ ├── process-statement-regs.test.ts
│ │ │ ├── process-statement-sync.test.ts
│ │ │ ├── process-statement.test.ts
│ │ │ ├── process-switch-sync.test.ts
│ │ │ ├── process-switch.test.ts
│ │ │ ├── process-try-sync.test.ts
│ │ │ ├── process-try.test.ts
│ │ │ └── test-helpers.ts
│ │ ├── test-metadata-handler.ts
│ │ ├── theming
│ │ │ ├── border-segments.test.ts
│ │ │ ├── component-layout.resolver.test.ts
│ │ │ ├── layout-property-parser.test.ts
│ │ │ ├── layout-resolver.test.ts
│ │ │ ├── layout-resolver2.test.ts
│ │ │ ├── layout-vp-override.test.ts
│ │ │ └── padding-segments.test.ts
│ │ └── utils
│ │ ├── date-utils.test.ts
│ │ ├── format-human-elapsed-time.test.ts
│ │ └── LruCache.test.ts
│ ├── language-server
│ │ ├── completion.test.ts
│ │ ├── format.test.ts
│ │ ├── hover.test.ts
│ │ └── mockData.ts
│ └── parsers
│ ├── common
│ │ └── input-stream.test.ts
│ ├── markdown
│ │ └── parse-binding-expression.test.ts
│ ├── parameter-parser.test.ts
│ ├── paremeter-parser.test.ts
│ ├── scripting
│ │ ├── eval-tree-arrow.test.ts
│ │ ├── eval-tree-pre-post.test.ts
│ │ ├── eval-tree.test.ts
│ │ ├── function-proxy.test.ts
│ │ ├── lexer-literals.test.ts
│ │ ├── lexer-misc.test.ts
│ │ ├── module-parse.test.ts
│ │ ├── parser-arrow.test.ts
│ │ ├── parser-assignments.test.ts
│ │ ├── parser-binary.test.ts
│ │ ├── parser-destructuring.test.ts
│ │ ├── parser-errors.test.ts
│ │ ├── parser-expressions.test.ts
│ │ ├── parser-function.test.ts
│ │ ├── parser-literals.test.ts
│ │ ├── parser-primary.test.ts
│ │ ├── parser-regex.test.ts
│ │ ├── parser-statements.test.ts
│ │ ├── parser-unary.test.ts
│ │ ├── process-event.test.ts
│ │ ├── process-implicit-context.test.ts
│ │ ├── process-statement-asgn.test.ts
│ │ ├── process-statement-destruct.test.ts
│ │ ├── process-statement-regs.test.ts
│ │ ├── process-statement-sync.test.ts
│ │ ├── process-statement.test.ts
│ │ ├── process-switch-sync.test.ts
│ │ ├── process-switch.test.ts
│ │ ├── process-try-sync.test.ts
│ │ ├── process-try.test.ts
│ │ ├── simplify-expression.test.ts
│ │ ├── statement-hooks.test.ts
│ │ └── test-helpers.ts
│ ├── style-parser
│ │ ├── generateHvarChain.test.ts
│ │ ├── parseHVar.test.ts
│ │ ├── parser.test.ts
│ │ └── tokens.test.ts
│ └── xmlui
│ ├── lint.test.ts
│ ├── parser.test.ts
│ ├── scanner.test.ts
│ ├── transform.attr.test.ts
│ ├── transform.circular.test.ts
│ ├── transform.element.test.ts
│ ├── transform.errors.test.ts
│ ├── transform.escape.test.ts
│ ├── transform.regression.test.ts
│ ├── transform.script.test.ts
│ ├── transform.test.ts
│ └── xmlui.ts
├── tests-e2e
│ ├── api-bound-component-regression.spec.ts
│ ├── api-call-as-extracted-component.spec.ts
│ ├── assign-to-object-or-array-regression.spec.ts
│ ├── binding-regression.spec.ts
│ ├── children-as-template-context-vars.spec.ts
│ ├── compound-component.spec.ts
│ ├── context-vars-regression.spec.ts
│ ├── data-bindings.spec.ts
│ ├── datasource-and-api-usage-in-var.spec.ts
│ ├── datasource-direct-binding.spec.ts
│ ├── datasource-onLoaded-regression.spec.ts
│ ├── modify-array-item-regression.spec.ts
│ ├── namespaces.spec.ts
│ ├── push-to-array-regression.spec.ts
│ ├── screen-breakpoints.spec.ts
│ ├── scripting.spec.ts
│ ├── state-scope-in-pages.spec.ts
│ └── state-var-scopes.spec.ts
├── tsconfig.json
├── tsdown.config.ts
├── vite.config.ts
└── vitest.config.ts
```
# Files
--------------------------------------------------------------------------------
/xmlui/src/components-core/theming/_themes.scss:
--------------------------------------------------------------------------------
```scss
@use "sass:string";
@use "sass:meta";
@use "sass:map";
@use "sass:list";
/*
* This file contains all CSS variables AppEngine uses for styling the UI, including individual visual components.
*
* We use a subset of these CSS variables in themes.
*/
// =====================================================================================================================
// We index all theme variables with this prefix to make a distinction from variables defined in other custom themes.
$THEME-VAR-PREFIX: xmlui;
/*
* This function creates a CSS variable name by combining the prefix and the argument variable name
*/
@function createVar($componentVariable) {
@return var(--#{$THEME-VAR-PREFIX}-#{$componentVariable});
}
@function createVarWithDefault($componentVariable, $defaultValue) {
@return var(--#{$THEME-VAR-PREFIX}-#{$componentVariable}, $defaultValue);
}
@function countSubstring($string, $delimiter: null) {
@if (meta.type-of($string) != "string") {
@return -1;
}
$list: ();
$length: string.length($string);
$count: 0;
$index: string.index($string, $delimiter);
$temp: $string;
@while $index != null {
$count: $count + 1;
$temp: string.slice($temp, $index + 1);
$index: string.index($temp, $delimiter);
}
@return $count;
}
/*
* This function allows other CSS modules to get the value of the CSS variable specified in $componentVariable.
Optionally, you can provide a $fallbackValue to set the variable's value if that is not defined.
*/
@function useVarInner($componentVariable, $fallbackValue: false) {
@if $fallbackValue {
$num: countSubstring($componentVariable, "var(");
@if ($num <= 1) {
@return var(#{str-slice($componentVariable, 5, -2)}, #{$fallbackValue});
}
//we offset with the number of 'vars' in the $componentVariable, because we have to offset backwards for the closing parenthesis
// typically when in a useVar we have a hVar as the first argument
$offset: -2;
@if ($num > 1) {
$offset: (-1 * $num) - 1;
}
//@if(string.index(#{$fallbackValue}, 'fontSize-sm')) {
// @debug 'original: ' + #{$componentVariable} + ", varcount: " + $num;
// @debug 'concatet:' + var(#{str-slice($componentVariable, 5, -2)}, #{$fallbackValue});
// @debug 'concat 2:' + var(#{str-slice($componentVariable, 5, $offset)}, #{$fallbackValue});
//}
@return string.unquote(
"var(#{str-slice($componentVariable, 5, $offset)}, #{$fallbackValue}#{str-slice($componentVariable, $offset + 1)}"
);
} @else {
@return $componentVariable;
}
}
@function reverse($list, $recursive: false) {
$result: ();
@for $i from length($list) * -1 through -1 {
@if type-of(nth($list, abs($i))) == list and $recursive {
$result: append($result, reverse(nth($list, abs($i)), $recursive));
} @else {
$result: append($result, nth($list, abs($i)));
}
}
@return $result;
}
@function useVar($vars...) {
$ret: false;
@each $var in reverse($vars) {
$ret: useVarInner($var, $ret);
}
@return $ret;
}
@function remove-nth($list, $index) {
$result: null;
@if type-of($index) != number {
@warn "$index: #{quote($index)} is not a number for `remove-nth`.";
} @else if $index == 0 {
@warn "List index 0 must be a non-zero integer for `remove-nth`.";
} @else if abs($index) > length($list) {
@warn "List index is #{$index} but list is only #{length($list)} item long for `remove-nth`.";
} @else {
$result: ();
$index: if($index < 0, length($list) + $index + 1, $index);
@for $i from 1 through length($list) {
@if $i != $index {
$result: append($result, nth($list, $i));
}
}
}
@return $result;
}
@function generate-combinations($list, $used: ()) {
$result: ();
@each $item in $list {
@if not index($used, $item) {
$result: append($result, $item, comma);
$used: append($used, $item, comma);
@if length($list) > 1 {
$rest: remove-nth($list, index($list, $item));
$combinations: generate-combinations($rest, $used);
@each $combination in $combinations {
$result: append($result, join($item, $combination), comma);
}
}
}
}
@return $result;
}
@function compare($string-a, $string-b) {
@return str-length($string-a) > str-length($string-b);
}
@function quick-sort($list) {
$less: ();
$equal: ();
$large: ();
@if length($list) > 1 {
$seed: nth($list, ceil(calc(length($list) / 2)));
@each $item in $list {
@if $item == $seed {
$equal: append($equal, $item, list-separator($list));
} @else if compare($item, $seed) {
$less: append($less, $item, list-separator($list));
} @else if not compare($item, $seed) {
$large: append($large, $item, list-separator($list));
}
}
@return join(join(quick-sort($less), $equal), quick-sort($large));
}
@return $list;
}
@function capitalize($string) {
@return to-upper-case(str-slice($string, 1, 1)) + str-slice($string, 2);
}
@function createHVar($attribute, $component, $traits: (), $states: (), $fallback: false) {
$stateCombinations: generate-combinations($states);
$sortedStateCombinations: ();
@each $stateComb in $stateCombinations {
$result: "";
@each $st in $stateComb {
$result: #{$result}--#{$st};
}
$sortedStateCombinations: append($sortedStateCombinations, $result);
}
$sortedStateCombinations: append($sortedStateCombinations, "");
$sortedStateCombinations: quick-sort($sortedStateCombinations);
$traitCombinations: generate-combinations($traits);
$sortedTraitCombinations: ();
@each $traitComb in $traitCombinations {
$result: "";
@each $st in $traitComb {
$result: #{$result}-#{$st};
}
$sortedTraitCombinations: append($sortedTraitCombinations, $result);
}
$sortedTraitCombinations: append($sortedTraitCombinations, "");
$sortedTraitCombinations: quick-sort($sortedTraitCombinations);
//@debug "trait combs: #{$sortedTraitCombinations}";
//@debug "state combs: #{$sortedStateCombinations}";
$base: #{$attribute}-#{capitalize($component)};
$vars: ();
@each $stateComb in $sortedStateCombinations {
@each $traitComb in $sortedTraitCombinations {
$vars: append($vars, createVar(#{$base}#{$traitComb}#{$stateComb}));
}
}
@if ($fallback != false) {
$vars: append($vars, $fallback);
}
@return useVar($vars...);
}
@function str-split($string, $separator) {
// empty array/list
$split-arr: ();
// first index of separator in string
$index: str-index($string, $separator);
// loop through string
@while $index != null {
// get the substring from the first character to the separator
$item: str-slice($string, 1, $index - 1);
// push item to array
$split-arr: append($split-arr, $item);
// remove item and separator from string
$string: str-slice($string, $index + 1);
// find new index of separator
$index: str-index($string, $separator);
}
// add the remaining string to list (the last item)
$split-arr: append($split-arr, $string);
@return $split-arr;
}
@function appendThemeVar($themeVars, $componentVariable) {
$split: str-split($componentVariable, ":");
$varName: list.nth($split, -1);
$cssVar: createVar($varName);
$themeVars: map.set($themeVars, #{$componentVariable}, $cssVar);
@return $themeVars;
}
@function appendThemeVarWithDefault($themeVars, $componentVariable, $defaultValue) {
$split: str-split($componentVariable, ":");
$varName: list.nth($split, -1);
$cssVar: createVarWithDefault($varName, $defaultValue);
$themeVars: map.set($themeVars, #{$componentVariable}, $cssVar);
@return $themeVars;
}
@function appendThemeVarWithFallback($themeVars, $componentVariable, $fallbackVar) {
$split: str-split($componentVariable, ":");
$varName: list.nth($split, -1);
$fallbackSplit: str-split($fallbackVar, ":");
$fallbackVarName: list.nth($fallbackSplit, -1);
$defaultValue: createVar($fallbackVarName);
$cssVar: createVarWithDefault($varName, $defaultValue);
$themeVars: map.set($themeVars, #{$componentVariable}, $cssVar);
@return $themeVars;
}
@function getThemeVar($themeVars, $componentVariable) {
@return map.get($themeVars, $componentVariable);
}
@function json-stringify($var) {
$var-type: type-of($var);
$encode-func-name: "_encode-#{$var-type}";
@if (function-exists($encode-func-name)) {
$encode-func: get-function($encode-func-name);
@return call($encode-func, $var);
}
@return $var; // strings and booleans don't need to be modified
}
@function stringify($var) {
@return '"#{$var}"';
}
@function _encode-string($string) {
@return stringify($string);
}
@function _encode-number($number) {
@if (unitless($number)) {
@return $number;
}
@return stringify($number);
}
@function _encode-null($string) {
@return "null";
}
@function _encode-color($color) {
@return stringify($color);
}
@function _encode-list($list) {
@return _encode-iterable($list);
}
@function _encode-map($map) {
@return _encode-iterable($map);
}
@function _encode-iterable($iterable) {
$is-list: type-of($iterable) == "list";
$is-map: type-of($iterable) == "map";
$str: "";
$opening-bracket: if($is-list, "[", "{");
$closing-bracket: if($is-list, "]", "}");
@each $key, $value in $iterable {
$entry-string: "";
@if ($is-list) {
$entry-string: json-stringify($key);
} @else if ($is-map) {
$entry-string: stringify($key) + ": " + json-stringify($value);
}
$str: $str + ", " + $entry-string;
}
$str: str-slice($str, 3); // remove leading ', ' from ', entry1, entry2'
@return $opening-bracket + $str + $closing-bracket;
}
// =====================================================================================================================
// Helper functions for theme variables
// This function composes padding variables for a given subject taking into
// account all possible padding directions
@function composePaddingVars($themeVars, $subject) {
$tmp: appendThemeVar($themeVars, "padding-#{$subject}") !global;
$tmpAll: getThemeVar($tmp, "padding-#{$subject}");
$tmp: appendThemeVarWithDefault($tmp, "paddingHorizontal-#{$subject}", $tmpAll) !global;
$tmpHorizontal: getThemeVar($tmp, "paddingHorizontal-#{$subject}");
$tmp: appendThemeVarWithDefault($tmp, "paddingVertical-#{$subject}", $tmpAll) !global;
$tmpVertical: getThemeVar($tmp, "paddingVertical-#{$subject}");
$tmp: appendThemeVarWithDefault($tmp, "paddingLeft-#{$subject}", $tmpHorizontal) !global;
$tmp: appendThemeVarWithDefault($tmp, "paddingRight-#{$subject}", $tmpHorizontal) !global;
$tmp: appendThemeVarWithDefault($tmp, "paddingTop-#{$subject}", $tmpVertical) !global;
$tmp: appendThemeVarWithDefault($tmp, "paddingBottom-#{$subject}", $tmpVertical) !global;
@return $tmp;
}
// This mixin applies padding variables to a given subject
@mixin paddingVars($themeVars, $subject) {
padding: getThemeVar($themeVars, "padding-#{$subject}");
padding-left: getThemeVar($themeVars, "paddingLeft-#{$subject}");
padding-right: getThemeVar($themeVars, "paddingRight-#{$subject}");
padding-top: getThemeVar($themeVars, "paddingTop-#{$subject}");
padding-bottom: getThemeVar($themeVars, "paddingBottom-#{$subject}");
}
// This function composes padding variables for a given subject taking into
// account all possible padding directions
@function composeBorderVars($themeVars, $subject) {
$tmp: appendThemeVar($themeVars, "border-#{$subject}") !global;
$tmpAll: getThemeVar($tmp, "border-#{$subject}");
$tmp: appendThemeVarWithDefault($tmp, "borderHorizontal-#{$subject}", $tmpAll) !global;
$tmpHorizontal: getThemeVar($tmp, "borderHorizontal-#{$subject}");
$tmp: appendThemeVarWithDefault($tmp, "borderVertical-#{$subject}", $tmpAll) !global;
$tmpVertical: getThemeVar($tmp, "borderVertical-#{$subject}");
$tmp: appendThemeVarWithDefault($tmp, "borderLeft-#{$subject}", $tmpHorizontal) !global;
$tmp: appendThemeVarWithDefault($tmp, "borderRight-#{$subject}", $tmpHorizontal) !global;
$tmp: appendThemeVarWithDefault($tmp, "borderTop-#{$subject}", $tmpVertical) !global;
$tmp: appendThemeVarWithDefault($tmp, "borderBottom-#{$subject}", $tmpVertical) !global;
$tmp: appendThemeVar($tmp, "borderWidth-#{$subject}") !global;
$tmpThickness: getThemeVar($tmp, "borderWidth-#{$subject}");
$tmp: appendThemeVarWithDefault($tmp, "borderHorizontalWidth-#{$subject}", $tmpThickness) !global;
$tmpThicknessHorizontal: getThemeVar($tmp, "borderHorizontalWidth-#{$subject}");
$tmp: appendThemeVarWithDefault(
$tmp,
"borderLeftWidth-#{$subject}",
$tmpThicknessHorizontal
) !global;
$tmp: appendThemeVarWithDefault(
$tmp,
"borderRightWidth-#{$subject}",
$tmpThicknessHorizontal
) !global;
$tmp: appendThemeVarWithDefault($tmp, "borderVerticalWidth-#{$subject}", $tmpThickness) !global;
$tmpThicknessVertical: getThemeVar($tmp, "borderVerticalWidth-#{$subject}");
$tmp: appendThemeVarWithDefault(
$tmp,
"borderTopWidth-#{$subject}",
$tmpThicknessVertical
) !global;
$tmp: appendThemeVarWithDefault(
$tmp,
"borderBottomWidth-#{$subject}",
$tmpThicknessVertical
) !global;
$tmp: appendThemeVar($tmp, "borderStyle-#{$subject}") !global;
$tmpStyle: getThemeVar($tmp, "borderStyle-#{$subject}");
$tmp: appendThemeVarWithDefault($tmp, "borderHorizontalStyle-#{$subject}", $tmpStyle) !global;
$tmpStyleHorizontal: getThemeVar($tmp, "borderHorizontalStyle-#{$subject}");
$tmp: appendThemeVarWithDefault($tmp, "borderLeftStyle-#{$subject}", $tmpStyleHorizontal) !global;
$tmp: appendThemeVarWithDefault(
$tmp,
"borderRightStyle-#{$subject}",
$tmpStyleHorizontal
) !global;
$tmp: appendThemeVarWithDefault($tmp, "borderVerticalStyle-#{$subject}", $tmpStyle) !global;
$tmpStyleVertical: getThemeVar($tmp, "borderVerticalStyle-#{$subject}");
$tmp: appendThemeVarWithDefault($tmp, "borderTopStyle-#{$subject}", $tmpStyleVertical) !global;
$tmp: appendThemeVarWithDefault($tmp, "borderBottomStyle-#{$subject}", $tmpStyleVertical) !global;
$tmp: appendThemeVar($tmp, "borderColor-#{$subject}") !global;
$tmpColor: getThemeVar($tmp, "borderColor-#{$subject}");
$tmp: appendThemeVarWithDefault($tmp, "borderHorizontalColor-#{$subject}", $tmpColor) !global;
$tmpColorHorizontal: getThemeVar($tmp, "borderHorizontalColor-#{$subject}");
$tmp: appendThemeVarWithDefault($tmp, "borderLeftColor-#{$subject}", $tmpColorHorizontal) !global;
$tmp: appendThemeVarWithDefault(
$tmp,
"borderRightColor-#{$subject}",
$tmpColorHorizontal
) !global;
$tmp: appendThemeVarWithDefault($tmp, "borderVerticalColor-#{$subject}", $tmpColor) !global;
$tmpColorVertical: getThemeVar($tmp, "borderVerticalColor-#{$subject}");
$tmp: appendThemeVarWithDefault($tmp, "borderTopColor-#{$subject}", $tmpColorVertical) !global;
$tmp: appendThemeVarWithDefault($tmp, "borderBottomColor-#{$subject}", $tmpColorVertical) !global;
$tmpRadius: appendThemeVar($tmp, "borderRadius-#{$subject}") !global;
$tmpRadiusAll: getThemeVar($tmpRadius, "borderRadius-#{$subject}") !global;
$tmp: appendThemeVarWithDefault(
$tmp,
"borderStartStartRadius-#{$subject}",
$tmpRadiusAll
) !global;
$tmp: appendThemeVarWithDefault($tmp, "borderStartEndRadius-#{$subject}", $tmpRadiusAll) !global;
$tmp: appendThemeVarWithDefault($tmp, "borderEndStartRadius-#{$subject}", $tmpRadiusAll) !global;
$tmp: appendThemeVarWithDefault($tmp, "borderEndEndRadius-#{$subject}", $tmpRadiusAll) !global;
$tmp: appendThemeVar($tmp, "borderStyle-#{$subject}") !global;
@return $tmp;
}
// This mixin applies padding variables to a given subject
@mixin borderVars($themeVars, $subject) {
border-left: getThemeVar($themeVars, "borderLeft-#{$subject}");
border-right: getThemeVar($themeVars, "borderRight-#{$subject}");
border-top: getThemeVar($themeVars, "borderTop-#{$subject}");
border-bottom: getThemeVar($themeVars, "borderBottom-#{$subject}");
border-left-style: getThemeVar($themeVars, "borderLeftStyle-#{$subject}");
border-right-style: getThemeVar($themeVars, "borderRightStyle-#{$subject}");
border-top-style: getThemeVar($themeVars, "borderTopStyle-#{$subject}");
border-bottom-style: getThemeVar($themeVars, "borderBottomStyle-#{$subject}");
border-left-width: getThemeVar($themeVars, "borderLeftWidth-#{$subject}");
border-right-width: getThemeVar($themeVars, "borderRightWidth-#{$subject}");
border-top-width: getThemeVar($themeVars, "borderTopWidth-#{$subject}");
border-bottom-width: getThemeVar($themeVars, "borderBottomWidth-#{$subject}");
border-left-color: getThemeVar($themeVars, "borderLeftColor-#{$subject}");
border-right-color: getThemeVar($themeVars, "borderRightColor-#{$subject}");
border-top-color: getThemeVar($themeVars, "borderTopColor-#{$subject}");
border-bottom-color: getThemeVar($themeVars, "borderBottomColor-#{$subject}");
border-radius: getThemeVar($themeVars, "borderRadius-#{$subject}");
border-start-start-radius: getThemeVar($themeVars, "borderStartStartRadius-#{$subject}");
border-start-end-radius: getThemeVar($themeVars, "borderStartEndRadius-#{$subject}");
border-end-start-radius: getThemeVar($themeVars, "borderEndStartRadius-#{$subject}");
border-end-end-radius: getThemeVar($themeVars, "borderEndEndRadius-#{$subject}");
}
// This function composes style variables for setting styles of text elements
@function composeTextVars($themeVars, $subject, $default: false) {
$tmp: if(
$default,
appendThemeVarWithFallback($themeVars, "textColor-#{$subject}", "textColor-#{$default}"),
appendThemeVar($themeVars, "textColor-#{$subject}")
) !global;
$tmp: if(
$default,
appendThemeVarWithFallback($tmp, "fontFamily-#{$subject}", "fontFamily-#{$default}"),
appendThemeVar($tmp, "fontFamily-#{$subject}")
) !global;
$tmp: if(
$default,
appendThemeVarWithFallback($tmp, "fontSize-#{$subject}", "fontSize-#{$default}"),
appendThemeVar($tmp, "fontSize-#{$subject}")
) !global;
$tmp: if(
$default,
appendThemeVarWithFallback($tmp, "fontStyle-#{$subject}", "fontStyle-#{$default}"),
appendThemeVar($tmp, "fontStyle-#{$subject}")
) !global;
$tmp: if(
$default,
appendThemeVarWithFallback($tmp, "fontVariant-#{$subject}", "fontVariant-#{$default}"),
appendThemeVar($tmp, "fontVariant-#{$subject}")
) !global;
$tmp: if(
$default,
appendThemeVarWithFallback($tmp, "fontWeight-#{$subject}", "fontWeight-#{$default}"),
appendThemeVar($tmp, "fontWeight-#{$subject}")
) !global;
$tmp: if(
$default,
appendThemeVarWithFallback($tmp, "fontStretch-#{$subject}", "fontStretch-#{$default}"),
appendThemeVar($tmp, "fontStretch-#{$subject}")
) !global;
$tmp: if(
$default,
appendThemeVarWithFallback(
$tmp,
"textDecorationLine-#{$subject}",
"textDecorationLine-#{$default}"
),
appendThemeVar($tmp, "textDecorationLine-#{$subject}")
) !global;
$tmp: if(
$default,
appendThemeVarWithFallback(
$tmp,
"textDecorationColor-#{$subject}",
"textDecorationColor-#{$default}"
),
appendThemeVar($tmp, "textDecorationColor-#{$subject}")
) !global;
$tmp: if(
$default,
appendThemeVarWithFallback(
$tmp,
"textDecorationStyle-#{$subject}",
"textDecorationStyle-#{$default}"
),
appendThemeVar($tmp, "textDecorationStyle-#{$subject}")
) !global;
$tmp: if(
$default,
appendThemeVarWithFallback(
$tmp,
"textDecorationThickness-#{$subject}",
"textDecorationThickness-#{$default}"
),
appendThemeVar($tmp, "textDecorationThickness-#{$subject}")
) !global;
$tmp: if(
$default,
appendThemeVarWithFallback(
$tmp,
"textUnderlineOffset-#{$subject}",
"textUnderlineOffset-#{$default}"
),
appendThemeVar($tmp, "textUnderlineOffset-#{$subject}")
) !global;
$tmp: if(
$default,
appendThemeVarWithFallback($tmp, "lineHeight-#{$subject}", "lineHeight-#{$default}"),
appendThemeVar($tmp, "lineHeight-#{$subject}")
) !global;
$tmp: if(
$default,
appendThemeVarWithFallback($tmp, "backgroundColor-#{$subject}", "backgroundColor-#{$default}"),
appendThemeVar($tmp, "backgroundColor-#{$subject}")
) !global;
$tmp: if(
$default,
appendThemeVarWithFallback($tmp, "textTransform-#{$subject}", "textTransform-#{$default}"),
appendThemeVar($tmp, "textTransform-#{$subject}")
) !global;
$tmp: if(
$default,
appendThemeVarWithFallback($tmp, "letterSpacing-#{$subject}", "letterSpacing-#{$default}"),
appendThemeVar($tmp, "letterSpacing-#{$subject}")
) !global;
$tmp: if(
$default,
appendThemeVarWithFallback($tmp, "wordSpacing-#{$subject}", "wordSpacing-#{$default}"),
appendThemeVar($tmp, "wordSpacing-#{$subject}")
) !global;
$tmp: if(
$default,
appendThemeVarWithFallback($tmp, "textShadow-#{$subject}", "textShadow-#{$default}"),
appendThemeVar($tmp, "textShadow-#{$subject}")
) !global;
$tmp: if(
$default,
appendThemeVarWithFallback($tmp, "textIndent-#{$subject}", "textIndent-#{$default}"),
appendThemeVar($tmp, "textIndent-#{$subject}")
) !global;
$tmp: if(
$default,
appendThemeVarWithFallback($tmp, "textAlign-#{$subject}", "textAlign-#{$default}"),
appendThemeVar($tmp, "textAlign-#{$subject}")
) !global;
$tmp: if(
$default,
appendThemeVarWithFallback($tmp, "textAlignLast-#{$subject}", "textAlignLast-#{$default}"),
appendThemeVar($tmp, "textAlignLast-#{$subject}")
) !global;
$tmp: if(
$default,
appendThemeVarWithFallback($tmp, "wordBreak-#{$subject}", "wordBreak-#{$default}"),
appendThemeVar($tmp, "wordBreak-#{$subject}")
) !global;
$tmp: if(
$default,
appendThemeVarWithFallback($tmp, "wordWrap-#{$subject}", "wordWrap-#{$default}"),
appendThemeVar($tmp, "wordWrap-#{$subject}")
) !global;
$tmp: if(
$default,
appendThemeVarWithFallback($tmp, "direction-#{$subject}", "direction-#{$default}"),
appendThemeVar($tmp, "direction-#{$subject}")
) !global;
$tmp: if(
$default,
appendThemeVarWithFallback($tmp, "writingMode-#{$subject}", "writingMode-#{$default}"),
appendThemeVar($tmp, "writingMode-#{$subject}")
) !global;
$tmp: if(
$default,
appendThemeVarWithFallback($tmp, "lineBreak-#{$subject}", "lineBreak-#{$default}"),
appendThemeVar($tmp, "lineBreak-#{$subject}")
) !global;
@return $tmp;
}
@mixin textVars($themeVars, $subject) {
color: getThemeVar($themeVars, "textColor-#{$subject}");
font-family: getThemeVar($themeVars, "fontFamily-#{$subject}");
font-size: getThemeVar($themeVars, "fontSize-#{$subject}");
font-style: getThemeVar($themeVars, "fontStyle-#{$subject}");
font-weight: getThemeVar($themeVars, "fontWeight-#{$subject}");
font-stretch: getThemeVar($themeVars, "fontStretch-#{$subject}");
text-decoration-line: getThemeVar($themeVars, "textDecorationLine-#{$subject}");
text-decoration-color: getThemeVar($themeVars, "textDecorationColor-#{$subject}");
text-decoration-style: getThemeVar($themeVars, "textDecorationStyle-#{$subject}");
text-decoration-thickness: getThemeVar($themeVars, "textDecorationThickness-#{$subject}");
text-underline-offset: getThemeVar($themeVars, "textUnderlineOffset-#{$subject}");
line-height: getThemeVar($themeVars, "lineHeight-#{$subject}");
background-color: getThemeVar($themeVars, "backgroundColor-#{$subject}");
text-transform: getThemeVar($themeVars, "textTransform-#{$subject}");
letter-spacing: getThemeVar($themeVars, "letterSpacing-#{$subject}");
word-spacing: getThemeVar($themeVars, "wordSpacing-#{$subject}");
text-shadow: getThemeVar($themeVars, "textShadow-#{$subject}");
text-indent: getThemeVar($themeVars, "textIndent-#{$subject}");
text-align: getThemeVar($themeVars, "textAlign-#{$subject}");
text-align-last: getThemeVar($themeVars, "textAlignLast-#{$subject}");
word-break: getThemeVar($themeVars, "wordBreak-#{$subject}");
word-wrap: getThemeVar($themeVars, "wordWrap-#{$subject}");
direction: getThemeVar($themeVars, "direction-#{$subject}");
writing-mode: getThemeVar($themeVars, "writingMode-#{$subject}");
line-break: getThemeVar($themeVars, "lineBreak-#{$subject}");
}
@mixin ignoreTextVars() {
color: inherit !important;
font-family: inherit !important;
font-size: inherit !important;
font-style: inherit !important;
font-weight: inherit !important;
font-stretch: inherit !important;
text-decoration-line: inherit !important;
text-decoration-color: inherit !important;
text-decoration-style: inherit !important;
text-decoration-thickness: inherit !important;
text-underline-offset: inherit !important;
line-height: inherit !important;
background-color: inherit !important;
text-transform: inherit !important;
letter-spacing: inherit !important;
word-spacing: inherit !important;
text-shadow: inherit !important;
text-indent: inherit !important;
text-align: inherit !important;
text-align-last: inherit !important;
word-break: inherit !important;
word-wrap: inherit !important;
direction: inherit !important;
writing-mode: inherit !important;
line-break: inherit !important;
}
@mixin withMaxScreenSize($maxScreenSize) {
$query: "";
@for $i from 0 through $maxScreenSize {
@if $query == "" {
$query: "style(--screenSize: #{$i})";
} @else {
$query: "#{$query} or style(--screenSize: #{$i})";
}
}
@container (#{$query}) {
@content;
}
}
// =====================================================================================================================
// CSS variables for miscellaneous shadows
$boxShadow:
0 1px 3px 0 rgba(0, 0, 0, 0.1),
0 1px 2px 0 rgba(0, 0, 0, 0.06);
$boxShadow-md:
0 4px 6px -1px rgba(0, 0, 0, 0.1),
0 2px 4px -1px rgba(0, 0, 0, 0.06);
$boxShadow-xxl:
0 8px 17px 0 rgba(0, 0, 0, 0.2),
0 6px 20px 0 rgba(0, 0, 0, 0.19);
$boxShadow-spread: 0px 0px 30px rgba(0, 0, 0, 0.1);
$boxShadow-spread-2: -6px -4px 40px 10px rgba(0, 0, 0, 0.1);
$boxShadow-spread-2-xl: -6px -4px 40px 18px rgba(0, 0, 0, 0.1);
// CSS variables describing spacing between UI elements
$space-0: createVar(space-0);
$space-0_5: createVar(space-0_5);
$space-1: createVar(space-1);
$space-1_5: createVar(space-1_5);
$space-2: createVar(space-2);
$space-2_5: createVar(space-2_5);
$space-3: createVar(space-3);
$space-3_5: createVar(space-3_5);
$space-4: createVar(space-4);
$space-5: createVar(space-5);
$space-6: createVar(space-6);
$space-7: createVar(space-7);
$space-8: createVar(space-8);
$space-9: createVar(space-9);
$space-10: createVar(space-10);
$space-11: createVar(space-11);
$space-12: createVar(space-12);
$space-14: createVar(space-14);
$space-16: createVar(space-16);
$space-20: createVar(space-20);
$space-24: createVar(space-24);
$space-28: createVar(space-28);
$space-32: createVar(space-32);
$space-36: createVar(space-36);
$space-40: createVar(space-40);
$space-44: createVar(space-44);
$space-48: createVar(space-48);
$space-52: createVar(space-52);
$space-56: createVar(space-56);
$space-60: createVar(space-60);
$space-64: createVar(space-64);
$space-72: createVar(space-72);
$space-80: createVar(space-80);
$space-96: createVar(space-96);
// ---------------------------------------------------------------------------------------------------------------------
// Generic style variables
$textColor-primary: createVar(textColor-primary);
$textColor-attention: createVar(textColor-attention);
$backgroundColor-attention: createVar(backgroundColor-attention);
$textColor-subtitle: createVar(textColor-subtitle);
$backgroundColor-primary: createVar(backgroundColor-primary);
$backgroundColor-secondary: createVar(backgroundColor-secondary);
$backgroundColor-Input-default: createVar(backgroundColor-Input-default);
$textColor--disabled: createVar(textColor--disabled);
$backgroundColor--disabled: createVar(backgroundColor--disabled);
$borderColor--disabled: createVar(borderColor--disabled);
$backgroundColor--selected: createVar(backgroundColor--selected);
$fontFamily: createVar(fontFamily);
$fontSize-tiny: createVar(fontSize-tiny);
$fontSize-xs: createVar(fontSize-xs);
$fontSize-sm: createVar(fontSize-sm);
$fontSize-base: createVar(fontSize-base);
$fontSize-xl: createVar(fontSize-xl);
$fontSize-2xl: createVar(fontSize-2xl);
$backgroundColor-overlay: createVar(backgroundColor-overlay);
$color-info: createVar(color-info);
$color-valid: createVar(color-valid);
$color-warning: createVar(color-warning);
$color-error: createVar(color-error);
$borderColor: createVar(borderColor);
$maxWidth-content: createVar(maxWidth-content);
$direction: createVar(direction);
$font-feature-settings: createVar(font-feature-settings);
$outlineColor--focus: createVar(outlineColor--focus);
$outlineWidth--focus: createVar(outlineWidth--focus);
$outlineStyle--focus: createVar(outlineStyle--focus);
$outlineOffset--focus: createVar(outlineOffset--focus);
$focus-outline: $outlineWidth--focus $outlineStyle--focus $outlineColor--focus;
$media-max-width-phone: createVar(media-max-width-phone);
$media-max-width-tablet: createVar(media-max-width-tablet);
// ---------------------------------------------------------------------------------------------------------------------
// Dropdown style variables
$backgroundColor-dropdown-item: createVar(backgroundColor-dropdown-item);
$backgroundColor-dropdown-item--active: createVar(backgroundColor-dropdown-item--active);
$borderColor-dropdown-item: createVar(borderColor-dropdown-item);
// ---------------------------------------------------------------------------------------------------------------------
// Tree style variables
$backgroundColor-tree-row--selected--before: createVar(backgroundColor-tree-row--selected--before);
// ---------------------------------------------------------------------------------------------------------------------
// Input border style variables
$borderColor-Input-default: createVar(borderColor-Input-default);
$borderColor-Input-default--hover: createVar(borderColor-Input-default--hover);
$borderColor-Input-default--success: createVar(borderColor-Input-default--success);
$borderColor-Input-default--warning: createVar(borderColor-Input-default--warning);
$borderColor-Input-default--error: createVar(borderColor-Input-default--error);
// ---------------------------------------------------------------------------------------------------------------------
// InputLabel style variables
$textColor-InputLabel-required: createVar(textColor-InputLabel-required);
// ---------------------------------------------------------------------------------------------------------------------
// formItem style variables
$textColor-FormItemLabel: createVar(textColor-FormItemLabel);
$fontSize-FormItemLabel: createVar(fontSize-FormItemLabel);
$fontWeight-FormItemLabel: createVar(fontWeight-FormItemLabel);
//----------------------------------------------------------------------------------------------------------------------
// Tab style variables
$color-primary-500: createVar(color-primary-500);
$color-danger-500: createVar(color-danger-500);
$backgroundColor: createVar(backgroundColor);
$textColor-secondary: createVar(textColor-secondary);
$fontWeight-light: createVar(fontWeight-light);
$fontWeight-normal: createVar(fontWeight-normal);
$fontWeight-medium: createVar(fontWeight-medium);
$fontWeight-bold: createVar(fontWeight-bold);
$borderRadius: createVar(borderRadius);
// body
$fontSize: createVar(fontSize);
$fontWeight: createVar(fontWeight);
```
--------------------------------------------------------------------------------
/docs/content/components/List.md:
--------------------------------------------------------------------------------
```markdown
# List [#list]
`List` is a high-performance, virtualized container for rendering large datasets with built-in grouping, sorting, and visual formatting. It only renders visible items in the viewport, making it ideal for displaying thousands of records while maintaining smooth scrolling performance.
**Key features:**
- **Virtualization**: Renders only visible items for optimal performance with large datasets
- **Advanced grouping**: Group data by any field with customizable headers and footers
- **Built-in sorting**: Sort by any data field in ascending or descending order
- **Visual formatting**: Pre-styled list appearance with borders, spacing, and layout
- **Pagination support**: Handle large datasets with built-in pagination controls
- **Empty state handling**: Customizable templates for when no data is available
**List vs Items:**
Use `List` for complex data presentation requiring performance optimization, grouping, sorting, or visual formatting. Use `Items` for simple data iteration without layout requirements.
In the following examples all use the same list of data which looks like so:
| Id | Name | Quantity | Unit | Category | Key |
| :--- | :------ | :------- | :----- | :--------- | :--- |
| 0 | Apples | 5 | pieces | fruits | 5 |
| 1 | Bananas | 6 | pieces | fruits | 4 |
| 2 | Carrots | 100 | grams | vegetables | 3 |
| 3 | Spinach | 1 | bunch | vegetables | 2 |
| 4 | Milk | 10 | liter | diary | 1 |
| 5 | Cheese | 200 | grams | diary | 0 |
The data is provided as JSON.
**Context variables available during execution:**
- `$group`: Group information when using `groupBy` (available in group templates)
- `$isFirst`: Boolean indicating if this is the first item
- `$isLast`: Boolean indicating if this is the last item
- `$item`: Current data item being rendered
- `$itemIndex`: Zero-based index of current item
## Use children as Content Template [#use-children-as-content-template]
The [itemTemplate](#itemtemplate) property can be replaced by setting the item template component directly as the List's child.
In the following example, the two List are functionally the same:
```xmlui copy
<App>
<!-- This is the same -->
<List>
<property name="itemTemplate">
<Text>Template</Text>
</property>
</List>
<!-- As this -->
<List>
<Text>Template</Text>
</List>
</App>
```
## Properties [#properties]
### `availableGroups` [#availablegroups]
This property is an array of group names that the `List` will display. If not set, all groups in the data are displayed.
```xmlui {5}
<App>
<List
data="{[...]}"
groupBy="category"
availableGroups="{['fruits', 'vegetables']}">
<property name="groupHeaderTemplate">
<Stack>
<Text variant="subtitle" value="{$group.key}" />
</Stack>
</property>
</List>
</App>
```
```xmlui-pg name="Example: availableGroups" height="400px"
<App>
<List availableGroups="{['fruits', 'vegetables']}" groupBy="category"
data='{[
{
id: 0,
name: "Apples",
quantity: 5,
unit: "pieces",
category: "fruits",
key: 5,
},
{
id: 1,
name: "Bananas",
quantity: 6,
unit: "pieces",
category: "fruits",
key: 4,
},
{
id: 2,
name: "Carrots",
quantity: 100,
unit: "grams",
category: "vegetables",
key: 3,
},
{
id: 3,
name: "Spinach",
quantity: 1,
unit: "bunch",
category: "vegetables",
key: 2,
},
{
id: 4,
name: "Milk",
quantity: 10,
unit: "liter",
category: "dairy",
key: 1,
},
{
id: 5,
name: "Cheese",
quantity: 200,
unit: "grams",
category: "dairy",
key: 0,
},
]}'>
<property name="groupHeaderTemplate">
<Stack>
<Text variant="subtitle" value="{$group.key}" />
</Stack>
</property>
</List>
</App>
```
### `borderCollapse` (default: true) [#bordercollapse-default-true]
Collapse items borders
Note how the `List` on the right has different borders:
```xmlui /borderCollapse/
<App>
<HStack>
<List data="{[...]}" groupBy="category" borderCollapse="false" width="$space-48">
<property name="groupHeaderTemplate">
<Stack>
<Text variant="subtitle" value="{$group.key}" />
</Stack>
</property>
</List>
<List data="{[...]}" groupBy="category" borderCollapse="true" width="$space-48">
<property name="groupHeaderTemplate">
<Stack>
<Text variant="subtitle" value="{$group.key}" />
</Stack>
</property>
</List>
</HStack>
</App>
```
```xmlui-pg name="Example: borderCollapse" height="400px"
<App>
<HStack>
<List data='{[
{
id: 0,
name: "Apples",
quantity: 5,
unit: "pieces",
category: "fruits",
key: 5,
},
{
id: 1,
name: "Bananas",
quantity: 6,
unit: "pieces",
category: "fruits",
key: 4,
},
{
id: 2,
name: "Carrots",
quantity: 100,
unit: "grams",
category: "vegetables",
key: 3,
},
{
id: 3,
name: "Spinach",
quantity: 1,
unit: "bunch",
category: "vegetables",
key: 2,
},
{
id: 4,
name: "Milk",
quantity: 10,
unit: "liter",
category: "dairy",
key: 1,
},
{
id: 5,
name: "Cheese",
quantity: 200,
unit: "grams",
category: "dairy",
key: 0,
},
]}'
groupBy="category" borderCollapse="false" width="$space-48">
<property name="groupHeaderTemplate">
<Stack>
<Text variant="subtitle" value="{$group.key}" />
</Stack>
</property>
</List>
<List data='{[
{
id: 0,
name: "Apples",
quantity: 5,
unit: "pieces",
category: "fruits",
key: 5,
},
{
id: 1,
name: "Bananas",
quantity: 6,
unit: "pieces",
category: "fruits",
key: 4,
},
{
id: 2,
name: "Carrots",
quantity: 100,
unit: "grams",
category: "vegetables",
key: 3,
},
{
id: 3,
name: "Spinach",
quantity: 1,
unit: "bunch",
category: "vegetables",
key: 2,
},
{
id: 4,
name: "Milk",
quantity: 10,
unit: "liter",
category: "dairy",
key: 1,
},
{
id: 5,
name: "Cheese",
quantity: 200,
unit: "grams",
category: "dairy",
key: 0,
},
]}'
groupBy="category" borderCollapse="true" width="$space-48">
<property name="groupHeaderTemplate">
<Stack>
<Text variant="subtitle" value="{$group.key}" />
</Stack>
</property>
</List>
</HStack>
</App>
```
### `data` [#data]
The component receives data via this property. The `data` property is a list of items that the `List` can display.
Note how the `List` infers the given data and provides a simple layout for it.
To tweak what data and how it is displayed, see the [`itemTemplate` section](#itemtemplate).
```xmlui copy
<App>
<List data='{[...]}' />
</App>
```
```xmlui-pg name="Example: data" height="400px"
<App>
<List data='{[
{
id: 0,
name: "Apples",
quantity: 5,
unit: "pieces",
category: "fruits",
key: 5,
},
{
id: 1,
name: "Bananas",
quantity: 6,
unit: "pieces",
category: "fruits",
key: 4,
},
{
id: 2,
name: "Carrots",
quantity: 100,
unit: "grams",
category: "vegetables",
key: 3,
},
{
id: 3,
name: "Spinach",
quantity: 1,
unit: "bunch",
category: "vegetables",
key: 2,
},
{
id: 4,
name: "Milk",
quantity: 10,
unit: "liter",
category: "dairy",
key: 1,
},
{
id: 5,
name: "Cheese",
quantity: 200,
unit: "grams",
category: "dairy",
key: 0,
},
]}' />
</App>
```
You can also provide the `List` with data directly from an API via this property.
In the example below, the `List` also uses the `itemTemplate` property to access the data attributes as well.
See the [itemTemplate section](#itemtemplate).
```xmlui-pg copy name="Example: data API Call" height="400px"
<App>
<List data='https://api.spacexdata.com/v3/rockets'>
<property name="itemTemplate">
<Card>
<Image height="100px" fit="cover" src="{$item.flickr_images[0]}"/>
<Text value="{$item.country}" />
<Text value="{$item.company}" variant="strong" />
</Card>
</property>
</List>
</App>
```
### `defaultGroups` [#defaultgroups]
This property adds an optional list of default groups for the `List` and displays the group headers in the specified order. If the data contains group headers not in this list, those headers are also displayed (after the ones in this list); however, their order is not deterministic.
>[!INFO]
> For the `defaultGroups` property to work, the data must be sectioned using the [`groupBy`](#groupBy) property, and either a [`groupHeaderTemplate`](#groupHeaderTemplate) or a [`groupFooterTemplate`](#groupFooterTemplate) needs to be provided.
```xmlui copy {4}
<App>
<List
data='{[...]}'
defaultGroups="{['dairy', 'meat', 'vegetables']}"
groupBy="category" >
<property name="groupHeaderTemplate">
<VStack>
<Text variant="subtitle" value="{$group.key}" />
</VStack>
</property>
</List>
</App>
```
```xmlui-pg name="Example: defaultGroups" height="400px"
<App>
<List
data='{[
{
id: 0,
name: "Apples",
quantity: 5,
unit: "pieces",
category: "fruits",
key: 5,
},
{
id: 1,
name: "Bananas",
quantity: 6,
unit: "pieces",
category: "fruits",
key: 4,
},
{
id: 2,
name: "Carrots",
quantity: 100,
unit: "grams",
category: "vegetables",
key: 3,
},
{
id: 3,
name: "Spinach",
quantity: 1,
unit: "bunch",
category: "vegetables",
key: 2,
},
{
id: 4,
name: "Milk",
quantity: 10,
unit: "liter",
category: "dairy",
key: 1,
},
{
id: 5,
name: "Cheese",
quantity: 200,
unit: "grams",
category: "dairy",
key: 0,
},
]}'
defaultGroups="{['dairy', 'meat', 'vegetables']}"
groupBy="category">
<property name="groupHeaderTemplate">
<VStack>
<Text variant="subtitle" value="{$group.key}" />
</VStack>
</property>
</List>
</App>
```
### `emptyListTemplate` [#emptylisttemplate]
This property defines the template to display when the list is empty.
```xmlui-pg copy display name="Example: emptyListTemplate" height="140px"
<App>
<List>
<property name="emptyListTemplate">
<VStack horizontalAlignment="center">
<Text variant="strong" value="Empty..." />
</VStack>
</property>
</List>
</App>
```
### `groupBy` [#groupby]
This property sets which data item property is used to group the list items. If not set, no grouping is done.
>[!INFO]
> For the `groupBy` property to work, either a [`groupHeaderTemplate`](#groupHeaderTemplate)
> or a [`groupFooterTemplate`](#groupFooterTemplate) needs to be provided.
```xmlui copy {3}
<App>
<List
data='{[...]}'
groupBy="category">
<property name="groupHeaderTemplate">
<VStack>
<Text variant="subtitle" value="{$group.key}" />
</VStack>
</property>
</List>
</App>
```
```xmlui-pg name="Example: groupBy" height="400px"
<App>
<List
data='{[
{
id: 0,
name: "Apples",
quantity: 5,
unit: "pieces",
category: "fruits",
key: 5,
},
{
id: 1,
name: "Bananas",
quantity: 6,
unit: "pieces",
category: "fruits",
key: 4,
},
{
id: 2,
name: "Carrots",
quantity: 100,
unit: "grams",
category: "vegetables",
key: 3,
},
{
id: 3,
name: "Spinach",
quantity: 1,
unit: "bunch",
category: "vegetables",
key: 2,
},
{
id: 4,
name: "Milk",
quantity: 10,
unit: "liter",
category: "dairy",
key: 1,
},
{
id: 5,
name: "Cheese",
quantity: 200,
unit: "grams",
category: "dairy",
key: 0,
},
]}'
groupBy="category">
<property name="groupHeaderTemplate">
<VStack>
<Text variant="subtitle" value="{$group.key}" />
</VStack>
</property>
</List>
</App>
```
### `groupFooterTemplate` [#groupfootertemplate]
Enables the customization of how the the footer of each group is displayed. Combine with [`groupHeaderTemplate`](#groupHeaderTemplate) to customize sections. You can use the `$item` context variable to access an item group and map its individual attributes.
The structure of `$group` in a `groupFooterTemplate` is the following:
| Attribute | Description |
| --------- | ------------------------------------------------------------------------------------------------------------- |
| id | Unique identifier for the section. It is commonly generated from the attribute name provided via `groupBy`. |
| items | The items filtered from the original data list that fall into this section. |
| key | The attribute name to section by provided via `groupBy` |
This example displays a separator line in the groups' footer:
```xmlui copy {8-12}
<App>
<List data='{[...]}' groupBy="category">
<property name="groupHeaderTemplate">
<VStack>
<Text variant="subtitle" value="{$group.key}" />
</VStack>
</property>
<property name="groupFooterTemplate">
<VStack paddingVertical="$space-normal">
<ContentSeparator/>
</VStack>
</property>
</List>
</App>
```
```xmlui-pg name="Example: groupFooterTemplate" height="400px"
<App>
<List data='{[
{
id: 0,
name: "Apples",
quantity: 5,
unit: "pieces",
category: "fruits",
key: 5,
},
{
id: 1,
name: "Bananas",
quantity: 6,
unit: "pieces",
category: "fruits",
key: 4,
},
{
id: 2,
name: "Carrots",
quantity: 100,
unit: "grams",
category: "vegetables",
key: 3,
},
{
id: 3,
name: "Spinach",
quantity: 1,
unit: "bunch",
category: "vegetables",
key: 2,
},
{
id: 4,
name: "Milk",
quantity: 10,
unit: "liter",
category: "dairy",
key: 1,
},
{
id: 5,
name: "Cheese",
quantity: 200,
unit: "grams",
category: "dairy",
key: 0,
},
]}'
groupBy="category">
<property name="groupHeaderTemplate">
<VStack>
<Text variant="subtitle" value="{$group.key}" />
</VStack>
</property>
<property name="groupFooterTemplate">
<VStack paddingVertical="$space-normal">
<ContentSeparator/>
</VStack>
</property>
</List>
</App>
```
### `groupHeaderTemplate` [#groupheadertemplate]
Enables the customization of how the groups are displayed, similarly to the [`itemTemplate`](#itemtemplate). You can use the `$item` context variable to access an item group and map its individual attributes.
The structure of `$group` in a `groupHeaderTemplate` is the following:
| Attribute | Description |
| --------- | ------------------------------------------------------------------------------------------------------------- |
| id | Unique identifier for the section. It is commonly generated from the attribute name provided via `groupBy`. |
| items | The items filtered from the original data list that fall into this section. |
| key | The attribute name to section by provided via `groupBy` |
```xmlui copy {3-7}
<App>
<List data='{[...]}' groupBy="category">
<property name="groupHeaderTemplate">
<Stack padding="$space-2">
<Text variant="subtitle" value="{$group.key}" />
</Stack>
</property>
</List>
</App>
```
```xmlui-pg copy name="Example: groupHeaderTemplate" height="400px"
<App>
<List data='{[
{
id: 0,
name: "Apples",
quantity: 5,
unit: "pieces",
category: "fruits",
key: 5,
},
{
id: 1,
name: "Bananas",
quantity: 6,
unit: "pieces",
category: "fruits",
key: 4,
},
{
id: 2,
name: "Carrots",
quantity: 100,
unit: "grams",
category: "vegetables",
key: 3,
},
{
id: 3,
name: "Spinach",
quantity: 1,
unit: "bunch",
category: "vegetables",
key: 2,
},
{
id: 4,
name: "Milk",
quantity: 10,
unit: "liter",
category: "dairy",
key: 1,
},
{
id: 5,
name: "Cheese",
quantity: 200,
unit: "grams",
category: "dairy",
key: 0,
},
]}'
groupBy="category">
<property name="groupHeaderTemplate">
<Stack padding="$space-2">
<Text variant="subtitle" value="{$group.key}" />
</Stack>
</property>
</List>
</App>
```
### `groupsInitiallyExpanded` (default: true) [#groupsinitiallyexpanded-default-true]
This Boolean property defines whether the list groups are initially expanded.
Note how the groups in the right `List` are expanded by default:
```xmlui /groupsInitiallyExpanded/
<App>
<HStack gap="$space-2">
<List data="{[...]}"
groupBy="category"
groupsInitiallyExpanded="false"
width="$space-48">
<property name="groupHeaderTemplate">
<Stack>
<Text variant="subtitle" value="{$group.key}" />
</Stack>
</property>
</List>
<List data="{[...]}"
groupBy="category"
groupsInitiallyExpanded="true"
width="$space-48">
<property name="groupHeaderTemplate">
<Stack>
<Text variant="subtitle" value="{$group.key}" />
</Stack>
</property>
</List>
</HStack>
</App>
```
```xmlui-pg name="Example: groupsInitiallyExpanded" height="400px"
<App>
<HStack gap="$space-2">
<List data='{[
{
id: 0,
name: "Apples",
quantity: 5,
unit: "pieces",
category: "fruits",
key: 5,
},
{
id: 1,
name: "Bananas",
quantity: 6,
unit: "pieces",
category: "fruits",
key: 4,
},
{
id: 2,
name: "Carrots",
quantity: 100,
unit: "grams",
category: "vegetables",
key: 3,
},
{
id: 3,
name: "Spinach",
quantity: 1,
unit: "bunch",
category: "vegetables",
key: 2,
},
{
id: 4,
name: "Milk",
quantity: 10,
unit: "liter",
category: "dairy",
key: 1,
},
{
id: 5,
name: "Cheese",
quantity: 200,
unit: "grams",
category: "dairy",
key: 0,
},
]}'
groupBy="category" groupsInitiallyExpanded="false" width="$space-48">
<property name="groupHeaderTemplate">
<Stack>
<Text variant="subtitle" value="{$group.key}" />
</Stack>
</property>
</List>
<List data='{[
{
id: 0,
name: "Apples",
quantity: 5,
unit: "pieces",
category: "fruits",
key: 5,
},
{
id: 1,
name: "Bananas",
quantity: 6,
unit: "pieces",
category: "fruits",
key: 4,
},
{
id: 2,
name: "Carrots",
quantity: 100,
unit: "grams",
category: "vegetables",
key: 3,
},
{
id: 3,
name: "Spinach",
quantity: 1,
unit: "bunch",
category: "vegetables",
key: 2,
},
{
id: 4,
name: "Milk",
quantity: 10,
unit: "liter",
category: "dairy",
key: 1,
},
{
id: 5,
name: "Cheese",
quantity: 200,
unit: "grams",
category: "dairy",
key: 0,
},
]}'
groupBy="category" groupsInitiallyExpanded="true" width="$space-48">
<property name="groupHeaderTemplate">
<Stack>
<Text variant="subtitle" value="{$group.key}" />
</Stack>
</property>
</List>
</HStack>
</App>
```
### `hideEmptyGroups` (default: true) [#hideemptygroups-default-true]
This boolean property indicates if empty groups should be hidden (no header and footer are displayed).
Note how the `meats` category is not displayed in the right `List`:
```xmlui {7, 19}
<App>
<HStack gap="$space-2">
<List
data="{[...]}"
defaultGroups="{['meats']}"
groupBy="category"
hideEmptyGroups="false"
width="$space-48">
<property name="groupHeaderTemplate">
<Stack>
<Text variant="subtitle" value="{$group.key}" />
</Stack>
</property>
</List>
<List
data="{[...]}"
defaultGroups="{['meats']}"
groupBy="category"
hideEmptyGroups="true"
width="$space-48">
<property name="groupHeaderTemplate">
<Stack>
<Text variant="subtitle" value="{$group.key}" />
</Stack>
</property>
</List>
</HStack>
</App>
```
```xmlui-pg name="Example: hideEmptyGroups" height="400px"
<App>
<HStack gap="$space-2">
<List data='{[
{
id: 0,
name: "Apples",
quantity: 5,
unit: "pieces",
category: "fruits",
key: 5,
},
{
id: 1,
name: "Bananas",
quantity: 6,
unit: "pieces",
category: "fruits",
key: 4,
},
{
id: 2,
name: "Carrots",
quantity: 100,
unit: "grams",
category: "vegetables",
key: 3,
},
{
id: 3,
name: "Spinach",
quantity: 1,
unit: "bunch",
category: "vegetables",
key: 2,
},
{
id: 4,
name: "Milk",
quantity: 10,
unit: "liter",
category: "dairy",
key: 1,
},
{
id: 5,
name: "Cheese",
quantity: 200,
unit: "grams",
category: "dairy",
key: 0,
},
]}'
defaultGroups="{['meats']}" groupBy="category" hideEmptyGroups="false" width="$space-48">
<property name="groupHeaderTemplate">
<Stack>
<Text variant="subtitle" value="{$group.key}" />
</Stack>
</property>
</List>
<List data='{[
{
id: 0,
name: "Apples",
quantity: 5,
unit: "pieces",
category: "fruits",
key: 5,
},
{
id: 1,
name: "Bananas",
quantity: 6,
unit: "pieces",
category: "fruits",
key: 4,
},
{
id: 2,
name: "Carrots",
quantity: 100,
unit: "grams",
category: "vegetables",
key: 3,
},
{
id: 3,
name: "Spinach",
quantity: 1,
unit: "bunch",
category: "vegetables",
key: 2,
},
{
id: 4,
name: "Milk",
quantity: 10,
unit: "liter",
category: "dairy",
key: 1,
},
{
id: 5,
name: "Cheese",
quantity: 200,
unit: "grams",
category: "dairy",
key: 0,
},
]}'
defaultGroups="{['meats']}" groupBy="category" hideEmptyGroups="true" width="$space-48">
<property name="groupHeaderTemplate">
<Stack>
<Text variant="subtitle" value="{$group.key}" />
</Stack>
</property>
</List>
</HStack>
</App>
```
### `idKey` (default: "id") [#idkey-default-id]
Denotes which attribute of an item acts as the ID or key of the item
```xmlui /idKey="key"/
<App>
<List idKey="key" data='{[...]}' />
</App>
```
```xmlui-pg name="Example: idKey" height="400px"
<App>
<List idKey="key" data='{[
{
id: 0,
name: "Apples",
quantity: 5,
unit: "pieces",
category: "fruits",
key: 5,
},
{
id: 1,
name: "Bananas",
quantity: 6,
unit: "pieces",
category: "fruits",
key: 4,
},
{
id: 2,
name: "Carrots",
quantity: 100,
unit: "grams",
category: "vegetables",
key: 3,
},
{
id: 3,
name: "Spinach",
quantity: 1,
unit: "bunch",
category: "vegetables",
key: 2,
},
{
id: 4,
name: "Milk",
quantity: 10,
unit: "liter",
category: "dairy",
key: 1,
},
{
id: 5,
name: "Cheese",
quantity: 200,
unit: "grams",
category: "dairy",
key: 0,
},
]}' />
</App>
```
### `itemTemplate` [#itemtemplate]
This property allows the customization of mapping data items to components. You can use the `$item` context variable to access an item and map its individual attributes.
Note how in the example below the `$item` is used to access the `name`, `quantity` and `unit` attributes.
```xmlui copy {3-14}
<App>
<List data='{[...]}'>
<property name="itemTemplate">
<Card>
<HStack verticalAlignment="center">
<Icon name="info" />
<Text value="{$item.name}" variant="strong" />
</HStack>
<HStack>
<Text value="{$item.quantity}" />
<Text value="{$item.unit}" variant="em" />
</HStack>
</Card>
</property>
</List>
</App>
```
```xmlui-pg name="Example: itemTemplate" height="400px"
<App>
<List data='{[
{
id: 0,
name: "Apples",
quantity: 5,
unit: "pieces",
category: "fruits",
key: 5,
},
{
id: 1,
name: "Bananas",
quantity: 6,
unit: "pieces",
category: "fruits",
key: 4,
},
{
id: 2,
name: "Carrots",
quantity: 100,
unit: "grams",
category: "vegetables",
key: 3,
},
{
id: 3,
name: "Spinach",
quantity: 1,
unit: "bunch",
category: "vegetables",
key: 2,
},
{
id: 4,
name: "Milk",
quantity: 10,
unit: "liter",
category: "dairy",
key: 1,
},
{
id: 5,
name: "Cheese",
quantity: 200,
unit: "grams",
category: "dairy",
key: 0,
},
]}'>
<property name="itemTemplate">
<Card>
<HStack verticalAlignment="center">
<Icon name="info" />
<Text value="{$item.name}" variant="strong" />
</HStack>
<HStack>
<Text value="{$item.quantity}" />
<Text value="{$item.unit}" variant="em" />
</HStack>
</Card>
</property>
</List>
</App>
```
### `limit` [#limit]
This property limits the number of items displayed in the `List`. If not set, all items are displayed.
```xmlui /limit="4"/
<App>
<List limit="3" data='{[...]}' />
</App>
```
```xmlui-pg name="Example: limit" height="400px"
<App>
<List limit="3" data='{[
{
id: 0,
name: "Apples",
quantity: 5,
unit: "pieces",
category: "fruits",
key: 5,
},
{
id: 1,
name: "Bananas",
quantity: 6,
unit: "pieces",
category: "fruits",
key: 4,
},
{
id: 2,
name: "Carrots",
quantity: 100,
unit: "grams",
category: "vegetables",
key: 3,
},
{
id: 3,
name: "Spinach",
quantity: 1,
unit: "bunch",
category: "vegetables",
key: 2,
},
{
id: 4,
name: "Milk",
quantity: 10,
unit: "liter",
category: "dairy",
key: 1,
},
{
id: 5,
name: "Cheese",
quantity: 200,
unit: "grams",
category: "dairy",
key: 0,
},
]}' />
</App>
```
### `loading` [#loading]
This property delays the rendering of children until it is set to `false`, or the component receives usable list items via the [`data`](#data) property.
```xmlui-pg copy display name="Example: loading" height="120px"
<App>
<List loading="true" />
</App>
```
### `orderBy` [#orderby]
This optioanl property enables the ordering of list items by specifying an attribute in the data.
```xmlui /orderBy="{{ field: 'quantity', direction: 'desc' }}"/
<App>
<List orderBy="{{ field: 'quantity', direction: 'desc' }}" data='{[...]}' />
</App>
```
```xmlui-pg name="Example: orderBy" height="400px"
<App>
<List
orderBy="{{ field: 'quantity', direction: 'desc' }}"
data='{[
{
id: 0,
name: "Apples",
quantity: 5,
unit: "pieces",
category: "fruits",
key: 5,
},
{
id: 1,
name: "Bananas",
quantity: 6,
unit: "pieces",
category: "fruits",
key: 4,
},
{
id: 2,
name: "Carrots",
quantity: 100,
unit: "grams",
category: "vegetables",
key: 3,
},
{
id: 3,
name: "Spinach",
quantity: 1,
unit: "bunch",
category: "vegetables",
key: 2,
},
{
id: 4,
name: "Milk",
quantity: 10,
unit: "liter",
category: "dairy",
key: 1,
},
{
id: 5,
name: "Cheese",
quantity: 200,
unit: "grams",
category: "dairy",
key: 0,
},
]}' />
</App>
```
### `pageInfo` [#pageinfo]
This property contains the current page information. Setting this property also enures the `List` uses pagination.
It contains the following boolean attributes:
| Attribute | Description |
| :------------------- | :------------------------------------|
| `hasPrevPage` | Does the list have a previous page |
| `hasNextPage` | Does the list have a next page |
| `isFetchingPrevPage` | _TBD_ |
| `isFetchingNextPage` | _TBD_ |
### `scrollAnchor` (default: "top") [#scrollanchor-default-top]
This property pins the scroll position to a specified location of the list. Available values are shown below.
Available values: `top` **(default)**, `bottom`
```xmlui /scrollAnchor="bottom"/
<App>
<List scrollAnchor="bottom" data='{[...]}' height="300px" />
</App>
```
```xmlui-pg name="Example: scrollAnchor" height="380px"
<App>
<List scrollAnchor="bottom" height="300px" data='{[
{
id: 0,
name: "Apples",
quantity: 5,
unit: "pieces",
category: "fruits",
key: 5,
},
{
id: 1,
name: "Bananas",
quantity: 6,
unit: "pieces",
category: "fruits",
key: 4,
},
{
id: 2,
name: "Carrots",
quantity: 100,
unit: "grams",
category: "vegetables",
key: 3,
},
{
id: 3,
name: "Spinach",
quantity: 1,
unit: "bunch",
category: "vegetables",
key: 2,
},
{
id: 4,
name: "Milk",
quantity: 10,
unit: "liter",
category: "dairy",
key: 1,
},
{
id: 5,
name: "Cheese",
quantity: 200,
unit: "grams",
category: "dairy",
key: 0,
},
]}' />
</App>
```
## Events [#events]
This component does not have any events.
## Exposed Methods [#exposed-methods]
### `scrollToBottom` [#scrolltobottom]
This method scrolls the list to the bottom.
**Signature**: `scrollToBottom(): void`
The following example demonstrates `scrollToBottom` and all the other scroll methods:
```xmlui-pg copy display name="Example: data API Call" height="400px"
<App layout="condensed-sticky">
<AppHeader>
<HStack>
<Button onClick="myList.scrollToBottom()">Scroll to Bottom</Button>
<Button onClick="myList.scrollToTop()">Scroll to Top</Button>
<Button onClick="myList.scrollToIndex(25)">Scroll to #25</Button>
<Button onClick="myList.scrollToId('item-40')">Scroll to ID 'item-40'</Button>
</HStack>
</AppHeader>
<List
id="myList"
data="{
Array.from({ length: 100 })
.map((_, i) => ({id: 'item-' + i, value: 'Item #' + i}))
}">
<property name="itemTemplate">
<Card>
<Text value="{$item.value}" />
</Card>
</property>
</List>
</App>
```
### `scrollToId` [#scrolltoid]
This method scrolls the list to a specific item. The method accepts an item ID as a parameter.
**Signature**: `scrollToId(id: string): void`
- `id`: The ID of the item to scroll to.
See the [`scrollToBottom`](#scrolltobottom) example.
### `scrollToIndex` [#scrolltoindex]
This method scrolls the list to a specific index. The method accepts an index as a parameter.
**Signature**: `scrollToIndex(index: number): void`
- `index`: The index to scroll to.
See the [`scrollToBottom`](#scrolltobottom) example.
### `scrollToTop` [#scrolltotop]
This method scrolls the list to the top.
**Signature**: `scrollToTop(): void`
See the [`scrollToBottom`](#scrolltobottom) example.
## Styling [#styling]
`List` is a layout container; its purpose is to render nested child components.
`List` has no theme variables to change its visual appearance.
```
