fix(ui): improve responsive workspace and account controls

This commit is contained in:
XiaoDaiGua-Ray 2026-11-08 13:19:16 +08:00
parent d489235be0
commit 86ca6962cc
No known key found for this signature in database
32 changed files with 923 additions and 337 deletions

View File

@ -0,0 +1,45 @@
import { avatarDropdownClick } from '../../apps/admin/src/layout/components/SiderBar/shared'
const { logout, createDialog, showError, push } = vi.hoisted(() => ({
logout: vi.fn(),
createDialog: vi.fn(),
showError: vi.fn(),
push: vi.fn(),
}))
vi.mock('@/store', () => ({
useSigningActions: () => ({ logout }),
useSettingActions: () => ({ updateSettingState: vi.fn() }),
}))
vi.mock('@/hooks', () => ({ useI18n: () => ({ t: (key: string) => key }) }))
vi.mock('@/router', () => ({ router: { push } }))
beforeEach(() => {
vi.clearAllMocks()
window.$dialog = { create: createDialog } as unknown as typeof window.$dialog
window.$message = { error: showError } as unknown as typeof window.$message
})
it('confirms sign-out with the active primary color before ending the session', async () => {
logout.mockResolvedValue(void 0)
await avatarDropdownClick('logout')
expect(logout).not.toHaveBeenCalled()
const dialog = createDialog.mock.calls[0]![0]
expect(dialog).toMatchObject({
title: 'signOut',
showIcon: false,
positiveButtonProps: { type: 'primary' },
})
expect(await dialog.onPositiveClick()).toBe(true)
expect(logout).toHaveBeenCalledOnce()
})
it('keeps the confirmation open and reports a failed sign-out', async () => {
logout.mockRejectedValue(new Error('offline'))
await avatarDropdownClick('logout')
expect(await createDialog.mock.calls[0]![0].onPositiveClick()).toBe(false)
expect(showError).toHaveBeenCalledWith('signOutFailed')
})

View File

