Skip to content

docs(core/application): Skip link for the ix-application component - #271

Open
dmytro-halimov wants to merge 1 commit into
mainfrom
feature/skip-links
Open

docs(core/application): Skip link for the ix-application component#271
dmytro-halimov wants to merge 1 commit into
mainfrom
feature/skip-links

Conversation

@dmytro-halimov

@dmytro-halimov dmytro-halimov commented Jul 29, 2026

Copy link
Copy Markdown
Collaborator

Main repo PR: siemens/ix#2670

🆕 What is the new behavior?

Add a default-on skip link to ix-application for bypassing repeated application-shell content, including configurable destination targeting with focus and scroll management, localized link text, and an explicit opt-out for applications that provide their own bypass mechanism.

👨‍💻 Help & support

@dmytro-halimov dmytro-halimov changed the title docs(core/application): Skip link for the ix-application comp… docs(core/application): Skip link for the ix-application component Jul 29, 2026
@netlify

netlify Bot commented Jul 29, 2026

Copy link
Copy Markdown

Deploy Preview for industrial-experience ready!

Name Link
🔨 Latest commit 732590d
🔍 Latest deploy log https://app.netlify.com/projects/industrial-experience/deploys/6a69e1e145520600085c4cf3
😎 Deploy Preview https://deploy-preview-271--industrial-experience.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
🤖 Make changes Run an agent on this branch

To edit notification comments on pull requests, go to your Netlify project configuration.

@coderabbitai

coderabbitai Bot commented Jul 29, 2026

Copy link
Copy Markdown
Contributor

Review Change Stack

📝 Walkthrough

Walkthrough

The documentation now describes the Application component’s built-in skip link, target configuration, localization, fallback behavior, disabling conditions, and related accessibility guidance.

Changes

Application skip-link documentation

Layer / File(s) Summary
Application skip-link reference
docs/components/application/code.mdx, docs/components/application/guide.md
Documents default skip-link behavior, skipLinkTargetId, target validation and fallback, localization, disabling conditions, available options, and related accessibility resources.
Accessibility skip-link guidance
docs/guidelines/accessibility/overview.md, docs/guidelines/accessibility/code.md
Identifies the Application component’s default “Skip to main content” link and describes its use within bypass-block accessibility guidance.

Estimated code review effort: 1 (Trivial) | ~5 minutes

Suggested reviewers: flxlst09, danielleroux, tokyojen

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title clearly and concisely summarizes the main change: adding skip-link documentation for ix-application.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch feature/skip-links

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@docs/components/application/code.mdx`:
- Line 23: Correct the documentation reference in the text near
ApplicationPlayground: point “the basic example” to the following example that
actually configures skipLinkTargetId, or add that configuration to the preceding
example. Ensure the prose accurately matches the example being referenced.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: 8472001c-5d81-4bea-bdd2-c6cd24e634b1

📥 Commits

Reviewing files that changed from the base of the PR and between 1f44ce1 and 732590d.

📒 Files selected for processing (4)
  • docs/components/application/code.mdx
  • docs/components/application/guide.md
  • docs/guidelines/accessibility/code.md
  • docs/guidelines/accessibility/overview.md


## Skip link target

`ix-application` includes a "Skip to main content" link with no configuration required. By default, it focuses the application's internal main region. The basic example above uses `skipLinkTargetId` to focus a specific content boundary instead:

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🎯 Functional Correctness | 🟡 Minor | ⚡ Quick win

Correct the example reference.

The text says the basic example above uses skipLinkTargetId, but that example is only <ApplicationPlayground />. Refer to the following example instead, or update the preceding example to include the configuration.

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@docs/components/application/code.mdx` at line 23, Correct the documentation
reference in the text near ApplicationPlayground: point “the basic example” to
the following example that actually configures skipLinkTargetId, or add that
configuration to the preceding example. Ensure the prose accurately matches the
example being referenced.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant