Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Links to Stacks of Cards in a Board #6390

Open
MaykGyver opened this issue Oct 10, 2024 · 1 comment
Open

Links to Stacks of Cards in a Board #6390

MaykGyver opened this issue Oct 10, 2024 · 1 comment

Comments

@MaykGyver
Copy link

MaykGyver commented Oct 10, 2024

Scenario

A user wants to link to a specific stack of cards in a deck board.

Attempts

  1. Links to the URL of the board (schema: https://example.org/apps/deck/board/NNNN) are easy. But if the referenced stack is outside of the initial viewport, the user has to close the conceptual gap and search for the referenced stack by scrolling.
  2. Links to the board with a text highlight (schema: https://example.org/apps/deck/board/NNNN#:~:text=foo%20bar) are possible. Closing the gap (see 1) is easier as the stack's caption is highlighted. If the stack is outside the viewport, the user is assisted by the browser. If there are multiple occurrences of the stack's caption the user has to figure that the stack was meant and not one of the other occurrences on the page.
  3. Inspected the DOM of a board view. Found no anchors, ids nor names in the branch of the stack.
  4. My humble search skills yielded no discussion of the usage scenario.

Proposed Solution

The most concise DOM element for referencing a stack might be the h3 element with title="stack.title" and class="stack__title". Its id attribute is not used yet. The id might be generated from a distinguishing prefix (e.g. stack-) and an identifying suffix (e.g. foo-bar) might yield an id of stack-foo-bar for a stack with the caption "Foo Bar". A link to the stack's id (schema: https://example.org/apps/deck/board/NNNN#stack-foo-bar) focusses the stack on a potentially huge page with all of the browser's capabilities.

Alternative and Optional Solutions

  • The proposed schema for the id is debatable.
  • There are some 1:1 parents and children that might be considered to get the id attribute attached.
  • A distinct page for a stack (schema: https://example.org/apps/deck/board/NNNN/stack/foo-bar) might be useful in more scenarios but requires more work than the proposed solution.
  • Having the link work as a preview widget in other Nextcloud apps would be a killer but requires much more work than the proposed solution.
@luka-nextcloud
Copy link
Contributor

@MaykGyver I prefer solution A distinct page for a stack (schema: https://example.org/apps/deck/board/NNNN/stack/foo-bar) but url should be https://example.org/apps/deck/board/{boardId}/stack/{stackId}

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

No branches or pull requests

2 participants