primevue-mirror/components/lib/basecomponent/BaseComponent.vue

381 lines
16 KiB
Vue
Raw Normal View History

2023-03-21 12:05:24 +00:00
<script>
import BaseStyle from 'primevue/base/style';
2024-03-05 09:22:33 +00:00
import Theme from 'primevue/themes';
import { DomHandler, ObjectUtils } from 'primevue/utils';
2023-05-10 11:49:54 +00:00
import { mergeProps } from 'vue';
import BaseComponentStyle from './style/BaseComponentStyle';
2023-05-19 10:32:44 +00:00
2023-03-21 12:05:24 +00:00
export default {
name: 'BaseComponent',
2023-03-21 12:05:24 +00:00
props: {
pt: {
type: Object,
2023-04-26 08:57:02 +00:00
default: undefined
},
ptOptions: {
type: Object,
default: undefined
},
unstyled: {
type: Boolean,
default: undefined
2023-03-21 12:05:24 +00:00
}
},
inject: {
$parentInstance: {
default: undefined
}
},
watch: {
isUnstyled: {
immediate: true,
handler(newValue) {
2023-08-02 11:59:10 +00:00
if (!newValue) {
2024-02-20 11:44:09 +00:00
BaseComponentStyle.loadStyle(this.$styleOptions);
this.$options.style && this.$style.loadStyle(this.$styleOptions);
2023-08-02 11:59:10 +00:00
}
}
2024-01-02 10:18:28 +00:00
},
2024-03-05 09:22:33 +00:00
$globalPresetTheme: {
deep: true,
immediate: true,
handler(newValue) {
2024-03-05 11:08:00 +00:00
const { primitive, semantic, global } = this.$style?.getCommonThemeCSS(newValue, this.$globalBaseTheme, this.$themeParams, this.$globalTheme);
2024-03-05 09:22:33 +00:00
BaseStyle.loadTheme(primitive, { name: 'primitive-variables', useStyleOptions: this.$styleOptions });
BaseStyle.loadTheme(semantic, { name: 'semantic-variables', useStyleOptions: this.$styleOptions });
BaseComponentStyle.loadGlobalTheme(global, this.$styleOptions);
}
},
2024-02-20 11:44:09 +00:00
$globalPresetCTheme: {
2024-03-05 09:22:33 +00:00
deep: true,
2024-01-02 10:18:28 +00:00
immediate: true,
2024-03-05 09:22:33 +00:00
handler(newValue) {
if (newValue) {
const variables_css = this.$style?.getPresetThemeCSS(newValue, this.$globalTheme);
this.$style?.loadTheme(`${variables_css}`, { name: `${this.$style.name}-variables`, useStyleOptions: this.$styleOptions });
}
}
},
2024-02-20 11:44:09 +00:00
$globalBaseCTheme: {
2024-03-05 09:22:33 +00:00
deep: true,
immediate: true,
2024-03-05 09:22:33 +00:00
handler(newValue) {
if (newValue) {
const style_css = this.$style?.getBaseThemeCSS(newValue, this.$themeParams, this.$globalTheme);
2024-03-05 09:22:33 +00:00
this.$style?.loadTheme(style_css, { useStyleOptions: this.$styleOptions });
2024-01-02 10:18:28 +00:00
}
}
}
},
beforeCreate() {
const _usept = this.pt?.['_usept'];
const originalValue = _usept ? this.pt?.originalValue?.[this.$.type.name] : undefined;
const value = _usept ? this.pt?.value?.[this.$.type.name] : this.pt;
(value || originalValue)?.hooks?.['onBeforeCreate']?.();
const _useptInConfig = this.$config?.pt?.['_usept'];
const originalValueInConfig = _useptInConfig ? this.$primevue?.config?.pt?.originalValue : undefined;
const valueInConfig = _useptInConfig ? this.$primevue?.config?.pt?.value : this.$primevue?.config?.pt;
(valueInConfig || originalValueInConfig)?.[this.$.type.name]?.hooks?.['onBeforeCreate']?.();
},
created() {
this._hook('onCreated');
},
beforeMount() {
2024-02-20 11:44:09 +00:00
BaseStyle.loadStyle(this.$styleOptions);
this._loadGlobalStyles();
this._hook('onBeforeMount');
2024-03-05 09:22:33 +00:00
// @todo
const { colorScheme } = this.$globalThemeOptions || {};
let colorSchemeOption = {
light: {
class: '',
default: false
},
dark: {
class: 'p-dark',
default: false
}
};
if (colorScheme) {
if (ObjectUtils.isObject(colorScheme)) {
colorSchemeOption.light = { ...colorSchemeOption.light, ...colorScheme.light };
colorSchemeOption.dark = { ...colorSchemeOption.dark, ...colorScheme.dark };
} else {
colorSchemeOption.light = { ...colorSchemeOption.light, default: colorScheme !== 'auto' && colorScheme !== 'dark' };
colorSchemeOption.dark = { ...colorSchemeOption.dark, default: colorScheme === 'dark' };
}
const isAuto = !colorSchemeOption.light?.default && !colorSchemeOption.dark?.default;
const isDark = isAuto ? window.matchMedia('(prefers-color-scheme: dark)') : colorSchemeOption.dark?.default;
const defaultDocument = DomHandler.isClient() ? window.document : undefined;
Theme.setColorMode(isDark ? 'dark' : 'light');
if (isDark && defaultDocument) {
DomHandler.addClass(defaultDocument.documentElement, colorSchemeOption.dark?.class);
}
}
},
mounted() {
this._hook('onMounted');
},
beforeUpdate() {
this._hook('onBeforeUpdate');
},
updated() {
this._hook('onUpdated');
},
beforeUnmount() {
this._hook('onBeforeUnmount');
},
unmounted() {
this._hook('onUnmounted');
},
2023-03-21 12:05:24 +00:00
methods: {
_hook(hookName) {
if (!this.$options.hostName) {
const selfHook = this._usePT(this._getPT(this.pt, this.$.type.name), this._getOptionValue, `hooks.${hookName}`);
const defaultHook = this._useDefaultPT(this._getOptionValue, `hooks.${hookName}`);
selfHook?.();
defaultHook?.();
}
},
_mergeProps(fn, ...args) {
return ObjectUtils.isFunction(fn) ? fn(...args) : mergeProps(...args);
},
_loadGlobalStyles() {
/*
* @todo Add self custom css support;
* <Panel :pt="{ css: `...` }" .../>
*
* const selfCSS = this._getPTClassValue(this.pt, 'css', this.$params);
* const defaultCSS = this._getPTClassValue(this.defaultPT, 'css', this.$params);
* const mergedCSS = mergeProps(selfCSS, defaultCSS);
* ObjectUtils.isNotEmpty(mergedCSS?.class) && this.$css.loadCustomStyle(mergedCSS?.class);
*/
const globalCSS = this._useGlobalPT(this._getOptionValue, 'global.css', this.$params);
2024-02-20 11:44:09 +00:00
ObjectUtils.isNotEmpty(globalCSS) && BaseComponentStyle.loadGlobalStyle(globalCSS, this.$styleOptions);
},
2023-06-08 11:16:48 +00:00
_getHostInstance(instance) {
return instance ? (this.$options.hostName ? (instance.$.type.name === this.$options.hostName ? instance : this._getHostInstance(instance.$parentInstance)) : instance.$parentInstance) : undefined;
},
_getPropValue(name) {
return this[name] || this._getHostInstance(this)?.[name];
},
_getOptionValue(options, key = '', params = {}) {
const fKeys = ObjectUtils.toFlatCase(key).split('.');
2023-05-23 21:10:36 +00:00
const fKey = fKeys.shift();
2023-04-03 00:12:25 +00:00
2023-05-23 23:40:14 +00:00
return fKey
? ObjectUtils.isObject(options)
? this._getOptionValue(ObjectUtils.getItemValue(options[Object.keys(options).find((k) => ObjectUtils.toFlatCase(k) === fKey) || ''], params), fKeys.join('.'), params)
2023-05-23 23:40:14 +00:00
: undefined
: ObjectUtils.getItemValue(options, params);
2023-04-03 00:12:25 +00:00
},
2023-06-08 11:16:48 +00:00
_getPTValue(obj = {}, key = '', params = {}, searchInDefaultPT = true) {
const searchOut = /./g.test(key) && !!params[key.split('.')[0]];
const { mergeSections = true, mergeProps: useMergeProps = false } = this._getPropValue('ptOptions') || this.$config?.ptOptions || {};
const global = searchInDefaultPT ? (searchOut ? this._useGlobalPT(this._getPTClassValue, key, params) : this._useDefaultPT(this._getPTClassValue, key, params)) : undefined;
const self = searchOut ? undefined : this._getPTSelf(obj, this._getPTClassValue, key, { ...params, global: global || {} });
const datasets = this._getPTDatasets(key);
return mergeSections || (!mergeSections && self) ? (useMergeProps ? this._mergeProps(useMergeProps, global, self, datasets) : { ...global, ...self, ...datasets }) : { ...self, ...datasets };
},
_getPTSelf(obj = {}, ...args) {
return mergeProps(
this._usePT(this._getPT(obj, this.$name), ...args), // Exp; <component :pt="{}"
this._usePT(this.$_attrsPT, ...args) // Exp; <component :pt:[passthrough_key]:[attribute]="{value}" or <component :pt:[passthrough_key]="() =>{value}"
);
},
_getPTDatasets(key = '') {
const datasetPrefix = 'data-pc-';
const isExtended = key === 'root' && ObjectUtils.isNotEmpty(this.pt?.['data-pc-section']);
return (
key !== 'transition' && {
...(key === 'root' && {
[`${datasetPrefix}name`]: ObjectUtils.toFlatCase(isExtended ? this.pt?.['data-pc-section'] : this.$.type.name),
...(isExtended && { [`${datasetPrefix}extend`]: ObjectUtils.toFlatCase(this.$.type.name) })
}),
[`${datasetPrefix}section`]: ObjectUtils.toFlatCase(key)
}
);
},
_getPTClassValue(...args) {
const value = this._getOptionValue(...args);
return ObjectUtils.isString(value) || ObjectUtils.isArray(value) ? { class: value } : value;
},
_getPT(pt, key = '', callback) {
2023-09-05 10:18:36 +00:00
const getValue = (value, checkSameKey = false) => {
const computedValue = callback ? callback(value) : value;
const _key = ObjectUtils.toFlatCase(key);
const _cKey = ObjectUtils.toFlatCase(this.$name);
2023-09-05 10:18:36 +00:00
return (checkSameKey ? (_key !== _cKey ? computedValue?.[_key] : undefined) : computedValue?.[_key]) ?? computedValue;
};
2023-09-20 11:48:21 +00:00
return pt?.hasOwnProperty('_usept')
? {
2023-09-20 11:48:21 +00:00
_usept: pt['_usept'],
originalValue: getValue(pt.originalValue),
value: getValue(pt.value)
}
2023-09-05 10:18:36 +00:00
: getValue(pt, true);
},
_usePT(pt, callback, key, params) {
const fn = (value) => callback(value, key, params);
if (pt?.hasOwnProperty('_usept')) {
const { mergeSections = true, mergeProps: useMergeProps = false } = pt['_usept'] || this.$config?.ptOptions || {};
const originalValue = fn(pt.originalValue);
const value = fn(pt.value);
if (originalValue === undefined && value === undefined) return undefined;
else if (ObjectUtils.isString(value)) return value;
else if (ObjectUtils.isString(originalValue)) return originalValue;
return mergeSections || (!mergeSections && value) ? (useMergeProps ? this._mergeProps(useMergeProps, originalValue, value) : { ...originalValue, ...value }) : value;
}
return fn(pt);
},
_useGlobalPT(callback, key, params) {
return this._usePT(this.globalPT, callback, key, params);
},
_useDefaultPT(callback, key, params) {
return this._usePT(this.defaultPT, callback, key, params);
},
2023-03-21 12:05:24 +00:00
ptm(key = '', params = {}) {
return this._getPTValue(this.pt, key, { ...this.$params, ...params });
},
ptmi(key = '', params = {}) {
2024-02-11 08:10:29 +00:00
// inheritAttrs:true without `pt:*`
return mergeProps(this.$_attrsNoPT, this.ptm(key, params));
},
ptmo(obj = {}, key = '', params = {}) {
2023-07-04 02:24:37 +00:00
return this._getPTValue(obj, key, { instance: this, ...params }, false);
2023-05-19 10:32:44 +00:00
},
2023-05-19 11:14:50 +00:00
cx(key = '', params = {}) {
return !this.isUnstyled ? this._getOptionValue(this.$style.classes, key, { ...this.$params, ...params }) : undefined;
2023-05-23 09:15:04 +00:00
},
2023-05-19 11:14:50 +00:00
sx(key = '', when = true, params = {}) {
2023-05-19 10:32:44 +00:00
if (when) {
const self = this._getOptionValue(this.$style.inlineStyles, key, { ...this.$params, ...params });
const base = this._getOptionValue(BaseComponentStyle.inlineStyles, key, { ...this.$params, ...params });
2023-05-19 10:32:44 +00:00
return [base, self];
}
return undefined;
2023-03-21 12:05:24 +00:00
}
2023-05-10 11:49:54 +00:00
},
computed: {
globalPT() {
return this._getPT(this.$config?.pt, undefined, (value) => ObjectUtils.getItemValue(value, { instance: this }));
},
2023-05-10 11:49:54 +00:00
defaultPT() {
return this._getPT(this.$config?.pt, undefined, (value) => this._getOptionValue(value, this.$name, { ...this.$params }) || ObjectUtils.getItemValue(value, { ...this.$params }));
},
isUnstyled() {
return this.unstyled !== undefined ? this.unstyled : this.$config?.unstyled;
},
2024-02-20 11:44:09 +00:00
$globalTheme() {
return this.$config?.theme;
2024-01-02 10:18:28 +00:00
},
2024-03-05 09:22:33 +00:00
$globalThemeOptions() {
return this.$globalTheme?.options;
},
$globalBaseTheme() {
2024-02-20 11:44:09 +00:00
return ObjectUtils.getItemValue(this.$globalTheme?.base);
},
$globalBaseCTheme() {
2024-03-05 09:22:33 +00:00
return ObjectUtils.getItemValue(this.$globalBaseTheme?.components?.[this.$style.name], this.$themeParams);
},
$globalPresetTheme() {
2024-03-05 09:22:33 +00:00
return ObjectUtils.getItemValue(this.$globalTheme?.preset, { options: { ...this.$globalThemeOptions } });
2024-02-20 11:44:09 +00:00
},
$globalPresetCTheme() {
2024-03-05 09:22:33 +00:00
return ObjectUtils.getItemValue(this.$globalPresetTheme?.components?.[this.$style.name], this.$themeParams);
2024-02-20 11:44:09 +00:00
},
$style() {
return { classes: undefined, inlineStyles: undefined, loadStyle: () => {}, loadCustomStyle: () => {}, loadTheme: () => {}, ...(this._getHostInstance(this) || {}).$style, ...this.$options.style };
},
$styleOptions() {
return { nonce: this.$config?.csp?.nonce };
},
$config() {
return this.$primevue?.config;
},
$name() {
return this.$options.hostName || this.$.type.name;
2024-01-02 10:18:28 +00:00
},
$params() {
const parentInstance = this._getHostInstance(this) || this.$parent;
return {
instance: this,
props: this.$props,
state: this.$data,
attrs: this.$attrs,
parent: {
instance: parentInstance,
props: parentInstance?.$props,
state: parentInstance?.$data,
2023-12-10 21:43:59 +00:00
attrs: parentInstance?.$attrs
},
/* @deprecated since v3.43.0. Use the `parent.instance` instead of the `parentInstance`.*/
parentInstance
};
},
2024-03-05 09:22:33 +00:00
$themeParams() {
return {
...this.$params,
globalTheme: {
base: { ...this.$globalBaseTheme },
preset: { ...this.$globalPresetTheme },
options: { ...this.$globalThemeOptions }
}
};
},
$_attrsPT() {
return Object.entries(this.$attrs || {})
.filter(([key]) => key?.startsWith('pt:'))
.reduce((result, [key, value]) => {
const [, ...rest] = key.split(':');
rest?.reduce((currentObj, nestedKey, index, array) => {
!currentObj[nestedKey] && (currentObj[nestedKey] = index === array.length - 1 ? value : {});
return currentObj[nestedKey];
}, result);
return result;
}, {});
},
$_attrsNoPT() {
// $attrs without `pt:*`
return Object.entries(this.$attrs || {})
2024-02-13 09:38:20 +00:00
.filter(([key]) => !key?.startsWith('pt:'))
2024-02-11 08:46:46 +00:00
.reduce((acc, [key, value]) => {
acc[key] = value;
return acc;
}, {});
2023-05-10 11:49:54 +00:00
}
2023-03-21 12:05:24 +00:00
}
};
</script>