mirror of
https://github.com/bilawalsidhu/gods-eye-view.git
synced 2026-11-20 10:12:18 +00:00
feat(kit): show the panel rails as labelled pills until a panel opens
UiRail takes `collapsible`: while no panel on its side is open, each item shows its icon and label as a pill, and once one opens the labels fold away to the icon rail, making room for the panel. The tip is not shown while the label is on screen; the button keeps its accessible name and the visible label is hidden from assistive technology. The side panel rails turn it on. Each rail is now placed by its screen-side edge, at the rail clearance, so a rail that widens grows toward the middle of the screen; collapsed, it sits 6px outside its stack as before.
This commit is contained in:
1 parent
6acaa01ca8
commit
d546d65380
7 files changed
+195
-9
No files matched your search
+58
-3
@@ -1,9 +1,10 @@
|
||||
<script setup>
|
||||
import { computed, onBeforeUnmount, reactive } from 'vue';
|
||||
import UiIcon from './UiIcon.vue';
|
||||
import UiTooltip from './UiTooltip.vue';
|
||||
import { RAIL_PANEL_OPEN_TOOLTIP_DELAY_MS } from './rail.js';
|
||||
|
||||
defineProps({
|
||||
const props = defineProps({
|
||||
/** @type {import('vue').PropType<import('./rail.js').UiRailItem[]>} */
|
||||
items: { type: Array, required: true },
|
||||
/** The selected item's id, or null. */
|
||||
@@ -17,18 +18,65 @@ defineProps({
|
||||
* panel's title, and the other tips wait for the pointer to rest.
|
||||
*/
|
||||
panelOpen: { type: Boolean, default: false },
|
||||
/**
|
||||
* Show each item as a labelled pill while no panel is open, and collapse to
|
||||
* icons once one is, making room for the panel.
|
||||
*/
|
||||
collapsible: { type: Boolean, default: false },
|
||||
});
|
||||
const emit = defineEmits(['select']);
|
||||
const expanded = computed(() => props.collapsible && !props.panelOpen);
|
||||
|
||||
// A label cut short by the pill's width keeps its tip, so the full name can
|
||||
// still be read. Each label is measured whenever its box changes size, which
|
||||
// includes the moment it settles after expanding.
|
||||
const truncated = reactive(new Set());
|
||||
const labelIds = new WeakMap();
|
||||
const labelElements = new Map();
|
||||
const labelObserver =
|
||||
typeof ResizeObserver === 'function'
|
||||
? new ResizeObserver((entries) => {
|
||||
for (const { target } of entries) {
|
||||
const id = labelIds.get(target);
|
||||
if (target.scrollWidth > target.clientWidth) truncated.add(id);
|
||||
else truncated.delete(id);
|
||||
}
|
||||
})
|
||||
: null;
|
||||
function trackLabel(id, element) {
|
||||
const previous = labelElements.get(id);
|
||||
if (previous === element) return;
|
||||
if (previous) {
|
||||
labelObserver?.unobserve(previous);
|
||||
labelElements.delete(id);
|
||||
truncated.delete(id);
|
||||
}
|
||||
if (!element) return;
|
||||
labelElements.set(id, element);
|
||||
labelIds.set(element, id);
|
||||
labelObserver?.observe(element);
|
||||
}
|
||||
onBeforeUnmount(() => labelObserver?.disconnect());
|
||||
const tipHidden = (item) =>
|
||||
(expanded.value && !truncated.has(item.id)) ||
|
||||
(props.panelOpen && item.id === props.active);
|
||||
</script>
|
||||
|
||||
<template>
|
||||
<nav class="ui-rail" :class="`ui-rail--${side}`" :aria-label="label">
|
||||
<nav
|
||||
class="ui-rail"
|
||||
:class="[
|
||||
`ui-rail--${side}`,
|
||||
{ 'ui-rail--collapsible': collapsible, 'ui-rail--expanded': expanded },
|
||||
]"
|
||||
:aria-label="label"
|
||||
>
|
||||
<template v-for="item in items" :key="item.id">
|
||||
<i v-if="item.separatorBefore" class="ui-rail__sep" aria-hidden="true" />
|
||||
<UiTooltip
|
||||
:text="item.label"
|
||||
:side="side === 'left' ? 'right' : 'left'"
|
||||
:disabled="panelOpen && item.id === active"
|
||||
:disabled="tipHidden(item)"
|
||||
:delay="panelOpen ? RAIL_PANEL_OPEN_TOOLTIP_DELAY_MS : 0"
|
||||
>
|
||||
<button
|
||||
@@ -42,6 +90,13 @@ const emit = defineEmits(['select']);
|
||||
@click="emit('select', item.id)"
|
||||
>
|
||||
<UiIcon :name="item.icon" />
|
||||
<span
|
||||
v-if="collapsible"
|
||||
:ref="(element) => trackLabel(item.id, element)"
|
||||
class="ui-rail__label"
|
||||
aria-hidden="true"
|
||||
>{{ item.label }}</span
|
||||
>
|
||||
<span v-if="item.badge !== undefined" class="ui-rail__badge">{{
|
||||
item.badge
|
||||
}}</span>
|
||||
|
||||
Reference in new issue
Block a user