Skip to content

🎨 Palette: [UX improvement] 외부 링크에 새 창 열림 툴팁(title) 추가 - #193

Open
seonghobae wants to merge 1 commit into
mainfrom
palette/a11y-external-link-tooltips-11946162662865325152
Open

🎨 Palette: [UX improvement] 외부 링크에 새 창 열림 툴팁(title) 추가#193
seonghobae wants to merge 1 commit into
mainfrom
palette/a11y-external-link-tooltips-11946162662865325152

Conversation

@seonghobae

@seonghobaeseonghobae commented Aug 25, 2026

Copy link
Copy Markdown
Contributor

💡 What: 외부 링크(target="_blank")에 다국어를 지원하는 title 툴팁을 추가하여 새 창에서 열림을 안내하도록 개선했습니다.
🎯 Why: 스크린 리더 및 시각 사용자에게 외부 링크 이동 시 새 탭이 열린다는 맥락을 제공하여 인지적 혼란을 막기 위함입니다.
📸 Before/After: 해당 없음 (툴팁만 노출됨).
♿ Accessibility: 스크린 리더가 링크를 읽을 때 새 창 열림 안내를 병합하여 공지할 수 있도록 다국어(한국어/영어) 지원을 i18n 구조에 확장 적용했습니다.


PR created automatically by Jules for task 11946162662865325152 started by @seonghobae


Open in Devin Review

Summary by CodeRabbit

  • 접근성 개선

    • 외부 링크에 새 창에서 열림을 안내하는 툴팁을 추가했습니다.
    • 주요 탐색 메뉴, CTA, 참고문헌 및 프로젝트 관련 링크에서 일관된 안내를 제공합니다.
    • 한국어와 영어를 지원하며, 언어 전환 시 안내 문구도 자동으로 갱신됩니다.
  • 문서

    • 외부 링크 접근성 개선 및 다국어 안내 적용 방법을 학습 자료에 기록했습니다.

@google-labs-jules

Copy link
Copy Markdown

👋 Jules, reporting for duty! I'm here to lend a hand with this pull request.

When you start a review, I'll add a 👀 emoji to each comment to let you know I've read it. I'll focus on feedback directed at me and will do my best to stay out of conversations between you and other bots or reviewers to keep the noise down.

I'll push a commit with your requested changes shortly after. Please note there might be a delay between these steps, but rest assured I'm on the job!

For more direct control, you can switch me to Reactive Mode. When this mode is on, I will only act on comments where you specifically mention me with @jules. You can find this option in the Pull Request section of your global Jules UI settings. You can always switch back!

New to Jules? Learn more at jules.google/docs.


For security, I will only act on instructions from the user who triggered this task.

@coderabbitai

coderabbitaiBot commented Aug 25, 2026

Copy link
Copy Markdown

Review Change Stack

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: 83ace321-df26-4267-b376-e3e659314c79

📥 Commits

Reviewing files that changed from the base of the PR and between 8103aad and 2292771.

📒 Files selected for processing (3)
  • .Jules/palette.md
  • i18n.js
  • index.html

Included review availability: Your plan provides up to 1 included review per hour; 0 remain after this review.


📝 Walkthrough

Walkthrough

외부 링크에 새 창 열림 안내를 추가했습니다. 한국어와 영어 메시지를 정의했습니다. data-i18n-title을 사용해 언어 전환 시 링크의 title 속성을 갱신합니다.

Changes

외부 링크 접근성 안내

Layer / File(s)Summary
title 국제화 지원
i18n.js
한국어와 영어에 a11y.newWindow 메시지를 추가했습니다. data-i18n-title 요소를 조회하고 해당 요소의 title 속성을 현재 언어 메시지로 갱신합니다.
외부 링크 적용
index.html, .Jules/palette.md
GitHub 내비게이션, CTA, 참고문헌, 프로젝트, 설립자 링크에 titledata-i18n-title 속성을 추가했습니다. 접근성 개선 학습 항목을 기록했습니다.

Estimated code review effort: 2 (Simple) | ~10 minutes

Merge Risk:⚪ Minimal · up to 22927

