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

380 lines
15 KiB
Vue
Raw Normal View History

2023-03-21 12:05:24 +00:00
<script>
import Base from 'primevue/base';
import BaseStyle from 'primevue/base/style';
2024-03-31 04:44:48 +00:00
import Theme, { ThemeService } from 'primevue/themes';
import { DomHandler, ObjectUtils, UniqueComponentId } 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
},
dt: {
type: Object,
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) {
this._loadCoreStyles();
this._themeChangeListener(this._loadCoreStyles); // update styles with theme settings
2023-08-02 11:59:10 +00:00
}
}
},
dt: {
immediate: true,
handler(newValue) {
if (newValue) {
this._loadScopedThemeStyles(newValue);
this._themeChangeListener(() => this._loadScopedThemeStyles(newValue));
} else {
this._unloadScopedThemeStyles();
}
}
}
},
scopedStyleEl: undefined,
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-03-13 12:05:23 +00:00
this._loadStyles();
this._hook('onBeforeMount');
},
mounted() {
2024-04-02 10:23:32 +00:00
// @todo - improve performance
const rootElement = DomHandler.findSingle(this.$el, `[data-pc-name="${ObjectUtils.toFlatCase(this.$.type.name)}"]`);
rootElement?.setAttribute(this.$attrSelector, '');
this._hook('onMounted');
},
beforeUpdate() {
this._hook('onBeforeUpdate');
},
updated() {
this._hook('onUpdated');
},
beforeUnmount() {
this._hook('onBeforeUnmount');
},
unmounted() {
this._unloadScopedThemeStyles();
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);
},
2024-03-13 12:05:23 +00:00
_loadStyles() {
const _load = () => {
// @todo
if (!Base.isStyleNameLoaded('base')) {
2024-05-02 22:12:36 +00:00
BaseStyle.loadCSS(this.$styleOptions);
this._loadGlobalStyles();
2024-03-13 12:05:23 +00:00
Base.setLoadedStyleName('base');
}
this._loadThemeStyles();
};
_load();
this._themeChangeListener(_load);
},
_loadCoreStyles() {
if (!Base.isStyleNameLoaded(this.$style?.name) && this.$style?.name) {
2024-05-02 22:12:36 +00:00
BaseComponentStyle.loadCSS(this.$styleOptions);
this.$options.style && this.$style.loadCSS(this.$styleOptions);
Base.setLoadedStyleName(this.$style.name);
}
2024-03-13 12:05:23 +00:00
},
_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-05-02 22:12:36 +00:00
ObjectUtils.isNotEmpty(globalCSS) && BaseStyle.load(globalCSS, { name: 'global', ...this.$styleOptions });
2024-02-20 11:44:09 +00:00
},
_loadThemeStyles() {
if (this.isUnstyled) return;
2024-03-13 12:05:23 +00:00
// common
2024-03-31 04:44:48 +00:00
if (!Theme.isStyleNameLoaded('common')) {
const { primitive, semantic } = this.$style?.getCommonThemeCSS?.() || {};
2024-03-13 12:05:23 +00:00
2024-05-02 22:12:36 +00:00
BaseStyle.load(primitive, { name: 'primitive-variables', ...this.$styleOptions });
BaseStyle.load(semantic, { name: 'semantic-variables', ...this.$styleOptions });
BaseStyle.loadTheme({ name: 'global-style', ...this.$styleOptions });
2024-03-31 04:44:48 +00:00
Theme.setLoadedStyleName('common');
}
2024-03-13 12:05:23 +00:00
// component
2024-03-31 04:44:48 +00:00
if (!Theme.isStyleNameLoaded(this.$style?.name) && this.$style?.name) {
2024-05-02 22:12:36 +00:00
const { variables } = this.$style?.getComponentThemeCSS?.() || {};
2024-05-02 22:12:36 +00:00
this.$style?.load(variables, { name: `${this.$style.name}-variables`, ...this.$styleOptions });
this.$style?.loadTheme({ name: `${this.$style.name}-style`, ...this.$styleOptions });
2024-03-13 12:05:23 +00:00
2024-03-31 04:44:48 +00:00
Theme.setLoadedStyleName(this.$style.name);
}
2024-03-18 12:23:53 +00:00
// layer order
2024-03-31 04:44:48 +00:00
if (!Theme.isStyleNameLoaded('layer-order')) {
const layerOrder = this.$style?.getLayerOrderThemeCSS?.();
2024-05-02 22:12:36 +00:00
BaseStyle.load(layerOrder, { name: 'layer-order', first: true, ...this.$styleOptions });
2024-03-18 12:23:53 +00:00
2024-03-31 04:44:48 +00:00
Theme.setLoadedStyleName('layer-order');
}
2024-03-13 12:05:23 +00:00
},
_loadScopedThemeStyles(preset) {
2024-05-02 22:12:36 +00:00
const { variables } = this.$style?.getPresetThemeCSS?.(preset, `[${this.$attrSelector}]`) || {};
const scopedStyle = this.$style?.load(variables, { name: `${this.$attrSelector}-${this.$style.name}`, ...this.$styleOptions });
this.scopedStyleEl = scopedStyle.el;
},
_unloadScopedThemeStyles() {
this.scopedStyleEl?.value?.remove();
},
_themeChangeListener(callback = () => {}) {
Base.clearLoadedStyleNames();
ThemeService.on('theme:change', callback);
},
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 = {}) {
// inheritAttrs:true
2024-03-31 04:44:48 +00:00
return mergeProps(this.$_attrsWithoutPT, 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-03-13 12:05:23 +00:00
$theme() {
2024-02-20 11:44:09 +00:00
return this.$config?.theme;
2024-01-02 10:18:28 +00:00
},
2024-02-20 11:44:09 +00:00
$style() {
2024-05-02 22:12:36 +00:00
return { classes: undefined, inlineStyles: undefined, load: () => {}, loadCSS: () => {}, loadTheme: () => {}, ...(this._getHostInstance(this) || {}).$style, ...this.$options.style };
2024-02-20 11:44:09 +00:00
},
$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
2024-03-31 04:44:48 +00:00
}
2024-03-05 09:22:33 +00:00
};
},
$_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;
}, {});
},
2024-03-31 04:44:48 +00:00
$_attrsWithoutPT() {
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;
}, {});
},
$attrSelector() {
return UniqueComponentId('pc');
2023-05-10 11:49:54 +00:00
}
2023-03-21 12:05:24 +00:00
}
};
</script>