Конфигурация

Объект конфигурации

Основной интерфейс конфигурации для FishtVue предоставляет полный контроль над стилизацией компонентов, темами и поведением.

Получение экземпляра FishtVue

Существует несколько способов получить экземпляр FishtVue:

Использование Dependency Injection (рекомендуется)

Рекомендуемый способ - использовать систему внедрения зависимостей Vue:

import {FishtVueSymbol, type FishtVue} from "fishtvue/config"

// В настройке вашего компонента
const fishtvue = inject<FishtVue>(FishtVueSymbol)

Использование глобального объекта Window

Альтернативно, вы можете получить доступ к экземпляру через глобальный объект window:

const fishtvue = (window as any)?.FishtVue

Свойства конфигурации

componentsStyle

Определяет стиль компонентов. Доступные опции:

• filled - Компоненты с залитым фоном
• outlined - Компоненты с обводкой
• underlined - Компоненты только с нижней границей

app.use(FishtVue, {
    componentsStyle: 'filled'
});

unstyled

Когда установлено в true, компоненты не будут включать встроенные стили, позволяя вам применять пользовательские стили с помощью CSS-фреймворков, таких как Tailwind или Bootstrap.

app.use(FishtVue, {
    unstyled: true
});

locale

FishtVue предоставляет полную поддержку интернационализации через свою систему локалей. Вы можете настроить языки по умолчанию, добавить пользовательские переводы и динамически переключаться между разными локалями.

optionsTheme

Опции темы предоставляют детальный контроль над поведением темы, включая конфигурацию CSS-слоев, настройки темного режима и настройку префикса темы.

componentsOptions

Глобальный объект конфигурации, который сопоставляет имена компонентов с их опциями по умолчанию и настройками поведения. Это позволяет вам установить свойства по умолчанию для всех компонентов определенного типа.

app.use(FishtVue, {
    componentsOptions: {
        Button: {
            // Опции, специфичные для Button
        },
        Input: {
            // Опции, специфичные для Input
        }
        // ... другие опции компонентов
    }
});

Методы экземпляра

Экземпляр FishtVue предоставляет несколько методов для управления конфигурацией:

useFishtVue()

Возвращает копию экземпляра FishtVue только для чтения.

const fishtvue = useFishtVue();

getOptions()

Получает опции компонента либо для конкретного компонента, либо для всех компонентов.

// Получить опции для всех компонентов
const allOptions = fishtvue.getOptions();

// Получить опции для конкретного компонента
const buttonOptions = fishtvue.getOptions('Button');

getActiveLocale()

Получает текущую активную локаль.

const activeLocale = fishtvue.getActiveLocale();

setActiveLocale()

Устанавливает активную локаль.

fishtvue.setActiveLocale('en');

getDefaultLocale()

Получает локаль по умолчанию.

const defaultLocale = fishtvue.getDefaultLocale();