useTextDirection ​
Reactive dir of the element's text.
Demo ​
This paragraph is in English and correctly goes left to right.
Click to change the direction
Usage ​
ts
import { useTextDirection } from '@vueuse/core'
const dir = useTextDirection() // Ref<'ltr' | 'rtl' | 'auto'>By default, it returns rlt direction when dir rtl is applied to the html tag, for example:
html
<!--ltr-->
<html>
...
</html>
<!--rtl-->
<html dir="rtl">
...
</html>Options ​
ts
import { useTextDirection } from '@vueuse/core'
const mode = useTextDirection({
selector: 'body'
}) // Ref<'ltr' | 'rtl' | 'auto'>Type Declarations ​
typescript
export type UseTextDirectionValue = "ltr" | "rtl" | "auto"
export interface UseTextDirectionOptions extends ConfigurableDocument {
/**
* CSS Selector for the target element applying to
*
* @default 'html'
*/
selector?: string
/**
* Observe `document.querySelector(selector)` changes using MutationObserve
*
* @default false
*/
observe?: boolean
/**
* Initial value
*
* @default 'ltr'
*/
initialValue?: UseTextDirectionValue
}
/**
* Reactive dir of the element's text.
*
* @see https://vueuse.org/useTextDirection
*/
export declare function useTextDirection(
options?: UseTextDirectionOptions,
): WritableComputedRef<UseTextDirectionValue>Source ​
Contributors ​
Anthony Fu
iChengbo
Nestor VeraChangelog ​
v9.0.0-beta.2 on 7/24/2022