msb-public
/
vitepress
mirror of https://github.com/vuejs/vitepress
2
1
Code Issues Projects Releases Wiki Activity

Merge c87875acb2 into 56fa6c9df1

Browse Source
pull/5416/merge
Achord Chan 1 day ago committed by GitHub
parent 56fa6c9df1 c87875acb2
commit 0838c37406
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
13 changed files with 53 additions and 15 deletions
Show Stats Download Patch File Download Diff File

1
__tests__/e2e/.vitepress/config.ts
Unescape View File

@ -197,6 +197,7 @@ const sidebar: DefaultTheme.Config['sidebar'] = {
export default defineConfig({
title: 'Example',
description: 'An example app using VitePress.',
dir: false,
srcExclude: ['**/parts/**'],
markdown: {
image: { lazyLoad: true }

19
__tests__/e2e/navigation.test.ts
Unescape View File

@ -42,6 +42,25 @@ describe('navigation accessibility', () => {
expect(await sectionLink.getAttribute('aria-current')).toBeNull()
})
test('preserves a runtime-managed document direction', async () => {
await goto('/')
const html = page.locator('html')
expect(await html.getAttribute('dir')).toBeNull()
await page.evaluate(() => {
document.documentElement.dir = 'rtl'
})
await page
.locator('.VPNavBarMenuLink[href="/markdown-extensions/"]')
.click()
await page.waitForFunction(() =>
location.pathname.startsWith('/markdown-extensions')
)
expect(await html.getAttribute('dir')).toBe('rtl')
})
test('marks only exact sidebar links, including fragments', async () => {
const overview = '.VPSidebarItem .link[href="/sidebar-hash/"]'
const sectionOne = '.VPSidebarItem .link[href="/sidebar-hash/#section-one"]'

6
__tests__/unit/node/config.test.ts
Unescape View File

@ -3,10 +3,16 @@ import {
mergeConfig,
normalizeAssetsBase,
normalizeSiteBase,
resolveSiteData,
type UserConfig
} from 'node/config'
describe('node/config', () => {
test('preserves disabled automatic direction handling', async () => {
expect((await resolveSiteData('', { dir: false })).dir).toBe(false)
expect((await resolveSiteData('', {})).dir).toBe('ltr')
})
test('merges markdown hooks from extended configs', async () => {
const calls: string[] = []
const md = {} as MarkdownItAsync

4
docs/en/guide/i18n.md
Unescape View File

@ -44,7 +44,7 @@ The following properties can be overridden for each locale (including root):
```ts
interface LocaleSpecificConfig<ThemeConfig = any> {
lang?: string
dir?: string
dir?: 'ltr' | 'rtl' | 'auto' | false
title?: string
titleTemplate?: string | boolean
description?: string
@ -53,6 +53,8 @@ interface LocaleSpecificConfig<ThemeConfig = any> {
}
```
Set `dir: false` at the site or locale level when application code manages the `<html dir>` attribute at runtime. VitePress will omit the attribute from generated HTML and will not overwrite it during client-side navigation.
Refer [`DefaultTheme.Config`](https://github.com/vuejs/vitepress/blob/main/types/default-theme.d.ts) interface for details on customizing the placeholder texts of the default theme. Don't override `themeConfig.algolia` or `themeConfig.carbonAds` at locale-level. Refer [Algolia docs](../reference/default-theme-search#algolia-search-i18n) for using multilingual search.
**Pro tip:** Config file can be stored at `docs/.vitepress/config/index.ts` too. It might help you organize stuff by creating a configuration file per locale and then merge and export them from `index.ts`.

2
docs/en/reference/runtime-api.md
Unescape View File

@ -40,7 +40,7 @@ interface VitePressData<T = any> {
description: Ref<string>
lang: Ref<string>
isDark: Ref<boolean>
dir: Ref<'ltr' | 'rtl' | 'auto'>
dir: Ref<'ltr' | 'rtl' | 'auto' | false>
localeIndex: Ref<string>
/**
* Current location hash

2
docs/en/reference/site-config.md
Unescape View File

@ -373,7 +373,7 @@ export default {
- Default: `ltr`
- Can be overridden at the [directory level](#directory-level-overrides)
The text direction of the site. This will render as a `<html dir="rtl">` tag in the page HTML, and the default theme mirrors its layout for right-to-left languages. It can also be overridden per page via [frontmatter](./frontmatter-config#dir). See [RTL Support](../guide/i18n#rtl-support).
The text direction of the site. This will render as a `<html dir="rtl">` tag in the page HTML, and the default theme mirrors its layout for right-to-left languages. It can also be overridden per page via [frontmatter](./frontmatter-config#dir). Set it to `false` to let application code manage the attribute. See [RTL Support](../guide/i18n#rtl-support).
```ts
export default {

5
src/client/app/data.ts
Unescape View File

@ -58,7 +58,10 @@ export function initData(route: Route): VitePressData {
frontmatter: computed(() => route.data.frontmatter),
params: computed(() => route.data.params),
lang: computed(() => site.value.lang),
dir: computed(() => route.data.frontmatter.dir || site.value.dir),
dir: computed(() => {
const dir = route.data.frontmatter.dir
return dir === false ? false : dir || site.value.dir
}),
localeIndex: computed(() => site.value.localeIndex || 'root'),
title: computed(() => createTitle(site.value, route.data)),
description: computed(

4
src/client/app/index.ts
Unescape View File

@ -49,7 +49,9 @@ const VitePressApp = defineComponent({
if (inBrowser) {
watchEffect(() => {
document.documentElement.lang = lang.value
document.documentElement.dir = dir.value
if (dir.value !== false) {
document.documentElement.dir = dir.value
}
})
}

2
src/client/theme-default/composables/langs.ts
Unescape View File

@ -41,7 +41,7 @@ export function useLangs({
linkToCorrespondingPage
}),
lang: value.lang,
dir: value.dir
dir: value.dir === false ? undefined : value.dir
}
)
)

6
src/node/build/render.ts
Unescape View File

@ -100,7 +100,9 @@ export async function renderPage(
const title = createTitle(siteData, pageData)
const description = pageData.description || siteData.description
const dir = pageData.frontmatter.dir || siteData.dir || 'ltr'
const frontmatterDir = pageData.frontmatter.dir
const dir = frontmatterDir === false ? false : frontmatterDir || siteData.dir
const dirAttr = dir === false ? '' : ` dir="${dir || 'ltr'}"`
const isDefault404 = page === '404.md' && !hasCustom404
let preloadLinks: string[] = []
@ -199,7 +201,7 @@ export async function renderPage(
}
const html = `<!DOCTYPE html>
<html lang="${siteData.lang}" dir="${dir}">
<html lang="${siteData.lang}"${dirAttr}>
<head>
<meta charset="utf-8">
${

2
src/node/config.ts
Unescape View File

@ -420,7 +420,7 @@ export async function resolveSiteData(
return {
lang: userConfig.lang || 'en-US',
dir: userConfig.dir || 'ltr',
dir: userConfig.dir === false ? false : userConfig.dir || 'ltr',
title: userConfig.title || 'VitePress',
titleTemplate: userConfig.titleTemplate,
description: userConfig.description || 'A VitePress site',

3
src/node/plugin.ts
Unescape View File

@ -334,9 +334,10 @@ export async function createVitePressPlugin(
} catch {
// malformed percent-encoding: keep the site-level values
}
const dirAttr = dir === false ? '' : ` dir="${dir}"`
let html = `\
<!DOCTYPE html>
<html lang="${lang}" dir="${dir}">
<html lang="${lang}"${dirAttr}>
<head>
<title></title>
<meta charset="utf-8">

12
types/shared.d.ts vendored
Unescape View File

@ -184,10 +184,11 @@ export interface SiteData<ThemeConfig = any> {
*/
lang: string
/**
* The text direction (`dir` attribute) of the site.
* The text direction (`dir` attribute) of the site. Set to `false` to let
* application code manage the attribute.
* @default 'ltr'
*/
dir: 'ltr' | 'rtl' | 'auto'
dir: 'ltr' | 'rtl' | 'auto' | false
/**
* The title of the site.
* @default 'VitePress'
@ -295,7 +296,7 @@ export interface VitePressData<T = any> {
/**
* The text direction of the active locale.
*/
dir: Ref<'ltr' | 'rtl' | 'auto'>
dir: Ref<'ltr' | 'rtl' | 'auto' | false>
/**
* The key of the active locale.
*/
@ -379,9 +380,10 @@ export interface LocaleSpecificConfig<ThemeConfig = any> {
*/
lang?: string
/**
* The text direction of the locale.
* The text direction of the locale. Set to `false` to let application code
* manage the `dir` attribute.
*/
dir?: 'ltr' | 'rtl' | 'auto'
dir?: 'ltr' | 'rtl' | 'auto' | false
/**
* The title of the site in the locale.
*/

Write Preview
Loading…
Cancel
Save