The PR adds multilingual new-window guidance to external links through localized tooltip text. No actionable merge-blocking risk remains beyond normal checks and review.

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check nameStatusExplanationResolution
Docstring Coverage⚠️ WarningDocstring coverage is 0.00% which is insufficient. The required threshold is 80.00%. Docstring coverage is scoped to functions touched by this diff. Analyzed 1 functions across 1 files. (2 skipped: 2 …Write docstrings for the functions missing them to satisfy the coverage threshold.
✅ Passed checks (4 passed)
Check nameStatusExplanation
Description Check✅ PassedCheck skipped - CodeRabbit’s high-level summary is enabled.
Title check✅ Passed제목은 외부 링크에 새 창 열림을 알리는 title 툴팁을 추가하는 주요 변경 사항을 정확하고 간결하게 설명합니다.
Linked Issues check✅ PassedCheck skipped because no linked issues were found for this pull request.
Out of Scope Changes check✅ PassedCheck skipped because no linked issues were found for this pull request.
Full details: Docstring Coverage

Explanation

Docstring coverage is 0.00% which is insufficient. The required threshold is 80.00%. Docstring coverage is scoped to functions touched by this diff. Analyzed 1 functions across 1 files. (2 skipped: 2 unsupported.)

✨ Finishing Touches 💡 1
📝 Generate docstrings 💡
  • Create stacked PR
  • Commit on current branch
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch palette/a11y-external-link-tooltips-11946162662865325152

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.

@devin-ai-integrationdevin-ai-integrationBot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Devin Review found 3 potential issues.

⚠️ 1 issue in files not directly in the diff

⚠️Missing CHANGELOG entry for user-facing change

CLAUDE.md requires CHANGELOG.md to be updated under [Unreleased] in Korean for user-facing changes. This PR adds external-link tooltips, a user-facing change, but adds no CHANGELOG entry.

Open in Devin Review

Comment threadi18n.js
Comment on lines 367 to 388

if (!isInitialDefault) {
if (!i18nNodes) {
i18nNodes = document.querySelectorAll("[data-i18n]");
i18nNodes = document.querySelectorAll("[data-i18n], [data-i18n-title]");
}

// Only update textContent if it actually changed to avoid layout recalculations
i18nNodes.forEach((node) => {
const newText = dict[node.dataset.i18n];
if (newText && node.textContent !== newText) {
node.textContent = newText;
if (node.hasAttribute("data-i18n")) {
const newText = dict[node.dataset.i18n];
if (newText && node.textContent !== newText) {
node.textContent = newText;
}
}
if (node.hasAttribute("data-i18n-title")) {
const newTitle = dict[node.dataset.i18nTitle];
if (newTitle && node.getAttribute("title") !== newTitle) {
node.setAttribute("title", newTitle);
}
}
});
}

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

📝 Info: Initial Korean load skips title translation, stays consistent

On initial Korean load isInitialDefault skips the node traversal, so data-i18n-title titles are never set by JS. Safe because every external link carries an inline Korean title matching a11y.newWindow, and later language switches populate i18nNodes and update titles correctly.

(Refers to this code)

Open in Devin Review

Was this helpful? React with 👍 or 👎 to provide feedback.

Comment thread.Jules/palette.md
**Learning:** Using an anchor tag to wrap an entire card (block-level element) can result in verbose and confusing screen reader output. However, restricting the clickable area to just the title makes the UI harder to interact with (violating Fitts's Law).
**Action:** Apply `position: relative` to the card container and use a `::after` pseudo-element with `position: absolute; inset: 0;` on the title's anchor tag. This expands the clickable area to the whole card while keeping semantic and accessible HTML structure.

## 2024-08-25 - 외부 링크에 접근성 향상을 위한 title 속성과 i18n 적용

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

📝 Info: Palette entry date likely off by two years

The new entry is dated 2024-08-25 while the change lands in 2026. Given the journal records recent incidents, this reads as a typo, though other entries also use 2024 dates so intent is ambiguous.

Open in Devin Review

Was this helpful? React with 👍 or 👎 to provide feedback.

@chatgpt-codex-connectorchatgpt-codex-connectorBot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit:22927712ec

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment threadindex.html
<a href="#forks" data-i18n="nav.forks">Fork</a>
<a href="#work" data-i18n="nav.work">작업</a>
<a target="_blank" rel="noopener noreferrer" href="https://github.com/ContextualWisdomLab">GitHub</a>
<a target="_blank" rel="noopener noreferrer" href="https://github.com/ContextualWisdomLab" title="(새 창에서 열림)" data-i18n-title="a11y.newWindow">GitHub</a>

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

P2 Badge Expose the new-tab hint without relying on title

For keyboard-only and touch users, the only new cue is a title tooltip, which is generally exposed through mouse hover and is not reliably announced by assistive technologies when the link already has visible text. Consequently, these users can still activate the link without learning that it opens a new tab, defeating the accessibility goal of this change; provide the localized hint through visible or visually hidden text, or associate it with the link using aria-describedby instead.

Useful? React with 👍 / 👎.

Sign up for freeto 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

@seonghobae