@ -1,22 +1,63 @@
import { mount } from '@vue/test-utils'
import { flushPromises, mount } from '@vue/test-utils'
import GlobalSearch from '../../apps/admin/src/layout/components/Search/GlobalSearch'
import { router } from '../../apps/admin/src/router'
import { piniaMenuStore } from '../../apps/admin/src/store/modules/menu'
import setupMiniApp from '../utils/setupMiniApp'
it('mounts the header search on a narrow viewport and closes it immediately', async () => {
it('keeps page search available on phones and lets a search result close the dialog', async () => {
vi.stubGlobal('innerWidth', 390)
const { app } = await setupMiniApp()
const menu = piniaMenuStore()
menu.options = [
{
path: '/visible',
fullPath: '/visible',
key: '/visible',
name: 'visible',
breadcrumbLabel: 'Visible page',
label: 'Visible page',
meta: {},
},
]
const navigate = vi
.spyOn(menu, 'changeMenuModelValue')
.mockImplementation(() => void 0)
const wrapper = mount(GlobalSearch, {
attachTo: document.body,
props: { show: true },
global: {
plugins: [router],
stubs: {
teleport: true,
RIcon: { inheritAttrs: false, template: '<span />' },
},
},
})
try {
const wrapper = mount(GlobalSearch, {
props: { show: true },
global: { plugins: [router] },
})
await flushPromises()
expect(wrapper.emitted('update:show')).toBeUndefined()
expect(wrapper.find('.global-search').exists()).toBe(true)
await wrapper.get('input').setValue('Visible')
await flushPromises()
expect(wrapper.findAll('.global-search__destination')).toHaveLength(1)
vi.stubGlobal('innerWidth', 1440)
window.dispatchEvent(new Event('resize'))
await flushPromises()
expect(wrapper.emitted('update:show')).toBeUndefined()
expect(wrapper.get('input').element.value).toBe('Visible')
await wrapper.get('.global-search__destination').trigger('click')
await flushPromises()
expect(navigate).toHaveBeenCalledWith(
'/visible',
expect.objectContaining({ fullPath: '/visible' }),
)
expect(wrapper.emitted('update:show')).toContainEqual([false])
expect(wrapper.find('.global-search').exists()).toBe(false)
wrapper.unmount()
} finally {
wrapper.unmount()
app.unmount()
vi.unstubAllGlobals()
}

View File

@ -1,12 +1,14 @@
import { mount } from '@vue/test-utils'
import { flushPromises, mount } from '@vue/test-utils'
import { createPinia, disposePinia, setActivePinia } from 'pinia'
import { nextTick } from 'vue'
import { useSiderScroll } from '../../apps/admin/src/hooks/template/useSiderScroll'
import Menu from '../../apps/admin/src/layout/components/Menu'
import { router } from '../../apps/admin/src/router'
import { piniaMenuStore } from '../../apps/admin/src/store/modules/menu'
import { piniaRuntimeStore } from '../../apps/admin/src/store/modules/runtime'
import { piniaSettingStore } from '../../apps/admin/src/store/modules/setting'
import { positionSelectedMenuItem } from '../../apps/admin/src/utils'
import setupMiniApp from '../utils/setupMiniApp'
it.each([
[true, '.n-layout-scroll-container'],
@ -78,3 +80,46 @@ it.each([
}
},
)
it('keeps the desktop collapse preference while the phone menu opens and closes', async () => {
vi.stubGlobal('innerWidth', 390)
const { app } = await setupMiniApp()
const menu = piniaMenuStore()
const runtime = piniaRuntimeStore()
menu.updateMenuState('collapsed', true)
runtime.setRuntimeState('globalDrawerValue', true)
const wrapper = mount(Menu, {
attachTo: document.body,
global: {
plugins: [router],
stubs: {
teleport: true,
RIcon: { inheritAttrs: false, template: '<span />' },
},
},
})
try {
await flushPromises()
expect(menu.collapsed).toBe(true)
expect(wrapper.find('.app-menu__mobile-heading').exists()).toBe(true)
expect(wrapper.find('.n-layout-sider--collapsed').exists()).toBe(false)
await wrapper.get('.app-menu__close').trigger('click')
expect(runtime.globalDrawerValue).toBe(false)
runtime.setRuntimeState('globalDrawerValue', true)
vi.stubGlobal('innerWidth', 1440)
window.dispatchEvent(new Event('resize'))
await flushPromises()
expect(runtime.globalDrawerValue).toBe(false)
expect(menu.collapsed).toBe(true)
expect(wrapper.find('.app-menu__mobile-heading').exists()).toBe(false)
expect(wrapper.find('.n-layout-sider--collapsed').exists()).toBe(true)
} finally {
wrapper.unmount()
app.unmount()
vi.unstubAllGlobals()
}
})

View File

@ -16,6 +16,71 @@ describe('workspace preference shortcuts', () => {
afterEach(() => disposePinia(pinia))
it('identifies the default spacing when settings first opens', () => {
const wrapper = mount(Layout, { global: { plugins: [pinia] } })
try {
const selected = wrapper.findAll(
'.r-workspace-presets button[aria-pressed="true"]',
)
expect(selected).toHaveLength(1)
expect(selected[0].text()).toContain('preferences.layout.spacious')
expect(wrapper.get('.r-workspace-presets__current').text()).toContain(
'24 px',
)
} finally {
wrapper.unmount()
}
})
it.each([
{ contentWidth: 'fluid' as const, contentPadding: 16 },
{
contentWidth: 'fixed' as const,
contentMaxWidth: 1200,
contentPadding: 24,
},
])('shows saved custom spacing without changing it: %j', async (layout) => {
const store = piniaSettingStore()
store.updateSettingState('layoutConfig', layout)
const previousLayout = { ...store.layoutConfig }
const wrapper = mount(Layout, { global: { plugins: [pinia] } })
try {
const current = wrapper.get('.r-workspace-presets__current')
expect(current.text()).toContain('preferences.layout.custom')
expect(current.text()).toContain(`${layout.contentPadding} px`)
expect(
wrapper.findAll('.r-workspace-presets button[aria-pressed="true"]'),
).toHaveLength(0)
expect(store.layoutConfig).toEqual(previousLayout)
await wrapper
.findAll('.r-workspace-presets button')
.find((button) => button.text() === 'preferences.layout.compact')!
.trigger('click')
expect(current.text()).toContain('preferences.layout.compact')
expect(current.text()).toContain('8 px')
expect(
wrapper.get('.r-workspace-presets button[aria-pressed="true"]').text(),
).toContain('preferences.layout.compact')
await wrapper
.findAll('button')
.find((button) => button.text() === 'layout.reset')!
.trigger('click')
expect(current.text()).toContain('preferences.layout.spacious')
expect(current.text()).toContain('24 px')
} finally {
wrapper.unmount()
}
})
it('applies reading spacing without replacing navigation or fixed bars', async () => {
const store = piniaSettingStore()

View File

@ -84,12 +84,13 @@ const AppAvatar = defineComponent({
return (
<NButton
class="r-app-avatar"
quaternary
strong
style={{ cursor: this.cursor }}
{...{ 'aria-label': showName ? void 0 : name }}
>
<NFlex align="center" size={spaceSize} vertical={vertical}>
<NFlex align="center" size={spaceSize} vertical={vertical} wrap={false}>
<AccountAvatar
{...($props as AvatarProps)}
name={name}
@ -114,6 +115,7 @@ const AppAvatar = defineComponent({
{name}
</span>
)}
{this.$slots.suffix?.()}
</NFlex>
</NButton>
)

View File

@ -10,25 +10,36 @@
display: flex;
align-items: center;
gap: 12px;
min-width: 0;
padding: 13px 16px;
min-inline-size: 0;
min-block-size: 44px;
padding: 12px 16px;
border: 1px solid var(--r-line);
border-radius: var(--r-control-radius);
color: var(--r-text-secondary);
text-decoration: none;
font-size: 13px;
background: var(--r-surface-muted);
background: var(--r-surface);
> span:nth-child(2) {
&__label {
flex: 1;
overflow-wrap: anywhere;
}
> .n-avatar {
&__icon {
display: grid;
place-items: center;
inline-size: 32px;
block-size: 32px;
flex-shrink: 0;
color: var(--r-primary-text);
}
&__arrow {
flex-shrink: 0;
color: var(--r-text-muted);
}
&:hover {
color: var(--r-text);
border-color: var(--r-control-border);
background: var(--r-surface-muted);
}
}
@container (min-width: 700px) {
@ -48,14 +59,14 @@
.r-share-link {
display: grid;
place-items: center;
width: 36px;
height: 36px;
inline-size: 44px;
block-size: 44px;
padding: 0;
border: 0;
border-radius: 50%;
background: transparent;
> span:nth-child(2),
> .r-icon {
> .r-share-link__label,
> .r-share-link__arrow {
display: none;
}
&:hover {

View File

@ -2,14 +2,14 @@ import './index.scss'
import { RAY_TEMPLATE_DOCS_URL } from '@/app-config'
import { RIcon } from '@/components'
import { useI18n } from '@/hooks'
import { NAvatar } from 'naive-ui'
import type { IconName } from '@/icons'
import type { PropType } from 'vue'
interface AvatarOptions {
interface ShareLinkOption {
key: string
src: string
tooltip: string
icon: string
icon: IconName
}
export default defineComponent({
@ -22,40 +22,40 @@ export default defineComponent({
},
setup() {
const { t } = useI18n('dashboard')
const avatarOptions: AvatarOptions[] = [
const links: ShareLinkOption[] = [
{
key: 'ray-js-note',
src: 'https://note.youdao.com/s/ObWEe2BB',
tooltip: 'links.notes',
icon: 'https://avatars.githubusercontent.com/u/51957438?v=4',
icon: 'navigation/form',
},
{
key: 'ray-js-cover',
src: 'https://note.youdao.com/s/IC8xKPdB',
tooltip: 'links.interviews',
icon: 'https://avatars.githubusercontent.com/u/51957438?v=4',
icon: 'status/question',
},
{
key: 'ray-template-doc',
src: RAY_TEMPLATE_DOCS_URL,
tooltip: 'links.docs',
icon: 'https://avatars.githubusercontent.com/u/51957438?v=4',
icon: 'navigation/document',
},
{
key: 'ray-template-doc-out',
src: 'https://ray-template.yunkuangao.com/',
tooltip: 'links.docsMirror',
icon: 'https://avatars.githubusercontent.com/u/51957438?v=4',
icon: 'navigation/window',
},
]
return { avatarOptions, t }
return { links, t }
},
render() {
return (
<div class={['r-share-links', `r-share-links--${this.variant}`]}>
<div class="r-share-links__grid">
{this.avatarOptions.map((item) => (
{this.links.map((item) => (
<a
class="r-share-link"
href={item.src}
@ -65,9 +65,15 @@ export default defineComponent({
rel="noreferrer"
key={item.key}
>
<NAvatar round src={item.icon} size={24} />
<span>{this.t(item.tooltip)}</span>
<RIcon name="action/external-link" size={13} />
<span class="r-share-link__icon" aria-hidden="true">
<RIcon name={item.icon} size={20} />
</span>
<span class="r-share-link__label">{this.t(item.tooltip)}</span>
<RIcon
class="r-share-link__arrow"
name="action/external-link"
size={14}
/>
</a>
))}
</div>

View File

@ -12,7 +12,7 @@
- At ≤768px, use the complete-menu drawer without overwriting saved desktop mode. Selecting a drawer item closes it automatically.
- Sidebar/drawer logos remain fixed above the menu; scrolling begins at the menu region. The native-scrollbar option affects only the menu list.
- Content supports fluid fill or centered fixed width, maximum widths of 640–2560px, spacing of 0–48px, and fixed or scrolling headers/footers. Tab and copyright visibility retain existing settings.
- Maximized content shares Pinia state with pages and tab menus. An exit button floats at the top right; Esc restores the layout too.
- Maximized content shares Pinia state with pages and tab menus. The exit button floats at the top right. On narrow screens the shell reserves no space for it. Click it or press Esc to restore the layout.
- Content loading uses the visible scrolling viewport. Remounting shows the indicator immediately; brief manual loading waits 120ms. Fixed headers, tabs, and footers are not covered by the overlay.
- “外观 → 页面切换动画” (Appearance → Page transition) retains previous options and adds upward fade-in and leftward slide-in. Only content animates; reduced-motion system settings use immediate transitions.

View File

@ -65,3 +65,25 @@
outline-offset: -2px;
}
}
.app-menu__mobile-heading {
display: flex;
align-items: center;
flex-shrink: 0;
min-inline-size: 0;
padding-inline-end: 8px;
border-block-end: 1px solid var(--r-line);
.r-menu__logo {
flex: 1;
min-inline-size: 0;
padding-inline: 16px 8px;
border-block-end: 0;
}
.app-menu__close {
min-inline-size: 44px;
min-block-size: 44px;
margin-inline-start: auto;
}
}

View File

@ -1,6 +1,7 @@
import './index.scss'
import { LAYOUT_SIDER_REF } from '@/app-config'
import { useDevice } from '@/hooks'
import { RIcon } from '@/components'
import { useDevice, useI18n } from '@/hooks'
import { positionSelectedMenuItem } from '@/layout/utils/position-selected-menu-item'
import {
useMenuActions,
@ -10,7 +11,7 @@ import {
useSettingGetters,
} from '@/store'
import type { AppMenuOption, NaiveMenuOptions } from '@/types'
import { NDrawer, NLayoutContent, NLayoutSider, NMenu } from 'naive-ui'
import { NButton, NDrawer, NLayoutContent, NLayoutSider, NMenu } from 'naive-ui'
import type { MenuInst } from 'naive-ui'
import type { PropType } from 'vue'
import SiderBarLogo from './components/SiderBarLogo'
@ -25,16 +26,15 @@ export default defineComponent({
},
setup(props) {
const menuRef = shallowRef<MenuInst | null>(null)
const { changeMenuModelValue, collapsedMenu, updateMenuState } =
useMenuActions()
const { changeMenuModelValue, collapsedMenu } = useMenuActions()
const { t } = useI18n('layout')
const { getAppTheme, getMenuConfig } = useSettingGetters()
const { getMenuOptions, getCollapsed, getMenuKey } = useMenuGetters()
const { globalDrawerValue } = useRuntimeGetters()
const { setRuntimeState } = useRuntimeActions()
const { isTabletOrSmaller, width } = useDevice({
observer: (isSmaller) => {
if (isSmaller) updateMenuState('collapsed', false)
else setRuntimeState('globalDrawerValue', false)
if (!isSmaller) setRuntimeState('globalDrawerValue', false)
},
})
const menuWidth = computed(() =>
@ -59,6 +59,11 @@ export default defineComponent({
{ flush: 'post' },
)
const logo = () =>
props.showLogo && getMenuConfig.value.menuSiderBarLogo ? (
<SiderBarLogo collapsed={collapsed.value} />
) : null
const basicMenu = () => (
<NLayoutSider
class={['app-menu__sider', { 'app-menu__sider--end': props.end }]}
@ -73,9 +78,28 @@ export default defineComponent({
collapsed={collapsed.value}
inverted={getMenuConfig.value.inverted}
>
{props.showLogo && getMenuConfig.value.menuSiderBarLogo ? (
<SiderBarLogo collapsed={collapsed.value} />
) : null}
{isTabletOrSmaller.value ? (
<div class="app-menu__mobile-heading">
{logo()}
<NButton
quaternary
class="app-menu__close"
aria-label={t('closeMenu')}
themeOverrides={{
textColor: 'inherit',
colorQuaternaryHover:
'color-mix(in srgb, currentColor 10%, transparent)',
colorQuaternaryPressed:
'color-mix(in srgb, currentColor 18%, transparent)',
}}
onClick={() => setRuntimeState('globalDrawerValue', false)}
>
<RIcon name="action/close" />
</NButton>
</div>
) : (
logo()
)}
<NLayoutContent
class="app-menu__scroll"
nativeScrollbar={getMenuConfig.value.nativeScrollbar}
@ -114,6 +138,9 @@ export default defineComponent({
}}
accordion={getMenuConfig.value.accordion}
iconSize={getMenuConfig.value.iconSize}
themeOverrides={
isTabletOrSmaller.value ? { itemHeight: '44px' } : void 0
}
inverted={getMenuConfig.value.inverted}
/>
</NLayoutContent>
@ -129,7 +156,6 @@ export default defineComponent({
onUpdateShow={(value) => setRuntimeState('globalDrawerValue', value)}
placement="left"
displayDirective="show"
autoFocus={false}
>
{basicMenu()}
</NDrawer>

View File

@ -1,7 +1,13 @@
.global-search.n-card {
width: min(650px, calc(100vw - 40px));
margin: 60px auto auto;
border-radius: 12px;
inline-size: min(650px, calc(100dvw - 24px));
max-block-size: calc(100dvh - 24px);
margin: 12px auto auto;
border-radius: var(--r-radius);
.n-card__content {
min-block-size: 0;
overflow: auto;
}
.n-card__action {
padding: 12px 20px;
@ -39,7 +45,7 @@
.global-search__item {
gap: 4px;
border: 1px solid var(--r-line);
border-radius: 8px;
border-radius: var(--r-control-radius);
margin-block: 6px;
padding-inline-end: 8px;
@ -57,7 +63,7 @@
min-height: 46px;
padding: 10px 12px;
border: 0;
border-radius: 8px;
border-radius: var(--r-control-radius);
background: transparent;
color: var(--r-text);
text-align: start;
@ -97,3 +103,43 @@
border-radius: 4px;
}
}
.global-search__results {
max-block-size: min(440px, calc(100dvh - 230px));
}
@media (max-width: 768px) {
.global-search.n-card {
.n-card-header {
padding: 12px 16px;
}
.n-card__content {
padding-inline: 16px;
}
.n-card__action {
padding: 12px 16px;
}
}
.global-search__header > .n-button,
.global-search__favorite {
min-inline-size: 44px;
min-block-size: 44px;
}
.global-search__shortcut {
display: none;
}
.global-search__help:has(> :not(.global-search__shortcut)) {
justify-content: flex-end;
}
}
@media (min-width: 769px) {
.global-search.n-card {
margin-block-start: min(60px, 8dvh);
}
}

View File

@ -1,6 +1,6 @@
import './index.scss'
import { RIcon } from '@/components'
import { useDevice, useI18n } from '@/hooks'
import { useI18n } from '@/hooks'
import { positionSelectedMenuItem } from '@/layout/utils/position-selected-menu-item'
import {
useMenuActions,
@ -42,11 +42,6 @@ export default defineComponent({
if (!value) resetSearch()
},
})
const { isTabletOrSmaller } = useDevice({
observer: (small) => {
if (small) modelShow.value = false
},
})
const visibleLeaves = computed(() => {
const leaves: AppMenuOption[] = []
const visit = (items: AppMenuOption[]) => {
@ -157,8 +152,7 @@ export default defineComponent({
}
useEventListener(window, 'keydown', (event: KeyboardEvent) => {
if (event.isComposing || isTabletOrSmaller.value || modelShow.value)
return
if (event.isComposing || modelShow.value) return
if ((event.ctrlKey || event.metaKey) && event.key.toLowerCase() === 'k') {
event.preventDefault()
@ -167,168 +161,162 @@ export default defineComponent({
}
})
return () =>
isTabletOrSmaller.value ? null : (
<NModal
show={modelShow.value}
onUpdateShow={(value) => {
modelShow.value = value
}}
onAfterEnter={() => input.value?.focus()}
transformOrigin="center"
displayDirective="if"
return () => (
<NModal
show={modelShow.value}
onUpdateShow={(value) => {
modelShow.value = value
}}
onAfterEnter={() => input.value?.focus()}
transformOrigin="center"
displayDirective="if"
>
<NCard
class="global-search"
role="dialog"
aria-modal="true"
aria-label={t('title')}
>
<NCard
class="global-search"
role="dialog"
aria-modal="true"
aria-label={t('title')}
>
{{
header: () => (
<div class="global-search__header">
<label for={inputId}>{t('title')}</label>
<NButton
quaternary
size="small"
aria-label={t('close')}
onClick={() => {
modelShow.value = false
}}
>
<RIcon name="action/close" />
</NButton>
</div>
),
default: () => (
<>
<NInput
ref={input}
size="large"
value={searchValue.value}
onUpdateValue={(value) => {
searchValue.value = value
}}
placeholder={t('placeholder')}
inputProps={{
id: inputId,
name: 'page-search',
autocapitalize: 'off',
spellcheck: false,
}}
onKeydown={(event) => moveResult(event, true)}
clearable
>
{{ prefix: () => <RIcon name="action/search" /> }}
</NInput>
{storageUnavailable.value && (
<p class="global-search__hint" role="status">
{t('storageUnavailable')}
{{
header: () => (
<div class="global-search__header">
<label for={inputId}>{t('title')}</label>
<NButton
quaternary
size="small"
aria-label={t('close')}
onClick={() => {
modelShow.value = false
}}
>
<RIcon name="action/close" />
</NButton>
</div>
),
default: () => (
<>
<NInput
ref={input}
size="large"
value={searchValue.value}
onUpdateValue={(value) => {
searchValue.value = value
}}
placeholder={t('placeholder')}
inputProps={{
id: inputId,
name: 'page-search',
autocapitalize: 'off',
spellcheck: false,
}}
onKeydown={(event) => moveResult(event, true)}
clearable
>
{{ prefix: () => <RIcon name="action/search" /> }}
</NInput>
{storageUnavailable.value && (
<p class="global-search__hint" role="status">
{t('storageUnavailable')}
</p>
)}
<NScrollbar class="global-search__results">
{options.value.length ? (
groups.value.map((group) => (
<section class="global-search__group" key={group.key}>
<div class="global-search__group-heading">
<h2>{t(group.key)}</h2>
</div>
<ul role="list">
{group.options.map((option) => {
const favorite = favoritePaths.value.includes(
option.fullPath,
)
return (
<li
key={option.fullPath}
class="global-search__item"
>
<button
type="button"
class="global-search__destination"
ref={(element) => {
if (element instanceof HTMLButtonElement)
rowButtons.set(option.fullPath, element)
else rowButtons.delete(option.fullPath)
}}
onFocus={() => {
activeIndex.value =
options.value.indexOf(option)
}}
onKeydown={(event) => moveResult(event)}
onClick={() => void openPage(option)}
>
{typeof option.meta.icon === 'string' &&
option.meta.icon ? (
<RIcon name={option.meta.icon} size={20} />
) : (
<RIcon name="navigation/menu" size={20} />
)}
<span>{option.breadcrumbLabel}</span>
{option.meta.windowOpen && (
<RIcon
name="action/external-link"
size={14}
/>
)}
</button>
<NButton
quaternary
size="small"
class="global-search__favorite"
type={favorite ? 'primary' : 'default'}
aria-pressed={favorite}
aria-label={t(
favorite ? 'removeFavorite' : 'addFavorite',
{ title: option.breadcrumbLabel },
)}
onClick={() => toggle(option.fullPath)}
>
<span aria-hidden="true">
{favorite ? '★' : '☆'}
</span>
</NButton>
</li>
)
})}
</ul>
</section>
))
) : (
<p class="global-search__empty">
{t(searchValue.value.trim() ? 'noResults' : 'empty')}
</p>
)}
<NScrollbar style="max-height: min(440px, calc(100dvh - 260px))">
{options.value.length ? (
groups.value.map((group) => (
<section class="global-search__group" key={group.key}>
<div class="global-search__group-heading">
<h2>{t(group.key)}</h2>
</div>
<ul role="list">
{group.options.map((option) => {
const favorite = favoritePaths.value.includes(
option.fullPath,
)
return (
<li
key={option.fullPath}
class="global-search__item"
>
<button
type="button"
class="global-search__destination"
ref={(element) => {
if (element instanceof HTMLButtonElement)
rowButtons.set(option.fullPath, element)
else rowButtons.delete(option.fullPath)
}}
onFocus={() => {
activeIndex.value =
options.value.indexOf(option)
}}
onKeydown={(event) => moveResult(event)}
onClick={() => void openPage(option)}
>
{typeof option.meta.icon === 'string' &&
option.meta.icon ? (
<RIcon
name={option.meta.icon}
size={20}
/>
) : (
<RIcon name="navigation/menu" size={20} />
)}
<span>{option.breadcrumbLabel}</span>
{option.meta.windowOpen && (
<RIcon
name="action/external-link"
size={14}
/>
)}
</button>
<NButton
quaternary
size="small"
class="global-search__favorite"
type={favorite ? 'primary' : 'default'}
aria-pressed={favorite}
aria-label={t(
favorite
? 'removeFavorite'
: 'addFavorite',
{ title: option.breadcrumbLabel },
)}
onClick={() => toggle(option.fullPath)}
>
<span aria-hidden="true">
{favorite ? '★' : '☆'}
</span>
</NButton>
</li>
)
})}
</ul>
</section>
))
) : (
<p class="global-search__empty">
{t(searchValue.value.trim() ? 'noResults' : 'empty')}
</p>
)}
</NScrollbar>
</>
),
action: () => (
<div class="global-search__help">
<span>
<kbd>↑</kbd> <kbd>↓</kbd> {t('move')}
</span>
<span>
<kbd>↵</kbd> {t('open')}
</span>
<span>
<kbd>Esc</kbd> {t('close')}
</span>
{recentPaths.value.length > 0 && (
<NButton text size="tiny" onClick={clearRecent}>
{t('clearRecent')}
</NButton>
)}
</div>
),
}}
</NCard>
</NModal>
)
</NScrollbar>
</>
),
action: () => (
<div class="global-search__help">
<span class="global-search__shortcut">
<kbd>↑</kbd> <kbd>↓</kbd> {t('move')}
</span>
<span class="global-search__shortcut">
<kbd>↵</kbd> {t('open')}
</span>
<span class="global-search__shortcut">
<kbd>Esc</kbd> {t('close')}
</span>
{recentPaths.value.length > 0 && (
<NButton text size="tiny" onClick={clearRecent}>
{t('clearRecent')}
</NButton>
)}
</div>
),
}}
</NCard>
</NModal>
)
},
})

View File

@ -1,4 +1,4 @@
.n-breadcrumb .n-breadcrumb-item {
.layout-breadcrumb .n-breadcrumb-item {
&.breadcrumb-enter-active,
&.breadcrumb-leave-active {
transition: all 0.3s var(--r-bezier);
@ -18,3 +18,17 @@
position: absolute;
}
}
.layout-breadcrumb,
.layout-breadcrumb__current {
min-inline-size: 0;
}
.layout-breadcrumb__current {
overflow: hidden;
text-overflow: ellipsis;
white-space: nowrap;
font-size: 15px;
font-weight: 600;
color: var(--r-text);
}

View File

@ -45,9 +45,11 @@ export default defineComponent({
const { dropdownSelect, breadcrumbItemClick } = this
return isTabletOrSmaller ? (
<div style="display: none;"></div>
<span class="layout-breadcrumb__current" aria-current="page">
{getBreadcrumbOptions.at(-1)?.breadcrumbLabel}
</span>
) : (
<NBreadcrumb>
<NBreadcrumb class="layout-breadcrumb">
<TransitionGroup tag="li" name="breadcrumb" appear>
{getBreadcrumbOptions.map((curr) => (
<NBreadcrumbItem

View File

@ -67,16 +67,12 @@
align-items: center;
justify-content: center;
gap: 6px;
min-inline-size: 0;
font-size: 12px;
font-size: 13px;
line-height: 1.4;
text-align: center;
}
&__text {
min-inline-size: 0;
overflow: hidden;
text-overflow: ellipsis;
white-space: nowrap;
}
@ -84,33 +80,14 @@
flex: none;
}
> .n-tabs-nav > .n-tabs-rail {
box-sizing: border-box;
gap: 6px;
padding: 8px 14px;
&__tab {
min-block-size: 44px;
}
> .n-tabs-nav {
border: 1px solid var(--r-line);
border-radius: var(--r-radius);
background: var(--r-surface);
> .n-tabs-tab-wrapper {
min-inline-size: 0;
> .n-tabs-tab {
min-block-size: 40px;
box-sizing: border-box;
padding: 8px 6px;
}
> .n-tabs-tab--active {
color: var(--r-primary-text);
}
}
> .n-tabs-capsule {
border-radius: var(--r-control-radius);
background: var(--r-surface-muted);
box-shadow: none;
}
}
> .n-tab-pane {
@ -254,6 +231,20 @@
inline-size: 14px;
margin-inline-start: 6px;
}
&__current {
display: flex;
flex-wrap: wrap;
gap: 4px 8px;
margin: 0;
color: var(--r-text-secondary);
font-size: 12px;
strong {
color: var(--r-primary-text);
font-weight: 600;
}
}
}
.r-settings-switch {

View File

@ -144,9 +144,18 @@ export default defineComponent({
),
default: () => (
<NTabs
type="segment"
type="line"
defaultValue="appearance"
class="r-settings-tabs"
tabClass="r-settings-tabs__tab"
tabsPadding={14}
themeOverrides={{
tabGapMediumLine: '16px',
tabPaddingMediumLine: '10px 4px',
tabTextColorActiveLine: 'var(--r-primary-text)',
tabTextColorHoverLine: 'var(--r-primary-text)',
barColor: 'var(--r-primary-text)',
}}
>
{categories.map(({ key, icon, view: View }) => (
<NTabPane

View File

@ -37,7 +37,11 @@ export default defineComponent({
<div class="r-settings-stack">
<SettingsSection title={t('layout.presets')}>
<p class="r-settings-hint">{t('layout.presetsHint')}</p>
<div class="r-settings-actions r-workspace-presets">
<div
class="r-settings-actions r-workspace-presets"
role="group"
aria-label={t('layout.presets')}
>
{Object.entries(workspacePresets).map(([key, config]) => (
<NButton
key={key}
@ -53,6 +57,11 @@ export default defineComponent({
</NButton>
))}
</div>
<p class="r-workspace-presets__current">
<span>{t('layout.current')}</span>
<strong>{t(`layout.${activePreset.value ?? 'custom'}`)}</strong>
<span>{getLayoutConfig.value.contentPadding} px</span>
</p>
</SettingsSection>
<SettingsSection title={t('section.layout')}>
<LayoutSettings showDescription />

View File

@ -1,20 +1,121 @@
.layout-header {
height: $layoutHeaderHeight;
padding: 0 $layoutRouterViewContainer;
block-size: $layoutHeaderHeight;
padding-inline: $layoutRouterViewContainer;
display: flex;
align-items: center;
border-bottom: 1px solid var(--r-line);
border-block-end: 1px solid var(--r-line);
> .layout-header__method {
width: 100%;
inline-size: 100%;
min-inline-size: 0;
gap: 16px;
}
&__navigation {
min-inline-size: 0;
flex: 1;
overflow: hidden;
}
&__actions {
flex-shrink: 0;
}
.n-breadcrumb {
font-size: 13px;
}
.override-button__layout,
&__menu-toggle {
inline-size: 36px;
padding: 0;
border-radius: var(--r-control-radius);
color: var(--r-text-secondary);
}
&__account {
block-size: 40px;
margin-inline-start: 8px;
padding-inline: 8px;
border-radius: var(--r-control-radius);
&.is-open {
background: var(--r-surface-hover);
}
.r-app-avatar__name {
max-inline-size: 9rem;
font-weight: 500;
}
}
&__account-chevron {
color: var(--r-text-muted);
transition: transform 160ms ease;
}
&__account.is-open &__account-chevron {
transform: rotate(180deg);
}
}
.override-button__layout {
padding: 0 9px;
border-radius: 8px;
.layout-account-menu {
min-inline-size: 224px;
max-inline-size: calc(100dvw - 24px);
&__identity {
display: grid;
gap: 4px;
max-inline-size: 256px;
padding: 12px 16px 8px;
overflow-wrap: anywhere;
> span {
color: var(--r-text-muted);
font-size: 12px;
}
> strong {
color: var(--r-text);
font-size: 14px;
font-weight: 600;
}
}
}
@media (max-width: 768px) {
.layout-header {
padding-inline: 8px;
> .layout-header__method {
gap: 4px;
}
.override-button__layout,
&__menu-toggle,
&__account {
inline-size: 44px;
block-size: 44px;
padding: 0;
}
&__account {
margin-inline-start: 0;
.r-app-avatar__name,
.layout-header__account-chevron {
display: none;
}
}
}
.layout-account-menu .n-dropdown-option-body {
min-block-size: 44px;
}
}
@media (prefers-reduced-motion: reduce) {
.layout-header__account-chevron {
transition: none;
}
}

View File

@ -4,9 +4,12 @@ import AppAvatar from '@/app-components/app/AppAvatar'
import { LOCAL_OPTIONS } from '@/app-config'
import { RIcon } from '@/components'
import { useDevice, useI18n } from '@/hooks'
import { useSettingActions, useSettingGetters } from '@/store'
import { NButton, NDropdown, NFlex, NLayoutHeader, NScrollbar } from 'naive-ui'
import type { VNode } from 'vue'
import {
useSettingActions,
useSettingGetters,
useSigningGetters,
} from '@/store'
import { NButton, NDropdown, NFlex, NLayoutHeader } from 'naive-ui'
import { useFullscreen } from 'vue-hooks-plus'
import {
Breadcrumb,
@ -37,6 +40,8 @@ export default defineComponent({
const { getDrawerPlacement, getBreadcrumbSwitch } = useSettingGetters()
// 是否显示设置抽屉
const showSettings = ref(false)
const accountMenuShown = ref(false)
const { getSigningCallback } = useSigningGetters()
// 是否展示全局搜索
const globalSearchShown = ref(false)
// 当前是否为平板或者更小的设备
@ -74,7 +79,7 @@ export default defineComponent({
showSettings.value = true
},
github: () => {
window.open('https://github.com/XiaoDaiGua-Ray/r-template')
window.open('https://github.com/XiaoDaiGua-Ray/ray-template')
},
fullscreen: () => {
if (!isEnabled) {
@ -98,15 +103,6 @@ export default defineComponent({
iconEventMap[key]?.()
}
/**
*
* @param vnode 需要渲染的节点
* @returns 如果是平板或者更小的设备, 就返回 null, 否则返回 vnode
*/
const isRenderVNode = (vnode: VNode) => {
return isTabletOrSmaller.value ? null : vnode
}
return {
t,
isFullscreen,
@ -118,7 +114,9 @@ export default defineComponent({
getDrawerPlacement,
getBreadcrumbSwitch,
globalSearchShown,
isRenderVNode,
isTabletOrSmaller,
accountMenuShown,
getSigningCallback,
}
},
render() {
@ -128,7 +126,7 @@ export default defineComponent({
getDrawerPlacement,
getBreadcrumbSwitch,
} = this
const { toolIconClick, updateLocale, isRenderVNode } = this
const { toolIconClick, updateLocale } = this
return (
<NLayoutHeader class="layout-header">
@ -139,10 +137,16 @@ export default defineComponent({
justify="space-between"
wrap={false}
>
<NFlex align="center" wrap={false}>
<NFlex
class="layout-header__navigation"
align="center"
size={this.isTabletOrSmaller ? 4 : 12}
wrap={false}
>
{leftIconOptions.map((curr) => (
<NButton
quaternary
class="layout-header__menu-toggle"
key={curr.name}
aria-label={this.t<string>('layout.toggleMenu')}
onClick={toolIconClick.bind(this, curr.eventKey ?? curr.name)}
@ -158,15 +162,32 @@ export default defineComponent({
))}
{getBreadcrumbSwitch ? <Breadcrumb /> : null}
</NFlex>
<NFlex justify="end" align="center" size={[0, 0]} wrap={false}>
{isRenderVNode(
<NFlex
class="layout-header__actions"
justify="end"
align="center"
size={[4, 0]}
wrap={false}
>
{this.isTabletOrSmaller ? (
<NButton
quaternary
class="override-button__layout"
aria-label={this.t<string>('headerTooltip.Search')}
onClick={() => {
this.globalSearchShown = true
}}
>
<RIcon name="action/search" size={20} />
</NButton>
) : (
<GlobalSearchButton
onClick={(e) => {
e.stopPropagation()
this.globalSearchShown = true
}}
/>,
/>
)}
{rightTooltipIconOptions.map((curr) => (
<NButton
@ -185,7 +206,7 @@ export default defineComponent({
)}
onClick={toolIconClick.bind(this, curr.eventKey ?? curr.name)}
>
<RIcon name={curr.name} />
<RIcon name={curr.name} size={20} />
</NButton>
))}
<NDropdown
@ -198,19 +219,57 @@ export default defineComponent({
aria-label={this.t<string>('layout.language')}
class="override-button__layout"
>
<RIcon name="system/language" />
<RIcon name="system/language" size={20} />
</NButton>
</NDropdown>
<NDropdown
options={createAvatarOptions(this.t)}
class="layout-account-menu"
placement="bottom-end"
show={this.accountMenuShown}
onUpdateShow={(show) => {
this.accountMenuShown = show
}}
options={[
{
key: 'identity',
type: 'render',
render: () => (
<div class="layout-account-menu__identity">
<span>{this.t('account.eyebrow')}</span>
<strong>{this.getSigningCallback.name}</strong>
</div>
),
},
{ key: 'identity-divider', type: 'divider' },
...createAvatarOptions(this.t),
]}
onSelect={(key) => void avatarDropdownClick(key)}
trigger="click"
>
<AppAvatar
avatarSize={24}
avatarSize={30}
cursor="pointer"
aria-label={this.t<string>('account.menu', {
name: this.getSigningCallback.name,
})}
aria-haspopup="menu"
aria-expanded={this.accountMenuShown}
spaceSize={[8, 0]}
class="override-button__layout"
/>
class={[
'layout-header__account',
{ 'is-open': this.accountMenuShown },
]}
>
{{
suffix: () => (
<RIcon
class="layout-header__account-chevron"
name="directional/expanded"
size={14}
/>
),
}}
</AppAvatar>
</NDropdown>
</NFlex>
</NFlex>

View File

@ -1,4 +1,5 @@
import { apiMockEnabled } from '@/api/admin/client'
import { RIcon } from '@/components'
import { useI18n } from '@/hooks'
import { router } from '@/router'
import { ACCOUNT_PROFILE_PATH } from '@/router/constant'
@ -9,10 +10,12 @@ export const createAvatarOptions = (t: ReturnType<typeof useI18n>['t']) => [
{
key: 'person',
label: t('account.profile'),
icon: () => h(RIcon, { name: 'navigation/form', size: 18 }),
},
{
key: 'lockScreen',
label: t(apiMockEnabled ? 'account.lockScreen' : 'account.lockSession'),
icon: () => h(RIcon, { name: 'action/lock', size: 18 }),
},
{
type: 'divider',
@ -21,6 +24,7 @@ export const createAvatarOptions = (t: ReturnType<typeof useI18n>['t']) => [
{
key: 'logout',
label: t('account.signOut'),
icon: () => h(RIcon, { name: 'action/out', size: 18 }),
},
]
@ -46,11 +50,13 @@ export const avatarDropdownClick = async (key: string | number) => {
}
if (key === 'logout') {
window.$dialog.warning({
window.$dialog.create({
title: t('signOut'),
showIcon: false,
content: t('signOutPrompt'),
positiveText: t('signOut'),
negativeText: t('cancel'),
positiveButtonProps: { type: 'primary' },
onPositiveClick: () => signOut(),
})
}

View File

@ -1,4 +1,5 @@
{
"menu": "Account menu: {name}",
"eyebrow": "Account settings",
"profile": "My profile",
"description": "Manage your profile and sign-in security.",

View File

@ -30,6 +30,7 @@
"restoreButton": "Exit fullscreen",
"loading": "Loading",
"tab": "Layout",
"closeMenu": "Close navigation menu",
"toggleMenu": "Open navigation menu",
"language": "Change language"
}

View File

@ -154,6 +154,8 @@
"spacious": "Comfortable spacing",
"compact": "Compact spacing",
"reading": "Centered reading",
"current": "Current",
"custom": "Custom spacing",
"focus": "Focus workspace",
"maximize": "Maximize content",
"maximizeHint": "Temporarily hide navigation and the footer. Close settings to see the result, then press Esc or use the exit button to restore. This resets on page reload."

View File

@ -1,4 +1,5 @@
{
"menu": "账户菜单:{name}",
"eyebrow": "账号设置",
"profile": "个人信息",
"description": "管理你的个人资料和登录安全。",

View File

@ -30,6 +30,7 @@
"restoreButton": "退出全屏",
"loading": "正在加载",
"tab": "布局",
"closeMenu": "关闭导航菜单",
"toggleMenu": "打开导航菜单",
"language": "切换语言"
}

View File

@ -154,6 +154,8 @@
"spacious": "舒适间距",
"compact": "紧凑间距",
"reading": "居中阅读",
"current": "当前",
"custom": "自定义间距",
"focus": "专注工作",
"maximize": "内容区最大化",
"maximizeHint": "临时隐藏导航和页脚。关闭设置抽屉后可查看效果,按 Esc 或点击退出按钮恢复;刷新页面不保留。"

View File

@ -3,16 +3,38 @@
display: flex;
flex-direction: column;
gap: 24px;
width: 100%;
max-width: 1360px;
inline-size: 100%;
max-inline-size: 1360px;
margin-inline: auto;
padding-block: 8px 20px;
&__header {
padding: 28px 32px;
border: 1px solid var(--r-line);
border-radius: var(--r-radius);
background: color-mix(
in srgb,
var(--r-theme-primary-color) 5%,
var(--r-surface)
);
.r-page-header__eyebrow {
color: var(--r-primary-text);
}
}
&__section-title {
margin-block-end: 12px;
color: var(--r-text);
font-size: 15px;
font-weight: 600;
}
&__brand {
display: grid;
place-items: center;
width: 72px;
height: 72px;
inline-size: 72px;
block-size: 72px;
border: 1px solid var(--r-line);
border-radius: var(--r-radius);
background: var(--r-surface);
@ -33,6 +55,7 @@
border: 1px solid var(--r-line);
border-radius: var(--r-radius);
background: var(--r-surface);
min-inline-size: 0;
}
span {
color: var(--r-text-secondary);
@ -44,6 +67,7 @@
font-size: 21px;
font-weight: 600;
letter-spacing: -0.03em;
overflow-wrap: anywhere;
}
small {
color: var(--r-text-muted);
@ -65,32 +89,36 @@
border: 1px solid var(--r-line);
border-radius: var(--r-control-radius);
color: var(--r-text);
background: var(--r-surface-muted);
background: var(--r-surface);
text-decoration: none;
transition:
border-color 0.18s ease,
background-color 0.18s ease;
&:hover {
border-color: var(--r-control-border);
background: var(--r-surface);
border-color: var(--r-primary-text);
background: var(--r-surface-muted);
}
&__icon {
display: grid;
place-items: center;
width: 38px;
height: 38px;
inline-size: 40px;
block-size: 40px;
flex-shrink: 0;
border: 1px solid var(--r-line);
border-radius: var(--r-control-radius);
color: var(--r-text-secondary);
background: var(--r-surface);
color: var(--r-primary-text);
background: color-mix(
in srgb,
var(--r-theme-primary-color) 9%,
var(--r-surface)
);
}
> span:nth-child(2) {
&__copy {
display: flex;
flex-direction: column;
gap: 5px;
min-width: 0;
min-inline-size: 0;
overflow-wrap: anywhere;
}
strong {
font-size: 14px;
@ -101,9 +129,14 @@
font-size: 12px;
}
&__arrow {
flex-shrink: 0;
margin-inline-start: auto;
color: var(--r-text-muted);
}
@media (prefers-reduced-motion: reduce) {
transition: none;
}
}
.r-dashboard-info {
@ -123,7 +156,7 @@
line-height: 1.8;
}
a {
color: var(--r-text);
color: var(--r-primary-text);
text-underline-offset: 3px;
}
}
@ -157,11 +190,15 @@
}
@container (max-width: 600px) {
.r-dashboard__header {
padding: 20px;
}
.r-dashboard-stack {
gap: 12px;
}
.r-dashboard-stack__item {
padding: 18px;
gap: 8px;
padding: 16px;
}
.r-dashboard__brand {
display: none;

View File

@ -14,6 +14,7 @@ export default defineComponent({
const { t } = useI18n('dashboard')
const text = (key: string) => t<string>(key)
const { getMenuOptions } = useMenuGetters()
const shortcutsTitle = useId()
const { dependencies, devDependencies } = __APP_CFG__.pkg
const stack = [
{ name: 'Vue', version: dependencies.vue, detail: 'Composition API' },
@ -38,7 +39,7 @@ export default defineComponent({
},
{
path: '/layout-demo',
icon: 'navigation/menu',
icon: 'navigation/layout',
title: 'layout',
description: 'layoutDescription',
},
@ -70,6 +71,7 @@ export default defineComponent({
return () => (
<section class="r-dashboard">
<AppPageHeader
class="r-dashboard__header"
title={text('title')}
description={text('description')}
eyebrow="RAY TEMPLATE / WORKSPACE"
@ -90,18 +92,21 @@ export default defineComponent({
))}
</div>
{shortcuts.value.length ? (
<NCard title={text('explore')}>
<div class="r-dashboard-shortcuts">
<section aria-labelledby={shortcutsTitle}>
<h2 id={shortcutsTitle} class="r-dashboard__section-title">
{text('explore')}
</h2>
<nav class="r-dashboard-shortcuts" aria-labelledby={shortcutsTitle}>
{shortcuts.value.map((item) => (
<RouterLink
key={item.path}
to={item.path}
class="r-dashboard-shortcut"
>
<span class="r-dashboard-shortcut__icon">
<span class="r-dashboard-shortcut__icon" aria-hidden="true">
<RIcon name={item.icon} size={20} />
</span>
<span>
<span class="r-dashboard-shortcut__copy">
<strong>{text(item.title)}</strong>
<small>{text(item.description)}</small>
</span>
@ -112,8 +117,8 @@ export default defineComponent({
/>
</RouterLink>
))}
</div>
</NCard>
</nav>
</section>
) : null}
<div class="r-dashboard-info">
<NCard title={text('project')}>

View File

@ -60,9 +60,36 @@
.n-data-table-base-body {
overscroll-behavior: contain;
}
&--stacked &__list {
&--stacked {
block-size: auto;
min-block-size: 100%;
gap: 20px;
> .n-spin-container {
flex: none;
}
> .n-spin-container > .n-spin-content {
block-size: auto;
}
.user-management__layout,
.user-management__list-viewport,
.user-management__list {
block-size: auto;
}
.user-management__organization {
max-block-size: 18rem;
}
.user-management__list-viewport > .n-scrollbar-container,
.n-data-table-base-body {
overscroll-behavior-y: auto;
}
.user-management__list-viewport > .n-scrollbar-container {
block-size: auto;
}
}
&--stacked &__list > .r-table {
flex: none;
@ -124,7 +151,8 @@
@container (max-width: 850px) {
.user-management__layout {
grid-template-columns: minmax(0, 1fr);
grid-template-rows: minmax(100px, 1fr) minmax(0, 3fr);
grid-template-rows: auto auto;
gap: 16px;
}
}
@media (max-width: 600px) {

View File

@ -31,7 +31,9 @@ updateSettingState('layoutConfig', {
})
```
最大宽度范围是 640–2560px,间距为 0–48px。顶栏和页脚可固定或随内容滚动。设置抽屉默认使用舒适间距(24px),并提供紧凑和居中阅读预设,只调整内容宽度与间距,保留导航方式和固定栏配置。已有浏览器偏好继续沿用,恢复默认布局时应用新的默认间距。内容区最大化复用 `useMaximize`,关闭设置后可查看效果,按 Esc 或退出按钮恢复;这一状态不随刷新保留。旧设置补齐默认值,布局恢复默认只重置 `layoutConfig`。
最大宽度范围是 640–2560px,间距为 0–48px。顶栏和页脚可固定或随内容滚动。设置抽屉默认使用舒适间距(24px),并提供紧凑和居中阅读预设,只调整内容宽度与间距,保留导航方式和固定栏配置。当前预设和实际间距会显示在预设区域;手动配置不匹配预设时显示「自定义间距」,不会覆盖已有设置。已有浏览器偏好继续沿用,恢复默认布局时应用新的默认间距。旧设置补齐默认值,布局恢复默认只重置 `layoutConfig`。
内容区最大化复用 `useMaximize`,关闭设置后可查看效果。窄屏的退出按钮固定悬浮在右上角,不占内容空间。点击按钮或按 Esc 即可恢复;最大化状态不随刷新保留。
外观页可批量显示或隐藏面包屑、页面标签和页脚,页面切换动画在「窗口与动效」中选择。各效果进入用时 240ms,退出用时 190ms,完整退出后再进入,并保留小幅位移和缩放。系统偏好减少动态效果时直接切换。恢复外观默认只重置外观选项,保留当前明暗模式。水印页提供疏朗、紧凑和水平预设、独立局部预览,以及应用标题和账户昵称快捷填入;无需开启全屏水印即可调试样式,预设保留已有文本和显隐状态。各模块的恢复按钮只作用于对应模块。
@ -61,6 +63,6 @@ updateSettingState('layoutConfig', {
## 最近访问和收藏
桌面搜索支持 Ctrl/Command + K。输入页面名称查找,点击星标收藏;空关键词时显示收藏与最近访问,方向键、回车和 Tab 可操作。记录按会话用户 id 隔离,刷新后恢复;清空记录保留收藏,也可在「偏好设置 → 通用」确认后清理当前账户的最近访问。缓存只存菜单路径,展示时重新依据当前菜单和权限筛选,语言切换沿用当前翻译。窄屏继续使用导航抽屉。
桌面搜索支持 Ctrl/Command + K。输入页面名称查找,点击星标收藏;空关键词时显示收藏与最近访问,方向键、回车和 Tab 可操作。记录按会话用户 id 隔离,刷新后恢复;清空记录保留收藏,也可在「偏好设置 → 通用」确认后清理当前账户的最近访问。缓存只存菜单路径,展示时重新依据当前菜单和权限筛选,语言切换沿用当前翻译。手机也可通过顶栏搜索按钮查询、收藏和打开页面;导航抽屉提供关闭按钮,切换屏幕宽度保留桌面侧栏的折叠偏好。
内容页需要撑满工作区时,先复用布局的 `--layout-content-height`、`RTablePro autoHeight` 和 `--r-table-height`,以及 Naive UI 的 `NCard contentScrollable` / `NScrollbar`。父容器提供确定高度,Flex/Grid 子项设置 `min-block-size: 0` 后再承载内部滚动;单纯填充与滚动无需新增通用组件。用户管理页展示了左右独立滚动与窄屏上下排布。
内容页需要撑满工作区时,先复用布局的 `--layout-content-height`、`RTablePro autoHeight` 和 `--r-table-height`,以及 Naive UI 的 `NCard contentScrollable` / `NScrollbar`。父容器提供确定高度,Flex/Grid 子项设置 `min-block-size: 0` 后再承载内部滚动;单纯填充与滚动无需新增通用组件。用户管理页在桌面左右独立滚动;窄屏改为纵向页面滚动,组织树限制高度,表格保留局部横向滚动。

View File

@ -153,6 +153,23 @@ export const AdminShell = defineComponent({
]}
style={props.maximized ? props.maximizedStyle : void 0}
>
{props.maximized ? (
<button
type="button"
class="r-layout-content-restore__button"
aria-label={props.restoreLabel}
title={props.restoreLabel}
{...{
onVnodeMounted: ({ el }: VNode) => {
if (el instanceof HTMLElement)
el.focus({ preventScroll: true })
},
}}
onClick={() => props.restore?.()}
>
<RIcon name="action/fullscreen_fold" size={18} />
</button>
) : null}
<NLayoutContent
ref={props.contentRef}
class="r-layout-full__viewer-content"
@ -171,23 +188,6 @@ export const AdminShell = defineComponent({
{!config.fixedFooter ? footer() : null}
</NLayoutContent>
{slots.loading?.()}
{props.maximized ? (
<button
type="button"
class="r-layout-content-restore__button"
aria-label={props.restoreLabel}
title={props.restoreLabel}
{...{
onVnodeMounted: ({ el }: VNode) => {
if (el instanceof HTMLElement)
el.focus({ preventScroll: true })
},
}}
onClick={() => props.restore?.()}
>
<RIcon name="action/fullscreen_fold" />
</button>
) : null}
</div>
{config.fixedFooter ? footer() : null}
</NLayoutContent>

View File

@ -90,23 +90,41 @@
place-items: center;
inline-size: 36px;
block-size: 36px;
border: 1px solid var(--r-control-border);
border-radius: var(--r-control-radius);
color: var(--r-text);
padding: 0;
border: 1px solid var(--r-line);
border-radius: 50%;
color: var(--r-text-secondary);
background: var(--r-surface);
box-shadow: var(--r-shadow-soft);
cursor: pointer;
&:hover {
color: var(--r-text);
background: var(--r-surface-hover);
}
}
@media (max-width: 768px) {
.r-layout-full .r-layout-content-inner {
--layout-content-gutter: min(
var(--layout-content-padding),
clamp(10px, 4vw, 16px)
);
.r-layout-full {
.r-layout-content-inner {
--layout-content-gutter: min(
var(--layout-content-padding),
clamp(10px, 4vw, 16px)
);
}
.r-layout-content--maximized {
.r-layout-content-scroll {
padding-inline-end: 0;
}
.r-layout-content-restore__button {
inset-block-start: 6px;
inset-inline-end: 8px;
min-inline-size: 44px;
min-block-size: 44px;
}
}
}
}